GitHub Copilot a través de Model Gate

GitHub Copilot y compatibilidad con Visual Studio Code Traiga su propia llave (BYOK) modelos. Model Gate se puede utilizar como un punto final personalizado compatible con OpenAI para los flujos de trabajo de agentes y chat de Copilot.

Para VS Code, la configuración recomendada es la Punto final personalizado proveedor con el API de respuestas. Utilice Finalizaciones de chat solo cuando un modelo o flujo de trabajo seleccionado requiera específicamente esa familia de API.

Valores requeridos

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

Cree una clave API dedicada en el Modelo Panel de control de puerta. Para la integración de un equipo o estación de trabajo, prefiera una clave separada en lugar de reutilizar una clave de producción no relacionada para que los límites, el historial de solicitudes, la rotación y la revocación sigan siendo fáciles de auditar.

Enumere los modelos actualmente habilitados antes de configurar Copilot:

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

Utilice un ID de modelo canónico habilitado o un alias administrado por el administrador devuelto por este punto final.

Código VS: configuración recomendada de punto final personalizado

Las versiones actuales de VS Code exponen modelos BYOK en el editor de modelos de lenguaje.

1. Abra la paleta de comandos. 2. correr Chat: Administrar modelos de lenguaje. 3. Seleccione Agregar modelos. 4. Seleccione Punto final personalizado. 5. Utilice un nombre de grupo como Model Gate. 6. Ingrese la clave API de Model Gate cuando VS Code solicite la credencial del proveedor. 7. Seleccione Respuestas como el tipo de API cuando el modelo seleccionado admite la API de Respuestas. 8. Configure el modelo con el punto final explícito de Model Gate y guarde el generado. chatLanguageModels.json. 9. Seleccione el modelo Model Gate en el selector de modelos de Chat.

No utilices el obsoleto. github.copilot.chat.customOAIModels ajuste para una nueva configuración. El proveedor de punto final personalizado actual admite puntos finales de estilo Respuestas, Finalizaciones de chat y Mensajes y es la ruta de configuración preferida de VS Code.

Configuración de respuestas recomendadas

el generado chatLanguageModels.json Puedo usar una configuración como esta:

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

Reemplazar gpt-5.4 con un modelo o alias Model Gate habilitado.

VS Code normalmente envía la clave API como:

Authorization: Bearer mg_live_...

que es el formulario de autenticación correcto para la API compatible con Model Gate OpenAI.

Reserva de finalización de chat

Si el flujo de trabajo elegido requiere Finalizaciones de Chat, configure el modelo como:

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

Prefiere una URL de punto final completa y explícita. Esto evita la ambigüedad si VS Code cambia el comportamiento de inferencia de ruta URL.

Recomendaciones de capacidad del modelo

Los flujos de trabajo del agente Copilot requieren un modelo que pueda utilizar herramientas. Para un uso confiable de agentes a través de Model Gate:

- elige un modelo con verificado llamada de herramienta/función apoyo; - elige un modelo con transmisión apoyo; - para archivos adjuntos de imágenes, utilice un modelo con verificación entrada de visión/imagen capacidad y conjunto "vision": true para ese modelo; - utilizar un modelo de contexto grande para el trabajo de agentes a escala de repositorio; Actualmente, GitHub recomienda al menos una ventana contextual de 128k token para los modelos personalizados de Copilot CLI; - no hacer publicidad toolCalling, vision, razonamiento, contexto o límites de salida por encima de la capacidad real del modelo Model Gate seleccionado; - Pruebe el modelo exacto en Model Gate Playground antes de habilitarlo para un equipo grande.

Si configura manualmente contextWindow, maxInputTokens, o maxOutputTokens en VS Code, use los límites del modelo seleccionado del autenticado /models página o desde GET /v1/models; no los adivines. Model Gate asigna los campos de la siguiente manera:

Configuración del código VS	Campo de puerta modelo
contextWindow	context_window (mismo valor que context_length)
maxInputTokens	max_input_tokens
maxOutputTokens	max_output_tokens

El autenticado /models La página los muestra como Contexto, Entrada máxima, y Salida máxima cuando se conoce el valor correspondiente. Para inspeccionar el objeto API directamente:

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 tiene un valor configurado para ese límite. En ese caso, deje la configuración manual correspondiente del Código VS sin configurar en lugar de ingresar 0 o inventar un límite.

Modelos de utilidad en VS Code

VS Code también utiliza modelos de fondo más pequeños para tareas como títulos, resúmenes, mensajes de confirmación, sugerencias de cambio de nombre y detección de intenciones.

Si usa Model Gate BYOK sin un modelo Copilot alojado en GitHub, configure:

chat.utilityModel
chat.utilitySmallModel

Elija un modelo de puerta modelo rápido y económico para chat.utilitySmallModel. Por lo general, no existe ningún beneficio en pagar por el modelo de razonamiento más grande para la generación de mensajes de confirmación u otro trabajo de utilidad liviano.

El chat.byokUtilityModelDefault La configuración también puede controlar si el trabajo de servicios públicos sigue el modelo de agente principal BYOK seleccionado, utiliza GitHub Copilot modelos de servicios públicos o no tiene ningún valor predeterminado.

CLI de copiloto

GitHub Copilot CLI admite proveedores personalizados compatibles con OpenAI a través de variables de entorno.

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"

copiloto ```

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"

copiloto ```

Para Copilot CLI, el modelo seleccionado debe admitir llamada y transmisión de herramientas. Utilice un modelo o alias de Model Gate habilitado y pruébelo antes de hacer que la configuración sea permanente.

