Note
As GitHub Copilot Extensions estão em versão prévia pública e sujeitas a alterações.
Este artigo foi elaborado para ajudar você a criar um GitHub Copilot Extension totalmente novo. Para saber como criar e testar rapidamente uma demonstração do Copilot Extension 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 Copilot Extensibility Platform. 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 o Copilot agents
Os Copilot agents contêm o código personalizado para sua Copilot Extension e se integram a um GitHub App para formar a própria Copilot Extension. Para saber mais, confira Sobre os agentes do Copilot.
Para construir um Copilot agent 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 Copilot agents e o SDK das Copilot Extensions
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 Copilot Extensions manipulando a verificação de solicitação, a análise de payloads e a formatação automática 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. Crie um Copilot agent
Usando o material de referência das etapas anteriores, planeje e crie seus Copilot agent. 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. Implante seu Copilot agent
Para tornar seu Copilot agent 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. Crie um GitHub App e integre-o ao seu Copilot agent
Para criar uma Copilot Extension, você precisa criar e configurar um GitHub App e, em seguida, integrá-lo ao seu Copilot agent. Confira Criar um aplicativo GitHub para sua extensão do Copilot e Configurar o Aplicativo GitHub para a extensão do Copilot.
6. Escolha a disponibilidade da sua Copilot Extension
Escolha um dos dois níveis de visibilidade para sua Copilot Extension:
- 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 Copilot Extension for pública, talvez você queira listá-la no GitHub Marketplace.
Para saber como alterar a visibilidade da seu Copilot Extension e listá-lo no GitHub Marketplace, confira Gerenciar a disponibilidade da sua extensão do Copilot.
Próximas etapas
Para saber como usar sua Copilot Extension, confira Usando extensões para integrar ferramentas externas ao Copilot Chat.
1. Saiba mais sobre Github Copilot skillsets
Os Github Copilot skillsets contêm o código personalizado para sua Copilot Extension e se integram a um GitHub App para formar a própria Copilot Extension.
Diferente do Copilot agents, os Copilot skillsets 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 Copilot skillset
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 Copilot skillset
Para tornar seu Copilot skillset 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 integre-o ao seu Copilot skillset
Para criar uma Copilot Extension, você precisa criar e configurar um GitHub App e, em seguida, integrá-lo ao seu Copilot skillset. Confira Criar um aplicativo GitHub para sua extensão do Copilot e Configurar o Aplicativo GitHub para a extensão do Copilot.
5. 6. Escolha a disponibilidade da sua Copilot skillset
Escolha um dos dois níveis de visibilidade para sua Copilot Extension:
- 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 Copilot Extension for pública, talvez você queira listá-la no GitHub Marketplace.
Para saber como alterar a visibilidade da seu Copilot Extension e listá-lo no GitHub Marketplace, confira Gerenciar a disponibilidade da sua extensão do Copilot.
Próximas etapas
Para saber como usar sua Copilot Extension, confira Usando extensões para integrar ferramentas externas ao Copilot Chat.