GitHub Copilot a través de Model Gate

GitHub Copilot i suport de Visual Studio Code Porta la teva pròpia clau (BYOK) models. Model Gate es pot utilitzar com a punt final personalitzat compatible amb OpenAI per als fluxos de treball de xat i agent de Copilot.

Per a VS Code, la configuració recomanada és la Punt final personalitzat proveïdor amb el API de respostes. Utilitzeu les finalitzacions de xat només quan un model o flux de treball seleccionat requereixi específicament aquesta família d'API.

Valors requerits

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

Creeu una clau API dedicada al fitxer Panell de control Model Gate. Per a la integració d'un equip o una estació de treball, preferiu una clau independent en lloc de reutilitzar una clau de producció no relacionada, de manera que els límits, l'historial de sol·licituds, la rotació i la revocació siguin fàcils d'auditar.

Llista els models activats actualment abans de configurar Copilot:

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

Utilitzeu un ID de model canònic habilitat o un àlies gestionat per l'administrador que retorna aquest punt final.

VS Code: configuració de punt final personalitzat recomanada

Les versions actuals de VS Code exposen els models BYOK a l'editor de models de llenguatge.

1. Obriu la paleta d'ordres. 2. Córrer Xat: Gestiona els models lingüístics. 3. Seleccioneu Afegeix models. 4. Seleccioneu Punt final personalitzat. 5. Utilitzeu un nom de grup com ara Model Gate. 6. Introduïu la clau de l'API Model Gate quan VS Code sol·liciti la credencial del proveïdor. 7. Seleccioneu Respostes com el tipus d'API quan el model seleccionat admet l'API de Respostes. 8. Configureu el model amb el punt final de Model Gate explícit i deseu el generat chatLanguageModels.json. 9. Seleccioneu el model Model Gate al selector de models de xat.

No utilitzeu el obsolet github.copilot.chat.customOAIModels configuració per a una nova configuració. El proveïdor de punt final personalitzat actual admet els punts finals d'estil Respostes, Finalitzacions de xat i Missatges i és el camí de configuració preferit de VS Code.

Configuració de respostes recomanades

El generat chatLanguageModels.json pot utilitzar una configuració com aquesta:

[
  {
    "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
      }
    ]
  }
]

Substitueix gpt-5.4 amb un model o àlies de Model Gate habilitat.

VS Code normalment envia la clau de l'API com:

Authorization: Bearer mg_live_...

que és el formulari d'autenticació correcte per a l'API compatible amb Model Gate OpenAI.

Alternativa de finalitzacions de xat

Si el flux de treball escollit requereix finalitzacions de xat, configureu el model com:

[
  {
    "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
      }
    ]
  }
]

Preferiu un URL de punt final complet explícit. Això evita l'ambigüitat si VS Code canvia el comportament d'inferència del camí d'URL.

Recomanacions de capacitat del model

Els fluxos de treball de l'agent Copilot requereixen un model que pugui utilitzar eines. Per a un ús fiable d'agents mitjançant Model Gate:

- triar un model amb verificat crida d'eina/funció suport; - triar un model amb streaming suport; - Per a fitxers adjunts d'imatges, utilitzeu un model amb verificat entrada de visió/imatge capacitat i conjunt "vision": true per a aquest model; - utilitzar un model de context gran per al treball d'agent a escala de repositori; Actualment, GitHub recomana almenys una finestra de context de 128.000 testimonis per als models personalitzats de Copilot CLI; - no fer publicitat toolCalling, vision, raonament, context o límits de sortida per sobre de la capacitat real del model Model Gate seleccionat; - Proveu el model exacte al Model Gate Playground abans d'habilitar-lo per a un equip gran.

Si configureu manualment contextWindow, maxInputTokens, o maxOutputTokens a VS Code, utilitzeu els límits del model seleccionat dels autenticats /models pàgina o des de GET /v1/models; no els endevinis. Model Gate mapeja els camps de la següent manera:

Configuració del codi VS	Camp Model Gate
contextWindow	context_window (el mateix valor que context_length)
maxInputTokens	max_input_tokens
maxOutputTokens	max_output_tokens

El autenticat /models la pàgina els mostra com a Context, Entrada màxima, i Sortida màxima quan es coneix el valor corresponent. Per inspeccionar l'objecte API directament:

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}'

Un valor de 0 significa que Model Gate no té un valor configurat per a aquest límit. En aquest cas, deixeu la configuració del codi VS manual corresponent desactivada en lloc d'introduir-la 0 o inventar un límit.

Models d'utilitat en VS Code

VS Code també utilitza models de fons més petits per a tasques com ara títols, resums, missatges de confirmació, suggeriments de canvi de nom i detecció d'intencions.

Si utilitzeu Model Gate BYOK sense un model Copilot allotjat a GitHub, configureu:

chat.utilityModel
chat.utilitySmallModel

Trieu un model Model Gate ràpid i econòmic chat.utilitySmallModel. Normalment no hi ha cap benefici en pagar el model de raonament més gran per a la generació de missatges de compromís o altres treballs d'utilitat lleugera.

El chat.byokUtilityModelDefault La configuració també pot controlar si el treball d'utilitat segueix el model d'agent principal de BYOK seleccionat, utilitza models d'utilitat GitHub Copilot o no té cap predeterminat.

Copilot CLI

GitHub Copilot La CLI admet proveïdors personalitzats compatibles amb OpenAI mitjançant variables d'entorn.

