Sobre o agentes personalizados
Agentes personalizados 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 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 de agente personalizado. Quando você atribui o agente a uma tarefa ou problema, ele instancia o agente personalizado.
Formato Perfil do agente
Perfis do agente são arquivos markdown com frontmatter YAML. Em sua forma mais simples, eles incluem:
* Nome (opcional): um nome de exibição para o agente personalizado. 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.
Perfis do agente também pode incluir configurações de servidor MCP usando a `mcp-servers` propriedade.
Exemplo perfil do agente
Este exemplo é básico perfil do agente 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 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. -
**Organização ou nível empresarial**: crie `/agents/CUSTOM-AGENT-NAME.md` em um repositório `.github-private` para maior disponibilidade.
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.
Where you can use 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.
Once you create agentes personalizados, they become available to:
- Copilot cloud agent on GitHub.com: The agents tab and panel, issue assignment, and pull requests
- Copilot cloud agent in IDEs: Visual Studio Code, JetBrains IDEs, Eclipse, and Xcode
- CLI do GitHub Copilot
You can use perfis de agente directly in Visual Studio Code, JetBrains IDEs, Eclipse, and Xcode. Some properties may function differently or be ignored between environments.
For more information on using agentes personalizados in Visual Studio Code, see Agentes personalizados in VS Code.
Next steps
To create your own agentes personalizados, see: