Criando agentes personalizados para agente de nuvem Copilot

Você pode criar agentes especializados com experiência personalizada para tarefas de desenvolvimento específicas.

Quem pode usar esse recurso?

agente de nuvem Copilot está disponível com os planos Copilot Pro do GitHub, GitHub Copilot Pro+, GitHub Copilot Business e GitHub Copilot Enterprise. O agente está disponível em todos os repositórios armazenados em GitHub, exceto nos repositórios de propriedade de contas de usuário gerenciadas e onde foi explicitamente desativado.
Sign up for Copilot

Neste artigo

          Agentes personalizados permite que você ajuste a especialização de Copilot para tarefas específicas. Para obter uma visão geral conceitual de agentes personalizados, consulte [AUTOTITLE](/copilot/concepts/agents/cloud-agent/about-custom-agents).

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.

Criando um perfil agente personalizado em um repositório GitHub

  1. Acesse a aba "Agentes" em https://github.com/copilot/agents.

  2. Usando o menu suspenso na caixa de prompt, selecione o repositório no qual você deseja criar o agente personalizado perfil.

    Observação

    Os proprietários de organização e empresa podem criar objetos de nível de organização e empresa agentes personalizados em um repositório .github-private que estão disponíveis em todos os repositórios dentro de suas organizações ou empresas. Para obter mais informações, consulte Preparando-se para usar agentes personalizados em sua empresa e Preparando-se para usar agentes personalizados em sua organização.

  3. Opcionalmente, selecione o branch em que você deseja criar perfil do agente . O padrão é o ramo principal.

  4. Clique e clique em Criar um agente. Isso abrirá um perfil de agente de modelo chamado my-agent.agent.md no diretório .github/agents do repositório de destino.

  5. Se você estiver criando uma organização ou no nível empresarial agente personalizado, exclua a parte .github/ do caminho do arquivo para mover seu modelo para o diretório agents raiz.

  6. Edite o nome do arquivo (o texto anterior .agent.md), selecionando um nome exclusivo e descritivo que identifica a finalidade do agente. Observe que o nome do arquivo pode conter apenas os seguintes caracteres: ., , -, _, , a-z, A-Z. 0-9

  7. Configure o perfil do agente, incluindo o nome, a descrição, as ferramentas e os prompts. Para obter mais informações sobre o que o perfil do agente pode incluir, consulte Configurando um perfil do agente.

  8. Confirme o arquivo no repositório e mescle-o no branch padrão. Volte à aba agentes e atualize a página, se necessário. Agora, o agente personalizado aparecerá na lista suspensa quando você clicar em na caixa de prompt.

Configurando um perfil do agente

Um perfil do agente é um arquivo Markdown com um frontmatter YAML que especifica o nome do agente personalizado, a descrição, as ferramentas disponíveis e as configurações do servidor MCP. A configuração de um perfil do agente 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 agentes personalizados são processados, consulte Configuração de agentes personalizados.

Para configurar seu perfil do agente:

  1. Opcionalmente, escreva um name para o seu agente personalizado. 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 perfil do agente (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.
  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.
  5. Se você estiver criando e usando o perfil do agente 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 perfis de agente

Os exemplos a seguir demonstram a aparência de um perfil do agente para as tarefas comuns de escrever testes ou planejar a implementação de um projeto. Para obter inspiração adicional, consulte os exemplos Agentes personalizados na biblioteca de customização. Você também pode encontrar exemplos mais específicos na coleção da comunidade awesome-copilot.

Especialista em testes

Este exemplo habilita todas as ferramentas omitindo a tools propriedade.

Text
---
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
---
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 agentes personalizados

Depois de criar um agente personalizado, você pode usá-lo sempre que agente de nuvem Copilot estiver disponível.

  • Ao acionar agente de nuvem Copilot com uma tarefa em GitHub.com, use o menu suspenso no painel de agentes ou na guia de agentes para selecionar o seu agente personalizado em vez do agente de nuvem padrão.
  • Ao atribuir agente de nuvem Copilot a um problema, você pode selecionar seu agente personalizado no menu suspenso para lidar com o problema com sua configuração especializada.
  • Ao usar o CLI do GitHub Copilot, você pode escolher usar um determinado agente personalizado através do comando de barra /agent, referenciando o agente em um prompt de comando ou por meio de um argumento de linha de comando. Para obter mais informações, consulte Usando GitHub Copilot CLI.

Quando Copilot abrir solicitações de pull, ele observará o que agente personalizado foi usado para concluir o trabalho na descrição da solicitação de pull.

Para obter mais informações sobre como usar agente de nuvem Copilot, confira Solicitando GitHub Copilot criar uma solicitação de pull.

Próximas Etapas