{"meta":{"title":"Invocando agentes personalizados","intro":"Use agentes personalizados, habilidades e servidores MCP no Copilot CLI para expandir seus recursos.","product":"GitHub Copilot","breadcrumbs":[{"href":"/pt/copilot","title":"GitHub Copilot"},{"href":"/pt/copilot/how-tos","title":"Instruções"},{"href":"/pt/copilot/how-tos/copilot-cli","title":"Copilot CLI"},{"href":"/pt/copilot/how-tos/copilot-cli/use-copilot-cli","title":"Utilize Copilot CLI"},{"href":"/pt/copilot/how-tos/copilot-cli/use-copilot-cli/invoke-custom-agents","title":"Invocar agentes personalizados"}],"documentType":"article"},"body":"# Invocando agentes personalizados\n\nUse agentes personalizados, habilidades e servidores MCP no Copilot CLI para expandir seus recursos.\n\n## Utilize custom agents\n\nA custom agent é uma versão especializada de Copilot.\nCustom agents ajudar Copilot a lidar com workflows exclusivos, convenções específicas de codificação e casos de uso especializados.\n\nCopilot CLI inclui um grupo padrão custom agents para tarefas comuns:\n\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n
AgenteDescription
ExplorarExecuta 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.
TarefaExecuta comandos como testes e compilações, fornecendo breves resumos em caso de sucesso e saída completa em caso de falha.
Uso geralLida 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ódigoRevê as mudanças com o foco em destacar apenas problemas genuínos, minimizando o ruído.
\n\nO 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.\n\nVocê 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.\n\nVocê pode definir custom agents no nível de usuário, repositório, organização ou empresa:\n\n| Tipo | Localização | Scope |\n| ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------- |\n| Nível do usuário custom agent | diretório local `~/.copilot/agents` | Todos os projetos |\n| Nível do repositório custom agent | | |\n| `.github/agents` diretório em seus repositórios locais e remotos | Projeto atual | |\n| 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| 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](/pt/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/prepare-for-custom-agents). | Todos os projetos na conta corporativa |\n\nNo 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.\n\nCustom agents pode ser usado de três maneiras:\n\n* Usando o comando de barra na interface interativa da CLI para selecionar na lista de custom agents disponíveis:\n\n ```shell\n /agent\n ```\n\n* Chamando o custom agent diretamente em um prompt:\n\n ```shell\n Use the refactoring agent to refactor this code block\n ```\n\nCopilot inferirá automaticamente o agente que você deseja usar.\n\n* Especificando a opção custom agent de linha de comando que você deseja usar. Por exemplo:\n\n ```shell\n copilot --agent=refactor-agent --prompt \"Refactor this code block\"\n ```\n\nPara obter mais informações, consulte [Criando agentes personalizados para Copilot cloud agent](/pt/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/create-custom-agents).\n\n## Utilizar habilidades\n\nVocê pode criar habilidades para aprimorar a capacidade de Copilot executar tarefas especializadas com instruções, scripts e recursos.\n\nPara obter mais informações, consulte [Adicionando habilidades de agente para GitHub Copilot CLI](/pt/copilot/how-tos/copilot-cli/customize-copilot/add-skills).\n\n## Adicionar um servidor MCP\n\nCopilot 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.\n\nPara estender a funcionalidade disponível para você em Copilot CLI, você pode adicionar mais servidores MCP:\n\n1. Use o seguinte comando de barra:\n\n ```shell\n /mcp add\n ```\n\n2. Preencha os detalhes do servidor de MCP que você deseja adicionar, usando a tecla Tab para mover-se entre os campos.\n\n3. Pressione Ctrl+S para salvar os detalhes.\n\nOs 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](/pt/copilot/how-tos/copilot-on-github/customize-copilot/configure-mcp-servers#writing-a-json-configuration-for-mcp-servers).\n\nPara obter informações mais detalhadas sobre como adicionar e gerenciar servidores Copilot CLIMCP, consulte [Adicionando servidores MCP para GitHub Copilot CLI](/pt/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers).\n\n## Próximas Etapas \n\nPara 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](/pt/copilot/how-tos/copilot-cli/use-copilot-cli/steer-agents)."}