GitHub Copilot

Verbind GitHub Copilot Chat, VS Code-agents en Copilot CLI met Model Gate met BYOK en een aangepast OpenAI-compatibel eindpunt.

GitHub Copilot via Model Gate

GitHub Copilot en Visual Studio Code-ondersteuning Breng uw eigen sleutel mee (BYOK) modellen. Model Gate kan worden gebruikt als een OpenAI-compatibel aangepast eindpunt voor Copilot-chat en agentworkflows.

Voor VS Code is de aanbevolen configuratie de Aangepast eindpunt aanbieder met de Reacties-API. Gebruik Chatvoltooiingen alleen wanneer een geselecteerd model of workflow specifiek die API-familie vereist.

Vereiste waarden

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

Maak een speciale API-sleutel in het Model Poortbedieningspaneel. Voor een team- of werkstationintegratie geeft u de voorkeur aan een afzonderlijke sleutel in plaats van een niet-gerelateerde productiesleutel te hergebruiken, zodat limieten, aanvraaggeschiedenis, rotatie en intrekking eenvoudig te controleren blijven.

Maak een lijst van momenteel ingeschakelde modellen voordat u Copilot configureert:

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

Gebruik een ingeschakelde canonieke model-ID of door de beheerder beheerde alias die door dit eindpunt wordt geretourneerd.

VS-code: aanbevolen aangepaste eindpuntconfiguratie

De huidige VS Code-versies tonen BYOK-modellen in de Taalmodellen-editor.

1. Open het opdrachtenpalet. 2. Rennen Chat: beheer taalmodellen. 3. Selecteer Modellen toevoegen. 4. Selecteer Aangepast eindpunt. 5. Gebruik een groepsnaam zoals Model Gate. 6. Voer de Model Gate API-sleutel in wanneer VS Code om de providerreferenties vraagt. 7. Selecteer Reacties als het API-type wanneer het geselecteerde model de Responses API ondersteunt. 8. Configureer het model met het expliciete Model Gate-eindpunt en sla het gegenereerde op chatLanguageModels.json. 9. Selecteer het Model Gate-model in de Chat-modelkiezer.

Gebruik het verouderde niet github.copilot.chat.customOAIModels instelling voor een nieuwe configuratie. De huidige aangepaste eindpuntprovider ondersteunt antwoorden, chatvoltooiingen en eindpunten in berichtstijl en is het geprefereerde VS Code-configuratiepad.

Aanbevolen antwoordenconfiguratie

De gegenereerde chatLanguageModels.json kan een configuratie als deze gebruiken:

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

Vervangen gpt-5.4 met een ingeschakeld Model Gate-model of alias.

VS Code verzendt normaal gesproken de API-sleutel als:

Authorization: Bearer mg_live_...

wat het juiste authenticatieformulier is voor de Model Gate OpenAI-compatibele API.

Terugval op chatvoltooiingen

Als de gekozen workflow Chat-voltooiingen vereist, configureer het model dan als:

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

Geef de voorkeur aan een expliciete volledige eindpunt-URL. Dit voorkomt dubbelzinnigheid als VS Code het inferentiegedrag van URL-paden verandert.

Aanbevelingen voor modelmogelijkheden

Workflows voor copilot-agenten vereisen een model dat gebruik kan maken van tools. Voor betrouwbaar agentgebruik via Model Gate:

- kies een model met geverifieerd tool/functie oproepen steun; - kies een model met streamen steun; - gebruik voor afbeeldingsbijlagen een model met geverifieerd visie/beeldinvoer mogelijkheden en set "vision": true voor dat model; - gebruik een groot contextmodel voor agentwerk op repositoryschaal; GitHub beveelt momenteel ten minste een contextvenster van 128k-token aan voor aangepaste Copilot CLI-modellen; - maak geen reclame toolCalling, vision, redenering, context of uitvoerlimieten boven de werkelijke mogelijkheden van het geselecteerde Model Gate-model; - test het exacte model in de Model Gate Playground voordat je het inschakelt voor een groot team.

Als u handmatig instelt contextWindow, maxInputTokens, of maxOutputTokens gebruik in VS Code de limieten van het geselecteerde model van het geverifieerde model /models pagina of van GET /v1/models; raad ze niet. Model Gate brengt de velden als volgt in kaart:

VS-code-instelling	Model Poortveld
`contextWindow`	`context_window` (dezelfde waarde als `context_length`)
`maxInputTokens`	`max_input_tokens`
`maxOutputTokens`	`max_output_tokens`

De geauthenticeerde /models pagina toont deze als Context, Maximale invoer, En Maximale output wanneer de overeenkomstige waarde bekend is. Om het API-object rechtstreeks te inspecteren:

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

Een waarde van 0 betekent dat Model Gate geen geconfigureerde waarde voor die limiet heeft. Laat in dat geval de corresponderende handmatige VS Code-instelling uitgeschakeld en voer deze niet in 0 of een limiet bedenken.

Gebruiksmodellen in VS Code

VS Code gebruikt ook kleinere achtergrondmodellen voor taken zoals titels, samenvattingen, commit-berichten, suggesties voor hernoemen en intentiedetectie.

Als u Model Gate BYOK gebruikt zonder een door GitHub gehost Copilot-model, configureert u:

chat.utilityModel
chat.utilitySmallModel

Kies voor een snel en voordelig Model Gate-model chat.utilitySmallModel. Er zit meestal geen voordeel in het betalen voor het grootste redeneermodel voor het genereren van commit-berichten of ander lichtgewicht nutswerk.

De chat.byokUtilityModelDefault De instelling kan ook bepalen of nutsvoorzieningen het geselecteerde BYOK-hoofdagentmodel volgen, GitHub Copilot nutsmodellen gebruiken of geen standaard hebben.

Copiloot CLI

GitHub Copilot CLI ondersteunt OpenAI-compatibele aangepaste providers via omgevingsvariabelen.

Linux of 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"

copiloot ```

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"

copiloot ```

Voor Copilot CLI moet het geselecteerde model ondersteuning bieden tool bellen en streamen. Gebruik een ingeschakeld Model Gate-model of alias en test het voordat u de configuratie permanent maakt.

Plaats de API-sleutel niet in de shell-geschiedenis, een repositorybestand of een commit .env. Gebruik waar mogelijk uw OS-referentieopslag, beschermde shell-omgeving of tools voor geheimbeheer van uw organisatie.

Copiloot Zakelijk en Enterprise

GitHub ondersteunt ook aangepaste modellen voor organisaties/ondernemingen via BYOK. GitHub vermeldt momenteel OpenAI-compatibele providers als een ondersteunde providercategorie voor aangepaste modellen. Deze mogelijkheid op organisatieniveau wordt beheerd door GitHub-beleid en kan beschikbaar zijn als preview-versie, afhankelijk van het Copilot-oppervlak.

Voor een beheerde organisatie:

1. Schakel de GitHub in aangepaste modellen / BYOK beleid vereist voor uw Copilot-abonnement. 2. Voeg een aangepaste OpenAI-compatibele provider/model toe in de Copilot-modelinstellingen van de organisatie of onderneming. 3. Gebruik een speciale Model Gate API-sleutel met de minimaal noodzakelijke Model Gate-machtigingen en -limieten. 4. Gebruik het Model Gate-eindpunt en een model-ID waartoe uw account toegang heeft. 5. Valideer het model in Copilot Chat/agent-workflows voordat u het breed openbaar maakt in de organisatiemodelkiezer.

GitHub kan de gebruikersinterface van het aangepaste model van de organisatie wijzigen terwijl de functie zich ontwikkelt. Volg de huidige administratieve gebruikersinterface van GitHub voor de exacte veldlabels in plaats van te vertrouwen op schermafbeeldingen uit een oudere release.

Beveiligings- en kostenaanbevelingen