Linux o 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 ```

Per a Copilot CLI, el model seleccionat ha de ser compatible crida d'eines i streaming. Utilitzeu un model o àlies de Model Gate habilitat i proveu-lo abans de fer que la configuració sigui permanent.

No col·loqueu la clau de l'API a l'historial de l'intèrpret d'ordres, un fitxer de repositori o un commit .env. Utilitzeu el vostre magatzem de credencials del sistema operatiu, l'entorn d'intèrpret d'ordres protegit o les eines de gestió de secrets de l'organització sempre que sigui possible.

Copilot Empresa i Empresa

GitHub també admet models personalitzats d'organització/empresa mitjançant BYOK. GitHub apareix actualment Proveïdors compatibles amb OpenAI com a categoria de proveïdor de model personalitzat compatible. Aquesta capacitat a nivell d'organització la gestiona la política de GitHub i pot estar en vista prèvia en funció de la superfície de Copilot.

Per a una organització gestionada:

1. Habiliteu GitHub models personalitzats / BYOK política necessària per al vostre pla Copilot. 2. Afegiu un proveïdor/model personalitzat compatible amb OpenAI a la configuració del model Copilot d'organització o empresa. 3. Utilitzeu una clau d'API Model Gate dedicada amb els permisos i límits mínims necessaris per a Model Gate. 4. Utilitzeu el punt final de Model Gate i un ID de model al qual pugui accedir el vostre compte. 5. Valideu el model als fluxos de treball de Copilot Chat/agent abans d'exposar-lo de manera àmplia al selector de models d'organització.

GitHub pot canviar la interfície d'usuari del model personalitzat de l'organització mentre la funció evoluciona. Seguiu la interfície d'usuari administrativa actual de GitHub per obtenir les etiquetes de camp exactes en lloc de confiar en captures de pantalla d'una versió anterior.

Recomanacions de seguretat i costos

- Creeu una clau Model Gate dedicada per a Copilot en lloc de compartir una clau d'ús general. - Apliqueu un límit de RPM, un límit de concurrència, un límit de despesa o una política de grup empresarial adequada per al trànsit de desenvolupadors-agents. - Gireu la clau immediatament si s'enganxa al control de font, al xat, als registres o a un problema. - No et comprometis mai mg_live_... en chatLanguageModels.json; permet que VS Code emmagatzemi la credencial o faci referència a una entrada/secret. - Mantingueu activades les aprovacions d'eines destructives tret que el vostre entorn de desenvolupament estigui intencionadament en una zona de sorra. - El mode d'agent pot generar molts girs de model/eina a partir d'una instrucció d'usuari. Establiu límits de despesa de Model Gate abans d'habilitar models de raonament cars per a dipòsits grans. - Utilitzeu un model d'utilitat més petit per a tasques de fons i reserveu models de raonament més grans per a la planificació, la depuració o els refactors complexos. - Comproveu l'historial de sol·licituds de Model Gate quan investigueu costos inesperats, latència, límit de velocitat o errors del proveïdor.

Què fa i què no substitueix BYOK

Un model BYOK de Model Gate pot alimentar el xat de VS Code, els fluxos de treball de l'agent, les eines i les tasques d'utilitat quan el model admet les capacitats requerides.

Ho fa no substitueix automàticament cada funció GitHub Copilot. Depenent de la versió actual de VS Code/GitHub, característiques com ara les finalitzacions de codi en línia estàndard, la cerca semàntica, les incrustacions o altres serveis allotjats a GitHub encara poden requerir l'autenticació de GitHub, un pla Copilot o una infraestructura de GitHub.

Per tant, utilitzeu Model Gate BYOK quan el vostre objectiu sigui controlar el camí del model de xat/agent i la seva facturació, no com una hipòtesi que tot el trànsit de xarxa GitHub Copilot s'encamina a través de Model Gate.

Verifiqueu Model Gate abans de provar Copilot

Respostes

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"
  }'

Finalitzacions de xat

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"}]
  }'

Si aquestes sol·licituds fallen, corregiu la política de clau/model/model de l'API abans de depurar Copilot.

Resolució de problemes

Problema	Resolució
El model no apareix en mode d'agent	Verifiqueu que el model estigui configurat amb la crida d'eines i que el model de Model Gate real admeti les trucades de funció/eina. Reinicieu VS Code després de canviar la configuració del proveïdor.
401 invalid_api_key	Torneu a introduir o gireu la clau dedicada Model Gate. Confirmeu els enviaments de Copilot Authorization: Bearer ....
404 o punt final equivocat	Per a les respostes, utilitzeu l'explícit https://api.model-gate.com/v1/responses; per utilitzar les finalitzacions de xat /v1/chat/completions.
No s'ha trobat el model	Consulta /v1/models i utilitzeu un identificador canònic o àlies habilitat.
L'agent no pot utilitzar eines	Seleccioneu un model amb una trucada d'eina/funció verificada. Copilot CLI també requereix streaming.
La imatge adjunta s'ignora/rebutja	Utilitzeu un model amb capacitat d'entrada/visió d'imatge verificada i configureu-lo vision: true només per aquest model.
Les funcions d'utilitat no funcionen amb la configuració només de BYOK	Configura chat.utilityModel i chat.utilitySmallModel als models BYOK disponibles.
Les finalitzacions en línia encara fan servir GitHub o requereixen iniciar sessió	S'esperava: BYOK controla principalment el trànsit del xat/agent/model d'utilitat, no totes les funcions de Copilot.
Les sol·licituds són inesperadament cares	Utilitzeu un model més petit per a treballs d'utilitat, reduïu el raonament si escau i configureu els límits de despesa/RPM/concurrència de Model Gate.

Referències actuals aigües amunt

GitHub i VS Code poden canviar la configuració de BYOK entre versions. Per al comportament actual aigües amunt, comproveu:

- 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