Sobre agentes personalizados

Custom agents aprimore Copilot com assistência adaptada às suas necessidades.

Neste artigo

Sobre o custom agents

Custom agents são versões especializadas do Copilot agente que você pode adaptar 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.

Você define custom agents usando arquivos Markdown chamados agent profiles. Esses arquivos especificam prompts, ferramentas e servidores MCP. Isso permite codificar suas convenções, estruturas e resultados desejados diretamente em Copilot.

O agent profile define o comportamento de custom agent. Quando você atribui o agente a uma tarefa ou problema, ele instancia o custom agent.

Formato Agent profile

Agent profiles são arquivos markdown com frontmatter YAML. Em sua forma mais simples, eles incluem:

  • Nome (opcional): um nome de exibição para o custom agent. Caso omitido, o nome do arquivo do agente será usado como seu identificador e nome de exibição padrão.
  • 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.

Agent profiles também pode incluir configurações de servidor MCP usando a mcp-servers propriedade.

Exemplo agent profile

Este exemplo é básico agent profile 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 custom agents

Você pode definir agent profiles em níveis diferentes:

  • Nível do repositório: crie .github/agents/CUSTOM-AGENT-NAME.md em seu repositório para agentes específicos do projeto.
  • Nível da organização: crie /agents/CUSTOM-AGENT-NAME.md no repositório .github ou .github-private da organização para maior disponibilidade dentro da organização.
  • No nível empresarial: crie /agents/CUSTOM-AGENT-NAME.md no repositório .github-private de uma organização que um proprietário da empresa designou nas configurações da empresa para ficar disponível em todos os repositórios da empresa.

Para obter mais informações, consulte Preparando-se para usar agentes personalizados em sua organização e Preparando-se para usar agentes personalizados em sua empresa.

Onde você pode usar custom agents

Observação

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

Depois de criar custom agents, eles ficam disponíveis para:

  • Copilot cloud agent em GitHub.com: a guia e o painel de agentes, atribuição de problemas e solicitações pull
  • Copilot cloud agent em IDEs: Visual Studio Code, IDEs da JetBrains, Eclipse e Xcode
  • GitHub Copilot CLI

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

Para obter mais informações sobre como usar custom agents em Visual Studio Code, consulte Custom agents em VS Code.

Próximas Etapas 

Para criar seu próprio custom agents, confira: