GitHub Copilot

Připojte GitHub Copilot Chat, agenty VS Code a Copilot CLI k Model Gate pomocí BYOK a vlastního koncového bodu kompatibilního s OpenAI.

GitHub Copilot přes modelovou bránu

GitHub Copilot a podpora kódu Visual Studio Přineste si svůj vlastní klíč (BYOK) modely. Model Gate lze použít jako vlastní koncový bod kompatibilní s OpenAI pro chatování Copilot a pracovní postupy agentů.

Pro VS Code je doporučené nastavení Vlastní koncový bod poskytovatel s Responses API. Dokončení chatu použijte pouze v případě, že vybraný model nebo pracovní postup konkrétně vyžaduje tuto rodinu rozhraní API.

Požadované hodnoty

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

Vytvořte vyhrazený klíč API v Ovládací panel modelu Gate. Pro integraci týmu nebo pracovní stanice upřednostňujte samostatný klíč namísto opětovného použití nesouvisejícího produkčního klíče, aby bylo možné snadno auditovat limity, historii požadavků, rotaci a odvolání.

Před konfigurací Copilota vypište aktuálně povolené modely:

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

Použijte povolené kanonické ID modelu nebo alias spravovaný správcem vrácený tímto koncovým bodem.

VS Code: doporučené nastavení vlastního koncového bodu

Aktuální verze kódu VS odhalují modely BYOK v editoru jazykových modelů.

1. Otevřete paletu příkazů. 2. Spustit Chat: Správa jazykových modelů. 3. Vyberte Přidat modely. 4. Vyberte Vlastní koncový bod. 5. Použijte název skupiny, např Model Gate. 6. Když VS Code požaduje pověření poskytovatele, zadejte klíč API modelu brány. 7. Vyberte Odezvy jako typ API, když vybraný model podporuje Responses API. 8. Nakonfigurujte model s explicitním koncovým bodem Model Gate a uložte vygenerovaný chatLanguageModels.json. 9. Vyberte model brány modelu z výběru modelu chatu.

Nepoužívejte zastaralé github.copilot.chat.customOAIModels nastavení pro novou konfiguraci. Aktuální poskytovatel vlastního koncového bodu podporuje odpovědi, dokončování chatu a koncové body ve stylu zpráv a je preferovanou cestou konfigurace kódu VS.

Konfigurace doporučených odpovědí

Vygenerované chatLanguageModels.json lze použít konfiguraci jako je tato:

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

Nahradit gpt-5.4 s povoleným modelem brány modelu nebo aliasem.

VS Code normálně odesílá klíč API jako:

Authorization: Bearer mg_live_...

což je správný ověřovací formulář pro API kompatibilní s Model Gate OpenAI.

Záložní funkce Dokončení chatu

Pokud vybraný pracovní postup vyžaduje dokončení chatu, nakonfigurujte model jako:

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

Preferujte explicitní úplnou adresu URL koncového bodu. Tím se zabrání nejednoznačnosti, pokud VS Code změní chování odvození cesty URL.

Doporučení schopností modelu

Pracovní postupy agenta Copilot vyžadují model, který může používat nástroje. Pro spolehlivé použití agenta prostřednictvím Model Gate:

- vyberte model s ověřeným volání nástroje/funkce podpora; - vyberte si model s streamování podpora; - pro obrazové přílohy použijte model s ověřeným vidění/vstup obrazu schopnosti a nastavení "vision": true pro tento model; - používat model velkého kontextu pro práci agentů v měřítku úložiště; GitHub v současné době doporučuje kontextové okno se 128 000 tokeny pro vlastní modely rozhraní CLI Copilot; - nereklamovat toolCalling, vision, uvažování, kontext nebo výstupní limity nad skutečnou schopností vybraného modelu brány modelu; - otestujte přesný model na hřišti Model Gate, než jej zpřístupníte velkému týmu.

