Tutorial: Adicionar sua base de dados de conhecimento ao Power Virtual Agents

Crie e estenda um bot do Power Virtual Agents para fornecer respostas da sua base de dados de conhecimento.

Observação

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

Neste tutorial, você aprenderá como:

• Criar um bot do Power Virtual Agents
• Criar um tópico de fallback do sistema
• Adicionar o QnA Maker como uma ação para um tópico como um fluxo do Power Automate
• Criar uma solução do Power Automate
• Adicionar um fluxo do Power Automate à sua solução
• Publicar Power Virtual Agents
• Testar o Power Virtual Agents e receber uma resposta da sua base de dados de conhecimento do QnA Maker

Observação

O serviço de QnA Maker está sendo desativado no dia 31 de março de 2025. Uma versão mais recente da funcionalidade de perguntas e respostas agora está disponível como parte da Linguagem de IA do Azure. Para saber mais sobre o recurso de respostas às perguntas no Serviço de Linguagem, confira respostas às perguntas. A partir de 1º de outubro de 2022, você não poderá criar novos recursos de QnA Maker. Para obter informações sobre como migrar bases de dados de conhecimento do QnA Maker existentes para responder à pergunta, consulte o Guia de migração.

Criar e publicar uma base de dados de conhecimento

1. Siga o início rápido para criar uma base de dados de conhecimento. Não conclua a última seção, sobre a criação de um bot. Em vez disso, use este tutorial para criar um bot com o Power Virtual Agents.

   

   Insira as configurações da base de dados de conhecimento publicadas encontradas na página Configurações no portal do QnA Maker. Você precisará dessas informações para a etapa do Power Automate para configurar a conexão GenerateAnswer do QnA Maker.

2. No portal do QnA Maker, na página Configurações, encontre a chave do ponto de extremidade, o host do ponto de extremidade e a ID da base de dados de conhecimento.

Criar bot no Power Virtual Agents

O Power Virtual Agents permite que as equipes criem bots avançados usando uma interface gráfica orientada 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 no 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 de assunto), a fim de responder às perguntas do usuário por meio da execução de ações.

Embora o bot possa se conectar à base de dados de conhecimento usando 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 transmite o texto do usuário para a API GenerateAnswer do QnA Maker, recebe a resposta da base de dados de conhecimento e a exibe ao usuário como uma mensagem.

Crie um tópico de fallback seguindo as etapas em Configurar o tópico de fallback do sistema no 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 à sua base de dados de conhecimento. O tópico começa com o texto de usuário não reconhecido. Adicione uma ação que transmite esse texto ao QnA Maker e, em seguida, mostra a resposta como uma mensagem. A última etapa da exibição de uma resposta será tratada como uma etapa separada mais adiante neste tutorial.

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

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

   

2. Acima do nó Mensagem, selecione o ícone de adição (+), depois escolha Chamar uma ação.

   

3. Escolha Criar um fluxo. O processo leva você ao portal do Power Automate.

   

   O Power Automate é aberto em um novo modelo. Você não usará esse novo modelo.

   

Criar um fluxo do Power Automate para se conectar à sua base de dados de conhecimento

Observação

Atualmente, o modelo do Power Automate não dá suporte para pontos de extremidade gerenciados (versão prévia) do QnA Maker. Para adicionar uma base de dados de conhecimento gerenciada (versão prévia) do QnA Maker ao Power Automate, ignore esta etapa e adicione manualmente os pontos de extremidade a ela.

O seguinte procedimento cria um fluxo do Power Automate que:

• Usa o texto de entrada do usuário e o envia para o QnA Maker.
• Retorna a resposta principal de volta ao bot.

1. Em Power Automate, selecione Modelos no painel de navegação à esquerda. Se for perguntado se deseja sair da página do navegador, aceite a saída.

2. Na página de modelos, pesquise pelo modelo Gerar resposta usando o QnA Maker e selecione-o. Este modelo tem todas as etapas para chamar o QnA Maker com as configurações da sua base de dados de conhecimento e retornar a resposta principal.

3. Na nova tela do fluxo do QnA Maker, selecione Continuar.

   

4. Selecione a caixa de ação Gerar Resposta e preencha as configurações do QnA Maker com base em uma seção anterior intitulada Criar e publicar uma base de dados de conhecimento. O Host de Serviço da imagem a seguir refere-se ao Host da base de dados de conhecimento e está no formato https://YOUR-RESOURCE-NAME.azurewebsites.net/qnamaker.

   

5. Selecione Salvar para salvar o fluxo.

Criar uma solução e adicionar o fluxo

Para que o bot encontre o fluxo e se conecte a ele, será preciso incluir o bot em uma solução do Power Automate.

1. Ainda no portal do Power Automate, escolha Soluções do painel de navegação do lado esquerdo.

2. Escolha + Nova solução.

3. Insira um nome de exibição. A lista de soluções inclui todas as soluções da sua organização ou da sua escola. Escolha uma convenção de nomenclatura que ajude a filtrar apenas suas soluções. Por exemplo, você pode usar seu email como prefixo do nome da solução: jondoe-power-virtual-agent-qnamaker-fallback.

4. Escolha o editor na lista de opções.

5. Aceite os valores padrão para o nome e a versão.

6. Selecione Criar para concluir o processo.

Adicionar seu fluxo à solução

1. Na lista de soluções, escolha a solução recém-criada. Ela deverá estar no início da lista. Caso contrário, pesquise seu nome de email, que faz parte do nome da solução.

2. Na solução, selecione + Adicionar existente e, em seguida, selecione Fluxo na lista.

3. Localize o fluxo na lista de Soluções Externas e, em seguida, selecione Adicionar para concluir o processo. Se houver muitos fluxos, observe a coluna Modificado para localizar o fluxo mais recente.

Adicionar o fluxo da sua solução ao Power Virtual Agents

1. Volte à guia do navegador com seu bot no Power Virtual Agents. A tela de criação ainda deverá 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 do Fluxo, selecione o novo fluxo chamado Gerar respostas usando a base de dados de conhecimento do QnA Maker... . A nova ação aparece no fluxo.

   

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

   

5. Para definir corretamente a variável de saída da ação do QnA Maker, na ação Mensagem selecione UnrecognizedTriggerPhrase e, em seguida, selecione o ícone para inserir uma variável, {x}, e selecione FinalAnswer.

6. Na barra de ferramentas de contexto, selecione Salvar para salvar os detalhes da tela de criação do tópico.

Veja a aparência final da tela do bot.

Testar o bot

Conforme você projeta seu bot no Power Virtual Agents, você pode usar o painel de teste de bot para ver como o bot conduz o cliente ao longo de uma conversa com o bot.

1. No painel de teste, alterne para Acompanhamento entre os tópicos. Isso permite que você inspecione à progressão entre tópicos, bem como dentro de um só tópico.

2. Teste o bot inserindo o texto do usuário na ordem a seguir. A tela de criação relata as etapas bem-sucedidas com uma marca de seleção verde.

   Ordem de perguntas	Testar perguntas	Finalidade
   1	Olá	Iniciar a conversa
   2	Horário de funcionamento	Tópico de exemplo. É configurado para você sem nenhum trabalho adicional da sua parte.
   3	Sim	Em resposta a Did that answer your question?
   4	Excelente	Em resposta a Please rate your experience.
   5	Sim	Em resposta a Can I help with anything else?
   6	Como posso melhorar o desempenho da taxa de transferência para previsões de consulta?	Essa pergunta dispara a ação de fallback, que envia o texto à base de dados de conhecimento para que ela forneça a resposta. Em seguida, a resposta é mostrada. as marcas de seleção verdes para as ações individuais indicam sucesso para cada ação.

   

Publicar seu bot

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

Publique seu bot seguindo as etapas em Publicar seu bot.

Compartilhar seu bot

Para disponibilizar seu bot a 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 dinâmico ou de demonstração.

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

Limpar os recursos

Quando terminar de usar a base de dados de conhecimento, remova os recursos do QnA Maker no portal do Azure.

Próxima etapa

Obter análises na base de dados de conhecimento

Saiba mais sobre:

• Power Virtual Agents
• Power Automate
• Conector do QnA Maker e as configurações do conector