GitHub Copilot

Anslut GitHub Copilot Chat, VS Code-agenter och Copilot CLI till Model Gate med BYOK och en anpassad OpenAI-kompatibel slutpunkt.

GitHub Copilot genom Model Gate

GitHub Copilot och stöd för Visual Studio Code Ta med din egen nyckel (BYOK) modeller. Model Gate kan användas som en OpenAI-kompatibel anpassad slutpunkt för Copilot-chatt och agentarbetsflöden.

För VS-kod är den rekommenderade inställningen Anpassad slutpunkt leverantör med Responses API. Använd chattavslut endast när en vald modell eller arbetsflöde specifikt kräver den API-familjen.

Obligatoriska värden

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

Skapa en dedikerad API-nyckel i Modell Gate kontrollpanel. För en team- eller arbetsstationsintegration, föredrar du en separat nyckel istället för att återanvända en icke-relaterad produktionsnyckel så att begränsningar, förfrågningshistorik, rotation och återkallelse förblir lätta att granska.

Lista för närvarande aktiverade modeller innan du konfigurerar Copilot:

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

Använd ett aktiverat kanoniskt modell-ID eller administratörshanterat alias som returneras av denna slutpunkt.

VS-kod: rekommenderad anpassad slutpunktsinställning

Aktuella VS-kodversioner exponerar BYOK-modeller i språkmodellredigeraren.

1. Öppna kommandopaletten. 2. Kör Chatt: Hantera språkmodeller. 3. Välj Lägg till modeller. 4. Välj Anpassad slutpunkt. 5. Använd ett gruppnamn som t.ex Model Gate. 6. Ange Model Gate API-nyckeln när VS Code begär leverantörsuppgifterna. 7. Välj Svar som API-typ när den valda modellen stöder Responses API. 8. Konfigurera modellen med den explicita Model Gate-ändpunkten och spara den genererade chatLanguageModels.json. 9. Välj Model Gate-modellen från Chat-modellväljaren.

Använd inte det föråldrade github.copilot.chat.customOAIModels inställning för en ny konfiguration. Den nuvarande leverantören av anpassade slutpunkter stöder svar, slutföranden av chatt och slutpunkter i meddelande-stil och är den föredragna konfigurationsvägen för VS-kod.

Rekommenderad svarskonfiguration

Den genererade chatLanguageModels.json kan använda en konfiguration så här:

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

Ersätta gpt-5.4 med en aktiverad Model Gate-modell eller alias.

VS Code skickar normalt API-nyckeln som:

Authorization: Bearer mg_live_...

vilket är det korrekta autentiseringsformuläret för Model Gate OpenAI-kompatibla API.

Alternativ för att slutföra chatt

Om det valda arbetsflödet kräver chattavslut, konfigurera modellen som:

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

Föredrar en explicit fullständig slutpunkts-URL. Detta undviker tvetydighet om VS-koden ändrar URL-sökvägs slutledningsbeteende.

Rekommendationer för modellkapacitet

Copilot-agentarbetsflöden kräver en modell som kan använda verktyg. För pålitlig agentanvändning genom Model Gate:

- välj en modell med verifierad verktyg/funktionsanrop stöd; - välj en modell med streaming stöd; - för bildbilagor, använd en modell med verifierad vision/bildinmatning förmåga och uppsättning "vision": true för den modellen; - använda en stor kontextmodell för agentarbete i förvarsskala; GitHub rekommenderar för närvarande minst ett 128k-token kontextfönster för Copilot CLI anpassade modeller; - annonsera inte toolCalling, vision, resonemang, sammanhang eller utdatagränser över den faktiska kapaciteten för den valda Model Gate-modellen; - testa den exakta modellen i Model Gate Playground innan du aktiverar den för ett stort team.

Om du ställer in manuellt contextWindow, maxInputTokens, eller maxOutputTokens i VS Code, använd den valda modellens gränser från den autentiserade /models sida eller från GET /v1/models; gissa dem inte. Model Gate kartlägger fälten enligt följande:

VS-kodinställning	Modell Gate fält
`contextWindow`	`context_window` (samma värde som `context_length`)
`maxInputTokens`	`max_input_tokens`
`maxOutputTokens`	`max_output_tokens`

Den autentiserade /models sidan visar dessa som Sammanhang, Max ingång, och Max effekt när motsvarande värde är känt. Så här inspekterar du API-objektet direkt:

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

Ett värde på 0 betyder att Model Gate inte har ett konfigurerat värde för den gränsen. Låt i så fall motsvarande manuella VS-kodsinställning vara inställd istället för att gå in 0 eller uppfinna en gräns.

Verktygsmodeller i VS Code

VS Code använder också mindre bakgrundsmodeller för uppgifter som titlar, sammanfattningar, commit-meddelanden, byt namn på förslag och avsiktsdetektering.

Om du använder Model Gate BYOK utan en GitHub-värd Copilot-modell, konfigurera:

chat.utilityModel
chat.utilitySmallModel

Välj en snabb och billig Model Gate-modell för chat.utilitySmallModel. Det finns vanligtvis ingen fördel med att betala för den största resonemangsmodellen för generering av åtagandemeddelanden eller annat lättviktsarbete.

De chat.byokUtilityModelDefault inställningen kan också styra om verktygsarbetet följer den valda BYOK-huvudagentmodellen, använder GitHub Copilot verktygsmodeller eller inte har någon standard.

Copilot CLI

GitHub Copilot CLI stöder OpenAI-kompatibla anpassade leverantörer genom miljövariabler.

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

