# Criando agentes personalizados no Copilot cloud agent em seu IDE
Você pode criar agentes especializados com experiência personalizada para tarefas de desenvolvimento específicas.
Custom agents permite que você ajuste a especialização de Copilot para tarefas específicas. Para obter uma visão geral conceitual de custom agents, consulte [Sobre agentes personalizados](/pt/copilot/concepts/agents/cloud-agent/about-custom-agents).
> \[!NOTE]
> Custom agents estão em prévia pública para IDEs JetBrains, Eclipse e Xcode e estão sujeitos a alterações.
## Criando um custom agent perfil
1. Abra a janela GitHub Copilot Chat no Eclipse.
2. Na lista suspensa agentes na parte inferior da janela de chat, clique em **Configurar Agentes...** e, em seguida, clique em **Adicionar...**.
3. Insira um nome de arquivo para o custom agent. Esse é o nome padrão que aparece na lista suspensa de agentes.
4. Configure o agent profile no arquivo `.agent.md` recém-criado no diretório `.github/agents`, incluindo a descrição, as ferramentas e os prompts. Para obter mais informações sobre o que o agent profile pode incluir, consulte [Configurando um agent profile](#configuring-an-agent-profile).
* 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 ferramentas selecionadas ao agent profile.
* Para definir qual modelo de IA o agente usa, adicione a propriedade `model:` e selecione seu modelo preferido na lista suspensa de preenchimento automático.
Para atualizar um agent profile, **selecione Configurar Agentes...** na lista suspensa de agentes e selecione o agente que você deseja modificar e clique em **Editar**.
## Configurando um agent profile
Um agent profile é um arquivo Markdown com um frontmatter YAML que especifica o nome do custom agent, a descrição, as ferramentas disponíveis e as configurações do servidor MCP. A configuração de um agent profile envolve a definição da identidade, dos recursos, do acesso à ferramenta e das instruções comportamentais do agente.
Para obter informações detalhadas de configuração sobre propriedades YAML, ferramentas, configuração do servidor MCP, aliases de ferramentas e como custom agents são processados, consulte [Configuração de agentes personalizados](/pt/copilot/reference/custom-agents-configuration).
Para configurar seu agent profile:
1. Opcionalmente, escreva um `name` para o seu custom agent. Se não for definido, o nome assumirá o nome do arquivo por padrão (sem o sufixo `.md` ou `.agent.md`).
2. Escreva um resumo `description` (obrigatório) explicando o que seu agente faz e seus recursos específicos ou conhecimento de domínio.
3. Na propriedade `tools`, defina quais ferramentas o agente pode usar. Esta é uma lista de nomes de ferramentas ou aliases, incluindo ferramentas de servidores MCP configuradas nas configurações do repositório ou no agent profile (por exemplo, `tools: ["read", "edit", "search", "some-mcp-server/tool-1"]`). Caso você omita essa propriedade, o agente terá acesso a todas as ferramentas disponíveis. Consulte "Ferramentas" em [Configuração de agentes personalizados](/pt/copilot/reference/custom-agents-configuration#tools).
4. 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](/pt/copilot/reference/custom-agents-configuration#mcp-server-configuration-details).
5. Se você estiver criando e usando o agent profile no VS Code, IDEs do JetBrains, Eclipse ou Xcode, também poderá usar a propriedade `model` para controlar qual modelo de IA o agente deve usar.
6. Opcionalmente, defina a propriedade `target` para `vscode` ou `github-copilot` se você deseja usar o agente apenas em um ambiente específico. O agente estará disponível em ambos os ambientes se você omitir a propriedade.
7. 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 agent profiles
Os exemplos a seguir demonstram a aparência de um agent profile para as tarefas comuns de escrever testes ou planejar a implementação de um projeto. Para obter inspiração adicional, consulte os exemplos [Custom agents](/pt/copilot/tutorials/customization-library/custom-agents) na biblioteca de customização. Você também pode encontrar exemplos mais específicos na coleção da comunidade [awesome-copilot](https://github.com/github/awesome-copilot/tree/main/agents).
### Especialista em testes
Este exemplo habilita todas as ferramentas omitindo a `tools` propriedade.
```text copy
---
name: test-specialist
description: Focuses on test coverage, quality, and testing best practices without modifying production code
---
You are a testing specialist focused on improving code quality through comprehensive testing. Your responsibilities:
- Analyze existing tests and identify coverage gaps
- Write unit tests, integration tests, and end-to-end tests following best practices
- Review test quality and suggest improvements for maintainability
- Ensure tests are isolated, deterministic, and well-documented
- Focus only on test files and avoid modifying production code unless specifically requested
Always include clear test descriptions and use appropriate testing patterns for the language and framework.
```
### Planejador de implementação
Este exemplo habilita apenas um subconjunto de ferramentas.
```text copy
---
name: implementation-planner
description: Creates detailed implementation plans and technical specifications in markdown format
tools: ["read", "search", "edit"]
---
You are a technical planning specialist focused on creating comprehensive implementation plans. Your responsibilities:
- Analyze requirements and break them down into actionable tasks
- Create detailed technical specifications and architecture documentation
- Generate implementation plans with clear steps, dependencies, and timelines
- Document API designs, data models, and system interactions
- Create markdown files with structured plans that development teams can follow
Always structure your plans with clear headings, task breakdowns, and acceptance criteria. Include considerations for testing, deployment, and potential risks. Focus on creating thorough documentation rather than implementing code.
```
## Usando custom agents
Depois de criar um custom agent, você pode usá-lo sempre que Copilot cloud agent estiver disponível.
* Ao solicitar uma tarefa ao Copilot cloud agent no GitHub.com, use o menu suspenso no painel de agentes ou na guia de agentes para selecionar o seu custom agent em vez do cloud agent padrão.
* Ao atribuir o Copilot cloud agent a um issue, você pode selecionar seu custom agent no menu suspenso para que ele trate o issue com sua configuração especializada.
* Ao usar o GitHub Copilot CLI, você pode escolher usar um custom agent específico usando o comando barra `/agent` ou referenciando o agente em um prompt ou por meio de um argumento da linha de comando. Para obter mais informações, consulte [Usando GitHub Copilot CLI](/pt/copilot/how-tos/copilot-cli/use-copilot-cli/overview#use-custom-agents).
Quando o Copilot abre pull requests, ele indica qual custom agent foi usado para concluir o trabalho na descrição do pull request.
Para obter mais informações sobre como usar Copilot cloud agent, confira [Iniciando sessões do GitHub Copilot](/pt/copilot/how-tos/use-copilot-agents/cloud-agent/start-copilot-sessions).
### Usando custom agents em seu IDE
Você também pode usar seu agent profiles personalizado diretamente em IDEs compatíveis. Você pode alternar entre custom agents usando a lista suspensa do agente na janela de chat, o que permite acessar configurações especializadas para tarefas distintas, como planejamento, edição de código ou pesquisa.
Algumas propriedades podem funcionar de forma diferente entre os ambientes GitHub.com e IDE. Para obter mais informações sobre as propriedades com suporte, consulte [Configuração de agentes personalizados](/pt/copilot/reference/custom-agents-configuration#yaml-frontmatter-properties).
Para obter mais informações sobre custom agents em VS Code especificamente, consulte [Custom agents em VS Code](https://code.visualstudio.com/docs/copilot/customization/custom-agents) na documentação de VS Code.
## Próximas Etapas
* Para obter um tutorial prático para criar seu primeiro custom agent, consulte [Seu primeiro agente personalizado](/pt/copilot/tutorials/customization-library/custom-agents/your-first-custom-agent).
* Para obter informações de configuração detalhadas, consulte [Configuração de agentes personalizados](/pt/copilot/reference/custom-agents-configuration).
* Para obter informações sobre como usar agentes de nuvem, incluindo seu custom agents, para iniciar Copilot sessões, consulte [Iniciando sessões do GitHub Copilot](/pt/copilot/how-tos/use-copilot-agents/cloud-agent/start-copilot-sessions).