Conecte a CLI do GitHub Copilot

Use a CLI do GitHub Copilot com modelos, ferramentas MCP e habilidades através do Unity Gateway. A CLI do Gateway Unity (ug) gerencia o login e a configuração do workspace. Você também pode configurar as conexões manualmente.

Antes de começar

Você precisa da URL do seu espaço de trabalho do Azure Databricks e acesso aos modelos, serviços MCP e habilidades que deseja usar. Para configuração manual, instale a CLI do GitHub Copilot e tenha um token de acesso pessoal do Azure Databricks.

Se seu administrador já configurou seu dispositivo, siga as instruções de configuração da sua organização.

Use o CLI do Unity Gateway

Instale ug, então execute este comando a partir do diretório do seu projeto:

ug copilot

Siga as instruções para selecionar seu espaço de trabalho e fazer login. O comando abre a CLI do GitHub Copilot com um modelo configurado. Comece a trabalhar com os mesmos prompts e comandos que você já usa.

Para começar com um modelo diferente disponível no seu espaço de trabalho:

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

Use o nome completo do Catálogo Unity do modelo, como system.ai.claude-sonnet-4-6. A integração atual ug configura os modelos Claude e GPT para o Copilot CLI.

Configure os modelos manualmente

Defina estas variáveis no seu 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"

Substitua o nome do host, o token e o nome do modelo. O tipo de provedor openai seleciona a API de Conclusões de Chat do gateway, inclusive quando você usa um modelo Claude. O modo offline desativa as conexões aos servidores do GitHub; as requisições de modelo ainda vão para o Unity Gateway.

Comece a CLI do Copilot no mesmo terminal:

copilot

Veja a documentação do GitHub para provedores de modelos personalizados para essas configurações.

Adicionar ferramentas MCP

Use o CLI do Unity Gateway

Execute:

ug mcp add --agents copilot

Selecione os serviços que deseja adicionar e comece uma nova sessão com ug copilot. Dentro do Copilot, entre /mcp para ver os servidores conectados. Peça ao agente para usar uma ferramenta, descrevendo o que você precisa.

ug copilot carrega as conexões MCP registradas por ug. Continue usando para iniciar suas sessões.

Configure os serviços MCP manualmente

Misture esta entrada em ~/.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": ["*"]
    }
  }
}

Substitua o nome do host e o token. Para outro serviço, use um nome único de servidor e substitua system.ai.dbsql pelo nome de três partes do Catálogo Unity. Mantenha as entradas existentes do servidor e depois reinicie a CLI do Copilot.

Veja a documentação MCP do GitHub.

Adicionar habilidades

Use o CLI do Unity Gateway

Baixe habilidades publicadas:

ug skills add

Escolha as habilidades que quer usar. O Copilot CLI lê os arquivos baixados de ~/.agents/skills/. Comece uma nova sessão, ou entre /skills reload, e então use /skills list para vê-los. Execute novamente o comando de download para obter versões atualizadas.

Configurar habilidades manualmente

Para os arquivos de skill que você já possui, coloque a pasta completa, incluindo SKILL.md e os arquivos incluídos, em ~/.agents/skills/ ou em .github/skills/ do seu projeto. Veja a documentação de habilidades do GitHub.

Para acessar o registro de habilidades publicado pelo MCP, adicione um segundo servidor usando a configuração MCP acima. Dê a ele o nome de databricks-skill-registry e use esta URL com a mesma autenticação Bearer:

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

Mantenha a barra final. Reinicie a CLI do Copilot e peça que use uma habilidade publicada usando seu nome completo. As habilidades do registro são acessadas via MCP; /skills list mostra as habilidades instaladas.

As habilidades do Gateway Unity estão em Beta. Veja Habilidades de Governar para habilitação e permissões.

Solução de problemas

Uma requisição de modelo falha: Verifique a URL do gateway, expiração do token, nome completo do modelo e permissões do modelo. A integração ug atual exclui modelos Gemini da CLI do Copilot devido a um problema de compatibilidade de requisição.

Um servidor MCP está faltando: Se você o registrou com ug, reinicie com ug copilot. Para configuração manual, verifique ~/.copilot/mcp-config.json e os detalhes da conexão em /mcp.

Uma habilidade baixada não foi encontrada: Verifique se a pasta dela contém SKILL.md em um diretório compatível e, em seguida, insira /skills reload.

Para problemas de login no workspace ou configuração ug, execute ug doctor.

Próximas Etapas 

  • Last updated on