No coloque la clave API en el historial del shell, en un archivo de repositorio o en un archivo confirmado. .env. Utilice el almacén de credenciales de su sistema operativo, el entorno de shell protegido o las herramientas de administración de secretos de la organización siempre que sea posible.

Copilot Negocios y Empresas

GitHub también admite modelos personalizados de organización/empresa a través de BYOK. GitHub actualmente lista Proveedores compatibles con OpenAI como categoría de proveedor de modelo personalizado compatible. Esta capacidad a nivel de organización se administra mediante la política de GitHub y puede estar en versión preliminar según la superficie de Copilot.

Para una organización administrada:

1. Habilite GitHub modelos personalizados / BYOK póliza requerida para su plan Copilot. 2. Agregue un proveedor/modelo personalizado compatible con OpenAI en la configuración del modelo Copilot de la organización o empresa. 3. Utilice una clave API de Model Gate dedicada con los permisos y límites mínimos necesarios de Model Gate. 4. Utilice el punto final de Model Gate y una identificación de modelo a la que su cuenta pueda acceder. 5. Valide el modelo en los flujos de trabajo de Copilot Chat/agente antes de exponerlo ampliamente en el selector de modelo de organización.

GitHub puede cambiar la interfaz de usuario del modelo personalizado de la organización mientras la función evoluciona. Siga la interfaz de usuario administrativa actual de GitHub para obtener las etiquetas de campo exactas en lugar de depender de capturas de pantalla de una versión anterior.

Recomendaciones de seguridad y costos.

- Cree una clave Model Gate dedicada para Copilot en lugar de compartir una clave de uso general. - Aplique un límite de RPM, un límite de simultaneidad, un límite de gasto o una política de grupo empresarial adecuada para el tráfico de agente desarrollador. - Gire la clave inmediatamente si se pega en el control de fuente, chat, registros o un problema. - Nunca te comprometas mg_live_... en chatLanguageModels.json; permita que VS Code almacene la credencial o haga referencia a una entrada/secreto. - Mantenga habilitadas las aprobaciones de herramientas destructivas a menos que su entorno de desarrollo esté intencionalmente protegido. - El modo agente puede generar muchos giros de modelo/herramienta a partir de una instrucción del usuario. Establezca límites de gasto de Model Gate antes de habilitar modelos de razonamiento costosos para repositorios grandes. - Utilice un modelo de utilidad más pequeño para tareas en segundo plano y reserve modelos de razonamiento más grandes para planificación, depuración o refactorizaciones complejas. - Verifique el historial de solicitudes de Model Gate cuando investigue errores inesperados de costo, latencia, límite de velocidad o proveedor.

Lo que BYOK reemplaza y lo que no reemplaza

Un modelo BYOK de Model Gate puede impulsar el chat de VS Code, los flujos de trabajo de los agentes, las herramientas y las tareas de utilidades cuando el modelo admite las capacidades requeridas.

lo hace no reemplaza automáticamente cada GitHub Copilot característica. Dependiendo de la versión actual de VS Code/GitHub, funciones como la finalización de código en línea estándar, búsqueda semántica, incrustaciones u otros servicios alojados en GitHub aún pueden requerir autenticación de GitHub, un plan Copilot o una infraestructura de GitHub.

Por lo tanto, utilice Model Gate BYOK cuando su objetivo sea controlar el Ruta del modelo de chat/agente y su facturación., no como una suposición de que todo el tráfico de red GitHub Copilot se enruta a través de Model Gate.

Verifique Model Gate antes de probar Copilot

Respuestas

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

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

Si estas solicitudes fallan, corrija la política de clave/modelo/Puerta de modelo de API antes de depurar Copilot.

Solución de problemas

Problema	Resolución
El modelo no aparece en modo agente.	Verifique que el modelo esté configurado con llamadas a herramientas y que el modelo real de Model Gate admita llamadas a funciones/herramientas. Reinicie VS Code después de cambiar la configuración del proveedor.
401 invalid_api_key	Vuelva a ingresar o gire la tecla dedicada Model Gate. Confirmar envíos de Copilot Authorization: Bearer ....
404 o punto final incorrecto	Para respuestas utilice el explícito https://api.model-gate.com/v1/responses; para uso de Finalizaciones de chat /v1/chat/completions.
No se encuentra el modelo	Consulta /v1/models y utilice un ID o alias canónico habilitado.
El agente no puede usar herramientas.	Seleccione un modelo con llamada de herramienta/función verificada. Copilot CLI también requiere transmisión.
La imagen adjunta se ignora/rechaza	Utilice un modelo con capacidad de visión/entrada de imagen verificada y configúrelo vision: true solo para ese modelo.
Las funciones de utilidad no funcionan con la configuración exclusiva de BYOK	Configurar chat.utilityModel y chat.utilitySmallModel a los modelos BYOK disponibles.
Las completaciones en línea aún usan GitHub o requieren inicio de sesión	Se esperaba: BYOK controla principalmente el tráfico de chat/agente/modelo de utilidad, no todas las funciones de Copilot.
Las solicitudes son inesperadamente caras	Utilice un modelo más pequeño para el trabajo de servicios públicos, un razonamiento más bajo cuando corresponda y configure los límites de gasto/RPM/concurrencia de Model Gate.

Referencias upstream actuales

GitHub y VS Code pueden cambiar la configuración BYOK entre versiones. Para conocer el comportamiento ascendente actual, verifique:

- 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