AI 教育訓練

【進階課程】AgEnD 實戰操作：從工具到團隊

2026/06/15 · 商用研一

1 / 38

今日議程

從日常管理 → 正確溝通 → 工具選擇 → 團隊協作 → 部署上線

1

AgEnD 入門回顧 & 管理
架構、WSL、安裝、Fleet vs ClassicBot、Context 管理

2

正確跟 Agent 溝通
資安機制、金鑰外洩案例、General 定位、WSL 路徑

3

CLI 工具箱
4 種 CLI 特性與選擇、網頁 vs CLI 差異、民生應用

4

Multi-Agent 團隊
為什麼多個 Agent、SOP 操作、追蹤結果

5

實戰部署
Cloudflare 介紹、Token 建立、部署到公網

6

回家作業
建團隊 + 部署成品到 Cloudflare Pages

2 / 38

SECTION 1

AgEnD 入門回顧 & 管理

了解背後原理，掌握日常維護

3 / 38

AgEnD 整體架構

使用者需求從通訊軟體直達 AI Agent

💬
User
Telegram / Discord
→
⚙️
AgEnD
WSL 內運行
→
🤖
Kiro CLI
AI Agent 處理
→
✅
回覆
結果傳回通訊軟體
4 / 38

為什麼要用 WSL？

主流 AI CLI 工具的作業系統支援度

🥇 macOS

原生支援最佳
零設定直接跑

🥈 WSL (Linux)

穩定度接近 macOS
Windows 使用者首選

🥉 Windows

原生支援有限
常遇到軟體相容性問題

WSL 是什麼？

Windows 內建的 Linux 虛擬子系統，可與 Windows 互通檔案。

⚠️ 如已安裝過 AgEnD，不需要執行此步驟

📋PS(admin)> wsl --install -d Ubuntu --location D:\WSL\Ubuntu

D:\ 請改為你的 SSD 路徑。藍底 = Windows PowerShell 深藍底 = WSL Linux

5 / 38

安裝與基本指令

一行安裝，幾個指令搞定日常管理

📋han@pc:~$ curl -fsSL https://songsid.github.io/AgEnD/install.sh | bash

常用指令

agend --version — 確認版本
agend quickstart — 快速初始化
agend start — 啟動 fleet
agend stop — 停止 fleet
agend ls — 列出所有 instance 狀態

進階指令

agend attach <name> — 進入 instance 終端

可以直接看到 agent 的即時輸出，
debug 或觀察用途。

6 / 38

AgEnD Fleet vs ClassicBot

Fleet = 個人專屬群組（全自動回應） · ClassicBot = 多人頻道（@才回應）

Fleet 模式

• 群組 = AgEnD 的家，所有訊息都會回應
• 多個 instance 各司其職
• 適合：個人專屬群組

han@pc:~$ agend quickstart
# 第一次設定完，fleet 即啟動

ClassicBot 模式

• 指定在特定群組 / channel 啟用
• 需要 @mention 機器人 才回應
• 適合：多人共用頻道

啟用方式：
1. 邀請 Bot 進 Discord Server / Telegram group
2. 通訊軟體內輸入 /start
3. 複製收到的資訊給 General 開通

7 / 38

ClassicBot 實際案例 — 數位客服

外部 bot 與內部 Fleet 通訊，不需開放所有權限

外部使用者 @HanAgent → ClassicBot 接收 → 轉發給內部 Fleet Leader → 修復完回報

8 / 38

Context 管理 — 最重要的日常習慣

AI 的記憶有限，定期查看才能維持品質

Discord 直接打 / 就會跳出指令

常用指令

/ctx

查看 context 用量

/compact

壓縮對話釋放空間

🟢 0-20% 黃金學習期　🟡 20-50% 正常使用　🔴 50%+ 記不住、token 飆高

每天看一下 /ctx 或 agend ls，也可以叫 General 幫忙看

9 / 38

AgEnD 背後是什麼

了解原理，遇到問題才知道怎麼排查

📋han@pc:~$ kiro-cli chat --resume

kiro-cli = Kiro CLI 本體 · chat = 對話模式 · --resume = 接續上次對話（記憶不斷）

底層引擎

Kiro CLI = AWS 的 AI 開發工具
AgEnD = 管理多個 Kiro CLI 的框架

記憶機制

--resume = 接續上次對話
context 不斷累積直到壓縮

多 Instance

每個 instance = 一個獨立 AI
各有自己的角色、記憶、工作目錄

10 / 38

SECTION 2

正確跟 Agent 溝通

讓 Agent 正確理解你、正確執行任務

11 / 38

AgEnD 資安機制

為什麼 Agent 有時候「不聽話」？

⚠️ 現象

透過 Discord/Telegram 說話時，Agent 回應變得保守、拒絕提供資料。
→ 這是正常的資安防護，Agent 不確定對方是誰。

✅ 解法

建 instance 時定義清楚角色：
「建一個 report-helper，角色是我的報告助手，工作目錄是 /mnt/d/Projects/月報」

角色越明確 → Agent 越不會拒絕。

💡 Prompt 寫法

❌「把所有檔案內容貼給我」→ 像在試探　　✅「請讀取 /mnt/d/Projects/月報/6月.xlsx 並整理成摘要」→ 明確具體

12 / 38

真實案例：金鑰外洩的代價

📰 2025：學生外洩 Gemini API Key → 帳單 $55,444 美元（≈180 萬台幣）ref

常見外洩方式

• API Key 寫在前端 JS
• .env commit 到 GitHub
• 截圖露出 token

規模

• GitHub 2024 偵測 3,900 萬筆外洩
• 平均損失 $488 萬美元/次

✅ 用 Multi-Agent 防止外洩

建議做法：建一個 Reviewer Agent，專門掃描 code 裡的 key / secret

• 機敏資料存環境變數，永遠不寫進 code
• .gitignore 加入 .env / credentials / *.pem
• 每次 commit 前讓 Agent 自動審查 → 比人眼更不會漏
• 可搭配 gitleaks 等工具做雙重檢查

💡 跟 General 說：「建一個 security-reviewer，角色是程式碼資安審查員，
　　每次我要 commit 前幫我檢查有沒有 API Key / Secret / Token 外洩」

13 / 38

General 的正確定位

它是管理員，不是工人

❌ 不要這樣用 General

• 「幫我寫週報」
• 「翻譯這篇文章」
• 「幫我整理這份 Excel」

日常任務會消耗 General 的 context，影響管理功能。

✅ General 該做的事

• 「我要建一個團隊，包含 leader 與 xxx，建議怎麼做？」
• 「幫我建立團隊與 Leader」
• 「列出目前所有 instance 的 ctx」
• 「幫我升級 agend」

管理、統籌、建立團隊。

💡 原則

日常任務 → 建專門的 instance 來做
General → 只負責管理 fleet 和建新 instance

14 / 38

WSL 路徑轉換

Agent 在 WSL 裡跑，你的檔案在 Windows — 路徑要轉換

❌ 錯誤

「幫我看 D:\Projects\報告.docx」

✅ 正確

「幫我看 /mnt/d/Projects/報告.docx」

🔑 轉換口訣

D:\X\Y → /mnt/d/X/Y　｜　反斜線換正斜線 ・ 碟符小寫 ・ 前面加 /mnt/

15 / 38

讓 Agent 操作 Windows 程式

透過 cmd.exe 呼叫 Windows 應用程式

📋han@pc:~$ cmd.exe /c start msedge "https://ai-training-advanced.pages.dev"
han@pc:~$ cmd.exe /c explorer.exe "D:\Projects"
han@pc:~$ cmd.exe /c start "" "D:\Projects\報告.pptx"

💡 怎麼跟 Agent 說

「做完 HTML 後用 Edge 打開讓我看」
「整理完後開啟檔案總管讓我確認」

如果 Agent 說「我無法操作 Windows」，直接告訴它：
「你跑在 WSL，cmd.exe 在 /mnt/c/Windows/system32/，你可以用它。」

16 / 38

SECTION 3

CLI 工具箱

4 種 CLI 各有擅長，選對工具事半功倍

17 / 38

CLI 選擇指南

🟣 Kiro

日常庶務首選
長篇分析、中文優化、圖片辨識

