Comparando os recursos de personalização do Copilot

Introduction

Você pode personalizar Copilot para seguir suas convenções, realizar fluxos de trabalho repetíveis ou conectar-se a sistemas além da base de código.

Este artigo explica a diferença entre:

Instruções personalizadas

Estes dizem Copilotcomo se comportar em geral. Por exemplo, para garantir que o código que ele escreve siga seus padrões de codificação. Saiba mais.
Habilidades do agente

Elas dizem Copilotcomo lidar com um tipo específico de tarefa. Por exemplo, para seguir o processo de sua equipe ao elaborar notas de versão. Saiba mais.
Ferramentas

Elas fornecem habilidades. Por exemplo, para localizar e modificar arquivos ou para interagir com partes de GitHub. Saiba mais.

Servidores MCP

Elas adicionam coleções de ferramentas que permitem Copilot interagir com serviços externos. Saiba mais.

Hooks

Elas permitem que você execute sua própria lógica em pontos específicos no fluxo de trabalho de um agente. Por exemplo, você pode executar um script antes que o agente use uma ferramenta. Saiba mais.
Subagentes

Estas executam o trabalho delegado separadamente do agente principal. Eles têm seu próprio contexto de conversa, portanto, seu trabalho intermediário não preenche a janela de contexto do agente principal. Saiba mais.
Agentes personalizados

Elas definem funções especializadas, com instruções e ferramentas para tarefas específicas. Por exemplo, um agente personalizado pode atuar como um revisor do React, um redator de documentação ou um gerador de teste. Saiba mais.

Extensões

Estes adicionam capacidades implementadas em código. Por exemplo, uma Copilot CLI extensão pode adicionar uma ferramenta que acompanha a atividade de sessão. Saiba mais.
Plug-ins

Esses são pacotes que podem fornecer personalizações pré-configuradas, como habilidades, ganchos, agentes personalizados e servidores MCP. Saiba mais.

O suporte e a configuração diferem entre superfícies. Para obter uma comparação de suporte, consulte Guia de personalização rápida do Copilot.

Instruções personalizadas

Há suporte para instruções personalizadas no GitHub Copilot app, Copilot code review, Copilot Chat, Copilot CLI, Copilot cloud agent no GitHub.com e em IDEs compatíveis. Os tipos de instruções disponíveis dependem de onde você as usa.

O que são instruções personalizadas?

Instruções personalizadas são diretrizes persistentes que Copilot usa dentro de um escopo definido. Por exemplo, as instruções do repositório podem descrever as convenções de codificação do projeto e os comandos de teste, enquanto as instruções pessoais podem descrever suas preferências de comunicação.

As instruções orientam o modelo, mas não garantem que ele siga todas as regras.

Que problema as instruções personalizadas resolvem?

Instruções personalizadas ajudam você a:

Mantenha-o Copilot alinhado com suas convenções e preferências de codificação.
Aplique padrões de equipe ou organização de forma consistente.
Evite incluir lembretes repetitivos em cada prompt.

Quando você deve usar instruções personalizadas?

Use instruções personalizadas para:

Regras de estilo e qualidade. Por exemplo: "Prefira pull requests pequenos, escreva testes e evite alterar APIs públicas sem discussão."
Convenções de repositório. Por exemplo: "Usar pnpm, manter entradas no CHANGELOG.mdchangelog e executar pnpm test antes de fazer commit."
Preferências de comunicação. Por exemplo: "Explicar as compensações brevemente e, em seguida, fornecer a opção recomendada."

Quando você não deve usar instruções personalizadas?

Mantenha-os mínimos quando:

Você só quer o comportamento de um tipo de tarefa. Em vez disso, use uma habilidade.
As instruções são tão detalhadas que distraem da tarefa imediata. Use uma skill ou um agente personalizado para orientação especializada.

Saiba mais sobre instruções personalizadas

Habilidades do agente

As habilidades do agente são compatíveis com o GitHub Copilot app, Copilot CLI, Copilot cloud agent, Copilot code review e com o modo de agente em Visual Studio Code, Visual Studio e IDEs JetBrains.

O que é uma habilidade?

Uma skill é uma pasta que contém um arquivo SKILL.md com instruções para um tipo específico de tarefa. O nome e a descrição ajudam Copilot a decidir quando carregar essas instruções.

As habilidades também podem incluir recursos de suporte, como modelos e scripts que o agente pode executar.

Que problema uma habilidade resolve?

