Este artigo foi elaborado para ajudar você a criar uma Extensão do Copilot totalmente nova. Para saber como criar e testar rapidamente uma demonstração da Extensão do Copilot criada pelo , confira Início Rápido das Extensões do 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.
Os Agentes do Copilot contêm o código personalizado para sua Extensão do Copilot e se integram a um 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 . Confira Configurar o agente do Copilot para se comunicar com o .
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.
- Models: um agente mais complexo que permite perguntar e interagir com vários LLMs listados no Marketplace via Copilot Chat. O agente 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ê.
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.
Para tornar seu Agente do Copilot acessível à plataforma Copilot e ao , 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.
Para criar um Extensão do Copilot, você precisa criar e configurar um App e, em seguida, integrá-lo ao seu Agente do Copilot. Confira Criar um aplicativo para sua extensão do Copilot e Configurar o Aplicativo para a 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 Marketplace.
Para saber como alterar a visibilidade da sua Extensão do Copilot e listá-lo no Marketplace, confira Gerenciar a disponibilidade da sua extensão do Copilot.
Para saber como usar sua Extensão do Copilot, confira Usando extensões para integrar ferramentas externas ao Copilot Chat.
Os Conjuntos de habilidades do Copilot contêm o código personalizado para sua Extensão do Copilot e se integram a um 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.
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.
Para tornar seu Conjunto de habilidades do Copilot acessível à plataforma Copilot e ao , 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.
Para criar um Extensão do Copilot, você precisa criar e configurar um App e, em seguida, integrá-lo ao seu Conjunto de habilidades do Copilot. Confira Criar um aplicativo para sua extensão do Copilot e Configurar o Aplicativo para a 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 Marketplace.
Para saber como alterar a visibilidade da sua Extensão do Copilot e listá-lo no Marketplace, confira Gerenciar a disponibilidade da sua extensão do Copilot.
Para saber como usar sua Extensão do Copilot, confira Usando extensões para integrar ferramentas externas ao Copilot Chat.