BroadRouter

OpenAI Agents SDK を BroadNet Inference で動かす

更新日

base_url を https://inference.broadnet.ai/v1、キーを BroadNet のキーにして AsyncOpenAI クライアントを作り、broadnet/glm-5.3 などのモデル ID とともに OpenAIChatCompletionsModel でラップして Agent に渡します。トレーシング用に別の OpenAI キーがない場合は、set_tracing_disabled(True) を呼んでください。

OpenAI Agents SDK は、ツール、ハンドオフ、ガードレールを備えたエージェントを作るための Python フレームワークです。ドキュメントには OpenAI 以外のプロバイダーをつなぐ方法も書かれています。BroadNet Inference のような OpenAI 互換 API の場合は、自分で作った AsyncOpenAI クライアントを SDK に渡し、Chat Completions のモデルクラスを使います。SDK のデフォルトは Responses API ですが、多くのプロバイダーはこれを提供していません。

セットアップ

  1. SDK をインストールします。 Python 3.10 以上が必要です。
pip install openai-agents
export BROADNET_API_KEY='your-broadnet-key'
  1. クライアント、モデル、エージェントを作成します。
import asyncio
import os

from agents import (
    Agent,
    AsyncOpenAI,
    OpenAIChatCompletionsModel,
    Runner,
    function_tool,
    set_tracing_disabled,
)

set_tracing_disabled(disabled=True)  # tracing needs a platform.openai.com key

client = AsyncOpenAI(
    base_url="https://inference.broadnet.ai/v1",
    api_key=os.environ["BROADNET_API_KEY"],
)

model = OpenAIChatCompletionsModel(model="broadnet/glm-5.3", openai_client=client)


@function_tool
def get_order_status(order_id: str) -> str:
    """Look up an order."""
    return f"Order {order_id}: shipped"


agent = Agent(
    name="Support agent",
    instructions="Answer briefly. Use tools when you need order data.",
    model=model,
    tools=[get_order_status],
)


async def main():
    result = await Runner.run(agent, "Where is order 4471?")
    print(result.final_output)


asyncio.run(main())
  1. 実行します。 エージェントが get_order_status を呼び出し、その結果をもとに答えるはずです。

プロバイダーをつなぐ 3 つの方法

SDK のドキュメントには、次の組み込みの方法が載っています。

  • エージェントごと: 上の例のように、OpenAIChatCompletionsModel を Agent.model として渡します。エージェントごとに別のプロバイダーを使う場合に向いています。
  • グローバルのデフォルト: set_default_openai_client(client) で自分のクライアントをデフォルトにします。set_default_openai_api("chat_completions") と組み合わせてください。
  • 実行ごと: RunConfig(model_provider=...) にカスタムの ModelProvider を渡します。

グローバルのデフォルトは次のようになります。

import os
from agents import (
    Agent,
    AsyncOpenAI,
    set_default_openai_api,
    set_default_openai_client,
    set_tracing_disabled,
)

client = AsyncOpenAI(base_url="https://inference.broadnet.ai/v1", api_key=os.environ["BROADNET_API_KEY"])
set_default_openai_client(client, use_for_tracing=False)
set_default_openai_api("chat_completions")
set_tracing_disabled(True)

agent = Agent(name="Assistant", instructions="Be brief.", model="broadnet/glm-5.3")

環境変数だけで設定する場合は、OPENAI_BASE_URL=https://inference.broadnet.ai/v1 とし、OPENAI_API_KEY に BroadNet のキーを設定したうえで、同じように set_default_openai_api と set_tracing_disabled を呼びます。

SDK のドキュメントによると、Chat Completions 経由にすると、previous_response_id、conversation_id、prompt のような Responses 専用のフィールドは黙って無視されます。エラーにしたい場合は、OpenAIProvider で strict_feature_validation=True を設定してください。会話の状態は自分のコードで管理します。たとえば、前回の結果の入力リストを次の実行に渡します。Web 検索やファイル検索のような OpenAI のホスト型ツールは、ほかのプロバイダーにはありません。エージェントに呼ばせたい処理はすべて function_tool で用意してください。

トレーシング

トレーシングはデフォルトで有効で、トレースを OpenAI に送信します。SDK のドキュメントでは、platform.openai.com の API キーがない場合は set_tracing_disabled() で無効にするか、別のトレーシングプロセッサーを設定するよう書かれています。OpenAI のキーがあるなら、トレーシングを有効にしたまま、そのキーを set_tracing_export_api_key(...) で渡せます。SDK はこのキーをトレースのアップロードにだけ使います。BroadNet のキーはここでは使えません。

どのモデルを選ぶか

エージェントの種類 モデル 備考
ツールを使うエージェント GLM 5.3 ツールと構造化出力の記載あり。100 万トークンのコンテキスト
画像入力とツール Qwen3.8 27B 262K コンテキスト。アラビア語でテスト済み
定額で長時間動かすエージェント DeepSeek V4.1 Flash 無制限プラン。BroadNet はツールを記載していない

SDK のドキュメントは、JSON スキーマによる構造化出力に対応していないプロバイダーもあると注意しています。エージェントに output_type を設定するなら、GLM 5.3 か Qwen3.8 27B を使ってください。料金は料金ページで比較できます。

トラブルシューティング

  • 401。 BroadNet のキーが間違っている、期限切れ、または従量課金の利用枠を使い切っています。ログに出るトレーシングのエラーは別の問題で、OpenAI のキーがないままトレーシングが有効になっていることを示しています。
  • 404 または「not found」。 おそらく Responses API を使っています。OpenAIChatCompletionsModel か set_default_openai_api("chat_completions") を使ってください。設定済みなら、モデル ID が BroadNet のものと完全に一致しているか確認します。有料モデルにはチャージが必要です。$5 のクレジットで使えるのは Gemma 4 VL 26B と 2 つの Transcribe モデルです。
  • final_output が空。 推論(reasoning)は max_tokens に含まれます。ModelSettings(max_tokens=...) を設定しているなら、値を上げてください。回答が空になる理由。
  • 429。 従量課金のキーは毎分 30 リクエスト、同時 4 リクエストまでです。ツールの呼び出しが 1 往復するたびに新しいリクエストになります。エラーとリトライを参照してください。
  • プランでエージェントを並列実行する場合。 無制限プランのセッションは一度に 1 リクエストしか処理しません。asyncio.gather でまとめて起動するエージェントには、それぞれ 1 セッションが必要で、そうでなければ順番待ちになります。定額で並列にコーディングエージェントを動かすも参照してください。

よくある質問

カスタムのベース URL を使うと、Agents SDK で 404 エラーになるのはなぜですか?

SDK はデフォルトで Responses API を使いますが、BroadNet が提供しているのはチャット補完です。OpenAIChatCompletionsModel を使うか、環境変数でクライアントを設定している場合は set_default_openai_api("chat_completions") を呼んでください。

Agents SDK がトレーシングについてエラーを出すのはなぜですか?

トレーシングは OpenAI にアップロードされるため、platform.openai.com のキーが必要です。SDK のドキュメントでは、キーがない場合は set_tracing_disabled() を使うか、別のトレーシングプロセッサーを使うよう勧めています。

環境変数だけで Agents SDK を設定できますか?

できます。OPENAI_BASE_URL を https://inference.broadnet.ai/v1、OPENAI_API_KEY を BroadNet のキーに設定し、set_default_openai_api("chat_completions") と set_tracing_disabled(True) を呼びます。モデルを指定しないエージェントのモデルは OPENAI_DEFAULT_MODEL で設定します。

マルチエージェントの実行には、プランのセッションがいくつ必要ですか?

同時に実行されるリクエスト 1 つにつき 1 セッションです。ハンドオフはエージェントを 1 つずつ順に実行するので、1 セッションで足ります。asyncio.gather で並列に動かすエージェントには、それぞれ 1 セッションが必要です。

Markdown で読むChatGPT に聞くClaude に聞くPerplexity に聞く