OpenAI Agents SDK は、ツール、ハンドオフ、ガードレールを備えたエージェントを作るための Python フレームワークです。ドキュメントには OpenAI 以外のプロバイダーをつなぐ方法も書かれています。BroadNet Inference のような OpenAI 互換 API の場合は、自分で作った AsyncOpenAI クライアントを SDK に渡し、Chat Completions のモデルクラスを使います。SDK のデフォルトは Responses API ですが、多くのプロバイダーはこれを提供していません。
セットアップ
- SDK をインストールします。 Python 3.10 以上が必要です。
pip install openai-agents
export BROADNET_API_KEY='your-broadnet-key'
- クライアント、モデル、エージェントを作成します。
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())
- 実行します。 エージェントが
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 セッションが必要で、そうでなければ順番待ちになります。定額で並列にコーディングエージェントを動かすも参照してください。
