このページは英語版ドキュメントの翻訳です。コマンド、識別子、例はそのままです。ランタイム 7.24.4 · SDK 2.6.7。英語版

モデル選択と回復

状態: 有効

範囲: 現行状態

最終確認: 2026-10-10

担当: ax-code runtime

AX Code はプロバイダーとモデルの選択を正確に保ちます。プロバイダーを接続しても、自動回復のプールには入りません。フォールバックが構成されていないとき、一時的な失敗は既存の再試行上限の中で選ばれた対象を再試行し、その後停止します。

順序付きフォールバックを構成する

llm_routing.fallback を設定してください。場所は利用者設定、AX_CODE_CONFIG で選んだカスタム設定、または明示的な AX_CODE_CONFIG_CONTENT です。対象は正確な組です。モデル ID にはスラッシュを含められます。例は次のとおりです。

{
  "model": "my-gateway/openai/gpt-oss-120b",
  "llm_routing": {
    "fallback": [
      { "providerID": "my-gateway", "modelID": "my-backup-model" },
      { "providerID": "my-other-provider", "modelID": "my-approved-model" }
    ]
  }
}

これらの例は、構成済みプロバイダーの正確な ID に置き換えてください。リストは最大 8 個の異なる対象を許します。空、または無いときは、対象は変わりません。プロジェクトとリモートの設定は利用者の許可を狭められますが、追加や並べ替えはできません。管理された制限が最終の天井を与えます。構成された次の対象が無いと回復は止まります。AX Code は別のカタログ項目を代用しません。

通常の一時的なレート制限、認識された過負荷、サーバーエラーは、同じ対象の再試行のあと、このリストを進められます。認証、権限、恒久的な枠、不正な要求の失敗は、切り替えを認可しません。ローカルプロバイダーのセッションは、リモート推論へ自動では移りません。取り消しは列を止めます。現在の要求が出力を公開したあと、またはツールを開始したあとの回復も止まり、効果を再演せず部分的な進捗を保ちます。

プロセッサは通常、最初の試行のあと同じ対象の再試行を 5 回許します。並行性上限のエラーは再試行上限が 8 回です。プロバイダーのサーキットブレーカーと外側のエラー上限は、より早く止めることがあります。成功したツールループのステップは新しい要求であり、以前の作業の再試行ではありません。制御された直接生成の箇所では AI SDK の再試行は無効です。外部 CLI とゲートウェイ内部の試行は、不透明なまま残り得ます。

補助作業と既存の設定

small_model がないとき、タイトル、要約、コンパクションはプライマリモデルを継承します。明示的な small_model、または役割固有のエージェントモデルは、その正確な対象をなお選びます。不正なピンは失敗し、別のプロバイダーやモデルへは移りません。任意のタイトルと要約の作業は、ローカルタイトルとスキップの振る舞いを保ちます。コンパクションは失敗したときトランスクリプトを保ち、モデルを変えるのは構成された回復を通るときだけです。

構成されたプライマリモデル、タスク、エージェント、コマンドのピン、保存された最近の選択も正確なままです。使えないピンは明示的に取り除くか直してください。構成も最近の選択もないヘッドレス実行には --model が必要です。見えるモデルピッカーは推奨を出せますが、それらの提案は回復リストにはなりません。

任意の複雑度分類器には、明示的な補助モデルが必要です。無いときは分類を飛ばします。プライマリが与えられているとき、要求されたプロバイダーに錨を下ろします。明示的なプライマリの選択は、エージェントトピックの経路を生き残ります。

有効な設定を調べる

ax-code debug routing
ax-code debug routing --model my-gateway/openai/gpt-oss-120b

これは正確なプライマリ、順序付きフォールバック、補助の選択、エージェントのピン、再試行上限を表示します。モデル要求は送らず、モデルの可用も探査しません。通常の設定読み込みは、構成されたリモート設定を取得することがあります。これは設定の説明であり、過去のゲートウェイ振る舞いの再構成ではありません。

利用者メッセージは、選択が要求、エージェントのピン、複雑度またはハイブリッドの経路、セッションまたは設定の既定のどれから来たかを記録します。この情報源はローカルの入口を表します。request は、誰が API クライアントを操作したかを証明しません。要求の証拠は、選ばれた目的と対象を記録します。モデルが生成した自己記述や、メモリまたはツール例の中のモデル名は、経路の証拠ではありません。上流の経路と認可の責任は、AX Trust と外部プロバイダーに残ります。