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?

O Agente de nuvem Copilot está disponível com os planos GitHub Copilot Pro, GitHub Copilot Pro+, GitHub Copilot Business e GitHub Copilot Enterprise. O agente está disponível em todos os repositórios armazenados no GitHub, exceto os repositórios pertencentes ao contas de usuário gerenciadas e em locais em que foi explicitamente desabilitado.
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/coding-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. Navegue até a guia 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 saber mais, confira 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 é a ramificação 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 faça a mesclagem na ramificação 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.

Criando um agente personalizado perfil em Visual Studio Code

  1. Abra Chat GitHub Copilot em Visual Studio Code.
  2. Na lista suspensa de agentes na parte inferior do modo de exibição de chat, clique em Configurar Agentes Personalizados... e, em seguida, clique em Criar novo agente personalizado.
  3. Escolha o local onde o perfil do agente deve ser criado: * Workspace: Crie o perfil agente personalizado na pasta .github/agents do seu espaço de trabalho para usá-lo somente nesse espaço de trabalho. * Perfil do usuário: crie o agente personalizado perfil na pasta de perfil do usuário atual para usá-lo em todos os seus workspaces.
  4. Insira um nome de arquivo para o agente personalizado. O nome padrão exibido no menu suspenso de agentes.
  5. Configure o perfil do agente no arquivo .agent.md recém-criado, incluindo 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.
    • Você pode usar o botão Configurar Ferramentas... no editor para abrir a caixa de diálogo "Configurar Ferramentas", onde você pode exibir e selecionar ferramentas disponíveis, incluindo ferramentas internas e ferramentas de servidores MCP. Clique em OK para adicionar ferramentas selecionadas ao perfil do agente.
    • Para configurar qual modelo de IA o agente utilizará, insira a propriedade model: e escolha o modelo desejado no menu suspenso de preenchimento automático.

Para atualizar um perfil do agente, selecione Configurar Agentes Personalizados na lista suspensa de agentes e clique em um agente na lista para modificá-lo. Para obter mais informações sobre agentes personalizados em VS Code, consulte Agentes personalizados em VS Code.

Criando um agente personalizado perfil em IDEs do JetBrains

  1. Abra a Chat GitHub Copilot janela no IDE do JetBrains.
  2. No menu suspenso de agentes na parte inferior da visualização do chat, clique em Configurar agentes... e, na janela de configurações, em "Agentes de chat", cliquem em Workspace.
  3. Insira um nome de arquivo para o agente personalizado. O nome padrão exibido no menu suspenso de agentes.
  4. Configure o perfil do agente no arquivo .agent.md recém-criado no diretório .github/agents, incluindo a descrição, as ferramentas e os prompts. Para obter mais informações sobre o que pode perfil do agente incluir, consulte Configurando um perfil do agente.
    • Você pode usar o botão Configurar Ferramentas... no editor para abrir a caixa de diálogo ferramentas, onde você pode exibir e selecionar ferramentas disponíveis, incluindo ferramentas internas e ferramentas de servidores MCP. Clique em Aplicar para adicionar ferramentas selecionadas ao perfil do agente.
    • Para configurar qual modelo de IA o agente utilizará, insira a propriedade model: e escolha o modelo desejado no menu suspenso de preenchimento automático.

Para atualizar um perfil do agente, selecione Configurar Agentes Personalizados na lista suspensa de agentes e clique em ao lado do agente que deseja modificar.

Criando um agente personalizado perfil no Eclipse

  1. Abra a janela Chat GitHub Copilot no Eclipse.
  2. No menu suspenso de agentes na parte inferior da visualização do chat, selecione Configurar agentes... e clique em Adicionar....
  3. Insira um nome de arquivo para o agente personalizado. O nome padrão exibido no menu suspenso de agentes.
  4. Configure o perfil do agente no arquivo .agent.md recém-criado no diretório .github/agents, incluindo a descrição, as ferramentas e os prompts. Para mais informações sobre o que o perfil do agente pode incluir, consulte Configurando um perfil do agente.
    • Você pode usar o botão Configurar Ferramentas... no editor para abrir a caixa de diálogo "Configurar Ferramentas", onde você pode exibir e selecionar ferramentas disponíveis, incluindo ferramentas internas e ferramentas de servidores MCP. Clique em Aplicar para adicionar ferramentas selecionadas ao perfil do agente.
    • Para configurar qual modelo de IA o agente utilizará, insira a propriedade model: e escolha o modelo desejado no menu suspenso de preenchimento automático.

Para atualizar um perfil do agente, selecione Configurar Agentes... na lista suspensa de agentes e selecione o agente que você deseja modificar e clique em Editar.

Criando um agente personalizado perfil no Xcode

  1. Abra a Chat GitHub Copilot janela no Xcode.
  2. Na lista suspensa de agentes na parte inferior da janela de chat, clique em Criar um agente.
  3. Insira um nome de arquivo para o agente personalizado. O nome padrão exibido no menu suspenso de agentes.
  4. Configure o perfil do agente no arquivo .agent.md recém-criado no diretório .github/agents, incluindo a descrição, as ferramentas e os prompts. Para mais informações sobre o que o perfil do agente pode incluir, consulte Configurando um perfil do agente.
    • Você pode usar o botão Personalizar Agente no editor de arquivos para abrir uma caixa de diálogo, onde você pode selecionar o modelo de IA para o agente usar, selecionar ferramentas disponíveis (incluindo ferramentas internas e de servidor MCP) e configurar a handoffs propriedade para a transição entre agentes personalizados. Clique em Aplicar para adicionar opções selecionadas ao perfil do agente.

Para atualizar um perfil do agente, na lista suspensa de agentes, clique no ícone de lápis ao lado do agente que você deseja modificar.

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"]). Se você omitir essa propriedade, o agente terá acesso a todas as ferramentas que estão 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 como vscode ou github-copilot se desejar usar apenas o agente 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 saber mais, confira 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 para criar uma solicitação de pull.

Usando agentes personalizados em seu IDE

Você também pode usar seu recurso personalizado perfis de agente diretamente em IDEs compatíveis, incluindo IDEs do JetBrains, Eclipse e Xcode. Você pode alternar entre agentes personalizados usando a lista suspensa do agente na janela de chat, o que permite acessar configurações especializadas para tarefas distintas, como planejamento, edição de código ou pesquisa.

Observe que algumas propriedades podem funcionar de forma diferente ou ser ignoradas entre os ambientes GitHub.com e IDE. Para obter mais informações sobre as propriedades com suporte, consulte Configuração de agentes personalizados.

Para obter mais informações sobre agentes personalizados em VS Code especificamente, consulte Agentes personalizados em VS Code na documentação de VS Code.

Próximas etapas