Criar plug-ins de conversa para o Microsoft Copilot (versão preliminar)

Importante

As capacidades e os recursos do Power Virtual Agents agora fazem parte do Microsoft Copilot Studio após investimentos significativos em IA generativa e integrações aprimoradas no Microsoft Copilot.

Alguns artigos e capturas de tela podem fazer referência ao Power Virtual Agents enquanto atualizamos a documentação e o conteúdo do treinamento.

O Microsoft Copilot oferece experiências prontas para uso para interagir com conteúdo e recursos de toda a sua organização. Em algumas situações, são necessárias respostas e interação com sistemas externos. Com o Microsoft Copilot Studio, você pode criar um tópico de conversa que pode ser publicado como um plug-in do Copilot. Depois que o Administrador do Locatário aprovar o Plug-in, ele poderá ser adicionado às experiências do M365 Chat da sua organização.

Para esta visualização, você pode criar um plug-in de conversa que recebe a consulta do usuário (armazenada na variável Activity.Text), a processe concluindo uma ou mais operações e, em seguida, envia uma ou mais respostas de volta ao usuário no M365 Chat.

Importante

Você não pode usar plug-ins de conversa que você criou no Microsoft Copilot Studio como uma ação de plug-in.

O que é um Plug-in do Microsoft Copilot e como ele funciona?

O sistema de conversa do Microsoft Copilot usa a lógica de orquestração e grandes modelos de linguagem para ajudar o usuário a atingir suas metas. Este sistema interpreta a solicitação do usuário, determinando o melhor curso de ação e, em seguida, ativa o sistema, plug-in, componente ou série de componentes apropriado. Finalmente, um resultado gerado é retornado ao usuário.

Um plug-in de conversa integrado no Microsoft Copilot Studio permite ampliar o comportamento do seu aplicativo. Você pode criar novas habilidades que não estão nativamente no Microsoft Copilot, como chamar uma API específica, aplicar lógica de negócios sofisticada ou acessar fontes de dados que exigem configuração fora do acesso do Microsoft Copilot.

Ao contrário de um modelo de componente tradicional que cria um ponto de integração codificado com o copiloto, um criador do Microsoft Copilot Studio cria um plug-in de conversa. Este criador fornece um texto descritivo ao orquestrador do Microsoft Copilot sobre as habilidades do plug-in. O orquestrador pode então tomar sua própria decisão sobre quando o plug-in seria mais útil e fazer perguntas apropriadas ao usuário para preencher os parâmetros do plug-in.

Pré-requisitos

• Os usuários finais devem ter uma licença para usar o Microsoft Copilot for Microsoft 365.
• O aplicativo Microsoft Copilot Studio deve ser um copiloto do Microsoft Copilot Studio, não um bot "Clássico" do Power Virtual Agents.
• Antes que a ponta a ponta funcione, o Administrador do Locatário do Microsoft 365 precisa habilitar a categoria de Aplicativos Integrados e o Microsoft Copilot Studio no Centro de Administração da Microsoft.

Observação

O bloco no Centro de Administração da Microsoft era anteriormente Dynamics 365 e Microsoft Copilot Studio e foi dividido em dois Dynamics 365 e Microsoft Copilot Studio. Apenas o último é necessário para que este recurso funcione.

Importante

Nesta visualização, existem algumas limitações:

• Seu tópico não poderá interagir (fazer perguntas) ao usuário e só poderá processar a consulta recebida do usuário (na variável Activity.Text) e enviar uma resposta.
• As respostas serão limitadas a texto, não haverá suporte à mídia ou aos cartões adaptáveis.
• Nesta versão preliminar, o Copilot Studio não pode autenticar o usuário, portanto as fontes do SharePoint e do OneDrive para respostas generativas não funcionarão.
• Esta prévia será limitada a copilotos de língua inglesa.
• Todos os usuários do Microsoft Copilot em sua organização poderão interagir com o copiloto, o copiloto não oferecerá suporte à autorização do próprio usuário.
• Se o seu Ambiente do Dataverse tiver um grupo de segurança atribuído, o plug-in poderá não estar visível ou não funcionar no M365 Chat.

Criando um plug-in de conversa básico para publicar no Microsoft Copilot

O tópico usado no chat do Microsoft Copilot usa a variável do Sistema Activity.Text como uma entrada que representa a pergunta do usuário no Microsoft Copilot. O chat processa a variável, passando-a para Respostas Generativa e retorna o resultado como uma ou mais mensagens. Essas mensagens podem incluir a resposta que vem dos nós de Respostas Gerativas ou Enviar uma Mensagem. Várias mensagens podem ser incluídas e enviadas separadamente para formar a saída.

As etapas a seguir ajudam você a criar um novo plug-in de conversa no Microsoft Copilot Studio. Você cria recursos básicos e os publica no Centro de Administração da Microsoft. Você pode escolher e ativar o plug-in na Interface do Usuário.

