如需查看完整的文档索引,请参阅 llms.txt。在文档页面的 URL 末尾加上 .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-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 文档。

如果某个专用智能体的职责决定了它需要怎样的模型配置,请将配置写在该智能体的定义附近。仅当一组智能体需要共用相同的运行时配置时,才将其设为工作流级默认值。

后续步骤

确定智能体的运行时配置后,请根据工作流的其他设计需求继续阅读相应指南。