Sobre agentes personalizados

Agentes personalizados são versões especializadas do agente Copilot que você pode personalizar aos seus fluxos de trabalho exclusivos, convenções de codificação e casos de uso. Eles agem como colegas personalizados que seguem seus padrões, usam as ferramentas certas e implementam práticas específicas da equipe. Você define esses agentes uma vez em vez de fornecer repetidamente as mesmas instruções e contexto.

Defina agentes personalizados usando arquivos Markdown chamados perfis de agente. Esses arquivos especificam prompts, ferramentas e servidores MCP. Isso permite codificar suas convenções, estruturas e resultados desejados diretamente em Copilot.

O perfil do agente define o comportamento do agente personalizado. Quando você atribui o agente a uma tarefa ou problema, ele instancia o agente personalizado.

Formato do Perfil do agente

Perfis do agente são arquivos Markdown com frontmatter YAML. Em sua forma mais simples, eles incluem:

        **Nome**: Um identificador exclusivo para o agente personalizado.

        **Descrição**: explica a finalidade e os recursos do agente.

        **Prompt**: instruções personalizadas que definem o comportamento e a experiência do agente.

        **Ferramentas** (opcional): ferramentas específicas que o agente pode acessar. Por padrão, os agentes podem acessar todas as ferramentas disponíveis, incluindo ferramentas internas e ferramentas de servidor MCP.

Perfis do agente também pode incluir configurações de servidor MCP usando a propriedade mcp-server.

Exemplo perfil do agente

Este exemplo é um perfil do agente básico com nome, descrição e prompt configurados.

---
name: readme-creator
description: Agent specializing in creating and improving README files
---

You are a documentation specialist focused on README files. Your scope is limited to README  files or other related documentation files only - do not modify or analyze code files.

Focus on the following instructions:
- Create and update README.md files with clear project descriptions
- Structure README sections logically: overview, installation, usage, contributing
- Write scannable content with proper headings and formatting
- Add appropriate badges, links, and navigation elements
- Use relative links (e.g., `docs/CONTRIBUTING.md`) instead of absolute URLs for files within the repository
- Make links descriptive and add alt text to images

Onde você pode configurar agentes personalizados

Você pode definir perfis de agente em diferentes níveis:

        **Nível do repositório**: crie `.github/agents/CUSTOM-AGENT-NAME.md` em seu repositório para agentes específicos do projeto.

        **Organização ou nível empresarial**: crie `/agents/CUSTOM-AGENT-NAME.md` em um `.github-private` repositório para uma disponibilidade mais ampla.

Para saber mais, confira Preparando-se para usar agentes personalizados em sua organização e Preparando-se para usar agentes personalizados em sua empresa.

Onde você pode usar 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.

Depois de criar agentes personalizados, eles ficarão disponíveis para:

        **Agente de codificação do Copilot em GitHub.com**: a aba e o painel dos agentes, atribuição de problemas e solicitações de pull

        **Agente de codificação do Copilot em IDEs**: Visual Studio Code, IDEs do JetBrains, Eclipse e Xcode

```
        **CLI do GitHub Copilot**
```

Você pode usar perfis de agente diretamente em Visual Studio Code, IDEs JetBrains, Eclipse e Xcode. Algumas propriedades podem funcionar de forma diferente ou ser ignoradas entre ambientes.

Para mais detalhes sobre o uso de agentes personalizados em Visual Studio Code, consulte Agentes personalizados em VS Code.

Próximas etapas

Para criar seu próprio agentes personalizados, consulte:

        [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/create-custom-agents)

        [AUTOTITLE](/copilot/how-tos/copilot-cli/customize-copilot/create-custom-agents-for-cli)

        [AUTOTITLE](/copilot/reference/customization-cheat-sheet)

Sobre agentes personalizados

Neste artigo