GitHub Copilot でモデル ゲートを通過

GitHub Copilot と Visual Studio Code のサポート 自分のキーの持ち込み (BYOK) モデル。 Model Gate は、Copilot チャットおよびエージェント ワークフローの OpenAI 互換カスタム エンドポイントとして使用できます。

VS Code の場合、推奨されるセットアップは次のとおりです。 カスタムエンドポイント プロバイダー レスポンスAPI。チャット補完は、選択したモデルまたはワークフローで特にその API ファミリが必要な場合にのみ使用してください。

必須の値

API key: mg_live_...
Responses endpoint: https://api.model-gate.com/v1/responses
Chat Completions endpoint: https://api.model-gate.com/v1/chat/completions
Base URL for Copilot CLI: https://api.model-gate.com/v1

専用の API キーを作成します。 モデルゲートコントロールパネル。チームまたはワークステーションの統合の場合は、制限、リクエスト履歴、ローテーション、失効を監査しやすい状態に保つために、無関係な本番キーを再利用するのではなく、別のキーを使用することをお勧めします。

Copilot を構成する前に、現在有効なモデルをリストします。

curl https://api.model-gate.com/v1/models \
  -H "Authorization: Bearer mg_live_..."

このエンドポイントから返される有効な正規モデル ID または管理者管理のエイリアスを使用します。

VS Code: 推奨されるカスタム エンドポイントのセットアップ

現在の VS Code バージョンでは、言語モデル エディターで BYOK モデルが公開されています。

1. コマンドパレットを開きます。
2. 走る チャット: 言語モデルの管理。
3. 選択 モデルの追加。
4. 選択 カスタムエンドポイント。
5. 次のようなグループ名を使用します。 Model Gate。
6. VS Code がプロバイダーの資格情報を要求するときに、Model Gate API キーを入力します。
7. 選択 応答 選択したモデルがレスポンス API をサポートする場合は、API タイプとして。
8. 明示的な Model Gate エンドポイントを使用してモデルを構成し、生成された chatLanguageModels.json。
9. Chat モデル ピッカーから Model Gate モデルを選択します。

非推奨のものは使用しないでください github.copilot.chat.customOAIModels 新しい構成の設定。現在のカスタム エンドポイント プロバイダーは、応答、チャット完了、メッセージ スタイルのエンドポイントをサポートしており、推奨される VS Code 構成パスです。

推奨される応答構成

生成された chatLanguageModels.json 次のような構成を使用できます。

[
  {
    "name": "Model Gate",
    "vendor": "customendpoint",
    "apiKey": "${input:modelGateApiKey}",
    "apiType": "responses",
    "models": [
      {
        "id": "gpt-5.4",
        "name": "GPT-5.4 through Model Gate",
        "url": "https://api.model-gate.com/v1/responses",
        "toolCalling": true
      }
    ]
  }
]

交換する gpt-5.4 有効な Model Gate モデルまたはエイリアスを使用します。

VS Code は通常、API キーを次のように送信します。

Authorization: Bearer mg_live_...

これは、Model Gate OpenAI 互換 API の正しい認証フォームです。

チャット完了フォールバック

選択したワークフローでチャット完了が必要な場合は、モデルを次のように構成します。

[
  {
    "name": "Model Gate",
    "vendor": "customendpoint",
    "apiKey": "${input:modelGateApiKey}",
    "apiType": "chat-completions",
    "models": [
      {
        "id": "MODEL_ID",
        "name": "MODEL_ID through Model Gate",
        "url": "https://api.model-gate.com/v1/chat/completions",
        "toolCalling": true
      }
    ]
  }
]

明示的な完全なエンドポイント URL を推奨します。これにより、VS Code が URL パス推論の動作を変更する場合のあいまいさが回避されます。

モデル機能の推奨事項

Copilot エージェントのワークフローには、ツールを使用できるモデルが必要です。 Model Gate を通じて信頼性の高いエージェントを使用するには:

