SuperAPI AI 工具集

claude-agent-sdk

智能体与模型

查看项目

更新于 10-15 20:05

技能介绍

用途:该技能用于使用 Python 版 Claude Agent SDK 构建可投入生产的应用,重点是通过 SDK 编排 Claude 智能体,包括带子智能体的编排器、程序化智能体配置、钩子与权限控制等。目标 SDK 版本为 claude-agent-sdk>=0.1.6。

主要能力:区分 query() 与 ClaudeSDKClient 两种交互方式。query() 适合一次性、独立任务,每次调用新建会话、无对话记忆,不支持钩子与自定义工具;ClaudeSDKClient 支持多轮对话记忆、钩子、自定义工具(SDK MCP 服务器)、中断操作与持久会话,适合交互式工作流和复杂多步流程。核心模式包括:编排器加子智能体(编排器需使用 system_prompt={"type": "preset", "preset": "claude_code"},通过 agents={} 注册智能体,allowed_tools 需含 "Task",智能体名称须完全匹配);系统提示词配置(预设、自定义、追加);工具限制;钩子(PreToolUse、PostToolUse 等);权限回调(can_use_tool)。

使用方式:可复制模板并定制:cp assets/sdk-template.py my-app.py,编辑后 chmod +x my-app.py 并运行 ./my-app.py。SDK 兼容 asyncio 与 anyio,官方示例偏好 anyio.run()。资源包含 references/ 深入文档与 examples/ 可运行示例,如 quick_start.py、basic-orchestrator.py、agents.py、hooks.py、streaming_mode.py、mcp_calculator.py、tool_permission_callback.py 等,以及 assets/sdk-validation-checklist.md 校验清单。

适用场景:创建新的 SDK 应用、构建多子智能体编排器、实现程序化智能体定义、配置钩子或权限回调、校验与审查 SDK 代码、从文件系统智能体发现迁移到程序化注册、调试 SDK 应用。

限制:不适用于 Claude Code 斜杠命令或技能、不经 SDK 的直接 API 使用、非 Python 实现(TypeScript SDK 模式不同)。钩子与自定义工具仅 ClaudeSDKClient 支持。常见反模式包括缺少编排器系统提示词、智能体名称不匹配、工具与提示词不一致。其他收费、价格、平台等信息暂未提供。