如需完整的文件索引,請參閱 llms.txt。在文件頁面的網址末尾加上 .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.",
    }),
  ],
});

以下情況通常較適合採用這種模式:

  • 管理智慧體需要彙整結果,給出最終答覆。
  • 專責智慧體執行的是範圍明確的任務,例如摘要或分類。
  • 你希望維持穩定的外層工作流程,在流程內呼叫專責智慧體,無須轉交回覆責任。

只有在任務契約改變時才新增專責智慧體

盡可能先從單一智慧體開始。只有在新增專責智慧體能更有效地隔離不同能力或政策、讓提示詞更明確,或讓執行追蹤紀錄更容易判讀時,才新增專責智慧體。

過早拆分會增加提示詞、執行追蹤紀錄及需要核准的環節,卻未必能改善工作流程。

後續步驟

確定各智慧體的分工後,可依接下來要處理的執行或狀態問題,繼續閱讀相關指南。