Utilize custom agents
A custom agent é uma versão especializada de Copilot. Custom agents ajudar Copilot a lidar com workflows exclusivos, convenções específicas de codificação e casos de uso especializados.
Copilot CLI inclui um grupo padrão custom agents para tarefas comuns:
| Agente | Description |
|---|---|
| Explorar | Executa uma análise rápida da base de código, permitindo que você faça perguntas sobre seu código sem adicionar ao contexto principal. |
| Tarefa | Executa comandos como testes e compilações, fornecendo breves resumos em caso de sucesso e saída completa em caso de falha. |
| Uso geral | Lida com tarefas complexas e de várias etapas que exigem o conjunto de ferramentas completo e o raciocínio de alta qualidade, em execução em um contexto separado para manter sua conversa principal claramente focada. |
| Revisão de código | Revê as mudanças com o foco em destacar apenas problemas genuínos, minimizando o ruído. |
O modelo de IA que está sendo usado pela CLI pode optar por delegar uma tarefa a um processo de subagente subsidiário, que opera usando um custom agent com experiência específica, se julgar que isso resultaria em uma conclusão mais eficaz do trabalho. O modelo pode igualmente escolher lidar com o trabalho diretamente no agente principal.
Você pode definir sua própria custom agents usando arquivos Markdown, chamados agent profiles, que especificam qual experiência o agente deve ter, quais ferramentas ele pode usar e quaisquer instruções específicas sobre como ele deve responder.
Você pode definir custom agents no nível de usuário, repositório, organização ou empresa:
| Tipo | Localização | Scope |
|---|---|---|
| Nível do usuário custom agent | diretório local ~/.copilot/agents | Todos os projetos |
| Nível do repositório custom agent | ||
.github/agents diretório em seus repositórios locais e remotos | Projeto atual | |
| Nível da organização custom agent | O diretório /agents no repositório .github ou .github-private da organização | Todos os projetos dentro da organização |
| Nível empresarial custom agent | O diretório /agents no repositório .github-private de uma organização designada em configurações corporativas. Para obter mais informações, consulte Preparando-se para usar agentes personalizados em sua empresa. | Todos os projetos na conta corporativa |
No caso de conflitos de nomenclatura (em que os agentes compartilham o mesmo nome de arquivo), um agente no nível do usuário substitui um agente no nível do repositório, um agente no nível do repositório substitui um agente no nível da organização e um agente no nível da organização substitui um agente de nível empresarial.
Custom agents pode ser usado de três maneiras:
-
Usando o comando de barra na interface interativa da CLI para selecionar na lista de custom agents disponíveis:
/agent -
Chamando o custom agent diretamente em um prompt:
Use the refactoring agent to refactor this code block
Copilot inferirá automaticamente o agente que você deseja usar.
-
Especificando a opção custom agent de linha de comando que você deseja usar. Por exemplo:
copilot --agent=refactor-agent --prompt "Refactor this code block"
Para obter mais informações, consulte Criando agentes personalizados para Copilot cloud agent.
Utilizar habilidades
Você pode criar habilidades para aprimorar a capacidade de Copilot executar tarefas especializadas com instruções, scripts e recursos.
Para obter mais informações, consulte Adicionando habilidades de agente para GitHub Copilot CLI.
Adicionar um servidor MCP
Copilot CLI vem com o GitHub servidor MCP já configurado. Esse servidor MCP permite que você interaja com recursos em GitHub.com— por exemplo, permitindo mesclar solicitações de pull da CLI.
Para estender a funcionalidade disponível para você em Copilot CLI, você pode adicionar mais servidores MCP:
-
Use o seguinte comando de barra:
/mcp add -
Preencha os detalhes do servidor de MCP que você deseja adicionar, usando a tecla Tab para mover-se entre os campos.
-
Pressione Ctrl+S para salvar os detalhes.
Os detalhes dos servidores de MCP configurados são armazenados no arquivo mcp-config.json, que está localizado, por padrão, no diretório ~/.copilot. Esse local pode ser alterado definindo a variável de ambiente COPILOT_HOME. Para obter informações sobre a estrutura JSON de uma definição de servidor, consulte Configurar servidores MCP para seu repositório.
Para obter informações mais detalhadas sobre como adicionar e gerenciar servidores Copilot CLIMCP, consulte Adicionando servidores MCP para GitHub Copilot CLI.
Próximas Etapas
Para saber como orientar e refinar o comportamento do agente durante a execução da tarefa para manter o trabalho no controle, consulte Direcionando agentes no GitHub Copilot CLI.