本文へスキップ
Ankole

ChatGPT サブスクリプション Provider

AI Agent 向け: このページの Markdown 版は https://ankole.agentbull.com/ja-JP/docs/chatgpt-subscription-provider/index.md、ドキュメント索引は https://ankole.agentbull.com/ja-JP/llms.txt にあります。

ChatGPT サブスクリプションは、通常の AIGateway provider の 1 つとして利用できます。日常の会話用プロファイルから Background Agent Jobs 用プロファイルまで、任意の言語モデルプロファイルから指定でき、プロファイル側で対象の provider レコードとモデルを選択します。

各 provider レコードは内部に credential pool(認証情報プール)を持っています。control plane が各アカウントのトークンを暗号化して保管し、OAuth トークンの自動更新とリクエストごとの利用可能なプールメンバーの選択を行います。Agent Computer 側に渡されるのは AIGateway のエンドポイントと AIGateway キーだけであり、ChatGPT のリフレッシュトークンが外部へ渡ることはありません。

Provider を作成する

  1. Console → LLM Providers を開きます。
  2. 新しい provider を追加し、種類(kind)として ChatGPT Subscription を選択します。
  3. chatgpt-main のような不変の provider ID を入力します。
  4. provider を保存します。

既定のエンドポイントと Identity ヘッダーは Codex プロトコルに合わせて構成されています。デプロイ環境に特別なプロキシ要件などがある場合にのみ、詳細設定のエンドポイントやヘッダーを変更してください。

デバイスログインでアカウントを追加する

  1. 作成した ChatGPT サブスクリプション provider を開きます。
  2. Add ChatGPT account を選択します。
  3. 表示された認証リンクを開き、Console に表示されているワンタイムコードを入力します。
  4. Console 側でログイン完了が確認され、プールメンバーとして追加されるまで待ちます。
  5. 同じ provider に複数のアカウントを登録したい場合は、この手順を繰り返します。

通常は公式のデバイスログインフローが使われますが、環境によってデバイスログインが利用できない場合、Console はブラウザー用のサインイン URL を表示し、認証後のコールバック URL 全体を貼り付ける代替フローへ案内します。また、Enterprise 環境の運用者は、信頼済みのアクセストークンと対応する ChatGPT アカウント ID を直接登録することも可能です。

credential pool を構成する

プール内の各メンバーには、ラベル、優先度(priority)、登録元(source)、ヘルス状態、リクエスト数、レート制限情報、およびモデル/画像の使用量が記録されます。シークレットトークン自体が画面に表示されることはありません。

プールからのメンバー選択戦略を次の 4 つから選びます(Console 画面では UI 言語に合わせて翻訳表示されますが、API と保存データでは以下の正規キーが使われます)。

Console ラベル API 値 動作
Fill first fill_first 上限に達して利用できなくなるまで、優先順位が最初の正常なメンバーを使い続けます。
Round robin round_robin リクエストのたびに正常なメンバーを順番にローテーションします。
Least used least_used これまでのリクエスト数が最も少ない正常なメンバーを選択します。
Random random 正常なメンバーの中からランダムに 1 つ選択します。

レート制限などで exhausted になったメンバーは、クールダウン期間が経過すると自動的に利用可能状態へ復帰します。一方、トークン失効などで dead になったメンバーを復旧させるには、再ログインまたは新しい認証情報への更新が必要です(ラベルを変更しただけでは dead 状態は解除されません)。必要に応じてメンバーを一時的に無効化したり削除したりすることもできます。

Provider を Agent に割り当てる

  1. Console → Agents を開き、対象の Agent を選択します。
  2. 設定したいモデルプロファイルを開きます(長時間ジョブには heavy(高度な推論・バックグラウンドジョブ)を、通常の会話ターンには primary、light、またはカスタムプロファイルを使います)。
  3. 作成した ChatGPT サブスクリプション provider と、サブスクリプションで利用可能なモデルを選択します。
  4. 必要に応じて推論強度(reasoning effort)と Fast Mode を設定します。
  5. プロファイルを保存します。

割り当て後も、すべてのモデル呼び出しは AIGateway を経由します。ステートフルなスレッドでは可能な限り同じアカウントが継続して使われ、リトライ可能なエラーが発生した際にはプール内の別アカウントへ自動的にローテーションされます(別の provider への自動フォールバックは行われません)。プール内の全メンバーがクールダウン中で回復時刻が分かる場合、対話型の呼び出しには最も早い回復時刻付きのレート制限エラーが返され、Background Agent Job はその時刻まで queued に戻って待機します。回復時刻が分からない場合、Job は通常の上限付きリトライ規則に従います。詳しくは Background Agent Jobs を参照してください。

ジョブの作成・操作・トラブルシューティングについては、Background Agent Jobs を参照してください。