用量無限 (Amazon Q)

Claude Opus 4.6 / Sonnet 4.6

🔵 Antigravity

Google 搜尋
Banana 2 產圖

⚠️ 用量有限

Gemini 3.5 Flash / 3.1 Pro

🟢 Codex

智慧 Skill 檢索
Image 2.0 產圖

⚠️ 用量有限

GPT-5.5 / GPT-5.4

🟤 Claude Code

Skills / Hooks 生態
更高階 Claude 模型

⚠️ 用量有限

Claude Opus 4.8

💡 怎麼選？

📌 日常所有任務 → Kiro，用量無限 (Amazon Q)
🔍 需要 Google 搜尋 / Banana 產圖 → Antigravity
🎨 需要 Image 2.0 產圖 → Codex
🤔 Kiro 做不好、需要 Skill → Codex 做做看

18 / 38

🟣 Kiro CLI

日常首選 · 用量無限 (Amazon Q) · Claude Opus 4.6 / Sonnet 4.6

19 / 38

🔵 Antigravity (agy)

Google 搜尋 · Banana 2 產圖 · Gemini 3.5 Flash / 3.1 Pro

20 / 38

🟢 Codex

智慧 Skill 檢索 · Image 2.0 產圖 · GPT-5.5 / GPT-5.4

21 / 38

🟤 Claude Code

Skills / Hooks 生態 · Claude Opus 4.8

22 / 38

網頁版 vs CLI 版 — 有什麼差？

CLI 不是「比較難用的版本」，而是「資源更多的版本」

比較項目 網頁/桌面版 CLI 版
Context 長度 ⭐ 128K ~ 200K 400K ~ 1M ⭐ 5倍差距
模型強度 速度優先版本 Coding 特化 / 頂級模型
操作檔案 ❌ 複製貼上 ✅ 直接讀寫你的檔案
Agent 能力 一問一答 工具呼叫、MCP、Multi-Agent
適合場景 快速問答、靈感發想 長時間任務、專案開發

💡 一句話總結

網頁版 = 適合問問題　｜　CLI 版 = 適合做事情
不是網頁比較笨，而是 CLI 給的資源（context、模型、工具）更多。

23 / 38

CLI 可以做到什麼事情？

不只是寫程式 — 日常民生需求也能搞定

📊 Excel 整理

讀取、分析、產報表

📝 寫週報

讀資料夾自動彙整

🌐 做網頁

一句話生成 + 部署

🔍 上網搜尋

整理摘要回傳

📄 PDF 摘要

讀長文件抓重點

🖼️ 圖片辨識

截圖丟給它看

🌍 翻譯文件

整份翻 + 校對

📁 整理資料夾

分類、改名、搬移

🎨 產圖

文字描述生成圖片

📧 寫信

草稿 + 潤飾 + 翻譯

🗓️ 排程提醒

設定定時訊息通知

💻 寫程式

開發、debug、重構

📋 PPT 製作

自動生成簡報

🔐 資安檢查

掃描 key/密碼外洩

📈 數據分析

CSV/DB 查詢視覺化

🚀 部署上線

一鍵推到 Cloudflare

24 / 38

SECTION 4

Multi-Agent 團隊

讓多個 Agent 分工合作完成複雜任務

25 / 38

Multi-Agent 操作

SOP：從目標到團隊，一步步建立

1

告訴 General：「我的目標是 XXX，給我一個建議的團隊分工，並建一個專門的 Leader」

2

團隊建好後，請 Leader 讓底下成員上網搜尋相關的 Codex / Claude Skill 並學習

3

人類只跟 Leader 對話，追蹤結果即可 — 不需要逐一指揮每個 Agent

💡 關鍵心態

你是老闆，Leader 是主管，其他 Agent 是員工。
老闆只需要跟主管說目標，不需要教每個員工怎麼做。

26 / 38

Multi-Agent 團隊實戰

用團隊完成「內容產出 → 部署上線」的完整流程

1

建團隊 — 跟 General 說「建 leader、研發、網管」

2

派任務 — 跟 Leader 說「把成品 1 去識別化，做成 HTML」

3

部署 — 把 Cloudflare Token 給網管，讓它部署到 Pages

