Este artigo foi elaborado para ajudar você a criar uma Extensão do GitHub Copilot totalmente nova. Para saber como criar e testar rapidamente uma demonstração da Extensão do Copilot criada pelo GitHub, confira Início Rápido das Extensões do GitHub Copilot usando agentes.
Conjuntos de habilidades e agentes são as duas maneiras de estender as funcionalidades e o contexto do Copilotpor meio do Plataforma de Extensibilidade do Copilot. Eles permitem que você integre serviços externos e APIs ao Copilot Chat, mas cada um deles atende a diferentes casos de uso e oferece diferentes níveis de controle e complexidade:
- Conjuntos de habilidades são leves e simplificados, projetados para desenvolvedores que precisam do Copilot para executar tarefas específicas (por exemplo, recuperação de dados ou operações simples) com configuração mínima. Eles lidam com roteamento, criação de prompts, avaliação de função e geração de resposta automaticamente, tornando-os ideais para integrações rápidas e simples. Para obter mais informações sobre conjuntos de habilidades, confira Sobre os conjuntos de habilidades do Copilot.
- Agentes são para integrações complexas que precisam de controle total sobre como as solicitações são processadas e as respostas são geradas. Eles permitem que você implemente a lógica personalizada, integre-se a outras LLMs e/ou à API do Copilot, gerencie o contexto da conversa e lide com todos os aspectos da interação do usuário. Embora os Agentes exijam mais engenharia e manutenção, eles oferecem flexibilidade máxima para fluxos de trabalho sofisticados. Para saber mais sobre agentes, confira Sobre os agentes do Copilot.
1. Saiba mais sobre Agentes do Copilot
Os Agentes do Copilot contêm o código personalizado para sua Extensão do Copilot e se integram a um GitHub App para formar a própria . Para saber mais, confira Sobre os agentes do Copilot.
Para construir um Agente do Copilot de forma bem-sucedida, você precisa entender como o agente se comunica com:
- A plataforma Copilot usando eventos enviados pelo servidor. Confira Configurar o agente do Copilot para se comunicar com a plataforma Copilot.
- A API GitHub. Confira Configurar o agente do Copilot para se comunicar com o GitHub.
2. Revise o exemplo de Agentes do Copilot e o SDK das Extensões do Copilot
Para ver os conceitos anteriores na prática e saber mais sobre implementações de agentes, revise os seguintes agentes de exemplo e o SDK (Software Development Kit), todos disponíveis na organização copilot-extensions:
- Blackbeard (melhor ponto de partida): um agente simples que responde a solicitações como um pirata usando a API do grande modelo de linguagem (LLM) do Copilot e prompts do sistema especiais.
- GitHub Models: um agente mais complexo que permite perguntar e interagir com vários LLMs listados no GitHub Marketplace via Copilot Chat. O agente GitHub Models usa o recurso de chamada de função.
- Chamada de função: um agente de exemplo escrito em Go que demonstra caixas de diálogo de confirmação e chamada de função.
- Extensão RAG: um agente de exemplo escrito em Go que demonstra uma implementação simples de geração aumentada de recuperação.
- SDK de visualização: um SDK que simplifica o desenvolvimento de Extensões do Copilot cuidando automaticamente da verificação de solicitação, da análise de payloads e da formatação de resposta. Esse SDK permite que os criadores de extensões se concentrem mais na criação de funcionalidades principais e menos em código clichê.
3. Criar um Agente do Copilot
Usando o material de referência das etapas anteriores, planeje e crie seu Agente do Copilot. Você pode optar por implementar uma das seguintes opções:
- Para evitar a criação e o gerenciamento de sua própria implantação de LLM, seu agente pode chamar a implantação do Copilot LLM. Confira Usar o LLM do Copilot para seu agente.
- Para interpretar rapidamente a entrada do usuário e escolher entre uma variedade de funções predefinidas a serem executadas, você pode implementar a chamada de função em seu agente. Para saber mais, consulte Como usar a chamada de função com o Serviço OpenAI do Azure na documentação do OpenAI do Azure e Chamada de função na documentação do OpenAI.
4. Implantar seu Agente do Copilot
Para tornar seu Agente do Copilot acessível à plataforma Copilot e ao GitHub, você precisa implantá-lo em um servidor que possa ser acessado por solicitação HTTP. Confira Configurando o servidor para hospedar a extensão do Copilot.
5. Criar um GitHub App e integrá-lo ao seu Agente do Copilot
Para criar um Extensão do Copilot, você precisa criar e configurar um GitHub App e, em seguida, integrá-lo ao seu Agente do Copilot. Confira Criar um aplicativo GitHub para sua extensão do Copilot e Configurar o Aplicativo GitHub para a extensão do Copilot.
6. Escolher a disponibilidade da sua Extensão do Copilot
Escolha um dos dois níveis de visibilidade para sua Extensão do Copilot:
- Pública: qualquer conta de usuário ou organização com o link da página de instalação da extensão pode instalá-la.
- Privada: somente a conta de usuário ou organização que criou a extensão pode instalá-la.
Se a Extensão do Copilot for pública, talvez você queira listá-la no GitHub Marketplace.
Para saber como alterar a visibilidade da sua Extensão do Copilot e listá-lo no GitHub Marketplace, confira Gerenciar a disponibilidade da sua extensão do Copilot.
Próximas etapas
Para saber como usar sua Extensão do Copilot, confira Usando extensões para integrar ferramentas externas ao Copilot Chat.
1. Saiba mais sobre Conjuntos de habilidades do Github Copilot
Os Conjuntos de habilidades do Github Copilot contêm o código personalizado para sua Extensão do Copilot e se integram a um GitHub App para formar a própria .
Diferente de Agentes do Copilot, os Conjuntos de habilidades do Copilot lidam com a lógica por trás da criação de prompt, avaliação de função e geração de resposta, tornando-os uma opção ideal para desenvolvedores que buscam integrações rápidas e eficazes com esforço mínimo. Para saber mais, confira Sobre os conjuntos de habilidades do Copilot.
2. Criar um Conjunto de habilidades do Copilot
Para explorar um exemplo de implementação de conjunto de habilidades, consulte o repositório skillset-example na organização copilot-extensions.
Para criar um conjunto de habilidades, confira Criando conjuntos de habilidades do Copilot.
3. Implantar seu Conjunto de habilidades do Copilot
Para tornar seu Conjunto de habilidades do Copilot acessível à plataforma Copilot e ao GitHub, você precisa implantá-lo em um servidor que possa ser acessado por solicitação HTTP. Confira Configurando o servidor para hospedar a extensão do Copilot.
4. Criar um GitHub App e integrá-lo ao seu Conjunto de habilidades do Copilot
Para criar um Extensão do Copilot, você precisa criar e configurar um GitHub App e, em seguida, integrá-lo ao seu Conjunto de habilidades do Copilot. Confira Criar um aplicativo GitHub para sua extensão do Copilot e Configurar o Aplicativo GitHub para a extensão do Copilot.
5. Escolher a disponibilidade do Conjunto de habilidades do Copilot
Escolha um dos dois níveis de visibilidade para sua Extensão do Copilot:
- Pública: qualquer conta de usuário ou organização com o link da página de instalação da extensão pode instalá-la.
- Privada: somente a conta de usuário ou organização que criou a extensão pode instalá-la.
Se a Extensão do Copilot for pública, talvez você queira listá-la no GitHub Marketplace.
Para saber como alterar a visibilidade da sua Extensão do Copilot e listá-lo no GitHub Marketplace, confira Gerenciar a disponibilidade da sua extensão do Copilot.
Próximas etapas
Para saber como usar sua Extensão do Copilot, confira Usando extensões para integrar ferramentas externas ao Copilot Chat.