OpenAI Agents SDK 模型与提供商

每次SDK运行最终都要确定模型与传输方式。多数应用应保持配置简单：明确选择模型，默认使用标准OpenAI路径，确有需要时再覆盖提供商或传输配置。

明确选择模型

生产环境优先显式指定模型，不依赖所安装SDK版本恰好提供的运行时默认值。

• 某个专项智能体持续需要不同质量、延迟或成本特征时，在该智能体上设置model。
• 一个工作流要同时覆盖多个智能体时，设置运行级默认模型。
• 希望为未提供model的智能体设置进程级后备值时，使用OPENAI_DEFAULT_MODEL。

下面分别设置智能体模型与运行级模型：

来源示例 1（javascript）：

// [中文] 示例1：明确选择模型。
// [中文] 展示智能体级model和运行级模型配置；快速支持指令处理常规问题，通用支持指令要求认真处理。
// [中文] 两个输入分别是“总结工单123”和“调查账户456的账单问题”；保留来源调用差异，运行级与智能体级优先级需按所用SDK版本核对。
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);

来源示例 2（python）：

## [中文] 示例2：明确选择模型。
## [中文] 展示智能体级model和运行级模型配置；快速支持指令处理常规问题，通用支持指令要求认真处理。
## [中文] 两个输入分别是“总结工单123”和“调查账户456的账单问题”；保留来源调用差异，运行级与智能体级优先级需按所用SDK版本核对。
import asyncio

from agents import Agent, RunConfig, Runner

fast_agent = Agent(
    name="Fast support agent",
    instructions="Handle routine support questions.",
    model="gpt-5.6-terra",
)

general_agent = Agent(
    name="General support agent",
    instructions="Handle support questions carefully.",
)


async def main() -> None:
    await Runner.run(fast_agent, "Summarize ticket 123.")

    result = await Runner.run(
        general_agent,
        "Investigate the billing issue on account 456.",
        run_config=RunConfig(model="gpt-6-astra"),
    )
    print(result.final_output)


if __name__ == "__main__":
    asyncio.run(main())

多数新的SDK工作流可从gpt-6-astra开始；延迟或成本足以支持取舍时，再换用较小型号。当前模型选择建议见平台模型指南。

选择最简单的默认策略

团队若关心确切默认值，应自行设置，不依赖SDK的后备选择。

提供商与传输方式

应区分两点：Responses WebSocket传输仍采用普通文本与工具的智能体循环，与语音会话路径分开。通过WebRTC或WebSocket进行的实时音频会话则面向低延迟语音或图像交互，见语音智能体和实时音频API指南。

提供商的具体配置、生命周期管理及传输辅助API因语言而异，详细内容保留在对应SDK文档中。

模型设置、提示词和功能支持

模型选择只是运行时约定的一部分：

• TypeScript的modelSettings、Python的model_settings用于推理强度、详细程度和工具行为等调整。
• prompt用于让已保存提示词配置控制运行，无需把完整系统提示词嵌入代码。
• 一些SDK功能依赖OpenAI Responses路径，而非较旧兼容接口；高级工具加载或传输功能应核对SDK文档。

某项模型约定属于专项智能体固有职责时，放在智能体定义附近；多个智能体需要共享运行时选择时，才移到工作流级默认值。

后续步骤

运行时约定明确后，可阅读：

• 智能体定义：让模型选择与职责一致。
• 运行智能体：传输及模型选择如何影响循环。
• 外部模型：混合模型架构的更多提供商选项。