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 使用的最佳实践。

• 利用子代理处理安全敏感的操作或模块化任务隔离，以防止上下文污染。