Adicionar ações a um bot usando o Power Automate

Selecione a versão do Power Virtual Agents que você está usando aqui:

Você pode habilitar seu bot para executar uma ação chamando um fluxo do Microsoft Power Automate. Os fluxos podem ajudar a automatizar atividades ou chamar sistemas de back-end. Por exemplo, você pode usar fluxos com autenticação de usuário final para recuperar informações sobre um usuário após o logon.

Você chama fluxos de dentro de tópicos, como um nó Chamar uma ação discreto. Você pode utilizar fluxos que já foram criados no seu ambiente do Power Apps ou pode criar um fluxo de dentro da tela de criação do Power Virtual Agents.

Importante

Um fluxo só pode ser chamado de um tópico localizado no mesmo ambiente do Common Data Service do seu bot. Os fluxos também devem estar em uma solução no Power Automate. Você pode mover fluxos para soluções para que eles sejam listados na tela de criação.

Normalmente, os fluxos usam variáveis para entrada e saída de informações. As variáveis podem ser usadas em outros nós no tópico.

Pré-requisitos

Crie um novo fluxo da tela de criação do Power Virtual Agents

  1. Vou para a página Tópicos do bot que você deseja editar.

  2. Abra a tela de criação do tópico do qual você deseja chamar um fluxo.

  3. Selecione botão de mais (+) abaixo de um nó existente para adicionar um novo nó.

  4. Na janela de seleção de nó, selecione Chamar uma ação e selecione a Criar um fluxo.

    Criar um novo fluxo do Power Automate

Usar a opção Criar um fluxo abre um modelo de fluxo inicial no portal do Power Automate em uma guia separada.

Modelo de fluxo do Power Automate

Observação

O portal do Power Automate é aberto automaticamente no mesmo ambiente que o bot (usando as mesmas credenciais do usuário).

Este modelo é um exemplo de um fluxo que pode ser usado por bots. Para ser adequado para bots, um fluxo do Power Automate requer um gatilho especial e uma ação de resposta do Power Virtual Agents:

  • Gatilho de fluxo: Power Virtual Agents

    Gatilho do Power Virtual Agents

  • Ação de resposta: Power Virtual Agents

    Resposta do Power Virtual Agents

Parâmetros de entrada e saída

Não há limite superior para quantos parâmetros de entrada ou saída um fluxo do Power Automate para bot pode ter. Os bots podem usar os seguintes tipos de entradas e saídas com fluxos do Power Automate:

  • Número
  • Cadeia de Caracteres
  • Booliano

Os tipos a seguir não têm suporte:

  • Objeto
  • Data
  • Carimbo de Data/Hora
  • Lista [Cadeia de Caracteres]
  • Lista [Número]
  • Lista [Booliano]
  • Lista [Objeto]
  • Lista [Data]
  • Lista [Carimbo de data/hora]

Observação

Um bot pode receber até 1 MB de dados de um fluxo do Power Automate em uma única ação. Não há limite superior no tamanho máximo de dados que um bot pode passar para um fluxo do Power Automate.

Parâmetros de entrada

Para especificar um fluxo para aceitar parâmetros de entrada de um bot, selecione a opção Adicionar uma entrada na interface do usuário do gatilho do Power Virtual Agents e selecione o tipo a - string, number ou um boolean.

Tipos de entrada de gatilho do Power Virtual Agents

Por exemplo, você pode selecionar Texto e Número para adicionar os seguintes parâmetros de entrada ao fluxo:

  • String_Input do tipo string
  • Number_Input do tipo number

Entradas de gatilho do Power Virtual Agents

Parâmetros de saída

Para retornar parâmetros de saída para o bot, que podem ser string, number ou um boolean, selecione a opção Adicionar uma saída na interface do usuário da resposta do Power Virtual Agents e selecione o tipo para a saída.

Tipos de saída da resposta do Power Virtual Agents

Por exemplo, você pode selecionar Texto e Número para adicionar os seguintes parâmetros de saída ao fluxo e atribuir valores de retorno para eles.

  • String_Output do tipo string
  • Number_Output do tipo number

Saídas da resposta do Power Virtual Agents

Este exemplo cria um fluxo totalmente funcional que aceita dois parâmetros, uma string e um number e os retorna para um bot como saídas.

Selecione Salvar para salvar seu novo fluxo.

