GitHub Copilot

Connetti GitHub Copilot Chat, agenti VS Code e CLI Copilot a Model Gate con BYOK e un endpoint personalizzato compatibile con OpenAI.

GitHub Copilot attraverso il Portale Modello

GitHub Copilot e supporto per Visual Studio Code Porta la tua chiave (BYOK) modelli. Model Gate può essere utilizzato come endpoint personalizzato compatibile con OpenAI per la chat Copilot e i flussi di lavoro degli agenti.

Per VS Code, la configurazione consigliata è la Endpoint personalizzato fornitore con il API di risposta. Utilizza i completamenti chat solo quando un modello o un flusso di lavoro selezionato richiede specificamente quella famiglia di API.

Valori richiesti

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

Crea una chiave API dedicata nel file Pannello di controllo modello Gate. Per l'integrazione di un team o di una workstation, preferisci una chiave separata invece di riutilizzare una chiave di produzione non correlata in modo che limiti, cronologia delle richieste, rotazione e revoca rimangano facili da controllare.

Elenca i modelli attualmente abilitati prima di configurare Copilot:

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

Utilizza un ID modello canonico abilitato o un alias gestito dall'amministratore restituito da questo endpoint.

VS Code: configurazione consigliata dell'endpoint personalizzato

Le attuali versioni di VS Code espongono i modelli BYOK nell'editor dei modelli linguistici.

1. Aprire la tavolozza dei comandi. 2. Corri Chat: gestisci modelli linguistici. 3. Seleziona Aggiungi modelli. 4. Seleziona Endpoint personalizzato. 5. Utilizzare un nome di gruppo come Model Gate. 6. Immettere la chiave API Model Gate quando VS Code richiede le credenziali del provider. 7. Seleziona Risposte come tipo API quando il modello selezionato supporta l'API Responses. 8. Configurare il modello con l'endpoint Model Gate esplicito e salvare il file generato chatLanguageModels.json. 9. Seleziona il modello Modello Porta dal selettore modello Chat.

Non utilizzare il deprecato github.copilot.chat.customOAIModels impostazione per una nuova configurazione. L'attuale provider di endpoint personalizzato supporta risposte, completamenti chat ed endpoint in stile messaggi ed è il percorso di configurazione VS Code preferito.

Configurazione delle risposte consigliate

Il generato chatLanguageModels.json può utilizzare una configurazione come questa:

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

Sostituire gpt-5.4 con un modello o alias Model Gate abilitato.

VS Code normalmente invia la chiave API come:

Authorization: Bearer mg_live_...

che è il modulo di autenticazione corretto per l'API compatibile con Model Gate OpenAI.

Fallback Completamenti chat

Se il flusso di lavoro scelto richiede Completamenti chat, configura il modello come:

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

Preferisci un URL endpoint completo esplicito. Ciò evita ambiguità se VS Code modifica il comportamento di inferenza del percorso URL.

Raccomandazioni sulla capacità del modello

I flussi di lavoro dell'agente Copilot richiedono un modello in grado di utilizzare strumenti. Per un utilizzo affidabile dell'agente tramite Model Gate:

- scegli un modello con verificato chiamata di strumento/funzione supporto; - scegli un modello con streaming supporto; - per gli allegati di immagini, utilizzare un modello verificato input di visione/immagine capacità e set "vision": true per quel modello; - utilizzare un modello di contesto di grandi dimensioni per il lavoro degli agenti su scala di repository; GitHub attualmente consiglia una finestra di contesto di almeno 128.000 token per i modelli personalizzati della CLI di Copilot; - non fare pubblicità toolCalling, vision, ragionamento, contesto o limiti di output superiori alla capacità effettiva del modello Model Gate selezionato; - testare il modello esatto nel Model Gate Playground prima di abilitarlo per una squadra numerosa.

