如需查看完整的文档索引,请参阅 llms.txt。在文档页面的 URL 末尾加上 .md 即可查看该页面的 Markdown 版本。
主导航
主题

编排与交接

选择让专用智能体接管对话,还是让它在后台协助管理智能体。

当一项工作需要由不同的专用智能体分工负责时,可以采用多智能体工作流。设计工作流时,首先要确定每个分支由哪个智能体负责向用户给出最终答复。

选择编排模式

模式 适用场景 执行结果
交接 某个分支需要由专用智能体接管对话 控制权转移给专用智能体
将智能体用作工具 管理智能体需要掌控流程,并调用专用智能体来完成范围明确的任务 管理智能体继续负责回复

通过交接移交回复职责

如果专用智能体需要直接负责下一条回复,而不仅仅是在后台提供协助,交接就是最合适的模式。

通过交接委派任务
import { Agent, handoff } from "@openai/agents";

const billingAgent = new Agent({ name: "Billing agent" });
const refundAgent = new Agent({ name: "Refund agent" });

const triageAgent = Agent.create({
  name: "Triage agent",
  handoffs: [billingAgent, handoff(refundAgent)],
});

要让路由逻辑清晰易懂,请遵循以下原则:

  • 为每个专用智能体分配一项范围明确的任务。
  • 用简短、具体的文字填写 handoffDescription。
  • 只有当后续分支确实需要不同的指令、工具或策略时,才拆分流程。

在更复杂的场景中,交接时还可以传递结构化元数据或经过筛选的对话历史。不同编程语言的接入方式有所不同,具体 API 请参阅 SDK 文档。

在管理智能体主导的工作流中将智能体用作工具

如果主智能体需要负责最终答复,并调用专用智能体提供协助,请使用 agent.asTool()。

将专用智能体作为工具调用
import { Agent } from "@openai/agents";

const summarizer = new Agent({
  name: "Summarizer",
  instructions: "Generate a concise summary of the supplied text.",
});

const mainAgent = new Agent({
  name: "Research assistant",
  tools: [
    summarizer.asTool({
      toolName: "summarize_text",
      toolDescription: "Generate a concise summary of the supplied text.",
    }),
  ],
});

在以下情况下,这种模式通常更合适:

  • 管理智能体需要综合各方结果,给出最终答复。
  • 专用智能体执行的是范围明确的任务,例如摘要或分类。
  • 您希望保持外层工作流稳定,在其中嵌套调用专用智能体,无需移交控制权。

仅在职责约定发生变化时添加专用智能体

尽可能从一个智能体开始。只有当专用智能体能在以下任一方面带来明显改善时,才添加专用智能体:更好地隔离能力或策略,让提示词更清晰,或让执行轨迹更易读。

过早拆分会增加提示词、执行轨迹和需要审批的环节,却未必能改善工作流。

后续步骤

确定由哪个智能体负责回复后,请根据您接下来要解决的运行时或状态问题,继续阅读相应指南。