代理程式框架構建

代理程式框架構建 是做什麼的？

當您正在改善代理的規劃、工具呼叫、錯誤恢復及任務收斂時，請使用此技能。

核心模型

代理輸出品質受到以下因素限制：

1. 行動空間品質
2. 觀察品質
3. 恢復品質
4. 上下文預算品質

行動空間設計

1. 使用穩定且明確的工具名稱。
2. 保持輸入以結構定義優先，且範圍狹窄。
3. 回傳確定性的輸出形狀。
4. 除非無法隔離，否則避免使用萬用工具。

粒化規則

• 對於高風險操作（部署、遷移、權限），使用微觀工具。
• 對於常見的編輯/讀取/搜尋迴圈，使用中觀工具。
• 僅在往返開銷為主要成本時，使用巨觀工具。

觀察設計

每個工具回應都應包含：

• status: success|warning|error
• summary: 一行摘要
• next_actions: 可操作的後續步驟
• artifacts: 檔案路徑 / ID

錯誤恢復合約

針對每個錯誤路徑，包含：

• 根本原因提示
• 安全重試指令
• 明確停止條件

上下文預算管理

1. 保持系統提示簡潔且不變。
2. 將大量指導內容移至按需載入的技能中。
3. 偏好引用檔案，而非內嵌長文件。
4. 在階段邊界進行壓縮，而非依據任意 token 門檻。

架構模式指引

• ReAct：最適合路徑不確定的探索性任務。
• Function-calling：最適合結構化的確定性流程。
• 混合模式（推薦）：ReAct 規劃 + 型別化工具執行。

基準測試

追蹤：

• 完成率
• 每任務重試次數
• pass@1 和 pass@3
• 每成功任務成本

反模式

• 過多語意重疊的工具。
• 不透明的工具輸出，無恢復提示。
• 僅輸出錯誤而無下一步驟。
• 使用不相關的參考資訊造成上下文負載過重。