Se imposti manualmente contextWindow, maxInputTokens, O maxOutputTokens in VS Code, utilizza i limiti del modello selezionato da quello autenticato /models pagina o da GET /v1/models; non indovinarli. Model Gate mappa i campi come segue:

Impostazione del codice VS	Campo Porta modello
`contextWindow`	`context_window` (stesso valore di `context_length`)
`maxInputTokens`	`max_input_tokens`
`maxOutputTokens`	`max_output_tokens`

L'autenticato /models la pagina li mostra come Contesto, Ingresso massimo, E Potenza massima quando si conosce il valore corrispondente. Per ispezionare direttamente l'oggetto 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}'

Un valore di 0 significa che Model Gate non ha un valore configurato per quel limite. In tal caso, lasciare disattivata l'impostazione manuale del codice VS corrispondente anziché inserirla 0 o inventare un limite.

Modelli di utilità nel codice VS

VS Code utilizza anche modelli di background più piccoli per attività quali titoli, riepiloghi, messaggi di commit, suggerimenti di ridenominazione e rilevamento degli intenti.

Se utilizzi Model Gate BYOK senza un modello Copilot ospitato su GitHub, configura:

chat.utilityModel
chat.utilitySmallModel

Scegli un modello Model Gate veloce ed economico per chat.utilitySmallModel. Solitamente non vi è alcun vantaggio nel pagare per il modello di ragionamento più ampio per la generazione di messaggi di commit o per altri lavori di utilità leggeri.

IL chat.byokUtilityModelDefault L'impostazione può anche controllare se il lavoro dell'utilità segue il modello dell'agente principale BYOK selezionato, utilizza GitHub Copilot modelli di utilità o non ha valori predefiniti.

CLI del copilota

GitHub Copilot La CLI supporta provider personalizzati compatibili con OpenAI tramite variabili di ambiente.

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"

copilota ```

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"

copilota ```

Per Copilot CLI, il modello selezionato deve supportare chiamata e streaming dello strumento. Utilizza un modello o un alias Model Gate abilitato e testalo prima di rendere permanente la configurazione.

Non inserire la chiave API nella cronologia della shell, in un file di repository o in un file commit .env. Ove possibile, utilizza l'archivio credenziali del sistema operativo, l'ambiente shell protetto o gli strumenti di gestione dei segreti dell'organizzazione.

Copilota Affari ed Impresa

GitHub supporta anche modelli personalizzati di organizzazione/impresa tramite BYOK. GitHub attualmente elenca Provider compatibili con OpenAI come categoria di provider di modelli personalizzati supportata. Questa funzionalità a livello di organizzazione è gestita dalla policy GitHub e potrebbe essere in anteprima a seconda della superficie Copilot.

Per un'organizzazione gestita:

1. Abilita GitHub modelli personalizzati / BYOK polizza richiesta per il tuo piano Copilot. 2. Aggiungere un provider/modello personalizzato compatibile con OpenAI nelle impostazioni del modello Copilot dell'organizzazione o dell'azienda. 3. Utilizzare una chiave API Model Gate dedicata con le autorizzazioni e i limiti minimi necessari di Model Gate. 4. Utilizza l'endpoint Model Gate e un ID modello a cui il tuo account può accedere. 5. Convalidare il modello nei flussi di lavoro Copilot Chat/agente prima di esporlo ampiamente nel selettore del modello di organizzazione.

GitHub può modificare l'interfaccia utente del modello personalizzato dell'organizzazione mentre la funzionalità si evolve. Segui l'attuale interfaccia utente amministrativa di GitHub per le etichette esatte dei campi anziché fare affidamento sugli screenshot di una versione precedente.

Raccomandazioni su sicurezza e costi