4

總結 — Leader 把技術架構寫到網頁上

5

驗收 — 打開 URL 確認成功 🎉

27 / 38

SECTION 5

回家作業

用 Multi-Agent 團隊完成一個公開成品

28 / 38

回家作業

延伸上次成果：把工作成果變成公開網頁

🎯 任務

用 Multi-Agent 團隊，把「上半年工作成果」
做成去識別化的 HTML 網頁，部署到 Cloudflare Pages

1

建 leader + 研發（+ 美術可選）+ 網管

2

跟 leader 說目標，讓團隊產出 HTML

3

給網管 Cloudflare Token，部署到 Pages

4

Leader 總結技術架構，新增到網頁

5

繳交：你的 Cloudflare Pages URL

⚠️ 提醒

內容必須去識別化 — 移除公司名、專案名、人名、帳號等敏感資訊。

29 / 38

SECTION 6

實戰部署（Cloudflare）

把成果發佈到公開網路上

30 / 38

Cloudflare — 業界最佛免費方案

把網頁丟上去就有公開網址，零設定、零伺服器、零成本

🆓 Pages

靜態網站部署
無限流量、500 次/月

🆓 Workers

Serverless 函式
每日 10 萬次

🆓 R2

物件儲存 10 GB
無 egress 費用

🆓 DNS + SSL

全球 CDN
自動 HTTPS

🤔 為什麼這麼佛？

商業模式是賣企業級服務（WAF、DDoS 防護）給大公司。免費 tier 是獲客策略 — 靜態 CDN 成本極低，養生態圈比收你錢更划算。

⚠️ 資安提醒

Cloudflare Pages 是公開網路，任何人都能看到。
禁止上傳：企業機密、個資、內部文件、帳號密碼。
作業內容必須去識別化。

31 / 38

Token 建立 — Step 1：登入

dash.cloudflare.com — 用 Google/GitHub 帳號最快

登入
不需要信用卡，免費帳號即可
32 / 38

Token 建立 — Step 2：建立 Token

Manage account → Account API tokens → Create a token

建立 Token
左側選單：Manage account → Account API tokens
33 / 38

Token 建立 — Step 3：設定權限

Developer Platform → Pages → Edit（只需要這一個權限）

權限設定
搜尋 "Page" → Pages → 開啟 Edit → Scope: Entire Account
34 / 38

Token 建立 — Step 4：確認

確認 Pages Write / Entire Account → Create token

確認
確認設定無誤後按 Create token
35 / 38

Token 建立 — Step 5：複製 Token

⚠️ 只顯示一次！馬上複製

複製 Token
點複製按鈕 → 貼給你的網管 Agent → 完成

⚠️ 重要

Token 只顯示這一次，關掉就看不到了。馬上複製貼給你的 Agent。

36 / 38

回家作業

延伸上次成果：把工作成果變成公開網頁

🎯 任務

用 Multi-Agent 團隊，把「上半年工作成果」
做成去識別化的 HTML 網頁，部署到 Cloudflare Pages

1

建 leader + 研發（+ 美術可選）+ 網管

2

跟 leader 說目標，讓團隊產出 HTML

3

給網管 Cloudflare Token，部署到 Pages

4

Leader 總結技術架構，新增到網頁

5

繳交：你的 Cloudflare Pages URL

⚠️ 提醒

內容必須去識別化 — 移除公司名、專案名、人名、帳號等敏感資訊。

37 / 38

今日重點回顧

⚙️ 架構 & 管理

User → AgEnD → Kiro CLI
Fleet vs ClassicBot
/ctx · /compact · agend ls

💬 溝通 & 資安

角色定義越明確越好
金鑰不進 code → Agent 幫掃
WSL 路徑：D:\ → /mnt/d/

🛠️ CLI & Multi-Agent

Kiro 用量無限，日常首選
Multi-Agent SOP：目標→團隊→追蹤
CLI 能做超多種民生任務，一切靠你想像

🚀 部署

Cloudflare Pages 免費部署
一行指令上線公網

📝 作業

建 Multi-Agent 團隊
完成任務 + 部署到 Cloudflare

38 / 38
↑ ↓