As habilidades ajudam você a:

Padronizar como Copilot executa tarefas em um contexto específico, como uma revisão de código.
Forneça instruções quando forem relevantes, sem adicioná-las a cada interação.
Evite preencher a janela de contexto com instruções não relacionadas à tarefa atual.

Quando você deve usar uma habilidade?

Use uma habilidade quando desejar:

Um fluxo de trabalho repetível. Por exemplo, verifique se a documentação voltada para o usuário é atualizada quando o código de front-end é alterado.
Um formato de saída consistente. Por exemplo, redija notas de versão usando o modelo da sua equipe.
Um fluxo de trabalho que às vezes você precisa, mas nem sempre. Por exemplo, siga um processo de refatoração detalhado durante uma migração.

Quando você não deve usar uma habilidade?

Escolha outra personalização quando:

As diretrizes devem se aplicar amplamente ao seu trabalho. Em vez disso, use instruções personalizadas.
Você precisa de acesso a um sistema externo. Use um servidor MCP para fornecer as ferramentas, que uma habilidade pode então descrever como usar.
Você precisa de um especialista que possa ser reutilizado com um conjunto de ferramentas específico. Considere um agente personalizado.

Saiba mais sobre as habilidades do agente

Consulte Habilidades do agente.

Tools

As ferramentas estão disponíveis para agentes no GitHub Copilot app, Copilot CLI, Copilot cloud agent e em IDEs com suporte. As ferramentas disponíveis e os controles de permissão dependem da interface.

O que é uma ferramenta?

Uma ferramenta é um recurso que Copilot usa para realizar algo, como pesquisar arquivos, visualizar o conteúdo de arquivos, editar ou executar comandos. Algumas ferramentas são internas e outras podem ser adicionadas por meio de servidores MCP ou extensões.

Que problema as ferramentas resolvem?

As ferramentas permitem que um agente:

Reúna o contexto lendo e pesquisando.
Faça alterações editando arquivos.
Execute os comandos e valide os resultados.

Quando as ferramentas são usadas?

Normalmente, você não chama ferramentas diretamente. Copilot escolhe ferramentas para realizar sua solicitação, de acordo com as permissões e controles da interface que você está usando.

Você verá as ferramentas usadas quando:

Peça a um agente para pesquisar um repositório, atualizar um arquivo ou executar testes.
Peça um trabalho que exija acesso a um serviço externo por meio de um servidor MCP.
Dê a um agente uma tarefa que se beneficie da delegação para um subagente.

Antes de adicionar uma integração, verifique se as ferramentas existentes do agente já atendem às suas necessidades.

Servidores MCP

Os servidores MCP têm suporte em GitHub Copilot app, Copilot CLI, Copilot cloud agent, Copilot code review, Visual Studio Code, Visual Studio, IDEs JetBrains, Xcode e Eclipse. As opções de configuração e autenticação dependem da plataforma.

O que é um servidor MCP?

Um servidor MCP é um serviço que permite que aplicativos de IA, como Copilot, conectem-se a fontes de dados e ferramentas externas.

Por exemplo, você pode adicionar um servidor MCP que fornece ferramentas para interagir com um calendário online ou um sistema de tíquetes de suporte.

Que problema os servidores MCP resolvem?

Os servidores MCP ajudam quando as ferramentas internas não são suficientes. Eles podem:

Conectar Copilot a sistemas externos.
Adicione ferramentas criadas para trabalhar com APIs, bancos de dados ou outros serviços.
Forneça acesso a informações fora do seu repositório.

Quando você deve usar um servidor MCP?

Use um servidor MCP quando precisar:

Informações de um sistema externo. Por exemplo: "Quantos tíquetes de suporte foram abertos este mês para o Produto X?"
Ações em outro serviço. Por exemplo: "Adicione um comentário ao tíquete de suporte resumindo essa correção".

Quando você não deve usar um servidor MCP?

Evite adicionar um servidor MCP quando as ferramentas internas já abrangem suas necessidades.

Saiba mais sobre servidores MCP

Consulte Protocolo MCP (Model Context Protocol).

Ganchos

Há suporte para ganchos no GitHub Copilot app, Copilot CLI, Copilot cloud agent e Visual Studio Code. Os eventos e controles com suporte dependem da plataforma.

O que é um gancho?

Um gancho executa um comando de shell que você define em um determinado ponto no fluxo de trabalho de um agente. Por exemplo, um hook pode ser executado antes de uma ferramenta ser usada ou quando uma sessão termina.

