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 或子进程即可运行完整的智能体循环。
• 广泛的内置工具集：包括用于 Bash、文件系统访问（读取/写入/编辑）、网络搜索和 LSP 代码智能的 35 多个工具。
• MCP 集成：支持 Model Context Protocol (MCP) 服务器，通过标准接口扩展智能体能力。
• 灵活的工具化：允许使用 Zod schema 进行验证并创建自定义工具。
• 子智能体与技能：支持为并行工作生成专门的子智能体，以及称为“技能”的可重用提示词模板（例如 debug、review）。
• 生命周期钩子：提供 20 种不同的生命周期事件（如 PreToolUse 和 PostToolUse）来拦截和控制智能体行为。
• 会话管理：支持会话持久化、分叉和恢复对话。