Modelo de fluxo do Power Automate - Salvar

Seu fluxo é salvo na Solução Padrão, na guia Soluções do portal do Power Automate.

Modelo de fluxo do Power Automate - Solução Padrão

Os fluxos criados da tela de criação do Power Virtual Agents ficam imediatamente disponíveis para o bot

Todos os fluxos gerados da tela de criação do Power Virtual Agents são salvos em uma Solução Padrão no Power Automate. Eles podem ser usados pelos seus bots imediatamente.

No Power Virtual Agents, agora você pode ver esse novo fluxo na lista de ações disponíveis ao usar Chamar um nó de ação na tela de criação.

Um novo fluxo é exibido no Seletor de ações

Opcionalmente, mova um fluxo da Solução Padrão para outra solução

Para estarem disponíveis para seus bots, os fluxos deverão ser armazenados em uma solução no Power Automate. Se você não quiser usar a Solução Padrão para esse fim, você poderá mover seus fluxos para outra solução.

Mova o fluxo para uma solução nova ou existente:

  1. No portal do Power Automate, vá para a guia Soluções, onde você poderá ver as soluções disponíveis. Use qualquer uma das soluções existentes ou crie uma nova solução para seus fluxos.

  2. Para criar uma nova solução, selecione Nova solução.

    Criar uma solução

  3. Dê um nome à sua nova solução, selecione Editor Padrão do CDS no campo Editor, insira um número de Versão e selecione Criar.

    Salvar uma nova solução

  4. Na guia Soluções, vá para a solução que deseja usar. Selecione Adicionar existente para adicionar um fluxo.

    Adicionar menu existente

  5. Na página Adicionar fluxo existente, selecione a guia De soluções e selecione seu fluxo. Selecione Adicionar para adicionar seu fluxo à solução.

    Adicionar fluxo a uma solução

    Para mover um fluxo da guia Meus fluxos para uma solução, selecione a opção Soluções externas. Selecione Adicionar para adicionar seu fluxo à solução.

    Adicionar fluxo de soluções externas

Modificar um fluxo no portal do Power Automate

Você pode renomear e modificar seu fluxo no portal do Power Automate. Por exemplo, o fluxo que você acabou de criar usando o modelo pode ser atualizado para fornecer uma previsão do tempo quando chamado de um bot.

  1. No Power Virtual Agents, agora você pode abrir um fluxo usando o link Exibir detalhes do fluxo do fluxo na lista de ações disponíveis ao usar Chamar um nó de ação na tela de criação.

    Modificar um fluxo do Selecionador de Ações

    Se você quiser atualizar um fluxo que já é usado em seu diálogo, o mesmo link Exibir detalhes do fluxo estará disponível diretamente no nó Ação.

    Modificar um fluxo do nó Ação

    O uso do link Exibir detalhes do fluxo do fluxo inicia o portal do Power Automate em uma guia separada do navegador e abre o fluxo em uma página Detalhes, onde você pode modificá-lo usando o comando Editar.

    Editar seu fluxo usando a página Detalhes

    Se você quiser abrir um fluxo no portal Power Automate, vá para a guia Soluções e então abra a solução do seu fluxo. Use o menu Editar do fluxo para abri-lo para edição.

    Abrir seu fluxo para edição

  2. Renomeie o fluxo para Obter previsão do tempo e adicione os seguintes parâmetros de entrada de fluxo ao gatilho do Power Virtual Agents:

    • Cidade (Cadeia de Caracteres)
    • CEP (Número)

    Adicionar entradas ao fluxo

  3. Escolha Adicionar uma ação para criar uma nova ação abaixo do gatilho do Power Virtual Agents.

    Adicionar ação de fluxo

  4. Insira MSN clima na caixa de pesquisa e selecione a ação Obter previsão para hoje na lista.

    Adicionar ação Obter previsão

  5. Um novo Conector MSN Clima é adicionado ao fluxo. Em Localização, selecione Adicionar conteúdo dinâmico. Selecione Cidade e CEP na lista.

    Passe os parâmetros de entrada do fluxo para o conector do MSN Clima como local

  6. No nó de resposta Retornar valores para o Power Virtual Agents, adicione os parâmetros de saída que você deseja retornar ao bot. Salve seu fluxo.

    • day_summary (Cadeia de Caracteres)
    • location (Cadeia de Caracteres)
    • chance_de_rain (Número)

    Inclua variáveis dinâmicas na resposta do fluxo