• 検証済みのモデルを選択してください ツール/関数の呼び出し サポート;
• でモデルを選択してください ストリーミング サポート;
• 画像添付の場合は、検証済みのモデルを使用してください。 視覚・画像入力 能力とセット "vision": true そのモデルの場合。
• リポジトリ規模のエージェント作業には大規模なコンテキスト モデルを使用します。 GitHub は現在、Copilot CLI カスタム モデルに対して少なくとも 128k トークンのコンテキスト ウィンドウを推奨しています。
• 宣伝しないでください toolCalling、 vision、選択した Model Gate モデルの実際の能力を超える推論、コンテキスト、または出力の制限。
• 大規模なチームで有効にする前に、Model Gate Playground で正確なモデルをテストしてください。

手動で設定する場合 contextWindow、 maxInputTokens、 または maxOutputTokens VS Code では、認証されたモデルから選択したモデルの制限を使用します。 /models ページまたはから GET /v1/models;推測しないでください。 Model Gate はフィールドを次のようにマッピングします。

認証された /models ページにはこれらが次のように表示されます コンテクスト、 最大入力、 そして 最大出力 対応する値がわかっている場合。 API オブジェクトを直接検査するには:

curl -s https://api.model-gate.com/v1/models \
  -H "Authorization: Bearer mg_live_..." \
| jq '.data[] | select(.id=="MODEL_ID") | {context_window,max_input_tokens,max_output_tokens}'

の値 0 は、Model Gate にその制限値が構成されていないことを意味します。その場合は、次のコマンドを入力せずに、対応する手動の VS Code 設定を未設定のままにしておきます。 0 または制限を発明します。

VS Code の実用新案

VS Code は、タイトル、概要、コミット メッセージ、名前変更の提案、意図の検出などのタスクに、より小さなバックグラウンド モデルも使用します。

GitHub でホストされている Copilot モデルを使用せずに Model Gate BYOK を使用する場合は、次のように構成します。

chat.utilityModel
chat.utilitySmallModel

高速で安価な Model Gate モデルを選択してください chat.utilitySmallModel。通常、コミットメッセージ生成やその他の軽量ユーティリティ作業のための最大の推論モデルに料金を支払うメリットはありません。

の chat.byokUtilityModelDefault この設定では、ユーティリティの作業が選択した BYOK メイン エージェント モデルに従うか、GitHub Copilot ユーティリティ モデルを使用するか、デフォルトを持たないかを制御することもできます。

コパイロット CLI

GitHub Copilot CLI は、環境変数を通じて OpenAI 互換のカスタム プロバイダーをサポートします。

Linux または macOS

export COPILOT_PROVIDER_TYPE="openai"
export COPILOT_PROVIDER_BASE_URL="https://api.model-gate.com/v1"
export COPILOT_PROVIDER_API_KEY="mg_live_..."
export COPILOT_MODEL="MODEL_ID"

copilot

Windows PowerShell

$env:COPILOT_PROVIDER_TYPE = "openai"
$env:COPILOT_PROVIDER_BASE_URL = "https://api.model-gate.com/v1"
$env:COPILOT_PROVIDER_API_KEY = "mg_live_..."
$env:COPILOT_MODEL = "MODEL_ID"

copilot

Copilot CLI の場合、選択したモデルはサポートする必要があります。 ツールの呼び出しとストリーミング。構成を永続化する前に、有効な Model Gate モデルまたはエイリアスを使用してテストします。

API キーをシェル履歴、リポジトリ ファイル、またはコミットされたファイルに配置しないでください。 .env。可能な場合は、OS 資格情報ストア、保護されたシェル環境、または組織の秘密管理ツールを使用します。

コパイロットのビジネスとエンタープライズ

GitHub は、BYOK を通じて組織/企業のカスタム モデルもサポートしています。 GitHub には現在リストされています OpenAI互換プロバイダー サポートされるカスタム モデル プロバイダー カテゴリとして。この組織レベルの機能は GitHub ポリシーによって管理されており、Copilot サーフェスによってはプレビュー段階にある場合があります。

管理された組織の場合:

1. GitHub を有効にする カスタムモデル / BYOK Copilot プランに必要なポリシー。
2. 組織または企業の Copilot モデル設定に、カスタムの OpenAI 互換プロバイダー/モデルを追加します。
3. 必要最小限の Model Gate 権限と制限を備えた専用の Model Gate API キーを使用します。
4. Model Gate エンドポイントとアカウントがアクセスできるモデル ID を使用します。
5. 組織モデル ピッカーでモデルを広く公開する前に、Copilot Chat/エージェント ワークフローでモデルを検証します。

GitHub は、機能の進化に合わせて組織のカスタムモデル UI を変更することができます。正確なフィールド ラベルについては、古いリリースのスクリーンショットに頼るのではなく、現在の GitHub 管理 UI に従ってください。

セキュリティとコストに関する推奨事項

• 汎用キーを共有する代わりに、Copilot 専用の Model Gate キーを作成します。
• 開発者とエージェントのトラフィックに適した RPM 制限、同時実行制限、支出制限、またはビジネス グループ ポリシーを適用します。
• キーがソース管理、チャット、ログ、または問題に貼り付けられている場合は、すぐにキーをローテーションします。
• 決してコミットしないでください mg_live_... で chatLanguageModels.json; VS Code に資格情報を保存させるか、入力/シークレットを参照させます。
• 開発環境が意図的にサンドボックス化されていない限り、破壊的ツールの承認を有効にしておきます。
• エージェント モードでは、1 つのユーザー指示から多くのモデル/ツール ターンを生成できます。大規模なリポジトリに対して高価な推論モデルを有効にする前に、Model Gate の使用制限を設定します。
• バックグラウンド タスクには小規模なユーティリティ モデルを使用し、計画、デバッグ、または複雑なリファクタリング用に大きな推論モデルを予約します。
• 予期しないコスト、遅延、レート制限、またはプロバイダーのエラーを調査する場合は、Model Gate のリクエスト履歴を確認してください。

BYOK で置き換えられるものと置き換えられないもの

Model Gate BYOK モデルは、モデルが必要な機能をサポートしている場合、VS Code チャット、エージェント ワークフロー、ツール、ユーティリティ タスクを強化できます。

それはあります ない すべての GitHub Copilot フィーチャーを自動的に置き換えます。現在の VS Code/GitHub リリースによっては、標準のインライン コード補完、セマンティック検索、埋め込み、その他の GitHub でホストされるサービスなどの機能には、依然として GitHub 認証、Copilot プラン、または GitHub インフラストラクチャが必要な場合があります。

したがって、目標を制御することである場合は、Model Gate BYOK を使用してください。 チャット/エージェントのモデル パスとその請求すべての GitHub Copilot ネットワーク トラフィックが Model Gate を介してルーティングされるという前提ではありません。

Copilot をテストする前に Model Gate を検証する

応答

curl https://api.model-gate.com/v1/responses \
  -H "Authorization: Bearer mg_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "input": "Reply with exactly: Model Gate OK"
  }'

チャットの完了

curl https://api.model-gate.com/v1/chat/completions \
  -H "Authorization: Bearer mg_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "messages": [{"role": "user", "content": "Reply with exactly: Model Gate OK"}]
  }'

これらのリクエストが失敗した場合は、Copilot をデバッグする前に API キー/モデル/モデル ゲート ポリシーを修正してください。

トラブルシューティング

現在の上流参照

GitHub と VS Code は、リリース間で BYOK 構成を変更できます。現在のアップストリームの動作については、以下を確認してください。

• https://code.visualstudio.com/docs/agent-customization/language-models
• https://docs.github.com/en/copilot/concepts/models/bring-your-own-key
• https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/use-byok-models
• https://docs.github.com/en/copilot/how-tos/administer-copilot/manage-for-organization/enable-custom-models

固定エンドポイント拡張機能

カスタム エンドポイントを構成できない承認されたローカル拡張機能については、を参照してください。 Windows および Linux でのエンドポイント オーバーライド。このオプションの mitmproxy フォールバックには、互換性のあるリクエスト、Model Gate キー、および明示的なローカル CA トラストが必要です。 Copilot 認証を置き換えたり、証明書の固定をバイパスしたりするものではありません。上記のネイティブ BYOK 設定を優先します。