1. No painel de navegação esquerdo do Copilot Studio, escolha a opção Estender Microsoft Copilot (versão preliminar) e, em seguida, Plug-ins de conversa.
2. Nessa página, escolha Adicionar plug-in de conversa na barra acima da tela de criação, que abre a tela de criação com um novo plug-in de conversa.
3. A tela de criação aparece com um novo nó de disparo do Microsoft Copilot (versão preliminar).
4. Antes de continuar a criação, defina o nome do tópico no painel superior acima da tela de criação. Esse nome fica visível para o usuário e o administrador no Microsoft Copilot e no Centro de Administração da Microsoft, respectivamente.
5. Na descrição do nó de Gatilho, forneça uma descrição clara de como o plug-in de conversa pode ajudar o usuário e o que ele pode fazer. Ao contrário de outras descrições, esta tem finalidade funcional e é usada pelo Microsoft Copilot para determinar se deve invocar seu plug-in ou não. Use frases claras para descrever o que seu plug-in faz pelo usuário e o que ele retorna.
6. No plug-in de conversa, crie qualquer tipo de lógica que não exija interação do usuário (sem botões, perguntas, cartões ou outros prompts). O menu da tela de criação para plug-ins de conversa é limitado para remover opções que possam exigir interação do usuário.
7. Para este exemplo, usamos o nó Respostas Generativas para executar uma pesquisa de conteúdo da Web e fornecer uma resposta ao usuário no Microsoft Copilot.
8. Para usar o nó Gerar Respostas, selecione o sinal de adição na tela sob o nó de gatilho e selecione Respostas generativas na guia Avançado do menu pop-up.
9. Para o campo Entrada, chame o seletor de variáveis selecionando a seta na caixa Entrada.
10. Escolha a variável do sistema Activity.Text que representa a última consulta do usuário para o Microsoft 365 Copilot. Essa consulta foi feita pelo usuário no M365 Chat, o que fez com que o Microsoft Copilot invocasse o plug-in.
11. Selecione o link Fontes de Dados no centro do bloco Respostas Generativas.
12. Insira um link para um site público que tenha o conteúdo que você deseja para o seu bot. Este conteúdo da web é usado para responder às perguntas dos usuários.

    Observação

    Não escolha conteúdo que não seja indexado pelo Bing, por exemplo, redirecionamentos 301.

13. Assim que o link for adicionado (não se esqueça de clicar em "+" ao inserir o URL), o painel de propriedades pode ser fechado
14. Se desejar, você envia uma ou mais mensagens ao usuário como resposta. Você pode usar um nó Enviar uma Mensagem ou outra chamada do nó Gerar Resposta, ou várias dessas ações, conforme a necessidade do seu plug-in de conversa.
15. Por fim, o plug-in de conversa pode ser salvo com o ícone salvar no canto superior direito da página.

Publicando seu plug-in de conversa no Microsoft Copilot

Publicar seu plug-in de conversa cria um novo plug-in no registro do Dataverse do seu Inquilino. Uma vez disponível lá, o administrador do locatário precisará aprovar seu plug-in para que fique disponível aos usuários no catálogo de plug-ins do Microsoft Copilot.

No Microsoft Copilot, seu plug-in de conversa é rotulado como Nome do plug-in de conversa na interface do usuário de adição de plug-ins. Dessa forma, especifique o nome do plug-in de conversa e o nome do copiloto para facilitar a leitura.

Importante

Durante esta versão prévia, na primeira vez que você publicar seu plug-in de conversa, a interface do usuário de administração do Microsoft Copilot mostrará seu plug-in de conversa após aproximadamente quatro horas. As alterações feitas na parte interna do seu plug-in de conversa acontecerão imediatamente.

Se você desabilitar, em seguida, publicar seu plug-in de conversa e, depois, reativá-lo e republicá-lo, ocorrerá a espera de quatro horas novamente.

Para publicar seu plug-in de conversa:

1. Primeiro, crie e salve seu plug-in de conversa conforme descrito na seção anterior.

2. Acesse Publicar no painel de navegação lateral do Copilot Studio.

3. Escolha Publicar. A publicação deve ser concluída rapidamente. A disponibilidade real no Microsoft Admin Center pode levar até 4 horas. Se ocorrer um erro, tente novamente. Se o erro continuar, arquive um tíquete de suporte no Centro de Administração do Power Platform.

   

4. Seu Administrador pode encontrar o Copilot Studio aplicativo integrado no Centro de Administração da Microsoft em Configurações e, em seguida, em Aplicativos Integrados. Nesta versão preliminar, Implantar/Bloquear está apenas neste nível de categoria.

   

   Importante

   Atualmente, um administrador de locatário que implanta o bloco do Copilot Studio implantará todos os plug-ins criados para o locatário no público-alvo escolhido por eles. Seja específico ao considerar o público-alvo para o qual publicar.

5. Depois que o administrador do Locatário aprovar o aplicativo integrado e , ele deverá aparecer na lista de plug-ins do usuário na interface do usuário do Microsoft Copilot.

   

Uma vez habilitado, seu usuário poderá fazer perguntas ao Microsoft Copilot e ver o plug-in invocado e retornar os resultados mais relevantes.

Observação

Para remover seu plug-in de conversa do catálogo, nos detalhes do plug-in de conversa, desmarque a caixa de seleção Status, salve seu plug-in de conversa e publique-o novamente, o que o removerá do registro do Dataverse e do catálogo de aplicativos do Microsoft Copilot.

Dica

Interagir com o orquestrador do Microsoft Copilot provavelmente será uma experiência diferente daquela que você teria na integração com sistemas anteriores.

• O Microsoft Copilot sempre reescreve suas respostas com sua própria voz. Não é possível nesta visualização fazer com que o conteúdo seja transmitido inalterado ao usuário final.
• A descrição do seu plug-in de conversa é fundamental para a confiabilidade com que ele será invocado. A descrição ensina ao Orquestrador que seu plug-in é bom e quais respostas ele pode fornecer. Certifique-se de usar uma linguagem clara ao escrever a descrição e experimente alterações para obter o melhor resultado.