Agora, esse fluxo está pronto para ser usado em seus bots.

Chamar um fluxo do Power Automate como uma ação de um bot

Você pode chamar um fluxo do Power Automate de um tópico de bot usando o nó Chamar uma ação. Você pode então passar variáveis para o fluxo e receber saídas de fluxo que podem ser usadas em uma conversa de bot.

Essas instruções usam a adição de informações meteorológicas a um fluxo como exemplo. Se você ainda não o fez, siga as etapas abaixo, na seção Modificar um fluxo no portal do Power Automate deste tópico, para criar um fluxo de previsão do tempo.

Chame um fluxo de dentro de um tópico:

  1. No Power Virtual Agents, vá para a página Tópicos do bot que você deseja editar.

  2. Crie um novo tópico e nomeie-o como Obter clima.

  3. Adicione as seguintes frases de gatilho:

    • vai chover
    • previsão de hoje
    • obter clima
    • como está o clima
  4. Vá para a Tela de criação do novo tópico.

    Criar novo Tópico

  5. Por padrão, um nó de mensagem é criado. Insira Eu posso ajudar você com isso no nó e selecione o botão de mais ( +) abaixo dele para adicionar um novo nó.

    Captura de tela da adição de um nó

  6. Adicione dois novos nós Fazer uma pergunta para solicitar aos usuários as entradas Cidade (Cadeia de Caracteres) e CEP (Número).

    Perguntas do diálogo Adicionar Tópico

  7. Selecione o botão de mais (+) abaixo dos nós de pergunta para adicionar um novo nó. Na janela de seleção de nó, selecione Chamar uma ação e selecione o fluxo que você criou anteriormente ao chamar Obter previsão do tempo.

    Chamar ação

  8. Mapeie os blocos de entrada de fluxo para as variáveis de saída dos nós da pergunta. Cidade (texto) obtém seu valor de Var1 (text) e CEP (número) obtém seu valor de Var2 (number).

  9. Sob o nó do fluxo, adicione um nó Mensagem e, em seguida, insira uma mensagem que use as saídas do fluxo. Por exemplo:

    Previsão de hoje para (x)location:{x}day_summary. A possibilidade de chuva é {x}chance_of_rain%

    Inserir as variáveis

  10. Selecione Salvar para salvar seu tópico.

Testar seu fluxo e tópico

No painel Teste de chat, inicie uma conversa com o bot digitando uma frase de gatilho para o tópico que contém o fluxo.

Digite sua cidade e CEP no prompt para obter a previsão do tempo de hoje do bot.

Diálogo Teste

Solucionar problemas do bot

Ao testar seu bot no painel Teste de chat, você poderá usar o comando Salvar instantâneo para obter dados de diagnóstico da conversa. Esses dados podem ajudar você a solucionar problemas, como o bot não responder da maneira esperada.

Aviso

O instantâneo tem todo o conteúdo do seu bot, o que pode incluir informações confidenciais.

  1. No topo do painel Teste de chat, selecione o ícone do menu (três pontos verticais) e depois Salvar instantâneo.

    Salvar instantâneo

  2. Na janela exibida, selecione Salvar.

    Salvar mensagem de instantâneo

  3. O conteúdo e o diagnóstico da conversa do bot serão salvos em um arquivo .zip chamado DSAT.zip.

    Arquivo de diagnóstico da conversa

  4. O arquivo DSAT.zip contém dois arquivos: botContent.json e dialog.json.

    1. dialog.json contém diagnósticos de conversa, incluindo descrições detalhadas de erros.

      Arquivo de diagnóstico da conversa

    2. botContent.json contém os tópicos e outros conteúdos do bot, incluindo entidades e variáveis usadas no bot.

Você pode nos ajudar a melhorar o Power Virtual Agents sinalizando problemas com o comando Sinalizar um problema no painel do bot de teste. Isso envia sua ID de conversa à Microsoft, que é um identificador exclusivo usado pela Microsoft para solucionar o problema da conversa. Outras informações, como as contidas no arquivo DSAT.zip, não são enviadas quando você sinaliza um problema.

Sinalizar um problema

Todas as informações coletadas são anônimas e serão usadas para ajudar a melhorar a qualidade do bot.