Sobre agentes personalizados

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.

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 ficam disponíveis para:

        **
        Copilot cloud agent em GitHub.com**: a guia e o painel de agentes, atribuição de problemas e solicitações de pull

        **
        Copilot cloud agent em IDEs**: Visual Studio Code, IDEs da JetBrains, Eclipse e Xcode

CLI do GitHub Copilot

Você pode usar perfis de agente 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 agentes personalizados em Visual Studio Code, consulte Agentes personalizados em VS Code.

Próximas Etapas

Para criar seu próprio agentes personalizados, confira:

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

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

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