codeany-ai/open-agent-sdk-typescript

解決的問題

Open Agent SDK 提供了一種無需單獨的子進程或 CLI 工具即可將自主 AI 代理整合到 TypeScript 應用程式中的方法。它簡化了建立能夠與本地檔案系統互動、執行 Shell 命令並使用外部工具，同時保持持久會話狀態的代理流程。

工作原理

該 SDK 直接在進程內實作代理循環（API 呼叫 $ ightarrow$ 工具執行 $ ightarrow$ 重複）。它抽象了 Anthropic 與 OpenAI 相容 API（包括 DeepSeek、Qwen 和 Mistral）之間的差異，允許開發人員輕鬆切換模型。系統使用提供商層來處理與 LLM 的通訊，並使用查詢引擎來管理工具與子代理的執行。

適用對象

希望在自己的應用程式環境、雲端函式或 CI/CD 流水線中，建構能夠執行程式碼審查、除錯或檔案操作等複雜任務的 AI 代理的 TypeScript 開發人員。

亮點

• 進程內執行：無需 CLI 或子進程即可執行完整的代理循環。
• 廣泛的內建工具集：包含超過 35 種用於 Bash、檔案系統存取（讀取/寫入/編輯）、網路搜尋和 LSP 程式碼智慧的工具。
• MCP 整合：支援 Model Context Protocol (MCP) 伺服器，透過標準介面擴展代理能力。
• 靈活的工具化：允許使用 Zod schema 進行驗證並建立自定義工具。
• 子代理與技能：支援為並行工作生成專門的子代理，以及稱為「技能」的可重用提示詞範本（例如 debug、review）。
• 生命週期鉤子：提供 20 種不同的生命週期事件（如 PreToolUse 和 PostToolUse）來攔截並控制代理行為。
• 會話管理：支援會話持久化、分支與恢復對話。