モデルとプロバイダー

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
24import { 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);

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
29import 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 のフォールバックに頼らず、明示的に設定してください。

プロバイダーとトランスポート

接続方法を選ぶ際は、次の 2 点を区別してください。

• Responses WebSocket トランスポートでも、テキストとツールを扱う通常のエージェントループを使います。音声セッションとは別の接続方法です。
• WebRTC または WebSocket 経由のライブ音声セッションは、音声や画像を使って低レイテンシでやり取りするためのものです。この接続方法については、音声エージェントとライブ音声 API ガイドを参照してください。

プロバイダーの具体的な設定方法、ライフサイクル管理、トランスポート用のヘルパー API は言語によって異なります。詳細は各言語の SDK ドキュメントを参照してください。

モデル設定、プロンプト、対応機能

モデルの選択は、エージェントの実行時の動作を決める設定の一部です。

• 推論強度、応答の詳しさ、ツールの動作などを調整するには、modelSettings を使います。
• システムプロンプト全体をコードに埋め込む代わりに、保存済みのプロンプト設定で実行を制御するには、prompt を使います。
• SDK の一部の機能は OpenAI Responses 経由の接続を前提としており、旧来の互換インターフェースでは利用できません。ツールの読み込みやトランスポートの高度な機能が必要な場合は、SDK ドキュメントを確認してください。

モデルの設定が専門エージェントの役割に固有であれば、そのエージェントの定義と一緒に記述します。複数のエージェントで同じ実行時設定を共有する場合に限り、ワークフロー単位のデフォルトに移します。

次のステップ

実行時の設定が決まったら、ワークフローの設計で次に検討する内容に合ったガイドに進んでください。