模型与服务商

每一次 SDK 运行最终都会确定一个模型和一种传输方式。大多数应用应保持简单的设置：显式选择模型，默认使用标准的 OpenAI 路径，仅在工作流确实需要时才使用提供商或传输覆盖项。

从显式模型选择开始

在生产环境中，优先选择显式模型，而不是依赖 SDK 版本自带的运行时默认值。

• 当某个专家（specialist）需要不同的质量、延迟或成本配置时，请在智能体上设置 model。
• 当一个工作流需要同时覆盖多个智能体时，请设置运行级别的默认值。
• 如果您希望为省略了 model 参数的智能体提供进程级别的回退方案，请设置 OPENAI_DEFAULT_MODEL。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
import { Agent, Runner } from "@openai/agents";

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

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

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

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

console.log(result.finalOutput);

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
import asyncio

from agents import Agent, RunConfig, Runner

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

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-5.5"),
    )
    print(result.final_output)


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

对于大多数新的 SDK 工作流，请从 gpt-5.5 开始；仅在延迟或成本至关重要时才考虑使用较小的模型版本。请使用全平台适用的使用 GPT-5.5 指南来获取当前的模型选择建议。

选择最简单的默认策略

如果您的团队非常在意确切的默认值，请不要依赖 SDK 的回退机制，请自行设置。

提供商与传输

两个区别非常重要

• Responses WebSocket 传输仍使用常规的文本与工具智能体循环，它与语音会话路径是分开的。
• 基于 WebRTC 或 WebSocket 的实时音频会话适用于低延迟语音或图像交互。请使用语音智能体和实时音频 API 指南来实现该路径。

确切的提供商配置、提供商生命周期管理以及传输辅助 API 仍为特定语言内容。请在 SDK 文档中查看这些细节，此处不再重复。

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

模型选择只是运行时契约的一部分。

• 不如说modelSettings用于调整推理工作量（reasoning effort）、冗长程度及工具行为。
• 当您希望使用存储的提示词配置来控制运行，而不是在代码中嵌入完整的系统提示词时，请使用 prompt。
• 某些 SDK 功能依赖于 OpenAI Responses 路径，而非旧版的兼容接口。因此，当您需要高级工具加载或传输功能时，请查阅 SDK 文档。

当模型契约对特定专家来说是内在属性时，请将其定义在智能体定义附近。仅当一组智能体需要共享相同的运行时选择时，才将其移动到工作流级别的默认值。

后续步骤

一旦运行时契约明确，请继续查阅与您工作流设计其余部分相匹配的指南。