SDK 每次執行時,都會決定要使用的模型和傳輸方式。大多數應用程式只需要簡單的設定:明確指定模型,預設採用 OpenAI 的標準連線方式,只有在工作流程確實需要時才覆寫供應商或傳輸設定。
先明確指定模型
在正式環境中,建議明確指定模型,避免依賴目前 SDK 版本內建的執行階段預設值。
- 如果某個專責智慧體一向有不同的品質、延遲或成本需求,請為該智慧體設定
model。 - 如果某個工作流程需要一次覆寫多個智慧體的模型設定,請設定該次執行的預設模型。
- 設定
OPENAI_DEFAULT_MODEL,即可為整個程序中未指定model的智慧體提供備用模型。
為個別智慧體和每次執行指定模型
TypeScript
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 文件。
如果模型設定取決於某個專責智慧體的職責,請將設定放在該智慧體的定義附近。只有在多個智慧體執行時需要共用相同設定的情況下,才將其設為工作流程的預設值。
後續步驟
確定智慧體的執行方式後,請依工作流程的其他設計需求,繼續閱讀相應的指南。