---
title: "OpenAI Agents SDK でカスタムの OpenAI 互換プロバイダーを使う | BroadRouter"
description: "Python 版 OpenAI Agents SDK を AsyncOpenAI と OpenAIChatCompletionsModel 経由で BroadNet Inference につなぎ、OpenAI のキーが必要なトレーシングをオフにする方法です。"
url: https://broadrouter.com/ja/guides/openai-agents-sdk-custom-provider/
lang: ja
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

このページは英語の原文を AI の支援を受けて翻訳したものです。[英語の原文を読む](https://broadrouter.com/guides/openai-agents-sdk-custom-provider/)（2026-11-16 更新）。

# OpenAI Agents SDK を BroadNet Inference で動かす

更新日 2026-11-16

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 以上が必要です。

```bash
pip install openai-agents
export BROADNET_API_KEY='your-broadnet-key'
```

2.  **クライアント、モデル、エージェントを作成します。**

```python
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())
```

3.  **実行します。** エージェントが `get_order_status` を呼び出し、その結果をもとに答えるはずです。

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

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

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

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

```python
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](https://broadrouter.com/ja/models/glm-5.3/) | ツールと構造化出力の記載あり。100 万トークンのコンテキスト |
| 画像入力とツール | [Qwen3.8 27B](https://broadrouter.com/ja/models/qwen3.8-27b/) | 262K コンテキスト。アラビア語でテスト済み |
| 定額で長時間動かすエージェント | [DeepSeek V4.1 Flash](https://broadrouter.com/ja/models/deepseek-v4.1-flash/) | 無制限プラン。BroadNet はツールを記載していない |

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

## トラブルシューティング

-   **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=...)` を設定しているなら、値を上げてください。[回答が空になる理由](https://broadrouter.com/ja/guides/reasoning-tokens-empty-response/)。
-   **429。** 従量課金のキーは毎分 30 リクエスト、同時 4 リクエストまでです。ツールの呼び出しが 1 往復するたびに新しいリクエストになります。[エラーとリトライ](https://broadrouter.com/ja/guides/errors-and-retries/)を参照してください。
-   **プランでエージェントを並列実行する場合。** [無制限プランのセッション](https://broadrouter.com/ja/guides/unlimited-llm-api-sessions/)は一度に 1 リクエストしか処理しません。`asyncio.gather` でまとめて起動するエージェントには、それぞれ 1 セッションが必要で、そうでなければ順番待ちになります。[定額で並列にコーディングエージェントを動かす](https://broadrouter.com/ja/blog/run-parallel-coding-agents-flat-rate/)も参照してください。

## このガイドの用語

[AI エージェント（AI agent）](https://broadrouter.com/ja/glossary/agent/)

AI エージェントとは、言語モデルが目標に向けて自分で手順を決めるシステムです。どのツールを呼ぶかを決め、結果を読み、最終回答を出すか上限に達するまで繰り返します。決まった箇所でモデルを呼ぶ固定のスクリプトは、ふつうワークフローと呼ばれます。

[Chat Completions API（チャット補完 API）](https://broadrouter.com/ja/glossary/chat-completions-api/)

Chat Completions API とは、OpenAI の HTTP エンドポイント POST /v1/chat/completions で、モデル名とロール付きメッセージのリストを受け取り、モデルの次のメッセージを返します。そのリクエストと応答の形は、OpenAI 互換のプロバイダーや SDK が使う共通形式になりました。

[OpenAI 互換 API（OpenAI-compatible API）](https://broadrouter.com/ja/glossary/openai-compatible-api/)

OpenAI 互換 API とは、POST /v1/chat/completions など OpenAI API と同じリクエスト形式とレスポンス形式を受け付ける HTTP API です。OpenAI の SDK やツールは、ベース URL、API キー、モデル名を変えるだけで利用できます。

[構造化出力（Structured Outputs）](https://broadrouter.com/ja/glossary/structured-output/)

構造化出力とは、モデルの回答を開発者が指定した形式（通常は JSON Schema）に制約し、コードで確実に解析できるようにする LLM API の機能です。有効な JSON であることだけを保証し、特定の形までは保証しない JSON モードより厳格です。

[従量課金（pay-as-you-go）](https://broadrouter.com/ja/glossary/pay-as-you-go/)

従量課金とは、使った分だけを支払う料金体系です。トークン、リクエスト、音声の分数などの単位で計測され、サブスクリプションや最低利用額はありません。多くの LLM API はこの方式で、前払いの残高か定期的な請求書から支払います。

[AI コーディングエージェント（AI coding agent）](https://broadrouter.com/ja/glossary/coding-agent/)

AI コーディングエージェントとは、言語モデルがループの中でコードベースに取り組むソフトウェアツールです。ファイルを読み、編集し、テストなどのコマンドを実行し、出力を読んで次の手順を決めることを、タスクが終わるか上限に達するまで繰り返します。

[API キー（API key）](https://broadrouter.com/ja/glossary/api-key/)

API キーとは、API を呼び出すクライアントを識別し、認可するための秘密の文字列です。LLM API では通常 Authorization: Bearer ヘッダーで送り、キーを持つ人は誰でも、そのキーの所有アカウントに課金されるリクエストを送れます。

[JSON Schema（JSON スキーマ）](https://broadrouter.com/ja/glossary/json-schema/)

JSON Schema とは、JSON データの構造（型、必須フィールド、許可される値、入れ子）を記述・検証するための、JSON で書かれた語彙です。現行バージョンは 2020-12 です。LLM API はツールのパラメーターや、構造化出力が従うべき正確な形の定義に使います。

## よくある質問

### カスタムのベース 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 セッションが必要です。

## 関連ガイド

-   [OpenAI Python SDK を BroadNet Inference で使う](https://broadrouter.com/ja/guides/openai-python-sdk/)
-   [エージェント向け無制限 LLM API プランのしくみ](https://broadrouter.com/ja/guides/unlimited-llm-api-sessions/)
-   [推論モデルが空の回答を返す理由](https://broadrouter.com/ja/guides/reasoning-tokens-empty-response/)
-   [LiteLLM から BroadNet Inference にルーティングする（SDK とプロキシ）](https://broadrouter.com/ja/guides/litellm-proxy-custom-provider/)
-   [BroadNet Inference で使えるすべてのツール（英語）](https://broadrouter.com/integrations/)：SDK、コーディングエージェント、チャット UI、自動化ツールと、それぞれの正確な設定

実際のワークロードで試してください。新規アカウントには US$5 の初回クレジットがあり、Gemma、文字起こし に使えます。DeepSeek、GLM、Qwen3.8 はチャージが必要です。

[始める](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ja-guides-openai-agents-sdk-custom-provider&utm_content=page-cta) ·

**出典**

-   [OpenAI Agents SDK ドキュメント、Models（OpenAI 以外のプロバイダー）（2026-11-14 確認）](https://openai.github.io/openai-agents-python/models/)
-   [PyPI の openai-agents パッケージ（0.24、Python 3.10 以上、2026-11-14 確認）](https://pypi.org/project/openai-agents/)
-   [BroadNet Inference API リファレンス（英語）](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ja-guides-openai-agents-sdk-custom-provider&utm_content=sources)
