Partilhar via


Adicione seu projeto de resposta a perguntas personalizado ao Power Virtual Agents

Crie e estenda um bot do Power Virtual Agents para fornecer respostas do seu projeto.

Nota

A integração demonstrada neste tutorial está em pré-visualização e não se destina à implantação em ambientes de produção.

Neste tutorial, irá aprender a:

  • Criar um bot do Power Virtual Agents
  • Criar um tópico de fallback do sistema
  • Adicionar respostas a perguntas personalizadas como uma ação a um tópico como um fluxo do Power Automate
  • Crie uma solução Power Automate
  • Adicione um fluxo Power Automate à sua solução
  • Publicar agentes virtuais de energia
  • Teste os Agentes Virtuais do Power e receba uma resposta do seu projeto personalizado de resposta a perguntas

Nota

O serviço QnA Maker será desativado no dia 31 de março de 2025. Uma versão mais recente do recurso de perguntas e respostas agora está disponível como parte da Linguagem de IA do Azure. Para obter recursos personalizados de resposta a perguntas dentro do Serviço de Idiomas, consulte Resposta personalizada a perguntas. A partir de 1º de outubro de 2022, você não poderá criar novos recursos do QnA Maker. Para obter informações sobre como migrar bases de conhecimento existentes do QnA Maker para respostas personalizadas a perguntas, consulte o guia de migração.

Criar e publicar um projeto

  1. Siga o início rápido para criar um projeto personalizado de resposta a perguntas. Depois de implantar seu projeto.
  2. Depois de implantar seu projeto a partir do Language Studio, selecione "Obter URL de previsão".
  3. Obtenha o URL do seu Site a partir do nome de anfitrião do URL de Previsão e da sua chave de Conta que seria a Ocp-Apim-Subscription-Key.

Captura de ecrã de como obter o URL de previsão e a chave de subscrição apresentados.

  1. Criar um conector de resposta a perguntas personalizado: siga a documentação do conector para criar uma conexão com a resposta a perguntas.
  2. Use este tutorial para criar um Bot com Power Virtual Agents em vez de criar um bot do Language Studio.

Criar um bot no Power Virtual Agents

O Power Virtual Agents permite que as equipes criem bots poderosos usando uma interface gráfica guiada e sem código. Você não precisa de cientistas de dados ou desenvolvedores.

Crie um bot seguindo as etapas em Criar e excluir bots do Power Virtual Agents.

Criar o tópico de fallback do sistema

No Power Virtual Agents, você cria um bot com uma série de tópicos (áreas temáticas), a fim de responder às perguntas do usuário executando ações.

Embora o bot possa se conectar ao seu projeto a partir de qualquer tópico, este tutorial usa o tópico de fallback do sistema. O tópico de fallback é usado quando o bot não consegue encontrar uma resposta. O bot passa o texto do usuário para a API da base de conhecimento Query de resposta a perguntas personalizadas, recebe a resposta do seu projeto e a exibe para o usuário como uma mensagem.

Crie um tópico de fallback seguindo as etapas em Configurar o tópico de fallback do sistema em Power Virtual Agents.

Usar a tela de criação para adicionar uma ação

Use a tela de criação do Power Virtual Agents para conectar o tópico de fallback ao seu projeto. O tópico começa com o texto do usuário não reconhecido. Adicione uma ação que passe esse texto para a resposta personalizada à pergunta e, em seguida, mostre a resposta como uma mensagem. A última etapa de exibição de uma resposta é tratada como uma etapa separada, mais adiante neste tutorial.

Esta seção cria o fluxo de conversa do tópico de fallback.

A nova ação de fallback já pode ter elementos de fluxo de conversa. Exclua o item Escalar selecionando o menu Opções .

Captura de tela de como excluir elementos de fluxo de conversa existentes.

Abaixo do nó Mensagem , selecione o ícone (+) e, em seguida, selecione Chamar uma ação.

Captura de tela de como selecionar o recurso Chamar uma ação.

Selecione Criar um fluxo. Isso leva você ao portal Power Automatic.

Captura de tela de onde encontrar a ação Criar um fluxo.

O Power Automate abre um novo modelo, conforme mostrado abaixo.

Captura de ecrã do modelo predefinido Power Automatic.Não use o modelo mostrado acima.

Em vez disso, você precisa seguir as etapas abaixo que criam um fluxo Power Automatic. Este fluxo:

  • Pega o texto do usuário de entrada como uma pergunta e o envia para a resposta personalizada à pergunta.
  • Retorna a resposta superior de volta ao seu bot.

selecione Criar no painel esquerdo e, em seguida, clique em "OK" para sair da página.

Captura de ecrã da ação Criar no painel esquerdo e uma mensagem de confirmação para navegar para fora da página.

Selecione "Instant Cloud flow"

Captura de ecrã da caixa de seleção Fluxo instantâneo na nuvem.

Para testar esse conector, você pode selecionar "Quando os agentes PowerVirtual chamam um fluxo" e selecionar Criar.

Captura de tela da seleção Quando o Power Virtual Agents chama um fluxo na lista Escolha como acionar esse fluxo.

Selecione "New Step" e procure por "Power Virtual Agents". Escolha "Adicionar uma entrada" e selecione o texto. Em seguida, forneça a palavra-chave e o valor.

Captura de ecrã da opção Adicionar uma entrada.

Selecione "Nova etapa" e pesquise "Idioma - resposta personalizada à pergunta" e escolha "Gerar resposta do projeto" das três ações.

Captura de tela da seleção Gerar resposta do Projeto na lista Ação.

Esta opção ajuda a responder à pergunta especificada usando seu projeto. Digite o nome do projeto, o nome da implantação e a versão da API e selecione a pergunta na etapa anterior.

Captura de tela dos campos para a ação Gerar resposta do projeto.

Selecione "New Step" e procure por "Initialize variable". Escolha um nome para sua variável e selecione o tipo "String".

Captura de tela dos campos de ação Inicializar variável.

Selecione "Nova etapa" novamente e procure por "Aplicar a cada um", selecione a saída das etapas anteriores e adicione uma ação de "Definir variável" e selecione a ação do conector.

Captura de tela da ação Definir variável dentro de Aplicar a cada etapa.

Selecione "Nova etapa" e procure por "Retornar valor(es) para Power Virtual Agents" e digite uma palavra-chave e, em seguida, escolha o nome da variável anterior na resposta.

Captura de tela da etapa Retornar valor(es) para Power Virtual Agents, contendo a variável anterior.

A lista de etapas concluídas deve ter esta aparência.

Captura de ecrã da lista completa de passos concluídos no Power Virtual Agents.

Selecione Guardar para guardar o fluxo.

Criar uma solução e adicionar o fluxo

Para que o bot encontre e se conecte ao fluxo, o fluxo deve ser incluído em uma solução Power Automatic.

  1. Ainda no portal Power Automatic, selecione Soluções na navegação do lado esquerdo.
  2. Selecione + Nova solução.
  3. Introduza um nome a apresentar. A lista de soluções inclui todas as soluções da sua organização ou escola. Escolha uma convenção de nomenclatura que o ajude a filtrar apenas as suas soluções. Por exemplo, você pode prefixar seu e-mail para o nome da solução: jondoe-power-virtual-agent-question-answering-fallback.
  4. Selecione o seu editor na lista de escolhas.
  5. Aceite os valores padrão para o nome e a versão.
  6. Selecione Criar para concluir o processo.

Adicione seu fluxo à solução

  1. Na lista de soluções, selecione a solução que acabou de criar. Deve estar no topo da lista. Se não estiver, pesquise pelo seu nome de e-mail, que faz parte do nome da solução.
  2. Na solução, selecione + Adicionar existente e, em seguida, selecione Fluxo na lista.
  3. Encontre seu fluxo na lista Soluções externas e selecione Adicionar para concluir o processo. Se houver muitos fluxos, observe a coluna Modificado para encontrar o fluxo mais recente.

Adicione o fluxo da sua solução aos Power Virtual Agents

  1. Retorne à guia do navegador com seu bot no Power Virtual Agents. A tela de criação ainda deve estar aberta.
  2. Para inserir uma nova etapa no fluxo, acima da caixa de ação Mensagem, selecione o ícone de adição (+). Em seguida, selecione Chamar uma ação.
  3. Na janela pop-up Fluxo, selecione o novo fluxo chamado Gerar respostas usando o Projeto de Resposta a Perguntas.... A nova ação aparece no fluxo.

Captura de tela da ação Chamar uma ação usando o fluxo Gerar respostas usando o Projeto de Resposta a Perguntas.

  1. Para definir corretamente a variável de entrada para a ação QnA Maker, selecione Selecionar uma variável e, em seguida, selecione bot. UnrecognizedTriggerPhrase.

Captura de tela do bot selecionado. UnrecognizedTriggerPhrase variável dentro da chamada de ação.

  1. Para definir corretamente a variável de saída para a ação personalizada Responder a perguntas, na ação Mensagem, selecione UnrecognizedTriggerPhrase, selecione o ícone para inserir uma variável, {x} e, em seguida, selecione FinalAnswer.
  2. Na barra de ferramentas de contexto, selecione Salvar para salvar os detalhes da tela de criação do tópico.

Veja como é a tela final do bot:

Captura de tela da tela do bot concluída.

Testar o bot

Ao projetar seu bot no Power Virtual Agents, você pode usar o painel Testar bot para ver como o bot conduz um cliente através da conversa do bot.

  1. No painel de teste, alterne Rastrear entre tópicos. Isso permite que você observe a progressão entre tópicos, bem como dentro de um único tópico.
  2. Teste o bot inserindo o texto do usuário na seguinte ordem. A tela de criação relata as etapas bem-sucedidas com uma marca de seleção verde.
Ordem das perguntas Perguntas do teste Objetivo
1 Hello (Olá) Iniciar conversa
2 Horário da loja Tópico de exemplo. Isso é configurado para você sem qualquer trabalho adicional de sua parte.
3 Sim Em resposta a "Isso respondeu à sua pergunta?"
4 Excelente Em resposta a "Por favor, classifique sua experiência."
5 Sim Em resposta a "Posso ajudar com mais alguma coisa?"
6 Como posso melhorar o desempenho da taxa de transferência para previsões de consulta? Esta pergunta aciona a ação de fallback, que envia o texto para o seu projeto para responder. Em seguida, a resposta é mostrada. As marcas de verificação verdes para as ações individuais indicam o sucesso de cada ação.

Captura de tela do bot de teste completo em execução junto com o fluxo do tutorial.

Publicar o seu bot

Para disponibilizar o bot para todos os membros da sua organização, você precisa publicá-lo.

Publique seu bot seguindo as etapas em Publicar seu bot.

Compartilhe seu bot

Para disponibilizar seu bot para outras pessoas, primeiro você precisa publicá-lo em um canal. Para este tutorial, usaremos o site de demonstração.

Configure o site de demonstração seguindo as etapas em Configurar um chatbot para um site ao vivo ou de demonstração.

Em seguida, você pode compartilhar o URL do seu site com os membros da sua escola ou organização.

Clean up resources (Limpar recursos)

Quando terminar o projeto, remova os recursos do QnA Maker no portal do Azure.

Consulte também