För Copilot CLI måste den valda modellen stödja verktygssamtal och streaming. Använd en aktiverad Model Gate-modell eller ett alias och testa det innan du gör konfigurationen permanent.

Placera inte API-nyckeln i skalhistoriken, en arkivfil eller en committed .env. Använd din OS-referensbutik, skyddade skalmiljö eller verktyg för organisationshemlighetshantering där det är möjligt.

Copilot Business och Enterprise

GitHub stöder även anpassade modeller för organisation/företag genom BYOK. GitHub listar för närvarande OpenAI-kompatibla leverantörer som en anpassad modellleverantörskategori som stöds. Denna förmåga på organisationsnivå hanteras av GitHub-policyn och kan vara i förhandsvisning beroende på Copilot-ytan.

För en hanterad organisation:

1. Aktivera GitHub anpassade modeller / BYOK policy som krävs för din Copilot-plan. 2. Lägg till en anpassad OpenAI-kompatibel leverantör/modell i organisationens eller företagets Copilot-modellinställningar. 3. Använd en dedikerad Model Gate API-nyckel med minsta nödvändiga Model Gate-behörigheter och gränser. 4. Använd Model Gate-slutpunkten och ett modell-ID som ditt konto kan komma åt. 5. Validera modellen i Copilot Chat/agent-arbetsflöden innan du exponerar den brett i organisationsmodellväljaren.

GitHub kan ändra organisationens anpassade modellgränssnitt medan funktionen utvecklas. Följ det nuvarande administrativa gränssnittet för GitHub för de exakta fältetiketterna istället för att lita på skärmdumpar från en äldre version.

Säkerhets- och kostnadsrekommendationer

- Skapa en dedikerad Model Gate-nyckel för Copilot istället för att dela en generell nyckel. - Tillämpa en RPM-gräns, samtidighetsgräns, utgiftsgräns eller Business group policy som är lämplig för utvecklaragenttrafik. - Vrid nyckeln omedelbart om den klistras in i källkontroll, chatt, loggar eller ett problem. - Begå aldrig mg_live_... i chatLanguageModels.json; låt VS Code lagra referensen eller referera till en ingång/hemlighet. - Håll destruktiva verktygsgodkännanden aktiverade såvida inte din utvecklingsmiljö är avsiktligt sandlåda. - Agentläge kan generera många modell-/verktygsvarv från en användarinstruktion. Ställ in utgiftsgränser för Model Gate innan du aktiverar dyra resonemangsmodeller för stora förråd. - Använd en mindre verktygsmodell för bakgrundsuppgifter och reservera större resonemangsmodeller för planering, felsökning eller komplexa refaktorer. - Kontrollera Model Gate Request History när du undersöker oväntade kostnader, latens, hastighetsgräns eller leverantörsfel.

Vad BYOK gör och inte ersätter

En Model Gate BYOK-modell kan driva VS Code-chatt, agentarbetsflöden, verktyg och verktygsuppgifter när modellen stöder de nödvändiga funktionerna.

Det gör det inte ersätt automatiskt varje GitHub Copilot funktion. Beroende på den aktuella VS Code/GitHub-utgåvan kan funktioner som standardinline-kodkompletteringar, semantisk sökning, inbäddningar eller andra GitHub-värdade tjänster fortfarande kräva GitHub-autentisering, en Copilot-plan eller GitHub-infrastruktur.

Använd därför Model Gate BYOK när ditt mål är att kontrollera chatt/agent modellsökväg och dess fakturering, inte som ett antagande om att all GitHub Copilot nätverkstrafik dirigeras genom Model Gate.

Verifiera Model Gate innan du testar Copilot

Svar

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

Chattavslut

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

Om dessa förfrågningar misslyckas, åtgärda API-nyckeln/modellen/Model Gate-policyn innan du felsöker Copilot.

Felsökning

Problem	Upplösning
Modellen visas inte i agentläge	Verifiera att modellen är konfigurerad med verktygsanrop och att den faktiska Model Gate-modellen stöder funktions-/verktygsanrop. Starta om VS Code efter att ha ändrat leverantörskonfigurationen.
`401 invalid_api_key`	Gå in igen eller vrid den dedikerade Model Gate-nyckeln. Bekräfta att Copilot skickar `Authorization: Bearer ...`.
`404` eller fel slutpunkt	Använd det explicita för svar `https://api.model-gate.com/v1/responses`; för chattavslutningar `/v1/chat/completions`.
Modellen hittades inte	Fråga `/v1/models` och använd ett aktiverat kanoniskt ID eller alias.
Agent kan inte använda verktyg	Välj en modell med verifierat verktyg/funktionsanrop. Copilot CLI kräver också streaming.
Bildbilaga ignoreras/avvisas	Använd en modell med verifierad bildinmatnings-/visionkapacitet och konfigurera `vision: true` bara för den modellen.
Verktygsfunktioner fungerar inte med enbart BYOK-installation	Konfigurera `chat.utilityModel` och `chat.utilitySmallModel` till tillgängliga BYOK-modeller.
Inline-slutföranden använder fortfarande GitHub eller kräver inloggning	Förväntat: BYOK kontrollerar främst chatt-/agent-/verktygsmodelltrafik, inte alla Copilot-funktioner.
Förfrågningar är oväntat dyra	Använd en mindre modell för verktygsarbete, lägre resonemang där så är lämpligt och konfigurera Model Gate-utgifts-/RPM-gränser.

Aktuella uppströmsreferenser

GitHub och VS Code kan ändra BYOK-konfiguration mellan utgåvor. För aktuellt beteende uppströms, kontrollera:

- 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