Configurar extensões 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 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 "Configuring your server to host your Copilot extension".

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 "Configuring your GitHub App for your Copilot extension".

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".