Ao contrário das habilidades e das instruções personalizadas, que orientam o modelo por meio de prompts, os ganchos executam código em eventos definidos.

Que problema os ganchos resolvem?

Os ganchos ajudam quando você precisa de mais controle sobre as ações do agente, como:

Verificando uma solicitação de ferramenta antes de permitir que ela seja executada.
Atividade de sessão ou uso da ferramenta de log.
Executando a validação personalizada em um evento com suporte.

Quando você deve usar hooks?

Use ganchos quando desejar:

Verificar ferramentas Por exemplo, verifique um comando proposto em relação a uma lista de permissões antes de ser executado.
Automação de sessão. Por exemplo, registre quando uma sessão do agente for iniciada ou encerrada.
Validação personalizada. Por exemplo, verifique se uma solicitação de ferramenta alteraria um caminho protegido.

Use a referência de evento e configuração para sua superfície em vez de assumir que um gancho funciona inalterado em todos os lugares.

Quando você não deve usar ganchos?

Escolha outra personalização quando:

Você só precisa de instruções de fluxo de trabalho. Use uma skill.
Você deseja preferências e padrões persistentes. Use instruções personalizadas.
Você precisa de acesso a ferramentas externas. Use um servidor MCP.

Saiba mais sobre ganchos

Subagentes

Os subagentes têm suporte no GitHub Copilot app, Copilot CLI, Visual Studio Code, IDEs JetBrains, Xcode e Eclipse.

O que é um subagente?

Um subagente é um agente para o qual o agente principal delega uma parte específica do trabalho. Ele funciona em seu próprio contexto de conversa e relata seus resultados de volta ao agente principal.

Um subagente pode usar um agente interno ou um perfil de agente personalizado. Você não precisa definir um agente personalizado para cada tarefa delegada.

Que problema os subagentes resolvem?

Subagentes ajudam um agente:

Mantenha a conversa principal focada manipulando uma subtarefa em um contexto separado.
Execute tarefas independentes em paralelo quando houver suporte.
Delegue trabalho especializado usando um perfil de agente personalizado.

Quando os subagentes são usados?

Subagentes são úteis para:

Exploração da base de código. Por exemplo, localize todos os endpoints em uma API.
Execução de comandos. Por exemplo, execute um conjunto de testes e resuma falhas.
Revisando alterações. Por exemplo, examine as alterações preparadas enquanto o agente principal trabalha em outra parte da tarefa.
Trabalho especializado. Por exemplo, delegue uma revisão a um agente de documentação personalizado.

Selecionar um agente personalizado para sua sessão principal é diferente de delegar o trabalho a ele como um subagente.

Saiba mais sobre subagentes

Agentes personalizados

Os agentes personalizados têm suporte no GitHub Copilot app, Copilot CLI, Copilot cloud agent, Visual Studio Code, Visual Studio, IDEs JetBrains, Eclipse e Xcode. As propriedades de perfil com suporte dependem do contexto.

O que é um agente personalizado?

Um agente personalizado define uma função de especialista, com instruções e ferramentas disponíveis para um determinado tipo de trabalho. Você pode pensar nisso como uma persona que Copilot pode adotar, como um revisor de React ou um redator de documentação.

Você define um agente personalizado em um arquivo Markdown com o frontmatter YAML. Seu perfil descreve sua finalidade, lhe fornece instruções e pode restringir suas ferramentas disponíveis. Em ambientes com suporte, ele também pode configurar servidores MCP.

Que problema os agentes personalizados resolvem?

Os agentes personalizados ajudam quando você precisa:

Diretrizes especializadas aplicadas consistentemente a tarefas específicas.
Um conjunto diferente de ferramentas para diferentes tipos de trabalho.
Uma função reutilizável que você pode selecionar para uma sessão ou usar para trabalho delegado.

O contexto separado é um benefício da execução de um agente como um subagente, não um requisito para usar um agente personalizado.

Quando você deve usar um agente personalizado?

Use um agente personalizado quando desejar:

Um revisor especializado ou um assistente. Por exemplo, um revisor do React que verifica os padrões de componente da sua equipe.
Um conjunto de ferramentas limitado. Por exemplo, um revisor com ferramentas para ler e pesquisar arquivos, mas não editá-los.
Uma abordagem consistente. Por exemplo, um agente de documentação que segue seus padrões de escrita e revisão.

Quando você não deve usar um agente personalizado?

Escolha uma opção mais simples quando:

Você só precisa de instruções e recursos específicos da tarefa. Uma habilidade pode ser suficiente.
Você não precisa de especialização e o agente padrão executa bem a tarefa.

Saiba mais sobre agentes personalizados

Extensions

Há suporte para extensões no GitHub Copilot app e Copilot CLI. Os exemplos abaixo descrevem extensões para Copilot CLI.

O que é uma extensão?

Uma extensão adiciona recursos implementados no código. Em Copilot CLI, uma extensão é um módulo JavaScript que é executado junto com uma sessão interativa e pode adicionar ferramentas, comandos de barra e comportamento com reconhecimento de sessão.

Elas são distintas das extensões do IDE e da integração Extensions baseada em Copilot, descontinuada.

Que problema as extensões resolvem?

As extensões permitem criar recursos que precisam de mais do que instruções ou configuração. Por exemplo, uma Copilot CLI extensão pode manter o estado entre chamadas de ferramenta e disponibilizá-lo por meio de uma ferramenta personalizada.

Quando você deve usar uma extensão?

Use uma extensão quando precisar:

Suas próprias ferramentas cientes da sessão. Por exemplo, acompanhe os tempos das chamadas de ferramenta em uma Copilot CLI sessão e exponha os totais para o agente.
Um comando de barra inclinada baseado em código. Por exemplo, adicione um comando que resume as informações coletadas durante uma sessão Copilot CLI.

Quando você não deve usar uma extensão?

Escolha outra personalização quando:

Instruções e recursos são suficientes. Use uma habilidade.
Um servidor MCP existente fornece as ferramentas externas necessárias.
Você só precisa executar um comando em um evento definido. Use um hook.

Saiba mais sobre extensões

Consulte Extensões para GitHub Copilot.

Plugins

Há suporte para plug-ins no GitHub Copilot app, Copilot CLICopilot cloud agente Visual Studio Code. Os componentes com suporte de um plug-in dependem do ambiente.

O que é um plug-in?

Um plug-in é um pacote instalável que fornece um conjunto de recursos. Por exemplo, ele pode incluir skills, agentes personalizados, hooks e configurações de servidor MCP.

Um plug-in empacota personalizações, mas não substitui suas finalidades individuais.

Que problema os plug-ins resolvem?

Os plug-ins ajudam você:

Adicione recursos relacionados sem configurar cada peça separadamente.
Distribua um conjunto de personalizações para sua equipe ou para o público.
Instale e atualize personalizações sem copiar manualmente arquivos.

Quando você deve usar um plug-in?

Use um plug-in quando:

Você quer um pacote para toda a equipe. Por exemplo, compartilhe habilidades de resposta a incidentes, um agente de revisão e a configuração do servidor MCP para serviços internos.
Você deseja instalar e manter os recursos relacionados juntos.

Quando você não deve usar um plug-in?

Comece com personalizações individuais quando:

Você está experimentando localmente e não precisa distribuir.
Você só precisa de um pequeno fluxo de trabalho. Uma única habilidade pode ser mais simples.

Saiba mais sobre plug-ins

Consulte Plug-ins para GitHub Copilot.

Juntando tudo: escolhendo a melhor opção

Comece com a menor personalização que resolve seu problema. Esses recursos podem funcionar juntos: uma habilidade pode descrever um fluxo de trabalho que usa ferramentas MCP e um plug-in pode distribuir ambos.

Requirement	Começar com
Quero que Copilot siga nossas convenções de repositório.	Instruções personalizadas
Quero um fluxo de trabalho repetível para um tipo específico de tarefa.	Habilidades do agente
Quero que um agente pesquise meu repositório, altere arquivos ou execute testes.	As ferramentas existentes dele
Preciso de ferramentas fornecidas por um serviço externo.	Um servidor MCP
Quero verificações ou automação em torno do uso de ferramentas e eventos de sessão.	Ganchos
Quero uma subtarefa focada tratada separadamente da conversa principal.	Subagentes
Quero um especialista que possa ser reutilizado, com uma abordagem e um conjunto de ferramentas específicos.	Um agente personalizado
Preciso criar minhas próprias ferramentas em Copilot CLI.	Uma extensão
Quero instalar ou compartilhar personalizações relacionadas em conjunto.	Um plug-in

Próximas Etapas

Para obter locais de configuração e suporte ao Surface, consulte Guia de personalização rápida do Copilot.

Comparando os recursos de personalização do Copilot

Neste artigo