Criar ações de conversa para o Microsoft Copilot

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.

Observação

As ações eram anteriormente conhecidas como Plug-ins. Alguns artigos e capturas de tela podem fazer referência a Ações 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 uma Ação do Copilot. Depois que o Administrador do Locatário aprovar a Ação, ela poderá ser adicionada às experiências do M365 Chat da sua organização.

Você pode criar uma ação de conversa que recebe a consulta do usuário (armazenada na variável Activity.Text), a processa 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 ações de conversa que você criou no Microsoft Copilot Studio como uma ação de plug-in.

O que é uma ação de copiloto e como ela 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. Esse sistema interpreta a solicitação do usuário, determinando o melhor curso de ação, em seguida, ativa o sistema, ação, componente ou série de componentes apropriados. Finalmente, um resultado gerado é retornado ao usuário.

Uma ação de conversa interna do Microsoft Copilot Studio permite que você estenda 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 embutido no código com o copiloto, um criador no Microsoft Copilot Studio cria uma ação de conversa. Esse criador fornece o texto descritivo para o orquestrador do Microsoft Copilot sobre as habilidades da ação. O orquestrador pode tomar sua própria decisão sobre quando a ação seria mais útil e fazer perguntas apropriadas ao usuário para preencher os parâmetros da ação.

Pré-requisitos

• Os usuários finais devem ter uma licença para usar o Microsoft Copilot for Microsoft 365.
• Seu locatário do Power Platform deve ser configurado para habilitar as ações de publicação, conforme descrito no artigo do Copilot for Microsoft 365 Criar plug-ins usando o Microsoft Business Applications.
• 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 versão, há 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. Nenhuma mídia ou cartões adaptáveis serão suportados.
• 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 versão é limitada a copilotos de língua inglesa.
• Todos os usuários do Microsoft Copilot em sua organização poderão interagir com a ação, a ação não suportará a autorização do próprio usuário.

Criando uma ação de conversa básica 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 uma nova ação 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 habilitar a ação na interface do usuário.

1. No painel de navegação no Copilot Studio, escolha os Copilots.
2. Na lista de Copilots, selecione o Microsoft Copilot que você deseja estender. A página de informações do Copilot específico é exibida.
3. Selecione a guia Ações/Extensões.
4. Os detalhes aqui dependerão do Microsoft Copilot específicos que você deseja estender.
   • Se você vir um botão + Adicionar extensão, selecione + Adicionar extensão e selecione Nova ação.
   • Se vir +Adicionar ação, selecione +Adicionar ação.
5. Selecione Conversacional para criar uma ação conversacional. Uma janela Criar uma ação de conversa é exibida, permitindo que você defina algumas configurações básicas para a ação de conversa.
6. Escolha um nome e idioma principal. Opcionalmente, você também pode selecionar uma solução e um nome de esquema para usar.
7. Selecione Criar para continuar. Sua nova ação de conversa levará alguns instantes para ser criada. Quando terminar, você será solto na tela de criação de conversas.
8. Selecione a guia Tópicos para editar sua ação de conversa.
9. 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.
10. Na descrição do nó de Gatilho, forneça uma descrição clara de como a ação 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 sua ação ou não. Use frases claras para descrever o que sua ação faz pelo usuário e o que ela retorna.
11. Na ação de conversa, crie qualquer tipo de lógica que não exija interação do usuário. Não deve haver botões, perguntas, cartões ou outros prompts. O menu da tela de criação para ações de conversa é limitado para remover opções que possam exigir interação do usuário.
12. Para este exemplo, vamos usar o nó Respostas Generativas para pesquisar conteúdo da Web em um site específico e fornecer uma resposta ao usuário no Microsoft Copilot.
13. Para usar o nó Respostas Generativas, 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.
14. Para o campo Entrada, chame o seletor de variáveis selecionando a seta na caixa Entrada.
15. 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 Microsoft Copilot chamasse a ação.
16. Selecione o editor Fontes de Dados no centro do bloco Criar respostas generativas. É exibida uma janela de configuração Criar propriedades de respostas generativas.
17. Em Dados clássicos e Fontes de dados dentro do campo Sites públicos 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. Como alternativa, em Fontes de conhecimento, selecione + Adicionar conhecimento para abrir a caixa de diálogo Adicionar fontes de conhecimento disponíveis para adicionar um site público lá. Para obter mais informações sobre como adicionar conhecimento, consulte Adicionar conhecimento a um copiloto.

    Observação

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

18. 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
19. Se desejar, você pode enviar uma ou mais mensagens ao usuário como resposta. Você pode usar um nó Enviar uma Mensagem ou outra chamada do nó Resposta Generativa, ou várias dessas ações, conforme sua ação de conversa precisar.
20. Se sua ação precisar receber parâmetros de entrada de um Conector e/ou passar parâmetros de saída para um conector, você poderá Adicionar variáveis de entrada e saída
21. Finalmente, selecione Salvar para salvar sua ação de conversa.

Publicando sua ação de conversa no Microsoft Copilot

Publicar sua ação de conversa cria uma nova ação no registro do Dataverse de seu Locatário. Uma vez disponível lá, o administrador do locatário precisará aprovar sua ação para que fique disponível aos usuários no catálogo de ações do Microsoft Copilot.

No Microsoft Copilot, sua ação de conversa é rotulada como Nome da ação de conversa na interface do usuário para adicionar ações. Dessa forma, especifique o nome da ação de conversa e o nome do copiloto para facilitar a leitura.

Para publicar sua ação de conversa:

1. Primeiro, crie e salve sua ação de conversa, conforme descrito na seção anterior.

2. Pressione Publicar acima da tela para publicar a ação de conversa.

3. Selecione Publicar. Uma caixa de diálogo Publicar conteúdo mais recente? é aberta.

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

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

1. 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 sua ação de conversa do catálogo, nos detalhes da ação de conversa, desmarque a caixa de seleção Status, salve sua ação 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 de sua ação de conversa é fundamental para a confiabilidade com que ela será invocada. A descrição ensina ao Orquestrador em que sua ação é boa e quais respostas ela pode fornecer. Certifique-se de usar uma linguagem clara ao escrever a descrição e experimente alterações para obter o melhor resultado.