# 代理程式

## 什麼是代理程式？

代理程式是隔離的 AI 助理，能夠推理解決問題、執行任務，並跨多個平台進行溝通。每個代理程式都有自己的工作空間、工作階段歷史、模型設定和頻道綁定。

## 代理程式隔離

每個代理程式都擁有：

- **工作空間**, 專屬的檔案、筆記和代理程式特定資料目錄
- **工作階段**, 獨立的對話歷史和轉錄記錄
- **設定**, 模型選擇、工具權限、消費限制
- **身份**, 在代理程式 `AGENTS.md` 檔案中定義的唯一角色
- **驗證設定檔**, 每個代理程式的 API 金鑰和驗證設定

## 代理程式角色

每個代理程式的工作空間都包含一個 `AGENTS.md` 檔案，用於定義個性、指令和行為準則。這個持久性系統提示決定代理程式的回應方式, , 語氣、領域專業知識、格式、工具使用和安全策略。

## 多代理程式路由

執行多個代理程式時，入站訊息會根據**綁定**自動路由：

- **頻道綁定**, 將來自某個平台的所有訊息路由至特定代理程式（例如，所有 Telegram 訊息 → `personal` 代理程式）
- **伺服器/工作空間綁定**, 將特定的 Discord 伺服器或 Slack 工作空間路由至專屬代理程式
- **對話類型綁定**, 將私人訊息路由至一個代理程式，將群組訊息路由至另一個
- **聯絡人/對等方綁定**, 將來自特定聯絡人的訊息路由至特定代理程式

綁定按優先順序評估。第一個符合的規則勝出。未匹配的訊息發送至預設代理程式。

## 子代理程式與委派

代理程式可以為專業任務生成子代理程式：

- **任務委派**, 分解複雜任務並將部分委派給專業子代理程式
- **隔離執行**, 子代理程式在各自的工作階段上下文中執行
- **乒乓對話**, 代理程式可以進行來回交流（最多 5 輪）以協同合作
- **結果公告**, 子代理程式的結果可以回傳至原始頻道

## 團隊與協調

多代理程式團隊支援協調工作流程：

- **並行執行**, 同時在不同任務面向執行多個代理程式
- **循序管道**, 鏈接代理程式，讓每個代理程式建立在前一個代理程式的輸出上
- **混合模式**, 結合並行和循序執行
- **任務追蹤**, 監控每個代理程式工作的狀態（排隊、執行中、完成、錯誤、已取消）

## 工具設定檔

控制每個代理程式能做什麼：

| 設定檔 | 可用工具 |
|--------|---------|
| **minimal** | 僅工作階段狀態 |
| **coding** | 檔案 I/O、執行、工作階段、記憶體、圖片 |
| **messaging** | 訊息傳送、工作階段歷史 |
| **full** | 所有工具（預設） |

可以為每個代理程式和每個模型提供者設定自訂允許/拒絕清單。

## 安全模式

安全模式提供執行沙盒：

- **主開關**, 全域啟用或停用
- **每代理程式控制**, 對受信任的代理程式停用，對其他代理程式保持開啟
- **執行核准**, 敏感操作需要明確的使用者核准
- **策略同步**, 設定即時同步至所有已連接的用戶端

## 代理程式記憶體

每個代理程式都可以存取記憶體系統：

- **MEMORY.md**, 跨工作階段的持久性筆記和重要資訊
- **記憶體檔案**, `memory/` 中的額外結構化知識
- **向量搜尋**, 使用自然語言查詢搜尋記憶體

詳情請參閱[工作階段與記憶體](sessions-memory.md)。