Pokud nastavíte ručně contextWindow, maxInputTokensnebo maxOutputTokens ve VS Code použijte limity vybraného modelu z ověřeného /models stránku nebo z GET /v1/models; nehádejte je. Model Gate mapuje pole následovně:

Nastavení VS kódu	Pole modelové brány
`contextWindow`	`context_window` (stejná hodnota jako `context_length`)
`maxInputTokens`	`max_input_tokens`
`maxOutputTokens`	`max_output_tokens`

Ověřené /models stránka zobrazuje tyto jako Kontext, Max vstupa Maximální výkon když je známa odpovídající hodnota. Chcete-li přímo zkontrolovat objekt 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}'

Hodnota 0 znamená, že Model Gate nemá pro tento limit nakonfigurovanou hodnotu. V takovém případě ponechte odpovídající ruční nastavení kódu VS nenastavené a nezadávejte je 0 nebo vymýšlení limitu.

Užitné vzory ve VS Code

VS Code také používá menší modely na pozadí pro úkoly, jako jsou názvy, souhrny, zprávy odevzdání, návrhy na přejmenování a zjišťování záměrů.

Pokud používáte Model Gate BYOK bez modelu Copilot hostovaného na GitHub, nakonfigurujte:

chat.utilityModel
chat.utilitySmallModel

Vyberte si rychlý a levný model Model Gate pro chat.utilitySmallModel. Platba za největší model uvažování pro generování zpráv o potvrzení nebo jinou nenáročnou pomocnou práci obvykle nepřináší žádnou výhodu.

The chat.byokUtilityModelDefault nastavení může také řídit, zda se užitná činnost řídí vybraným modelem hlavního agenta BYOK, používá užitné modely GitHub Copilot nebo nemá žádné výchozí nastavení.

CLI druhého pilota

GitHub Copilot CLI podporuje vlastní poskytovatele kompatibilní s OpenAI prostřednictvím proměnných prostředí.

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

druhý pilot ```

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"

druhý pilot ```

Pro Copilot CLI musí vybraný model podporovat volání nástroje a streamování. Použijte aktivovaný model brány modelu nebo alias a otestujte jej před tím, než nastavíte konfiguraci na trvalou.

Neumisťujte klíč API do historie shellu, souboru úložiště nebo potvrzení .env. Kde je to možné, používejte úložiště pověření operačního systému, chráněné prostředí shellu nebo nástroje pro správu tajných informací organizace.

Copilot Business and Enterprise

GitHub také podporuje vlastní modely organizací/podniků prostřednictvím BYOK. GitHub aktuálně uvádí Poskytovatelé kompatibilní s OpenAI jako podporovaná kategorie poskytovatelů vlastního modelu. Tato funkce na úrovni organizace je spravována zásadami GitHubu a může být ve verzi Preview v závislosti na povrchu Copilot.

Pro řízenou organizaci:

1. Povolte GitHub vlastní modely / BYOK zásady požadované pro váš plán Copilot. 2. Přidejte vlastního poskytovatele/model kompatibilního s OpenAI v nastavení modelu organizace nebo podnikového Copilota. 3. Použijte vyhrazený klíč Model Gate API s minimálními nezbytnými oprávněními a limity Model Gate. 4. Použijte koncový bod Model Gate a ID modelu, ke kterému má váš účet přístup. 5. Ověřte model v pracovních postupech Copilot Chat/agent, než jej široce zpřístupníte v nástroji pro výběr organizačního modelu.

GitHub může měnit uživatelské uživatelské rozhraní vlastního modelu organizace, zatímco se funkce vyvíjí. Přesná označení polí sledujte podle aktuálního administrativního uživatelského rozhraní GitHubu, než abyste se spoléhali na snímky obrazovky ze starší verze.

Bezpečnostní a cenová doporučení

