---
featureId: custom-agents
title: Criar seus agentes personalizados
area: GitHub Copilot
thumbnailImage: ../media/custom-agents-thumbnail.png
devComUrl: https://developercommunity.visualstudio.com/t/Custom-modes-for-Copilot-Chat/10950930?q=custom+agents
description: Defina agentes personalizados adaptados ao fluxo de trabalho da sua equipe usando arquivos .agent.md no seu repositório ou perfil de usuário.

---


Os agentes personalizados ajudam você a criar agentes do Copilot especializados para o fluxo de trabalho da sua equipe. Eles podem utilizar o reconhecimento do ambiente de trabalho, a compreensão do código, ferramentas, o modelo selecionado por você e conexões MCP com fontes de conhecimento externas, como documentação interna, sistemas de design, APIs e bancos de dados.

Os agentes personalizados são definidos como arquivos `.agent.md` no seu repositório ou perfil de usuário.
Os agentes específicos do workspace ou do projeto são armazenados em `.github/agents/` no seu repositório. Por exemplo:

```text
your-repo/
└── .github/
    └── agents/
        └── code-reviewer.agent.md
```

Os agentes de nível de usuário são armazenados em `%USERPROFILE%/.github/agents/` por padrão. Você pode alterar esse local em **Ferramentas > Opções > Copilot Chat > Diretório de usuários de agentes personalizados**.

Para criar um agente personalizado, crie um arquivo `.agent.md` diretamente em um dos locais acima ou clique no botão **+** no seletor de agentes e siga as instruções.

![Seletor de agentes exibindo um agente personalizado especializado em CSharp](../media/custom-agents.png)

Depois de criar um agente personalizado, ele aparecerá no seletor de agentes para que você possa usá-lo a qualquer momento.

Algumas observações:

- Se você não especificar um modelo, o agente utilizará o modelo selecionado no seletor de modelos.
- Os nomes das ferramentas variam entre as plataformas do GitHub Copilot — verifique as ferramentas disponíveis no Visual Studio para garantir que seu agente funcione conforme o esperado.
- O repositório [awesome-copilot](https://github.com/github/awesome-copilot) contém configurações de agentes criadas pela comunidade que você pode usar como ponto de partida. Verifique os nomes das ferramentas antes de usá-las no Visual Studio.