Criar e editar tópicos em seu bot do Power Virtual Agents
No Power Virtual Agents, um tópico define como se desenvolve uma conversa de bot.
Para criar tópicos, você pode personalizar modelos fornecidos, criar tópicos do zero ou obter sugestões de sites de ajuda existentes.
No Power Virtual Agents, um tópico representa alguma parte de um thread de conversa entre um usuário e um chatbot. Você define e trabalha com tópicos em uma tela de criação. Um tópico contém um ou mais nós de conversação, que juntos definem os caminhos de conversação que esse tópico pode seguir. Cada nó executa uma ação, como enviar uma mensagem ou fazer uma pergunta.
Geralmente, um tópico também tem um conjunto de frases de gatilho, ou seja, frases, palavras-chave e perguntas que um cliente provavelmente usará, relacionadas a um problema específico. A IA do Power Virtual Agents usa a compreensão da linguagem natural, a mensagem do seu cliente e as frases de gatilho para todos os seus tópicos para encontrar o tópico mais apropriado para acionar. A mensagem não precisa ser uma correspondência exata com as frases de gatilho de um tópico para acioná-lo. Por exemplo, um tópico sobre o horário de funcionamento da loja pode incluir a frase de gatilho check store hours
. Se um cliente enviar "ver horário de funcionamento da loja", o Power Virtual Agents poderá ainda acionar seu tópico de horário de funcionamento da loja.
Reconhecimento vocal natural
A IA usa o reconhecimento de linguagem natural (NLU) para analisar o que um cliente realmente digita e encontrar o nó ou a frase de gatilho mais apropriado.
Por exemplo, um usuário pode digitar "Horário de funcionamento" em seu bot. A IA combina isso com o tópico Horários da loja, inicia uma conversa que pergunta em qual loja o cliente está interessado e, em seguida, exibe o horário de funcionamento da loja.
O painel Bot de teste mostra como a conversa do bot se desenvolve em cada etapa. Você pode usar o painel Bot de teste para ajustar um tópico sem ter que sair do portal do Power Virtual Agents.
Para saber os limites de bots e tópicos, consulte Cotas, limites e valores de configuração.
Pré-requisitos
Tipos de tópicos
Um bot pode incluir dois tipos de tópicos, sistema e personalizado. Cada novo bot começa com um conjunto de tópicos personalizados e de sistema.
Os tópicos do sistema são aqueles que suportam o comportamento essencial do seu bot, como uma solicitação personalizada para falar com uma pessoa ou encerrar a conversa. Alguns tópicos do sistema têm frases de gatilho, que você pode personalizar para atender às necessidades do seu bot.
- Você não pode criar tópicos do sistema.
- Você não pode excluir tópicos do sistema, mas eles podem ser desativados.
- Você pode fazer alterações nos tópicos do sistema. No entanto, até que você se sinta à vontade para criar conversas de ponta a ponta, não edite os tópicos do sistema.
Para obter mais informações, consulte Usar tópicos do sistema.
Tópicos personalizados abrangem comportamentos comuns, como cumprimentar um cliente, encerrar uma conversa ou recomeçar uma conversa.
- Você pode fazer alterações nos tópicos personalizados com os quais seu bot começa ou removê-los completamente de seu bot.
- Todos os tópicos que você cria são tópicos personalizados.
Criar um tópico
Abra seu bot e selecione Tópicos. Na página Tópicos, selecione + Novo tópico.
O painel Frases de gatilho já deve estar aberto. Se não estiver, selecione o nó Frases de gatilho para abrir o painel.
Em Adicionar frases, digite uma frase de gatilho para seu tópico.
Seu bot precisa de 5 a 10 frases de gatilho para treinar a IA para entender as respostas de seus clientes. Para adicionar mais frases de gatilho:
- Selecione o botão +.
- Cole um conjunto de frases de gatilho, cada uma em uma linha separada.
- Digite um conjunto de frases de gatilho, pressionando Shift+Enter após cada uma para colocá-la em uma linha separada.
Você pode incluir a pontuação em uma frase de gatilho, mas é melhor usar frases curtas em vez de frases longas.
Selecione Detalhes para abrir o painel de detalhes do tópico.
Digite um Nome para seu tópico e, se quiser, uma Descrição.
Use o nome para identificar o tópico. A página Tópicos lista todos os tópicos atualmente definidos em seu bot, por nome. Um cliente poderá ver o nome do tópico se o bot não puder determinar qual tópico corresponde à mensagem do cliente.
A Descrição nunca é mostrada aos usuários. Use-a para descrever a finalidade do tópico para você e outros criadores de bots de sua equipe.
Selecione Salvar para salvar suas alterações e adicionar o tópico à lista de tópicos.
Projetar um caminho da conversa do tópico
Quando você cria um novo tópico, um nó de Frases de gatilho é inserido para você. Adicione mais nós para controlar a conversa.
Abra seu bot e selecione Tópicos e um tópico.
Para adicionar um nó, selecione Adicionar nó (+) na linha ou ramificação entre ou após um nó.
Selecione um tipo de nó para inserir o nó.
A tabela a seguir lista os tipos de nós que você pode inserir em um tópico:
Opção | Descrição |
---|---|
Enviar uma mensagem | Envie uma mensagem ao cliente. |
Adicionar uma condição | Ramifica sua conversa com base em uma condição. |
Definir o valor de uma variável | Defina um valor para uma variável nova ou existente. |
Gerenciamento de tópicos | Redirecione, transfira ou encerre o tópico ou a conversa. |
Chamar uma ação | Chame um fluxo do Power Automate. |
Adicionar um nó da pergunta
O nó Pergunta permite que você solicite informações a um usuário e armazene sua resposta em uma variável para uso posterior na conversa.
O nó permite que você escolha o tipo de informação a ser coletada, como uma resposta de múltipla escolha, uma entidade predefinida ou uma entidade personalizada. As propriedades de comportamento da pergunta permitem que você controle o comportamento do nó, como o que fazer quando o usuário insere uma resposta inválida.
Assim como os nós Mensagem, os nós Pergunta podem incluir imagens, vídeos, cartões, respostas rápidas e variações de mensagens. Para obter mais informações, consulte Enviar uma mensagem.
Selecione Adicionar nó (+) e Fazer uma pergunta.
Na caixa Digite uma mensagem, digite a pergunta que deseja fazer.
Selecione a caixa em Identidade e crie ou selecione uma entidade para determinar o que o bot deve ouvir na resposta do usuário. Aprenda a usar as entidades em uma conversa.
Dependendo da opção Identificar selecionada, você pode ter mais propriedades do que precisa definir.
Por exemplo, para Opções de múltipla escolha, é necessário inserir as opções que o usuário pode especificar em Opções para o usuário. Cada escolha é apresentada como um botão de múltipla escolha para o usuário, mas os usuários também podem digitar as respostas.
Selecione a caixa em Salvar resposta como e altere o nome da variável padrão para algo significativo, como customerName ou bookingDate.
Para escolher uma variável diferente, selecione > e selecione uma variável.
Configurar comportamento da pergunta
As propriedades do comportamento da pergunta permitem controlar outros aspectos do nó da Pergunta, como de que maneira o bot responde a uma resposta inválida ou como valida a entrada do usuário.
No nó Pergunta, selecione o menu do nó (⋮) e, em seguida, selecione Propriedades.
No painel Propriedades da pergunta, selecione Comportamento da pergunta.
O painel Comportamento da pergunta é aberto.
Ignorar comportamento
Pular comportamento determina o que o bot deve fazer se a variável do nó de pergunta já tem um valor de antes na conversa.
- Permitir que a pergunta seja ignorada: pule a pergunta se a variável tiver um valor.
- Perguntar sempre: faça a pergunta mesmo que a variável tenha um valor.
Solicitar novamente
Solicitar novamente determina como seu bot reagirá se não obtiver uma resposta válida do usuário. Você pode dizer para tentar novamente uma, duas vezes ou seguir em frente sem obter uma resposta. Para personalizar o que seu bot faz quando avança, consulte Nenhuma entidade válida encontrada. Você também pode alterar o prompt para fornecer mais contexto ao usuário.
Quantas novas solicitações: o número de vezes que seu bot tenta obter uma resposta válida. Repita até 2 vezes é o padrão. Você também pode selecionar Repetir uma vez ou Não repetir.
Repetir prompt: para alterar a mensagem, selecione Personalizar e insira o novo prompt.
Validação de entidade adicional
Por padrão, o nó Pergunta verifica uma resposta válida com base apenas na entidade que você selecionou. Validação adicional da entidade permite que você acrescente critérios ao teste básico. Por exemplo, o nó Pergunta aceita qualquer valor numérico quando identifica um número, mas você pode querer garantir que seja menor que 10. Você também pode alterar o prompt para ajudar o usuário a inserir uma resposta válida.
Condição: digite uma fórmula do Power Fx que retorne um valor booleano (
true
oufalse
); por exemplo,Topic.Var1 < 10
Condição que não é atendida pelo prompt: para alterar a mensagem, selecione Personalizar e insira o novo prompt.
Nenhuma entidade válida encontrada
Nenhuma entidade válida encontrada determina o que acontece quando seu bot deixa de tentar obter uma resposta válida do usuário. Você pode escalar para um agente humano ou fornecer um valor padrão por enquanto. Você também pode alterar a solicitação para que o usuário saiba.
Ação se Nenhuma entidade encontrada:
- Escalar: redirecione o usuário para o tópico do sistema Escalar. Esse é o padrão.
- Definir variável para valor: defina a variável de saída para um valor e passe para o próximo nó. Digite ou selecione o valor em Valor da entidade padrão.
- Definir variável como vazia (sem valor): defina a variável de saída como
Blank
e vá para o próximo nó. Você pode usar um nó de Condição posteriormente para verificar se a variável tem um valor.
Mensagem sobre Nenhuma entidade encontrada: para alterar a mensagem, selecione Personalizar e insira o novo prompt.
Interrupções
Interrupções determina se o usuário pode alternar para um tópico diferente durante a pergunta.
- Permitir mudança para outro tópico: o usuário pode abandonar a pergunta para um novo tópico.
Exclui um nó
Selecione o Menu do nó, (⋮) e, em seguida, Excluir.
Controles para editar nós na tela
Você pode usar a barra de ferramentas da tela de criação para renomear rapidamente o tópico. Selecione o nome do tópico na barra de ferramentas, digite o novo nome e pressione Enter.
Você pode usar controles na barra de ferramentas para cortar, copiar, colar e excluir o nó selecionado ou os nós adjacentes selecionados.
A barra de ferramentas também possui um controle para desfazer. Abra o menu Desfazer para reverter todas as ações para o último salvamento ou para refazer a ação anterior.
Colar os nós
Depois que você usar Recortar ou Copiar para adicionar um ou mais nós à área de transferência, existem algumas maneiras de colar os nós na tela:
Se você selecionar um nó e depois escolher Colar, os nós da área de transferência serão adicionados após o nó selecionado.
Se você selecionar o menu Adicionar nó (+) e Colar, os nós da área de transferência serão adicionados nesse ponto.
Editar tópicos com o editor de códigos
O editor de códigos mostra o tópico em YAML, uma linguagem de marcação fácil de ler e entender. Use o editor de códigos para copiar e colar tópicos de outros bots, mesmo aqueles criados por outros criadores.
Importante
Projetar um tópico inteiramente no editor de códigos e colar tópicos complexos não é totalmente suportado.
Neste exemplo, você copiará e colará YAML no editor de códigos para adicionar rapidamente um tópico que solicite informações de envio a um cliente.
Na página Tópicos, selecione + Novo tópico.
No canto superior direito da tela de criação, selecione Mais opções (…) e Abrir editor de códigos.
Selecione e exclua o conteúdo do editor de códigos. Em seguida, copie e cole o seguinte código YAML:
kind: AdaptiveDialog beginDialog: kind: OnRecognizedIntent id: main intent: displayName: Lesson 3 - A topic with a condition, variables and a prebuilt entity triggerQueries: - Buy items - Buy online - Buy product - Purchase item - Order product actions: - kind: SendMessage id: Sjghab message: I am happy to help you place your order. - kind: Question id: eRH3BJ alwaysPrompt: false variable: init:Topic.State prompt: To what state will you be shipping? entity: StatePrebuiltEntity - kind: ConditionGroup id: sEzulE conditions: - id: pbR5LO condition: =Topic.State = "California" || Topic.State = "Washington" || Topic.State = "Oregon" elseActions: - kind: SendMessage id: X7BFUC message: There will be an additional shipping charge of $27.50. - kind: Question id: 6lyBi8 alwaysPrompt: false variable: init:Topic.ShippingRateAccepted prompt: Is that acceptable? entity: BooleanPrebuiltEntity - kind: ConditionGroup id: 9BR57P conditions: - id: BW47C4 condition: =Topic.ShippingRateAccepted = true elseActions: - kind: SendMessage id: LMwySU message: Thank you and please come again.
Selecione Salvar e Fechar editor de códigos.
Testar e publicar seu bot
Teste o bot quando você faz alterações nos tópicos, para garantir que tudo esteja funcionando conforme o esperado.
Depois de projetar e testar seu bot, publique-o na Web, em aplicativos móveis ou nativos ou Microsoft Bot Framework canais.