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-6.1-terra",
});
const generalAgent = new Agent({
name: "General support agent",
instructions: "Handle support questions carefully.",
});
const runner = new Runner({
model: "gpt-6.2-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.2-astra,仅在确有必要降低延迟或成本时再换用较小的版本。有关整个平台的最新模型选择建议,请参阅模型选择指南。
选择最简单的默认模型策略
| 需求 | 建议做法 | 原因 |
|---|---|---|
| 为每个专用智能体明确指定一个模型 | 为每个智能体设置 model |
查看代码或追踪记录时,都能清楚了解工作流使用了哪些模型 |
| 为整个进程指定一个后备模型 | OPENAI_DEFAULT_MODEL |
即使智能体省略了 model,也能明确知道它会使用哪个模型 |
| 在单个工作流中统一覆盖模型设置 | 设置运行级默认模型 | 您可以为脚本、工作进程或环境更换模型,无需逐个修改智能体 |
| 在同一工作流中使用不同规模的模型 | 为不同智能体分别选用合适的模型 | 同一工作流可以同时使用快速分流的智能体和速度较慢、负责深入分析的专用智能体 |
如果您的团队需要确定默认使用哪个模型,请自行设置,不要依赖 SDK 的后备模型。
提供商与传输方式
| 需求 | 建议做法 |
|---|---|
| 使用 OpenAI 模型执行标准的 SDK 运行 | 使用默认的 OpenAI 提供商接入方式 |
| 通过套接字与 Responses 模型进行多轮请求和响应 | 使用 SDK 中的 Responses WebSocket 传输方式 |
| 使用非 OpenAI 模型或集成多个提供商 | 参阅相应语言的 SDK 文档,了解提供商或适配器接口 |
请区分以下两种用法:
- Responses WebSocket 传输方式仍使用常规的智能体运行循环来处理文本和调用工具。语音会话使用单独的运行流程。
- 基于 WebRTC 或 WebSocket 的实时音频会话适用于低延迟的语音或图像交互。有关这种用法,请参阅语音智能体和实时音频 API 指南。
提供商的具体配置、生命周期管理方式以及用于传输的辅助 API 因语言而异。这些细节请查阅相应语言的 SDK 文档,此处不再重复。
模型设置、提示词与功能支持
选择模型只是确定智能体运行方式的一部分。
- 使用
调整推理力度、输出详细程度和工具行为等设置。modelSettings - 如果您希望通过已保存的提示词配置控制运行过程,请使用
prompt,无需将完整的系统提示词嵌入代码。 - 某些 SDK 功能依赖 OpenAI Responses 接口,较早的兼容接口无法提供这些功能。如果您需要高级工具加载或传输功能,请查阅 SDK 文档。
如果某个专用智能体的职责决定了它需要怎样的模型配置,请将配置写在该智能体的定义附近。仅当一组智能体需要共用相同的运行时配置时,才将其设为工作流级默认值。
后续步骤
确定智能体的运行时配置后,请根据工作流的其他设计需求继续阅读相应指南。