> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/ja/build/ai-gateway.md).

# AI Gateway

AI Gateway で組織独自のモデルプロバイダーを接続し、モデルカタログとフォールバックモデルグループを管理して、Gateway のトラフィックと異常を確認します。

AI Gateway は、組織がモデルへのアクセスを一元管理する場所です。組織独自のプロバイダー認証情報（OpenAI、Amazon Bedrock など）や、セルフホストの OpenAI 互換エンドポイントを接続して「カスタムモデル」を作成し、「フォールバックモデルグループ」でメインモデルの失敗時に順番に切り替えるモデルを設定します。接続したモデルは、AI アシスタント、MaiGPT、または OpenAI 互換 API で連携するプログラムから利用できます。このページでは、モデルガバナンスを担当する組織管理者と IT 担当者向けに、管理画面の設定方法を説明します。プログラムからの連携については、技術ガイドの [AI Gateway：OpenAI 互換 API 連携](https://docs.maiagent.ai/tech/ai-gateway/ai-gateway-openai-compatible)をご覧ください。

{% hint style="info" %}
AI Gateway は、組織で有効化されてから利用できます（エンタープライズ版の機能で、現在は Beta です）。有効化されていない場合、左側メニューに AI Gateway は表示されず、<mark style="color:blue;">組織の概要</mark>の「高度な機能」セクションではグレー表示になります。有効化をご希望の場合は、営業担当者にお問い合わせください（[高度な機能](/maiagent-user-guide/ja/org/organization-overview.md#advanced-features)を参照）。
{% endhint %}

## 利用できるユーザー <a href="#permissions" id="permissions"></a>

| 操作                                                         | 必要な権限                                                                                                                                                                                                        |
| ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 左側メニューの AI Gateway を表示し、各タブの内容を閲覧する                        | ロール権限の<mark style="color:blue;">AI Gateway 権限</mark>（組織オーナーはデフォルトで保有します。ほかのロールで有効化する方法は、[指定したロールで AI Gateway を利用する](/maiagent-user-guide/ja/org/roles/role-permission.md#enable-ai-gateway-for-role)をご覧ください） |
| プロバイダー認証情報、カスタムモデル、フォールバックモデルグループの追加・編集・テスト・削除             | 組織オーナー                                                                                                                                                                                                       |
| マネージドモデルの<mark style="color:blue;">組織で利用可能</mark>スイッチの切り替え | 組織オーナー（[モデルアクセス権限](/maiagent-user-guide/ja/org/model-access.md)ページと同じ設定です）                                                                                                                                   |
| Gateway 呼び出し用 API Key の作成                                  | <mark style="color:blue;">API Key 管理権限</mark>                                                                                                                                                                |

組織オーナー以外のメンバーは各タブを閲覧できますが、追加、変更、削除、テストはシステムによって拒否されます。<mark style="color:blue;">Provider を追加</mark>、<mark style="color:blue;">モデルを追加</mark>、<mark style="color:blue;">フォールバックモデルグループを追加</mark>などのボタンは無効になり、マウスを合わせると「プロバイダー認証情報を管理できるのは組織オーナーのみです」「カスタムモデルを管理できるのは組織オーナーのみです」「フォールバックルールを管理できるのは組織オーナーのみです」と表示されます。

## アクセス方法 <a href="#how-to-enter" id="how-to-enter"></a>

左側メニューの<mark style="color:blue;">AI Gateway</mark>をクリックすると、デフォルトで<mark style="color:blue;">概要</mark>が開きます。次の 5 つのタブがあります。

| タブ                                              | 用途                                      |
| ----------------------------------------------- | --------------------------------------- |
| <mark style="color:blue;">概要</mark>             | Gateway のトラフィック、費用、レイテンシ、対応が必要な異常を確認します |
| <mark style="color:blue;">モデルプロバイダー</mark>      | 組織独自のプロバイダー認証情報を管理します                   |
| <mark style="color:blue;">モデル</mark>            | マネージドモデルとカスタムモデルのカタログです                 |
| <mark style="color:blue;">フォールバックモデルグループ</mark> | メインモデルが失敗したときに順番に切り替えるフォールバックチェーンです     |
| <mark style="color:blue;">連携例</mark>            | OpenAI 互換 API を呼び出すコード例です               |

組織にプロバイダーがまだ登録されていない場合、<mark style="color:blue;">概要</mark>に「AI Gateway へようこそ」と 3 つの手順が表示されます。<mark style="color:blue;">プロバイダーを追加</mark> → <mark style="color:blue;">モデルカタログ</mark>で利用するモデルを有効化 → <mark style="color:blue;">API Key を追加</mark>の順に進めます。最初の手順を完了すると、概要がリアルタイムのヘルスダッシュボードに変わります。

## 概要 <a href="#overview" id="overview"></a>

概要では、OpenAI 互換 API の呼び出しと、カスタムモデルを使用する AI アシスタントの会話を含む、組織の Gateway トラフィックを集計します。右上で<mark style="color:blue;">直近 1 時間</mark>、<mark style="color:blue;">直近 24 時間</mark>、<mark style="color:blue;">直近 7 日間</mark>、<mark style="color:blue;">直近 30 日間</mark>を選ぶか、日付ピッカーで開始・終了時刻を指定できます（カスタム期間は最長 92 日間です）。

| セクション                                                                          | 内容                                                                                                                                                                                                                                                                                                                                                                                                   |
| ------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ステータス概要                                                                        | 「すべて正常・対応待ち項目なし」または「N 件の注意／対応が必要」と表示します。右側には<mark style="color:blue;">アクセス診断</mark>があり、対応待ちの項目がある場合はワンクリックで「要注意」カードまでスクロールできます                                                                                                                                                                                                                                                                       |
| 指標カード                                                                          | <mark style="color:blue;">リクエスト</mark>、<mark style="color:blue;">費用（credits）</mark>、<mark style="color:blue;">Token</mark>、<mark style="color:blue;">エラー率</mark>、<mark style="color:blue;">最も遅いレイテンシ</mark>、<mark style="color:blue;">フォールバック発動</mark>を表示し、直前の同じ長さの期間と比較します                                                                                                                          |
| プロバイダー                                                                         | プロバイダーごとに<mark style="color:blue;">正常</mark>、<mark style="color:blue;">レート制限が多い</mark>（直近 24 時間の上流エラー率が 5% を超過）、<mark style="color:blue;">設定待ち</mark>（認証情報が無効）のステータスラベルを表示します。クリックすると直近 24 時間の上流エラー率と対処案を確認でき、<mark style="color:blue;">接続テスト</mark>や<mark style="color:blue;">認証情報の管理</mark>を行えます。<mark style="color:blue;">レート制限が多い</mark>場合は<mark style="color:blue;">フォールバックルールを作成</mark>も表示されます |
| <mark style="color:blue;">使用量の推移</mark>、<mark style="color:blue;">レイテンシ</mark> | リクエスト数またはコストの推移グラフです。<mark style="color:blue;">最初のトークンまでの時間（TTFT）</mark>、<mark style="color:blue;">総レイテンシ</mark>、<mark style="color:blue;">上流レイテンシ</mark>について、それぞれ<mark style="color:blue;">通常</mark>（p50）と<mark style="color:blue;">最も遅い</mark>（p95）の値を表示します                                                                                                                                        |
| <mark style="color:blue;">使用量の内訳</mark>                                        | <mark style="color:blue;">プロバイダー</mark>または<mark style="color:blue;">モデル</mark>別にリクエスト数、フォールバック回数、費用を表示します（プロバイダーにはエラー率も表示します）。モデルを展開すると、呼び出しに使われている API Key を確認できます                                                                                                                                                                                                                                  |
| <mark style="color:blue;">要注意</mark>                                           | プロバイダーの直近 24 時間の上流エラー率が 5% を超えた場合、API Key に紐付くメンバーの割り当て使用率が 90% に達した場合、無効なキーに直近 24 時間のリクエストがある場合、またはフォールバックルールの今月の発動回数が先月同期の 2 倍以上になった場合に表示します                                                                                                                                                                                                                                                       |

<mark style="color:blue;">アクセス診断</mark>は、「モデルにアクセスできないユーザーがいる」場合の調査に使います。API キーを 1 つ選択し（必要に応じてモデルも選択）、<mark style="color:blue;">診断</mark>をクリックします。システムは、キーが取り消されていないこと、有効であること、有効期限内であること、メンバーとユーザーが有効であること、組織で Gateway が有効であること、組織がそのモデルを利用できること、キーでそのモデルが有効化されていることを順に確認し、最初に失敗したチェックを示します。

## プロバイダーの追加 <a href="#add-provider" id="add-provider"></a>

<mark style="color:blue;">モデルプロバイダー</mark>で<mark style="color:blue;">Provider を追加</mark>をクリックし、4 ステップのウィザードに従います。同じ種類のプロバイダーを複数登録できます（異なるリージョンの Bedrock など）。

{% stepper %}
{% step %}

### プロバイダーの選択 <a href="#pick-provider" id="pick-provider"></a>

プロバイダーの種類を選択します。カードに<mark style="color:blue;">自動検出に対応</mark>と表示されているプロバイダーは、作成後に利用可能なモデルを自動で一覧表示できます。<mark style="color:blue;">モデルの手動追加が必要</mark>と表示されている場合は、後でモデルカタログから個別に追加します。
{% endstep %}

{% step %}

### 接続用認証情報 <a href="#provider-credentials" id="provider-credentials"></a>

<mark style="color:blue;">表示名</mark>（例：「Bedrock 米国東部」）とプロバイダーの認証情報を入力し、<mark style="color:blue;">作成して検出</mark>をクリックします。認証情報はこのステップで保存されるため、その後ウィザードを閉じても失われません。

| プロバイダー            | 必須項目                                                                                                                                                  | 任意項目                                                             | モデルの自動検出  |
| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- | --------- |
| OpenAI            | <mark style="color:blue;">API Key</mark>                                                                                                              | —                                                                | 対応しています   |
| Anthropic         | <mark style="color:blue;">API Key</mark>                                                                                                              | <mark style="color:blue;">API Base（任意、空欄の場合は公式エンドポイントを使用）</mark> | 対応しています   |
| Amazon Bedrock    | <mark style="color:blue;">AWS Access Key ID</mark>、<mark style="color:blue;">AWS Secret Access Key</mark>、<mark style="color:blue;">AWS Region</mark> | —                                                                | 手動追加が必要です |
| Google Vertex AI  | <mark style="color:blue;">Service Account JSON</mark>（サービスアカウントの JSON 全体を貼り付けます）                                                                      | —                                                                | 手動追加が必要です |
| vLLM              | <mark style="color:blue;">API Base</mark>（セルフホストの vLLM サービスの URL、例：`https://vllm.example.com/v1`）                                                     | <mark style="color:blue;">API Key（任意）</mark>                     | 対応しています   |
| OpenAI Compatible | <mark style="color:blue;">API Base</mark>（セルフホストまたはサードパーティーの OpenAI 互換エンドポイントの URL）                                                                   | <mark style="color:blue;">API Key（任意）</mark>                     | 対応しています   |
| {% endstep %}     |                                                                                                                                                       |                                                                  |           |

{% step %}

### モデルの検出 <a href="#discover-models" id="discover-models"></a>

システムがプロバイダーに利用可能なモデルを問い合わせ、デフォルトですべて選択します。カタログに登録済みのモデルは<mark style="color:blue;">既存</mark>と表示され、選択できません。確認後に「N 個をインポート」をクリックすると、選択した各モデルがカスタムモデルとして作成されます。インポート中に<mark style="color:blue;">停止</mark>をクリックできます。不要な場合は、<mark style="color:blue;">スキップして手動で追加</mark>をクリックしてください。
{% endstep %}

{% step %}

### 完了 <a href="#provider-done" id="provider-done"></a>

画面に<mark style="color:blue;">プロバイダー接続済み</mark>とインポート結果が表示されます。インポートしたモデルのコンテキストと機能はデフォルト値のため、<mark style="color:blue;">モデルカタログ</mark>で個別に調整できます。
{% endstep %}
{% endstepper %}

プロバイダー一覧の各行には、ステータス、マスクされた認証情報、「N 個のモデル」リンクが表示されます（クリックすると、そのプロバイダーのモデルで絞り込んだモデルカタログが開きます）。右側で<mark style="color:blue;">テスト</mark>、<mark style="color:blue;">編集</mark>、<mark style="color:blue;">削除</mark>を行えます。編集時にプロバイダーの種類は変更できません。シークレットの欄を空欄にすると、既存の値を維持します。

## モデルの管理 <a href="#manage-models" id="manage-models"></a>

<mark style="color:blue;">モデル</mark>タブでは、2 種類のモデルを同じカタログに表示します。

* **マネージドモデル**：MaiAgent が提供するモデルで、ソースは「MaiAgent マネージド」と表示されます。
* **カスタムモデル**：組織独自のプロバイダー認証情報で作成したモデルです。ソースは<mark style="color:blue;">カスタム</mark>と表示され、<mark style="color:blue;">料金</mark>欄には「総 token 数 × N%」というトラフィック料金の料率が表示されます。

カタログの項目には、<mark style="color:blue;">名前</mark>、<mark style="color:blue;">組織で利用可能</mark>、<mark style="color:blue;">フォールバックで参照</mark>、<mark style="color:blue;">ソース</mark>、<mark style="color:blue;">プロバイダー</mark>、<mark style="color:blue;">Model ID</mark>、<mark style="color:blue;">料金</mark>、<mark style="color:blue;">コンテキスト</mark>があります。上部では、機能（<mark style="color:blue;">チャット</mark>、<mark style="color:blue;">ビジョン</mark>、<mark style="color:blue;">ツール呼び出し</mark>、<mark style="color:blue;">推論</mark>）、プロバイダー、キーワードで絞り込めます。行をクリックすると<mark style="color:blue;">モデル詳細</mark>が開き、Gateway モデル ID のコピー、所属プロバイダーの確認、<mark style="color:blue;">使用されているフォールバックチェーン</mark>の確認ができます。

### 組織で利用可能スイッチ <a href="#org-access-switch" id="org-access-switch"></a>

マネージドモデルの<mark style="color:blue;">組織で利用可能</mark>スイッチは、[モデルアクセス権限](/maiagent-user-guide/ja/org/model-access.md)ページと同じ設定です。ここでオフにすると、AI アシスタントのモデルメニューからもそのモデルが削除されます。オフにする前に「このモデルを無効にしますか？」という確認が表示され、影響を受けるアシスタント数とフォールバックチェーン数が示されます。鍵アイコンが表示されるモデルは、MaiAgent が組織での利用をまだ有効化していないか、プラットフォームがそのモデルへの Gateway アクセスを無効にしているため、組織側では有効化できません。カスタムモデルは常に<mark style="color:blue;">カスタム・自動で利用可能</mark>と表示され、このスイッチの対象にはなりません。

### カスタムモデルの追加 <a href="#add-custom-model" id="add-custom-model"></a>

1. <mark style="color:blue;">モデルを追加</mark>をクリックし、<mark style="color:blue;">Provider を選択</mark>ステップでプロバイダー認証情報を選択します（プロバイダーがまだない場合は、<mark style="color:blue;">プロバイダーを追加</mark>を直接クリックできます）。
2. <mark style="color:blue;">モデル設定</mark>で次の項目を入力します。
   * <mark style="color:blue;">名前</mark>：カタログとモデルメニューに表示する名前です。
   * <mark style="color:blue;">ファミリー</mark>：Anthropic、GPT、Gemini、Grok、Qwen、DeepSeek、Mistral、Other のいずれかです。
   * <mark style="color:blue;">モデル ID</mark>：プロバイダー側が要求するモデル ID です（例：`gpt-4.1`）。同じプロバイダー認証情報の配下で重複する ID は使えません。
   * <mark style="color:blue;">コンテキスト</mark>、<mark style="color:blue;">最大出力 token 数</mark>：デフォルトは 128,000 と 8,000 です。モデルの仕様に合わせて調整してください。
   * <mark style="color:blue;">機能</mark>：<mark style="color:blue;">ビジョン</mark>、<mark style="color:blue;">ツール呼び出し</mark>、<mark style="color:blue;">ストリーミング</mark>、<mark style="color:blue;">推論</mark>です。
3. <mark style="color:blue;">作成</mark>をクリックします。完了ページに自動生成された Gateway モデル ID が表示されます。<mark style="color:blue;">接続テスト</mark>をクリックして、呼び出しができることを確認できます。

Gateway モデル ID は、プロバイダーの Slug とモデル名から生成され、作成後に名前を変更しても変わりません。プログラムからの呼び出しには、この ID を指定します。カスタムモデルの行の右側では、<mark style="color:blue;">テスト</mark>、<mark style="color:blue;">編集</mark>、<mark style="color:blue;">削除</mark>を行えます。モデルを作成したり、モデル ID やプロバイダーを変更したりすると、システムがバックグラウンドで temperature、top\_p、top\_k などのパラメーターをモデルが拒否するかどうかを検出します。結果は編集ダイアログの<mark style="color:blue;">リクエストパラメーターの対応状況</mark>に表示され、<mark style="color:blue;">再検出</mark>をクリックすることもできます。すべてのプロバイダーで検出できるわけではなく、検出できない場合は「このモデルを検出できません（有効な認証情報と対応プロバイダーが必要です）」と表示されます。

## フォールバックモデルグループ <a href="#fallback-groups" id="fallback-groups"></a>

フォールバックモデルグループでは、メインモデルが失敗すると、Gateway がフォールバックチェーン内の次のモデルに順番に切り替えます。異なるモデルやプロバイダーを組み合わせられます。

1. <mark style="color:blue;">フォールバックモデルグループ</mark>で<mark style="color:blue;">フォールバックモデルグループを追加</mark>をクリックします。
2. <mark style="color:blue;">グループ名</mark>（例：「Claude 高可用性」）を入力します。
3. <mark style="color:blue;">フォールバックチェーン</mark>の最初の行でメインモデルを選択し、<mark style="color:blue;">次の優先順位を追加</mark>をクリックしてフォールバックモデルを追加します。マネージドモデルとカスタムモデルのどちらも選択でき、少なくとも 1 つのモデルが必要です。ドラッグ、または<mark style="color:blue;">上へ移動</mark>、<mark style="color:blue;">下へ移動</mark>で順序を調整できます。
4. <mark style="color:blue;">保存</mark>をクリックします。システムがグループの Slug を自動生成します。プログラムから呼び出す際に model フィールドへ Slug を指定すると、フォールバックチェーン全体を利用できます。

<mark style="color:blue;">発動条件</mark>はシステムで固定され、カスタマイズできません。条件は<mark style="color:blue;">タイムアウト</mark>、<mark style="color:blue;">接続エラー</mark>、<mark style="color:blue;">429 レート制限</mark>、<mark style="color:blue;">5xx エラー</mark>です。各グループのカードには、今月と先月同期の発動回数が表示されます。今月の回数が先月同期の 2 倍以上になると、赤字で通知されます。<mark style="color:blue;">プラットフォームレベル・読み取り専用</mark>と表示されるグループは、プラットフォーム共通のルールであり、組織側では<mark style="color:blue;">閲覧</mark>のみ可能です。

## 連携例 <a href="#integration-examples" id="integration-examples"></a>

<mark style="color:blue;">連携例</mark>タブでは、OpenAI 互換インターフェースで Gateway を呼び出す 3 つのステップ（Gateway キーの取得、モデル名の指定、自動転送とフォールバック）を説明し、cURL、Python、Node.js の例を提供します。<mark style="color:blue;">モデルまたはフォールバックグループを選択</mark>で選択すると、例の model が対応する Gateway モデル ID またはフォールバックグループの Slug に切り替わります。<mark style="color:blue;">コピー</mark>をクリックして、そのまま利用できます。

呼び出し用の API Key は、<mark style="color:blue;">API Key 管理権限</mark>を持つ管理者が、<mark style="color:blue;">組織設定</mark> → <mark style="color:blue;">API Key 管理</mark>で作成します。各キーは 1 人のメンバーに紐付けられ、組織で利用できるモデルの範囲内で<mark style="color:blue;">有効化するモデル</mark>をさらに制限できます。また、<mark style="color:blue;">毎分リクエスト数（RPM）</mark>と<mark style="color:blue;">毎分 Token 数（TPM）</mark>を設定できます。認証方法やエラーコードなどの詳細は、[AI Gateway：OpenAI 互換 API 連携](https://docs.maiagent.ai/tech/ai-gateway/ai-gateway-openai-compatible)と [AI Gateway のセキュリティ](https://docs.maiagent.ai/tech/ai-gateway/ai-gateway-security)をご覧ください。

## AI アシスタントと MaiGPT での利用 <a href="#use-in-agents-and-maigpt" id="use-in-agents-and-maigpt"></a>

* **AI アシスタント**：カスタムモデルを作成すると、[AI アシスタント設定](/maiagent-user-guide/ja/build/agent/setup.md)の<mark style="color:blue;">LLM モデル</mark>メニューに自動で表示され、<mark style="color:blue;">カスタム</mark>と表示されます。<mark style="color:blue;">AI Gateway 権限</mark>を持つメンバーが AI アシスタントを編集する場合、メニューに<mark style="color:blue;">フォールバックモデルグループ</mark>のセクションも表示され、組織のフォールバックグループを直接選択できます。フォールバックグループを選択すると、思考設定は表示されません。
* **MaiGPT**：MaiGPT は<mark style="color:blue;">ツール呼び出し</mark>機能を持つモデルのみを表示するため、カスタムモデルを表示するには<mark style="color:blue;">ツール呼び出し</mark>を選択する必要があります。メンバーのロールで MaiGPT の利用可能モデルが制限されている場合は、[MaiGPT のロール別利用権限](/maiagent-user-guide/ja/org/roles/maigpt-role-permissions.md)でも、そのモデルを選択してください。

{% hint style="warning" %}
カスタムモデルやフォールバックモデルグループを削除する前に、それらを使用している AI アシスタントを別のモデルに切り替えてください。その後に削除すると、稼働中のサービスの中断を防げます。
{% endhint %}

## 料金 <a href="#billing" id="billing"></a>

カスタムモデル（独自の認証情報またはセルフホストのエンドポイント）を利用する場合、MaiAgent はプラットフォームのモデル料率ではなく、総 token 数に基づくトラフィック料金を請求します。マネージドモデルには従来の料率が適用されます。料率と使用履歴の確認方法は、[AI Gateway カスタムモデルのトラフィック料金](/maiagent-user-guide/ja/org/credits.md#ai-gateway-traffic-fee)をご覧ください。

## よくある質問 <a href="#faq" id="faq"></a>

#### Q：左側メニューに AI Gateway が表示されません。 <a href="#faq-menu-missing" id="faq-menu-missing"></a>

次の 2 点を確認してください。組織で AI Gateway が有効化されているか（<mark style="color:blue;">組織の概要</mark>の「高度な機能」で確認できます）、そして所属ロールで<mark style="color:blue;">AI Gateway 権限</mark>が選択されているかを確認します。

#### Q：OpenAI Compatible プロバイダーで「テスト」をクリックすると、デフォルトのテストモデルがないと表示されます。 <a href="#faq-compatible-test" id="faq-compatible-test"></a>

プロバイダーの行の<mark style="color:blue;">テスト</mark>は、そのプロバイダーのデフォルトのテストモデルでテストリクエストを送信します。OpenAI 互換エンドポイントには、利用できるデフォルトモデルがありません。まずモデルカタログでカスタムモデルを作成し、そのモデルの行の<mark style="color:blue;">テスト</mark>で接続を確認してください。

#### Q：プロバイダーを削除できません。 <a href="#faq-delete-provider" id="faq-delete-provider"></a>

カスタムモデルがプロバイダー認証情報を使用している場合、システムは削除を拒否します。まずプロバイダーの行の「N 個のモデル」リンクから該当するカスタムモデルを見つけて削除し、その後プロバイダーを削除してください。

#### Q：AI アシスタントのモデルメニューにフォールバックモデルグループが表示されません。 <a href="#faq-fallback-not-in-agent" id="faq-fallback-not-in-agent"></a>

AI アシスタントを編集するメンバーが<mark style="color:blue;">AI Gateway 権限</mark>を持っている場合にのみ、組織のフォールバックモデルグループがメニューに表示されます。プラットフォームレベルの読み取り専用グループは、AI アシスタントのメニューには表示されません。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.maiagent.ai/maiagent-user-guide/ja/build/ai-gateway.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.