如需完整的文件索引,請參閱 llms.txt。在文件頁面的網址末尾加上 .md ,即可取得該頁面的 Markdown 版本。
主要導覽
主題

模型與供應商

為透過 SDK 執行的智慧體選擇模型、預設值與傳輸策略。

SDK 每次執行時,都會決定要使用的模型和傳輸方式。大多數應用程式只需要簡單的設定:明確指定模型,預設採用 OpenAI 的標準連線方式,只有在工作流程確實需要時才覆寫供應商或傳輸設定。

先明確指定模型

在正式環境中,建議明確指定模型,避免依賴目前 SDK 版本內建的執行階段預設值。

  • 如果某個專責智慧體一向有不同的品質、延遲或成本需求,請為該智慧體設定 model。
  • 如果某個工作流程需要一次覆寫多個智慧體的模型設定,請設定該次執行的預設模型。
  • 設定 OPENAI_DEFAULT_MODEL,即可為整個程序中未指定 model 的智慧體提供備用模型。
為個別智慧體和每次執行指定模型
import { Agent, Runner } from "@openai/agents";

const fastAgent = new Agent({
  name: "Fast support agent",
  instructions: "Handle routine support questions.",
  model: "gpt-5.6-terra",
});

const generalAgent = new Agent({
  name: "General support agent",
  instructions: "Handle support questions carefully.",
});

const runner = new Runner({
  model: "gpt-6-astra",
});

await runner.run(fastAgent, "Summarize ticket 123.");
const result = await runner.run(
  generalAgent,
  "Investigate the billing issue on account 456."
);

console.log(result.finalOutput);

建立新的 SDK 工作流程時,大多數情況下建議先使用 gpt-6-astra,只有在確實需要降低延遲或成本時,才改用較小的模型版本。如需最新的模型選用建議,請參閱適用於整個平台的模型選用指南。

選擇最簡單的預設策略

需求 建議做法 原因
為每個專責智慧體明確指定模型 在每個智慧體上設定 model 從程式碼和追蹤記錄都能清楚看出工作流程如何運作
讓整個程序共用一個備用模型 OPENAI_DEFAULT_MODEL 即使智慧體省略 model,仍能確定它會使用哪個模型
為整個工作流程統一覆寫模型設定 設定該次執行的預設模型 可以為指令碼、背景工作程序或環境更換模型,無須逐一修改智慧體
在同一個工作流程中使用不同大小的模型 為不同智慧體指定不同模型 可以搭配使用快速分流的智慧體,以及速度較慢、負責深入分析的專責智慧體

如果團隊需要確切掌握預設使用的模型,請自行指定,不要依賴 SDK 的備用設定。

供應商與傳輸方式

需求 建議做法
透過 SDK 在 OpenAI 上執行一般智慧體工作流程 採用 SDK 預設的 OpenAI 供應商連線方式
透過通訊端反覆傳送 Responses 模型請求並接收回應 使用 SDK 的 Responses WebSocket 傳輸方式
使用非 OpenAI 模型或整合多家供應商 參閱所用程式語言的 SDK 文件,瞭解供應商或轉接器介面

請區分以下兩種情況:

  • Responses WebSocket 傳輸仍使用標準的智慧體執行迴圈來處理文字及呼叫工具。語音工作階段使用的是另一套流程。
  • 透過 WebRTC 或 WebSocket 建立的即時音訊工作階段,適用於低延遲的語音或影像互動。相關做法請參閱語音智慧體和即時音訊 API 指南。

供應商的具體設定方式、供應商生命週期管理,以及傳輸輔助 API 都因程式語言而異。這些細節請參閱各語言的 SDK 文件,此處不再重述。

模型設定、提示詞與功能支援

選擇模型只是決定智慧體執行方式的一部分。

  • 使用 modelSettings 調整推理強度、回應詳略程度和工具行為等設定。
  • 如果希望由已儲存的提示詞設定控制執行流程,請使用 prompt,這樣就無須將完整的系統提示詞嵌入程式碼。
  • 部分 SDK 功能依賴 OpenAI Responses 介面,較舊的相容介面無法提供這些功能。因此,需要進階工具載入或傳輸功能時,請查閱 SDK 文件。

如果模型設定取決於某個專責智慧體的職責,請將設定放在該智慧體的定義附近。只有在多個智慧體執行時需要共用相同設定的情況下,才將其設為工作流程的預設值。

後續步驟

確定智慧體的執行方式後,請依工作流程的其他設計需求,繼續閱讀相應的指南。