Invocando agentes personalizados

Usar agentes personalizados

Um agente personalizado é uma versão especializada do Copilot. Agentes personalizados ajuda Copilot lidar com fluxos de trabalho exclusivos, convenções de codificação específicas e casos de uso especializado.

CLI do Copilot inclui um grupo padrão de agentes personalizados para tarefas comuns:

Agente	Descrição
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 um subagente subsidiário, que opera usando um agente personalizado especializado, se ele julgar que isto resultaria na conclusão do trabalho de forma mais eficaz. O modelo pode igualmente escolher lidar com o trabalho diretamente no agente principal.

Você pode definir seu próprio agentes personalizados usando arquivos Markdown, chamado perfis de agente, 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 agentes personalizados no nível de usuário, repositório ou organização/empresa:

Tipo	Localidade	Scope
Nível de usuário agente personalizado	diretório local ~/.copilot/agents	Todos os projetos
Nível de repositório agente personalizado	.github/agents diretório em seus repositórios locais e remotos	Projeto atual
Nível organizacional e empresarial agente personalizado	/agents diretório no repositório .github-private em uma organização ou corporação	Todos os projetos sob sua organização e conta empresarial

No caso de conflitos de nomenclatura, um agente no nível do sistema substitui um agente no nível do repositório e o agente no nível do repositório substituiria um agente no nível da organização.

Agentes personalizados podem ser usados de três maneiras:

• Usando o comando barra na interface interativa da CLI para selecionar na lista de dados disponíveis agentes personalizados:

  /agent
  

• Invocando agente personalizado diretamente em uma solicitação:

  Use the refactoring agent to refactor this code block
  

  Copilot inferirá automaticamente o agente que você deseja usar.

• Especificando o agente personalizado que você deseja usar com a opção de linha de comando. Por exemplo:

  copilot --agent=refactor-agent --prompt "Refactor this code block"
  

Para saber mais, confira Criando agentes personalizados para agente de codificação Copilot.

Utilizar habilidades

Você pode criar habilidades para aprimorar a capacidade do Copilot de executar tarefas especializadas com instruções, scripts e recursos.

Para saber mais, confira Criando habilidades de agente para CLI do GitHub Copilot.

Adicionar um servidor MCP

A CLI do Copilot vem com o servidor de MCP do GitHub já configurado. Esse servidor de MCP permite que você interaja com recursos no GitHub.com, por exemplo, permitindo mesclar pull requests na CLI.

Para estender a funcionalidade disponível para você na CLI do Copilot, você pode adicionar mais servidores de MCP:

1. Use o seguinte comando de barra:

   /mcp add
   

2. Preencha os detalhes do servidor de MCP que você deseja adicionar, usando a tecla Tab para mover-se entre os campos.

3. 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 Estendendo o agente de codificação do GitHub Copilot com o protocolo de contexto do modelo (MCP).

Para obter informações mais detalhadas sobre como adicionar e gerenciar servidores MCP no CLI do Copilot, consulte Adicionando servidores MCP para CLI do GitHub Copilot.

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 Controle de agentes em CLI do GitHub Copilot.