AI 教育訓練

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

2026/06/15 · 商用研一

今日議程

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

1

AgEnD 入門回顧 & 管理
背後原理、安裝升級、Context 管理

2

正確跟 Agent 溝通
資安機制、General 定位、WSL 路徑、cmd.exe

3

CLI 工具箱
4 種 CLI 的特性，什麼時候該新增

4

Multi-Agent 團隊
為什麼多個 Agent、怎麼派任務驗收

5

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

6

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

SECTION 1

AgEnD 入門回顧 & 管理

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

AgEnD 背後是什麼

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

# AgEnD 每個 instance 實際上是： kiro-cli chat --resume # 意思是： # - kiro-cli = Kiro CLI 本體 # - chat = 對話模式 # - --resume = 接續上次對話（記憶不斷）

安裝 / 升級

npm update -g @songsid/agend
或跟 General 說「幫我升級」

確認狀態

agend ls
列出所有 instance 的運行狀態

日常重啟

跟 General 說「重啟 xxx」
自動 --resume 接回上次狀態

Context 管理 & 壓縮

AI 記憶有限 — 學會查看和管理（目前僅 Kiro CLI 完整支援）

查看用量

# 在對話中輸入： /ctx # 顯示類似： # Context: 45,000 / 200,000 (22%)

手動壓縮

# 在對話中輸入： /compact # 把對話壓縮成摘要 # 釋放空間，但細節會丟失

💡 最佳實踐

• ctx 超過 60% → compact 或開新對話
• 重要結論 → 先請 AI 存成檔案再 compact
• 換主題 → 直接開新對話比 compact 更乾淨

SECTION 2

正確跟 Agent 溝通

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

AgEnD 資安機制

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

⚠️ 現象

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

✅ 解法：建 instance 時就定義清楚

在 General 建立角色時，明確告訴它：

「建一個 instance 叫 report-helper，角色是我的個人報告助手，
　工作目錄是 /mnt/d/Projects/月報，可以讀寫該目錄的所有檔案」

角色定位越明確，Agent 越不會「猜你在試探」而拒絕。

💡 避免觸發防護的 prompt 寫法

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

General 的正確定位

它是管理員，不是工人

❌ 不要這樣用 General

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

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

✅ General 該做的事

• 「幫我建一個新 instance」
• 「列出目前所有 instance」
• 「幫我升級 agend」
• 「幫我安裝 MCP」

管理、統籌、建立團隊。

💡 原則

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

WSL 路徑轉換

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

❌ 錯誤

「幫我看 D:\Projects\報告.docx」 「你能看到我的桌面嗎？」

✅ 正確

「幫我看 /mnt/d/Projects/報告.docx」 「讀取 /mnt/c/Users/你的名字/Desktop/檔案.xlsx」

🔑 轉換口訣

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

讓 Agent 操作 Windows 程式

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

# 用 Edge 開啟網頁 cmd.exe /c start msedge "https://ai-training-advanced.pages.dev" # 開啟檔案總管 cmd.exe /c explorer.exe "D:\Projects" # 用預設程式開啟檔案 cmd.exe /c start "" "D:\Projects\報告.pptx"

💡 怎麼跟 Agent 說

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

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

SECTION 3

CLI 工具箱

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

CLI 選擇指南

🟠 Kiro CLI (Amazon Q)

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

Claude Opus 4.6 / Sonnet 4.6

🔵 Antigravity

Google 搜尋、Banana 2 產圖
Gemini CLI 接替品（2026/6 停服）

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 做做看

🟠 Kiro CLI (Amazon Q)

日常首選 · 用量無限 · Claude Opus 4.6 / Sonnet 4.6

🔵 Antigravity (agy)

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 Opus 4.8

SECTION 4

Multi-Agent 團隊

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

Multi-Agent 操作

你是「驗收者」不是「操作員」— 說目標，不管分工

# 你跟 Leader 說： 「幫我把這份報告翻譯成英文」 # 背後發生： Leader → delegate_task → 研發 Agent （研發 Agent 安靜工作...） 研發 Agent → report_result → Leader Leader → 「翻譯完成，存在 /mnt/d/output/report_en.md」

你看到的

只跟 Leader 一個人對話
結果自動出現

為什麼要分開

寫的人跟審的人不同
→ 品質才上得去
→ 平行工作更快

SECTION 5

實戰部署

把成果發佈到公開網路上

Cloudflare — 業界最佛免費方案

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

🆓 Pages

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

🆓 Workers

Serverless 函式
每日 10 萬次

🆓 R2

物件儲存 10 GB
無 egress 費用

🆓 DNS + SSL

全球 CDN
自動 HTTPS

🤔 為什麼這麼佛？

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

⚠️ 資安提醒

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

Token 建立 — Step 1：登入

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

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

Token 建立 — Step 2：建立 Token

Manage account → Account API tokens → Create a token

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

Token 建立 — Step 3：設定權限

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

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

Token 建立 — Step 4：確認

確認 Pages Write / Entire Account → Create token

確認
確認設定無誤後按 Create token

Token 建立 — Step 5：複製 Token

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

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

⚠️ 重要

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

Multi-Agent 團隊實戰

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

1

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

2

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

3

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

4

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

5

驗收 — 打開 URL 確認成功 🎉

回家作業

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

🎯 任務

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

1

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

2

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

3

給網管 Cloudflare Token，部署到 Pages

4

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

5

繳交：你的 Cloudflare Pages URL

⚠️ 提醒

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

今日重點回顧

⚙️ 管理

agend update / ls
/ctx 查看 / /compact
kiro-cli chat --resume

💬 溝通

建 instance 時定義角色
WSL 路徑 /mnt/
General 只做管理

🚀 實戰

Multi-Agent 團隊
Cloudflare Pages 部署
去識別化後上線

下次課程：Agent 專案實戰

自訂角色定位 ・ 跨 Agent 協作 ・ 從 spec 到成品的完整工作流

↑ ↓