- Crea una chiave Model Gate dedicata per Copilot invece di condividere una chiave generica. - Applicare un limite RPM, un limite di concorrenza, un limite di spesa o una policy del gruppo aziendale appropriata per il traffico sviluppatore-agente. - Ruotare immediatamente la chiave se viene incollata nel controllo del codice sorgente, nella chat, nei registri o in un problema. - Non impegnarsi mai mg_live_... In chatLanguageModels.json; lasciare che VS Code memorizzi la credenziale o faccia riferimento a un input/segreto. - Mantieni abilitate le approvazioni degli strumenti distruttivi a meno che il tuo ambiente di sviluppo non sia intenzionalmente sandbox. - La modalità agente può generare molti giri di modello/utensile da un'unica istruzione dell'utente. Imposta i limiti di spesa di Model Gate prima di abilitare modelli di ragionamento costosi per repository di grandi dimensioni. - Utilizzare un modello di utilità più piccolo per le attività in background e riservare modelli di ragionamento più ampi per la pianificazione, il debug o refactoring complessi. - Controlla la cronologia delle richieste di Model Gate durante l'analisi di costi imprevisti, latenza, limite di velocità o errori del fornitore.

Ciò che BYOK fa e non sostituisce

Un modello Model Gate BYOK può alimentare la chat VS Code, i flussi di lavoro degli agenti, gli strumenti e le attività di utilità quando il modello supporta le funzionalità richieste.

Lo fa non sostituisci automaticamente ogni GitHub Copilot funzione. A seconda della versione corrente di VS Code/GitHub, funzionalità come i completamenti di codice in linea standard, la ricerca semantica, gli incorporamenti o altri servizi ospitati su GitHub possono ancora richiedere l'autenticazione GitHub, un piano Copilot o un'infrastruttura GitHub.

Pertanto, utilizza Model Gate BYOK quando il tuo obiettivo è controllare il percorso del modello chat/agente e relativa fatturazione, non presupponendo che tutto il traffico di rete GitHub Copilot venga instradato attraverso Model Gate.

Verificare Model Gate prima di testare Copilot

Risposte

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

Completamenti della chat

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

Se queste richieste falliscono, correggi la chiave API/modello/policy Model Gate prima di eseguire il debug di Copilot.

Risoluzione dei problemi

Problema	Risoluzione
Il modello non viene visualizzato in modalità agente	Verificare che il modello sia configurato con la chiamata allo strumento e che il modello effettivo di Model Gate supporti le chiamate a funzione/strumento. Riavviare VS Code dopo aver modificato la configurazione del provider.
`401 invalid_api_key`	Reinserire o ruotare il tasto dedicato Model Gate. Conferma l'invio di Copilot `Authorization: Bearer ...`.
`404` o punto finale sbagliato	Per le risposte utilizzare l'esplicito `https://api.model-gate.com/v1/responses`; per l'utilizzo dei Completamenti Chat `/v1/chat/completions`.
Il modello non è stato trovato	Domanda `/v1/models` e utilizzare un ID canonico o un alias abilitato.
L'agente non può utilizzare gli strumenti	Seleziona un modello con chiamata di strumento/funzione verificata. Anche la CLI di Copilot richiede lo streaming.
L'allegato immagine viene ignorato/rifiutato	Utilizzare un modello con capacità di visione/input di immagini verificate e configurarlo `vision: true` solo per quel modello.
Le funzionalità dell'utilità non funzionano con la configurazione solo BYOK	Configura `chat.utilityModel` E `chat.utilitySmallModel` ai modelli BYOK disponibili.
I completamenti in linea utilizzano ancora GitHub o richiedono l'accesso	Previsto: BYOK controlla principalmente il traffico di chat/agente/modello di utilità, non tutte le funzionalità di Copilot.
Le richieste sono inaspettatamente costose	Utilizza un modello più piccolo per il lavoro dei servizi di pubblica utilità, riduci il ragionamento ove appropriato e configura i limiti di spesa/RPM/concorrenza di Model Gate.

Attuali riferimenti a monte

GitHub e VS Code possono modificare la configurazione BYOK tra le versioni. Per il comportamento upstream attuale, controlla:

- 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