Agents SDK 系统构建

从单代理开始

Agents SDK 提供构建代理应用的编排原语。先用一个职责明确的 agent 和少量工具解决问题，只有当角色、权限或上下文真正不同才拆成多个 agent。

工具 schema、instructions 和输出类型共同构成代理契约。每个 agent 应有明确成功条件和不能执行的动作。

• agent 只拥有完成职责所需的工具。
• handoff 传递必要上下文和责任。
• guardrails 验证输入输出和高风险动作。
• tracing 记录运行轨迹并支持调试。
• 人工批准位于不可逆操作之前。

编排与治理

多代理系统需要防止循环 handoff、上下文膨胀和责任不清。为运行设置最大步数、超时和预算，并为失败定义终止状态。

用评测检查路由是否正确、工具是否被滥用、最终结果是否满足业务标准。生产中观察的是整条轨迹，不只是最后一句话。