Custom agents são versões especializadas do Copilot agente que você adapta a tarefas e fluxos de trabalho específicos. Defina uma função uma vez em vez de repetir suas instruções e requisitos de ferramenta sempre que precisar dessa especialização.
Por exemplo, você pode criar um especialista em documentação que siga seus padrões de escrita ou um revisor que possa ler e pesquisar arquivos, mas não precisa de ferramentas de edição.
Sobre os perfis de agente
Um perfil de agente é um arquivo Markdown com frontmatter YAML. Ele descreve a finalidade do agente, fornece instruções e pode restringir suas ferramentas disponíveis. Em ambientes com suporte, um perfil também pode configurar servidores MCP para esse agente.
Use um agente personalizado quando precisar de um papel reutilizável com uma abordagem e um conjunto de ferramentas específicos. Se você precisar apenas de instruções e recursos específicos da tarefa, um skill poderá ser uma opção mais simples. Para ver uma comparação, confira Comparando os recursos de personalização do Copilot.
Os perfis podem ser compartilhados em níveis de repositório, organização e empresa. Copilot CLI também dá suporte a perfis pessoais. Locais de configuração, propriedades com suporte e precedência dependem do ambiente. Consulte Configuração de agentes personalizados.
Onde você pode usar agentes personalizados
Você pode usar agentes personalizados com:
- O GitHub Copilot app.
- GitHub Copilot CLI.
- Copilot cloud agent em GitHub.com, incluindo a guia e o painel de agentes, atribuição de issues e pull requests.
- IDEs com suporte, incluindo Visual Studio Code, Visual Studio, IDEs JetBrains, Eclipse e Xcode.
Agentes personalizados em IDEs JetBrains e no Xcode estão em prévia pública. Para obter suporte de versão e status de lançamento específicos do IDE, consulte matriz de recursos Copilot.
Em um IDE, usar um agente personalizado diretamente no chat é diferente de delegar uma tarefa para Copilot cloud agent. As propriedades de um perfil podem se comportar de forma diferente ou ser ignoradas entre ambientes. Para o comportamento do perfil VS Code, consulte Agentes personalizados em VS Code.
Agentes integrados
Você não precisa definir um agente personalizado para cada tarefa especializada. Copilot CLI inclui agentes internos que o agente principal pode usar para tarefas comuns:
explorepara exploração da base de código-fontetaskpara executar comandosgeneral-purposepara o trabalho que exige um contexto de agente separadocode-reviewpara revisar as alteraçõesresearchpara pesquisarubber-duckpara uma segunda opiniãosecurity-reviewpara revisão focada em segurança
Eles são fornecidos por Copilot CLI, em vez de criados por você como se fossem seus próprios perfis. As ferramentas e os comportamentos disponíveis diferem por agente. Para obter seus recursos e padrões de modelo, consulte agentes integrados.
Agentes e subagentes personalizados
Um agente personalizado é uma definição de um especialista. Um subagente é um agente que está fazendo um trabalho delegado em uma janela de contexto separada. O agente principal pode delegar a um agente interno ou executar um especialista usando um perfil de agente personalizado.
O contexto separado permite que um subagente se concentre em sua tarefa atribuída sem adicionar todos os detalhes intermediários à conversa principal. Tarefas independentes também podem ser executadas em paralelo. Esses são benefícios da delegação, não propriedades que exigem que você crie um perfil personalizado.
Selecionar um agente personalizado para uma sessão e delegar uma subtarefa a um deles são maneiras diferentes de usar um perfil. Em Copilot CLI, as instruções do repositório são incluídas para o agente de sessão, mas não estão incluídas para um subagente personalizado por padrão. Para obter a configuração de adesão e os métodos de invocação, consulte Criando e usando agentes personalizados para GitHub Copilot CLI.
Para obter o modelo de delegação mais abrangente no GitHub Copilot app e Copilot CLI, consulte Delegar e paralelizar o trabalho com agentes.
Próximas Etapas
Escolha o guia de configuração para o local onde você trabalha: