Criando agentes personalizados para agente de codificação Copilot

Agentes personalizados possibilitam que você adapte a expertise do Copilot para tarefas específicas. Para uma visão geral conceitual de agentes personalizados, consulte Sobre agentes personalizados.

Observação

Agentes personalizados estão em versão prévia pública para IDEs JetBrains, Eclipse e Xcode e estão sujeitos a alterações.

Criando um perfil agente personalizado em um repositório em GitHub

Navegue até a guia agentes em https://github.com/copilot/agents.
Use o menu suspenso na caixa de prompt para selecionar o repositório em que você quer criar o perfil de agente personalizado.

Observação

Os proprietários de organizações e empresas podem criar agentes personalizados de agentes personalizados no nível da organização e da empresa em um repositório .github-private, que ficam disponíveis em todos os repositórios dentro de sua organização ou empresa. Para saber mais, confira Preparando-se para usar agentes personalizados em sua empresa e Preparando-se para usar agentes personalizados em sua organização.
Opcionalmente, selecione o ramo no qual você deseja criar o perfil do agente perfil do agente. O padrão é a ramificação principal.
Clique em e clique em Criar um agente. Isso abrirá um perfil de agente de modelo chamado my-agent.agent.md no diretório .github/agents do repositório de destino.
Se você estiver criando uma organização ou nível empresarial agente personalizado, exclua a parte .github/ do caminho do arquivo para mover seu modelo para o diretório agents raiz.
Edite o nome do arquivo (o texto anterior .agent.md), selecionando um nome exclusivo e descritivo que identifica a finalidade do agente. Observe que o nome do arquivo pode conter apenas os seguintes caracteres: ., , -, _, , a-z, A-Z. 0-9
Configure o perfil do agente, incluindo o nome, a descrição, as ferramentas e os prompts. Para mais informações sobre o que o perfil do agente pode incluir, veja Configuração de um perfil do agente.
Confirme o arquivo no repositório e faça a mesclagem na ramificação padrão. Volte à aba agentes e atualize a página, se necessário. O agente personalizado agora será exibido no menu suspenso ao clicar em na caixa de prompt.

Criando um perfil agente personalizado em Visual Studio Code

Abra o Chat GitHub Copilot no Visual Studio Code.
No menu suspenso de agentes na parte inferior da visualização do chat, selecione Configurar agentes personalizados... e clique em Criar novo agente personalizado.
Defina o local onde o perfil do agente será criado: * Workspace: crie o perfil agente personalizado na pasta .github/agents do seu workspace para usá-lo somente nesse workspace. * Perfil do usuário: crie o perfil agente personalizado na pasta de perfil do usuário atual para que ele seja utilizado em todos os workspaces.
Insira um nome de arquivo para o agente personalizado. O nome padrão exibido no menu suspenso de agentes.
Configure o perfil do agente no arquivo .agent.md recém-criado, adicionando a descrição, as ferramentas e os prompts. Para mais informações sobre o que o perfil do agente pode incluir, veja Configuração de um perfil do agente.
- Você pode usar o botão Configurar Ferramentas... no editor para abrir a caixa de diálogo "Configurar Ferramentas", onde você pode exibir e selecionar ferramentas disponíveis, incluindo ferramentas internas e ferramentas de servidores MCP. Clique OK para adicionar as ferramentas selecionadas ao perfil do agente.
- Para configurar qual modelo de IA o agente utilizará, insira a propriedade model: e escolha o modelo desejado no menu suspenso de preenchimento automático.

Para atualizar um perfil do agente, selecione Configurar agentes personalizados no menu suspenso de agentes e clique em um agente da lista para alterá-lo. Para obter mais detalhes sobre agentes personalizados em VS Code, consulte Agentes personalizados em VS Code.

Criar um perfil agente personalizado em IDEs do JetBrains

Abra a janela Chat GitHub Copilot no IDE do JetBrains.
No menu suspenso de agentes na parte inferior da visualização do chat, clique em Configurar agentes... e, na janela de configurações, em "Agentes de chat", cliquem em Workspace.
Insira um nome de arquivo para o agente personalizado. O nome padrão exibido no menu suspenso de agentes.
Configure o perfil do agente no arquivo .agent.md recém-criado no diretório .github/agents, incluindo a descrição, as ferramentas e os prompts. Para mais informações sobre o que o perfil do agente pode incluir, veja Configuração de um perfil do agente.
- Você pode usar o botão Configurar Ferramentas... no editor para abrir a caixa de diálogo ferramentas, onde você pode exibir e selecionar ferramentas disponíveis, incluindo ferramentas internas e ferramentas de servidores MCP. Clique em Aplicar para adicionar as ferramentas selecionadas ao perfil do agente.
- Para configurar qual modelo de IA o agente utilizará, insira a propriedade model: e escolha o modelo desejado no menu suspenso de preenchimento automático.

Para atualizar um perfil do agente, selecione Configurar agentes personalizados no menu suspenso de agentes e clique em ao lado do agente que quer editar.

Criando um perfil agente personalizado no Eclipse

Abra a janela Chat GitHub Copilot no Eclipse.
No menu suspenso de agentes na parte inferior da visualização do chat, selecione Configurar agentes... e clique em Adicionar....
Insira um nome de arquivo para o agente personalizado. O nome padrão exibido no menu suspenso de agentes.
Configure o perfil do agente no arquivo .agent.md recém-criado no diretório .github/agents, incluindo a descrição, as ferramentas e os prompts. Para mais informações sobre o que o perfil do agente pode incluir, veja Configuração de um perfil do agente.
- Você pode usar o botão Configurar Ferramentas... no editor para abrir a caixa de diálogo "Configurar Ferramentas", onde você pode exibir e selecionar ferramentas disponíveis, incluindo ferramentas internas e ferramentas de servidores MCP. Clique em Aplicar para adicionar as ferramentas selecionadas ao perfil do agente.
- Para configurar qual modelo de IA o agente utilizará, insira a propriedade model: e escolha o modelo desejado no menu suspenso de preenchimento automático.

Para atualizar um perfil do agente, selecione Configurar agentes... no menu suspenso de agentes, escolha o agente que você quer alterar e clique em Editar.

Criando um perfil agente personalizado no Xcode

Abra a janela Chat GitHub Copilot no Xcode.
No menu suspenso de agentes na parte inferior da visualização do chat, clique em Criar um agente.
Insira um nome de arquivo para o agente personalizado. O nome padrão exibido no menu suspenso de agentes.
Configure o perfil do agente no arquivo .agent.md recém-criado no diretório .github/agents, incluindo a descrição, as ferramentas e os prompts. Para mais informações sobre o que o perfil do agente pode incluir, veja Configuração de um perfil do agente.
- Você pode usar o botão Personalizar Agente dentro do editor de arquivos para abrir uma caixa de diálogo, onde você pode selecionar o modelo de IA para o agente usar, selecionar ferramentas disponíveis (incluindo ferramentas internas e de servidor MCP) e configurar a handoffs propriedade para a transição entre agentes personalizados. Clique em Aplicar para adicionar opções selecionadas aos dados perfil do agente.

Para atualizar um perfil do agente, no menu suspenso de agentes, clique no ícone de lápis ao lado do agente que você quer alterar.

Configurar um perfil do agente

Um perfil do agente é um arquivo Markdown com frontmatter YAML que especifica o nome, a descrição, as ferramentas disponíveis e as configurações do servidor MCP do agente personalizado. A configuração de um perfil do agente envolve a definição da identidade, capacidades, acesso de ferramentas e instruções comportamentais do agente.

Para informações completas de configuração relacionadas a propriedades YAML, ferramentas, configuração de servidores MCP, aliases de ferramenta e processamento de agentes personalizados, consulte Configuração de agentes personalizados.

Como configurar o perfil do agente:

Se preferir, defina um name para o agente personalizado. Se não for definido, o nome assumirá o nome do arquivo por padrão (sem o sufixo .md ou .agent.md).
Escreva um resumo description (obrigatório) explicando o que seu agente faz e seus recursos específicos ou conhecimento de domínio.
Na propriedade tools, defina quais ferramentas o agente pode usar. Esta é uma lista de nomes ou aliases de ferramentas, abrangendo também as ferramentas de servidores MCP configurados nas definições do repositório ou no perfil do agente (por exemplo, tools: ["read", "edit", "search", "some-mcp-server/tool-1"]). Se você omitir essa propriedade, o agente terá acesso a todas as ferramentas que estão disponíveis. Consulte "Ferramentas" em Configuração de agentes personalizados.
Opcionalmente, na mcp-servers propriedade, você pode configurar servidores MCP que estarão disponíveis apenas para esse agente para estender seus recursos. Consulte "Detalhes de configuração do servidor MCP" em Configuração de agentes personalizados.
Se você estiver criando e usando o perfil do agente no VS Code, nas IDEs do JetBrains, Eclipse ou Xcode, também poderá usar a propriedade model para controlar qual modelo de IA o agente deve usar.
Opcionalmente, defina a propriedade target como vscode ou github-copilot se desejar usar apenas o agente em um ambiente específico. O agente estará disponível em ambos os ambientes se você omitir a propriedade.
Escreva o prompt do agente. Defina o comportamento, a competência e as instruções do agente no conteúdo Markdown, localizado abaixo do frontmatter YAML. O prompt pode ter no máximo 30.000 caracteres.

Exemplo de perfis de agente

Usar agentes personalizados

Depois de criar um agente personalizado, você poderá usá-lo sempre que agente de codificação Copilot estiver disponível.

Ao solicitar uma tarefa ao agente de codificação Copilot em GitHub.com, utilize o menu suspenso no painel de agentes ou na guia de agentes para escolher o agente personalizado no lugar do agente de codificação padrão.
Ao designar o agente de codificação Copilot a uma issue, é possível escolher o agente personalizado no menu suspenso para lidar com a issue usando a configuração especializada.
Ao utilizar o CLI do GitHub Copilot, é possível selecionar um agente personalizado específico usando o comando de barra /agent ou fazendo referência ao agente em um prompt ou por um argumento da linha de comando. Para saber mais, confira Usando GitHub Copilot CLI.

Quando o Copilot abrir pull requests, será informado qual agente personalizado executou o trabalho na descrição de pull request.

Para obter mais informações sobre como usar agente de codificação Copilot, consulte Solicitando GitHub Copilot para criar uma solicitação de pull.

Usando agentes personalizados em seu IDE

Você também pode usar seus perfis personalizados perfis de agente diretamente em IDEs com suporte, incluindo Visual Studio Code, IDEs do JetBrains, Eclipse e Xcode. Você pode alternar entre agentes personalizados usando a lista suspensa do agente na janela do chat, permitindo que você acesse configurações especializadas para diferentes tarefas, como planejamento, edição de código ou pesquisa.

Note que certas propriedades podem ter comportamentos distintos ou serem desconsideradas entre o GitHub.com e os ambientes de IDE. Para obter mais informações sobre as propriedades com suporte, consulte Configuração de agentes personalizados.

Para mais detalhes sobre os agentes personalizados em VS Code especificamente, consulte Agentes personalizados em VS Code na documentação VS Code.

Próximas etapas

Para acessar um tutorial prático para criar seu primeiro agente personalizado, consulte Seu primeiro agente personalizado.
Para obter informações de configuração detalhadas, consulte Configuração de agentes personalizados.
Para mais detalhes sobre como utilizar agentes de codificação, inclusive agentes personalizados, a fim de criar pull requests, consulte Solicitando GitHub Copilot para criar uma solicitação de pull.