agent-sdk

Claude Agent SDK 技能提供 Anthropic 官方代理開發框架的全面專業知識。專為希望從簡單 API 請求過渡到穩定、生產級自主代理系統的工程師與開發者設計。此技能涵蓋代理開發的完整生命週期，包括代理迴圈、上下文管理、工具編排與系統提示詞工程。透過此技能，開發者能有效實作複雜的代理工作流程，例如多步驟推理鏈、工具使用迴圈以及子代理層次結構。它特別支援與模型上下文協議 (MCP) 伺服器的整合，使代理能夠以標準化方式與外部檔案系統、資料庫及第三方 API 進行互動。

• 自主代理迴圈與狀態管理的架構指導。

• 使用 JSON Schema 設計與實作工具，以實現無縫的模型互動。

• 先進的上下文管理，包括自動壓縮、Token 預算追蹤以及透過子代理實現的對話歷史隔離。

• 整合模型上下文協議 (MCP)，以實現可擴展的工具能力與環境連接。

• 實作生產級模式，如 Hooks、權限系統（白名單/黑名單）以及錯誤處理重試機制。

• 支援 Python (claude-agents) 與 TypeScript (@anthropics/agent-sdk) 兩種實作方式。

• 推薦用於需要迭代工具執行與驗證的自主代理。

• 適用於涉及任務拆解與多代理協作的代理工作流程。

• 不適用於簡單的單輪聊天應用或直接呼叫 Messages API 即可滿足的場景。

• 確保正確配置 ANTHROPIC_API_KEY 等環境變數以保障安全訪問。

• 透過監控工具輸出並利用上下文摘要功能，遵循 Token 使用的最佳實踐。

• 利用子代理處理安全敏感的操作或模組化任務隔離，以防止上下文污染。