Invocando agentes personalizados

Use agentes personalizados, habilidades e servidores MCP no CLI do Copilot para expandir seus recursos.

Quem pode usar esse recurso?

CLI do GitHub Copilot está disponível com todos os Copilot planos. Se você receber Copilot de uma organização, a CLI do Copilot política deverá ser habilitada nas configurações da organização.

Neste artigo

Utilize agentes personalizados

A agente personalizado é uma versão especializada de Copilot. Agentes personalizados ajudar Copilot a lidar com workflows exclusivos, convenções específicas de codificação e casos de uso especializados.

          CLI do Copilot inclui um grupo padrão 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 subagente subsidiário, que opera usando um agente personalizado 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 agentes personalizados usando arquivos Markdown, chamados 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:

TipoLocalidadeScope
Nível do usuário agente personalizadodiretório local ~/.copilot/agentsTodos os projetos
Nível do repositório agente personalizado
          `.github/agents` diretório em seus repositórios locais e remotos | Projeto atual |

| Organização e nível 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 pode ser usado de três maneiras:

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

    /agent

  • Chamando o agente personalizado 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 agente personalizado de linha de comando que você deseja usar. Por exemplo:

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

Para saber mais, confira Criando agentes personalizados para agente de nuvem Copilot.

Utilizar habilidades

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

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

Adicionar um servidor MCP

          CLI do Copilot 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 CLI do Copilot, você pode adicionar mais servidores 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 nuvem do GitHub Copilot com o Protocolo de Contexto de Modelo (MCP).

Para obter informações mais detalhadas sobre como adicionar e gerenciar servidores CLI do CopilotMCP, 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 Direcionando agentes no CLI do GitHub Copilot.