Pular para o conteúdo principal
Última atualização em

Connect GitHub Copilot CLI

Use a CLI do GitHub Copilot com modelos, ferramentas de MCP e habilidades por meio do Unity Gateway. A Unity Gateway CLI (ug) lida com 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 workspace Databricks e de acesso aos modelos, serviços de MCP e competências que deseja usar. Para a configuração manual, instale o GitHub Copilot CLI e tenha um access token pessoal do Databricks.

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

Use a CLI do Unity Gateway​

Instale o ug e execute a execução deste comando no diretório do seu projeto:

Bash
ug copilot

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

Para começar com um modelo diferente disponível no seu workspace:

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

Use the model's full Unity Catalog name, such as system.ai.claude-sonnet-4-6. A integração atual de ug configura os modelos Claude e GPT para a CLI do Copilot.

Configurar modelos manualmente​

Defina estas variáveis no seu terminal:

Bash
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 hostname, o token e o nome do modelo. O tipo de provedor openai seleciona a API Chat Completions do gateway, inclusive ao usar um modelo Claude. O modo offline desativa as conexões com os servidores do GitHub; as solicitações de modelo ainda vão para o Unity Gateway.

Inicie a Copilot CLI no mesmo terminal:

Bash
copilot

Consulte a documentação do provedor de modelos personalizados do GitHub para obter essas configurações.

Add MCP tools​

Use a CLI do Unity Gateway​

execução:

Bash
ug mcp add --agents copilot

Selecione os serviços que você deseja adicionar e, em seguida, comece uma nova sessão com ug copilot. Dentro do Copilot, insira /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-o para começar suas sessões.

Configurar serviços MCP manualmente​

Merge this entry into ~/.copilot/mcp-config.json:

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

Replace the hostname and token. For another serviço, use a unique server name and replace system.ai.dbsql with its three-part Unity Catalog name. Keep existing server entries, then restart Copilot CLI.

Consulte a documentação do MCP do GitHub.

Adicionar habilidades​

Use a CLI do Unity Gateway​

Fazer download de habilidades publicadas:

Bash
ug skills add

Escolha as skills que deseja usar. A Copilot CLI lê os downloads de ~/.agents/skills/. Inicie uma nova sessão ou insira /skills reload, depois use /skills list para vê-los. Execute o comando de download novamente para obter versões atualizadas.

Configurar habilidades manualmente​

Para arquivos de habilidade que você já possui, coloque a pasta completa, incluindo SKILL.md e arquivos empacotados, em ~/.agents/skills/ ou no .github/skills/ do seu projeto. Consulte a documentação de habilidades do GitHub.

To access the published skill registry through MCP, add a second server using the MCP configuration above. Name it databricks-skill-registry and use this URL with the same bearer authentication:

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

Mantenha a barra à direita. Reinicie a CLI do Copilot e peça para ela usar uma habilidade publicada pelo nome completo. As habilidades do registro são acessadas por meio do MCP; /skills list mostra as habilidades instaladas.

As habilidades do Unity Gateway estão em Beta. Consulte Governar habilidades para ver a habilitação e as permissões.

Solução de problemas​

A model request fails: Check the gateway URL, token expiration, full model name, and model permissions. The current ug integration excludes Gemini models from Copilot CLI because of a request compatibility issue.

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

Falta uma skill da qual foi feito o download: verifique se a pasta dela contém SKILL.md em um diretório compatível e, em seguida, insira /skills reload.

For workspace sign-in or ug setup problems, run ug doctor.

Passos seguintes​

Nesta página