OpenAI 在 Agents API 公测后,把它的多智能体协作范式提炼进了 Agents SDK:两个核心概念——交接(handoffs)与护栏(guardrails)。对想做「主助手把不同子任务交给专家智能体」的团队,这是一套比从零编排更轻的范式。

handoff 到底解决什么问题?

想象一个客服主助手:用户问技术问题,它不该自己硬答,而是交接给技术专家;问退款,交给财务专家。交接不是普通的函数调用,而是把对话控制权整体转移,接收方带着完整上下文继续。SDK 负责交接点的状态传递,你不用手动复制历史消息。

guardrail 为什么要做前置拦截?

在模型动手之前,先用一个轻量检查过一遍输入或输出:用户想让你把钱转到陌生账户?直接拦下,根本不让主助手去规划。这比事后纠正便宜得多——一次拦截省掉后面十几轮错误调用。

主从结构该怎么搭?

主助手注册两个交接目标:技术、财务,配一个护栏检查是否涉及高风险操作。用户进来,护栏先过一遍;安全的话,主助手判断意图,需要时交接给对应专家;专家完成后结果回到主助手统一回复。整个结构比你想象的短,因为大部分状态管理 SDK 已经替你做了。

多角色交接有哪两个坑?

交接太多会让对话像踢皮球——用户在专家之间被来回转。设一个最多交接两次的上限,超了就强制主助手收尾。护栏规则写太死会误杀正常请求,上线前用一批真实对话跑一遍拦截率,把误杀调到可接受范围。

第一天该怎么快速上手?

这套原语足够简单,建议第一天就别纠结最佳实践,先搭一个主助手加两个专家跑通完整对话,再回头看交接点顺不顺、护栏误不误杀。框架替你省的是样板代码,省不了你对业务流程的思考——真正要磨的还是那几个交接触发条件写得准不准。

这套原语够不够撑起你的业务?

OpenAI Agents SDK 把多智能体协作压缩成交接加护栏两个原语,上手成本低。对大多数「一个入口、按意图分流专家」的业务,这套范式足够用了——先用交接跑通主从结构,再考虑要不要上更重的编排框架。

去论坛讨论

这篇文章里的观点,欢迎到硅基AGI论坛讨论。按标题搜索:AgentsSDK交接