- Vytvořte vyhrazený klíč Model Gate pro Copilota namísto sdílení klíče pro obecné účely. - Použijte limit RPM, limit souběžnosti, limit útraty nebo zásady obchodní skupiny vhodné pro provoz mezi vývojáři a agenty. - Otočte klíč okamžitě, pokud je vložen do ovládání zdroje, chatu, protokolů nebo problému. - Nikdy se nezavazuj mg_live_... v chatLanguageModels.json; nechat VS Code uložit pověření nebo odkazovat na vstup/tajemství. - Nechte schvalování destruktivních nástrojů povoleno, pokud vaše vývojové prostředí není záměrně sandboxováno. - Režim agenta může generovat mnoho otočení modelu/nástroje z jedné uživatelské instrukce. Před povolením drahých modelů uvažování pro velká úložiště nastavte limity výdajů Model Gate. - Použijte menší užitný model pro úkoly na pozadí a vyhraďte si větší modely uvažování pro plánování, ladění nebo složité refaktory. - Zkontrolujte historii požadavků modelové brány při vyšetřování neočekávaných nákladů, latence, limitu rychlosti nebo chyb poskytovatele.

Co BYOK dělá a co nenahrazuje

Model Model Gate BYOK může podporovat VS Code chat, pracovní postupy agentů, nástroje a pomocné úlohy, pokud model podporuje požadované schopnosti.

To ano ne automaticky nahradit každou funkci GitHub Copilot. V závislosti na aktuální verzi VS Code/GitHub mohou funkce, jako je standardní dokončování vloženého kódu, sémantické vyhledávání, vkládání nebo jiné služby hostované na GitHubu, stále vyžadovat ověření GitHubu, plán Copilot nebo infrastrukturu GitHubu.

Proto použijte Model Gate BYOK, když je vaším cílem ovládat cesta modelu chatu/agenta a její účtování, nikoli za předpokladu, že veškerý síťový provoz GitHub Copilot je směrován přes Model Gate.

Před testováním Copilota ověřte model Gate

Odezvy

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

Dokončení chatu

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

Pokud tyto požadavky selžou, před laděním Copilota opravte zásadu API klíč/model/brána modelu.

Odstraňování problémů

Problém	Rezoluce
Model se nezobrazuje v režimu agenta	Ověřte, zda je model nakonfigurován s voláním nástroje a zda skutečný model brány modelu podporuje volání funkcí/nástrojů. Po změně konfigurace poskytovatele restartujte kód VS.
`401 invalid_api_key`	Znovu zadejte nebo otočte vyhrazený klíč brány modelu. Potvrďte odeslání Copilotem `Authorization: Bearer ...`.
`404` nebo špatný koncový bod	Pro odpovědi použijte explicitní `https://api.model-gate.com/v1/responses`; pro použití Dokončení chatu `/v1/chat/completions`.
Model nebyl nalezen	Dotaz `/v1/models` a použijte povolené kanonické ID nebo alias.
Agent nemůže používat nástroje	Vyberte model s ověřeným voláním nástroje/funkce. Copilot CLI také vyžaduje streamování.
Obrazová příloha je ignorována/odmítnuta	Použijte model s ověřenou schopností vstupu obrazu/vidění a nakonfigurujte jej `vision: true` pouze pro tento model.
Funkce nástroje nefungují s nastavením pouze BYOK	Konfigurovat `chat.utilityModel` a `chat.utilitySmallModel` na dostupné modely BYOK.
Vložená dokončení stále používají GitHub nebo vyžadují přihlášení	Očekáváno: BYOK primárně řídí provoz chatu/agenta/utilitního modelu, ne všechny funkce Copilota.
Žádosti jsou nečekaně drahé	Pro pomocné práce použijte menší model, kde je to vhodné, nižší uvažování a nakonfigurujte limity výdajů/RPM/souběhu Model Gate.

Aktuální upstream reference

GitHub a VS Code mohou změnit konfiguraci BYOK mezi vydáními. Pro aktuální upstream chování zkontrolujte:

- 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