Note
As GitHub Copilot Extensions estão em versão prévia pública e sujeitas a alterações.
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 obter mais informações, consulte "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. Consulte "Configurar o agente do Copilot para se comunicar com a plataforma Copilot".
- A API GitHub. Consulte "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. Consulte "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. Consulte "Configurar o servidor para implantar o agente 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. Consulte "Criar um aplicativo GitHub para sua extensão do Copilot" e "Configurar seu aplicativo GitHub para o agente 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, consulte "AUTOTITLE".
Próximas etapas
Para saber como usar sua Copilot Extension, consulte "AUTOTITLE".