- Maak een speciale Model Gate-sleutel voor Copilot in plaats van een sleutel voor algemeen gebruik te delen. - Pas een RPM-limiet, gelijktijdigheidslimiet, bestedingslimiet of bedrijfsgroepsbeleid toe dat geschikt is voor verkeer tussen ontwikkelaars en agenten. - Draai de sleutel onmiddellijk om als deze in bronbeheer, chat, logboeken of een probleem wordt geplakt. - Nooit plegen mg_live_... in chatLanguageModels.json; laat VS Code de referentie opslaan of naar een invoer/geheim verwijzen. - Houd destructieve toolgoedkeuringen ingeschakeld, tenzij uw ontwikkelomgeving opzettelijk in een sandbox is geplaatst. - De Agent-modus kan uit één gebruikersinstructie vele model-/gereedschapswisselingen genereren. Stel de bestedingslimieten van Model Gate in voordat u dure redeneringsmodellen voor grote opslagplaatsen inschakelt. - Gebruik een kleiner gebruiksmodel voor achtergrondtaken en reserveer grotere redeneermodellen voor planning, debuggen of complexe refactoren. - Controleer de Model Gate Request History bij het onderzoeken van onverwachte kosten, latentie, snelheidslimieten of providerfouten.

Wat BYOK wel en niet vervangt

Een Model Gate BYOK-model kan VS Code-chat, agentworkflows, tools en hulpprogrammataken aandrijven wanneer het model de vereiste mogelijkheden ondersteunt.

Dat doet het niet vervang automatisch elk GitHub Copilot-element. Afhankelijk van de huidige versie van VS Code/GitHub kunnen functies zoals standaard inline codeaanvullingen, semantisch zoeken, insluitingen of andere door GitHub gehoste services nog steeds GitHub-authenticatie, een Copilot-abonnement of GitHub-infrastructuur vereisen.

Gebruik daarom Model Gate BYOK als het uw doel is om de chat/agent-modelpad en de facturering ervan, niet als aanname dat al het GitHub Copilot netwerkverkeer via Model Gate wordt gerouteerd.

Verifieer Model Gate voordat u Copilot test

Reacties

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

Chat-voltooiingen

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

Als deze verzoeken mislukken, corrigeer dan het API-sleutel/model/Model Gate-beleid voordat u fouten in Copilot opspoort.

Problemen oplossen

Probleem	Oplossing
Model verschijnt niet in agentmodus	Controleer of het model is geconfigureerd met het aanroepen van tools en of het daadwerkelijke Model Gate-model functie-/toolaanroepen ondersteunt. Start VS Code opnieuw nadat u de providerconfiguratie hebt gewijzigd.
`401 invalid_api_key`	Voer de speciale Model Gate-sleutel opnieuw in of draai deze. Bevestig dat Copilot verzendt `Authorization: Bearer ...`.
`404` of verkeerd eindpunt	Gebruik voor reacties de expliciete `https://api.model-gate.com/v1/responses`; voor gebruik van Chat-voltooiingen `/v1/chat/completions`.
Model is niet gevonden	Vraag `/v1/models` en gebruik een ingeschakelde canonieke ID of alias.
Agent kan geen tools gebruiken	Selecteer een model met geverifieerde tool-/functieaanroep. Copilot CLI vereist ook streaming.
Afbeeldingsbijlage wordt genegeerd/geweigerd	Gebruik een model met geverifieerde beeldinvoer/visiemogelijkheden en configureer `vision: true` alleen voor dat model.
Hulpprogrammafuncties werken niet bij een configuratie met alleen BYOK	Configureer `chat.utilityModel` En `chat.utilitySmallModel` naar beschikbare BYOK-modellen.
Inline voltooiingen gebruiken nog steeds GitHub of vereisen aanmelding	Verwacht: BYOK beheert voornamelijk het chat-/agent-/utiliteitsmodelverkeer, niet elke Copilot-functie.
Verzoeken zijn onverwacht duur	Gebruik een kleiner model voor nutsvoorzieningen, beperk de redenering waar nodig en configureer de limieten voor uitgaven/RPM/gelijktijdigheid van Model Gate.

Huidige upstream-referenties

GitHub en VS Code kunnen de BYOK-configuratie tussen releases wijzigen. Voor het huidige stroomopwaartse gedrag, controleer:

- 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