模型与提供方

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

从显式模型选择开始

在生产环境中，更倾向于显式选择模型，而不是使用您的 SDK 版本恰好附带的运行时默认值。

• 设置 model 在某个智能体上[设置]，当该专职智能体持续需要不同的质量、延迟或成本配置时。
• 当某个工作流需要一次性覆盖多个智能体时，设置运行级别的默认值。
• 设置 OPENAI_DEFAULT_MODEL 当您想要为省略[模型配置]的智能体提供进程范围的回退方案时 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 的实时音频会话适用于低延迟的语音或图像交互。请使用 语音智能体 and the 实时音频 API 指南 for that path.

具体的提供商配置、提供商生命周期管理以及传输辅助 API 仍属于特定语言的内容。请将这些细节保留在 SDK 文档中，而不是在此处重复。

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

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

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

当模型契约是该专职智能体固有的组成部分时，请将其保持在靠近智能体定义的位置。仅当一组智能体应共享相同的运行时选择时，才将其移至工作流级别的默认值。

后续步骤

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