Conecta la CLI de GitHub Copilot

Usa la CLI de GitHub Copilot con modelos, herramientas MCP y habilidades a través de Unity Gateway. La CLI de Unity Gateway (ug) gestiona el inicio de sesión y la configuración del espacio de trabajo. También puedes configurar las conexiones manualmente.

Antes de empezar

Necesitas la URL de tu espacio de trabajo de Azure Databricks y el acceso a los modelos, servicios MCP y habilidades que quieres usar. Para la configuración manual, instala la CLI de GitHub Copilot y ten un token de acceso personal de Azure Databricks.

Si tu administrador ya ha configurado tu dispositivo, sigue las instrucciones de configuración de tu organización.

Utiliza la CLI de Unity Gateway

Instala ug, y luego ejecuta este comando desde el directorio de tu proyecto:

ug copilot

Sigue las indicaciones para seleccionar tu espacio de trabajo e iniciar sesión. El comando abre la CLI de GitHub Copilot con un modelo configurado. Empieza a usar las mismas indicaciones y comandos que ya usas.

Para empezar con un modelo diferente disponible en tu espacio de trabajo:

ug copilot --model "<model-name>"

Utiliza el nombre completo del Catálogo de Unity del modelo, como system.ai.claude-sonnet-4-6. La integración actual ug configura los modelos Claude y GPT para la CLI de Copilot.

Configurar los modelos manualmente

Establece estas variables en tu terminal:

export COPILOT_PROVIDER_TYPE="openai"
export COPILOT_PROVIDER_BASE_URL="https://<workspace-hostname>/ai-gateway/mlflow/v1"
export COPILOT_PROVIDER_BEARER_TOKEN="<databricks-pat>"
export COPILOT_MODEL="system.ai.claude-sonnet-4-6"
export COPILOT_OFFLINE="true"

Sustituye el nombre de host, el token y el nombre del modelo. El tipo de openai proveedor selecciona la API de Completación de Chat del gateway, incluso cuando se utiliza un modelo Claude. El modo offline desactiva las conexiones a los servidores de GitHub; las solicitudes de modelo siguen yendo a Unity Gateway.

Comienza la CLI de Copilot desde el mismo terminal:

copilot

Consulta la documentación del proveedor de modelos personalizados de GitHub para estas configuraciones.

Añadir herramientas MCP

Utiliza la CLI de Unity Gateway

¡Corre!

ug mcp add --agents copilot

Selecciona los servicios que quieres añadir y luego comienza una nueva sesión con ug copilot. Dentro de Copilot, entra /mcp para ver los servidores conectados. Pide al agente que use una herramienta describiendo lo que necesitas.

ug copilot carga las conexiones MCP registradas por ug. Sigue usándola para empezar tus sesiones.

Configurar los servicios MCP manualmente

Fusiona esta entrada en ~/.copilot/mcp-config.json:

{
  "mcpServers": {
    "dbsql": {
      "type": "http",
      "url": "https://<workspace-hostname>/ai-gateway/mcp-services/system.ai.dbsql",
      "headers": {
        "Authorization": "Bearer <databricks-pat>"
      },
      "tools": ["*"]
    }
  }
}

Cambia el nombre de host y el token. Para otro servicio, utiliza un nombre de servidor único y sustituye system.ai.dbsql por su nombre de Unity Catalog de tres partes. Mantén las entradas existentes en el servidor y luego reinicia la CLI de Copilot.

Consulta la documentación MCP de GitHub.

Adición de aptitudes

Utiliza la CLI de Unity Gateway

Descargar habilidades publicadas:

ug skills add

Elige las habilidades que quieres usar. Copilot CLI lee los archivos descargados de ~/.agents/skills/. Inicia una nueva sesión o introduce /skills reload; luego usa /skills list para verlos. Reejecuta el comando de descarga para obtener versiones actualizadas.

Configurar habilidades manualmente

Para los archivos de skill que ya tienes, coloca la carpeta completa, incluyendo SKILL.md y los archivos incluidos en el paquete, en ~/.agents/skills/ o en la carpeta .github/skills/ de tu proyecto. Consulta la documentación de habilidades de GitHub.

Para acceder al registro de habilidades publicado a través de MCP, añade un segundo servidor usando la configuración MCP anterior. Nombra la databricks-skill-registry palabra y usa esta URL con la misma autenticación de portador:

https://<workspace-hostname>/ai-gateway/skills/

Mantén la barra de arrastre. Reinicia la CLI de Copilot y pídele que use una habilidad publicada junto a su nombre completo. Se puede acceder a las habilidades del Registry a través de MCP; /skills list muestra las habilidades instaladas.

Las habilidades de Unity Gateway están en Beta. Consulta Habilidades de Gobierno para habilitación y permisos.

Troubleshooting

Falla una solicitud de modelo: Comprueba la URL de la pasarela, la expiración del token, el nombre completo del modelo y los permisos del modelo. La integración actual ug excluye los modelos Gemini de la CLI de Copilot debido a un problema de compatibilidad de solicitudes.

Falta un servidor MCP: Si lo registraste con ug, reinicia con ug copilot. Para la configuración manual, comprueba ~/.copilot/mcp-config.json y los detalles de conexión en /mcp.

Falta una habilidad descargada: Comprueba que su carpeta esté SKILL.md en un directorio soportado y luego introduce /skills reload.

Para problemas de inicio de sesión o de configuración del ug espacio de trabajo, ejecuta ug doctor.

Pasos siguientes

  • Last updated on