GitHub Copilot

GitHub Copilot Chat、VS Code エージェント、および Copilot CLI を、BYOK とカスタム OpenAI 互換エンドポイントを使用して Model Gate に接続します。

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 はフィールドを次のようにマッピングします。

VSコードの設定	モデルゲートフィールド
`contextWindow`	`context_window` (と同じ値 `context_length`)
`maxInputTokens`	`max_input_tokens`
`maxOutputTokens`	`max_output_tokens`

認証された /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"

副操縦士「」

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 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 の使用制限を設定します。 - バックグラウンドタスクには小規模なユーティリティモデルを使用し、計画、デバッグ、または複雑なリファクタリング用に大きな推論モデルを予約します。 - 予期しないコスト、遅延、レート制限、またはプロバイダーのエラーを調査する場合は、モデルゲートのリクエスト履歴を確認します。

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 キー/モデル/モデルゲートポリシーを修正してください。

トラブルシューティング

問題	解決
エージェントモードではモデルが表示されない	モデルがツール呼び出しを使用して構成されていること、および実際の Model Gate モデルが関数/ツール呼び出しをサポートしていることを確認します。プロバイダー構成を変更した後、VS Code を再起動します。
`401 invalid_api_key`	専用の Model Gate キーを再入力するか、回転させます。コパイロットの送信を確認する `Authorization: Bearer ...`。
`404` または間違ったエンドポイント	応答には明示的なものを使用します `https://api.model-gate.com/v1/responses`;チャット補完用に使用します `/v1/chat/completions`。
モデルが見つかりません	クエリ `/v1/models` 有効な正規 ID またはエイリアスを使用します。
エージェントはツールを使用できません	検証済みのツール/関数呼び出しを備えたモデルを選択します。 Copilot CLI にもストリーミングが必要です。
画像添付ファイルが無視/拒否される	画像入力/ビジョン機能が検証済みのモデルを使用し、設定を行ってください。 `vision: true` そのモデルのみ。
ユーティリティ機能は BYOK のみのセットアップでは動作しません	設定する `chat.utilityModel` そして `chat.utilitySmallModel` 利用可能なBYOKモデルに。
インライン補完では引き続き GitHub を使用するか、サインインが必要です	予想: BYOK は、すべての Copilot 機能ではなく、主にチャット/エージェント/ユーティリティモデルのトラフィックを制御します。
リクエストは予想外に高価です	ユーティリティ作業にはより小さなモデルを使用し、必要に応じて推論を下げ、Model Gate の支出/RPM/同時実行制限を構成します。

現在の上流参照

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

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