Exemplo 4 - Exibir um formulário com um botão Enviar no Power Virtual Agents

Observação

Agora o Power Virtual Agents oferece suporte estes recursos sem o Composer.

Aprimore seu bot desenvolvendo diálogos personalizados com o Bot Framework Composer e, em seguida, adicione-os ao seu bot do Power Virtual Agents.

Neste exemplo, você aprenderá como exibir um formulário com um botão Enviar no Power Virtual Agents usando o Composer.

Importante

A integração do Composer não está disponível para usuários que têm somente a licença do Teams do Power Virtual Agents. É necessário ter uma licença de avaliação ou integral do Power Virtual Agents.

Pré-requisitos

• Exemplo 1 – Mostrar um Cartão Adaptável no Power Virtual Agents
• Exemplo 2 – Exibir uma lista de opções de seleção múltipla no Power Virtual Agents
• Exemplo 3 – Usar o Bing Search como fallback no Power Virtual Agents

Criar um gatilho

1. No Power Virtual Agents, abra o bot do Exemplo 3. Se você ainda não concluiu o Exemplo 3, consulte Usar o Bing Search como fallback no Power Virtual Agents.

2. Abra seu bot no Composer. Para obter instruções sobre como fazer isso, consulte Introdução ao Bot Framework Composer.

3. No Bot explorer, vá até o diálogo principal. Selecione Mais opções (...) e, depois, Adicionar novo gatilho.

4. Na janela Criar um gatilho:

   1. Em Qual é o tipo deste gatilho?, selecione Intenção reconhecida.

   2. Em Qual é o nome deste gatilho?, insira StartTrial.

   3. Em Frases de gatilho, copie e cole o seguinte:

      - start trial
      - sign up to try
      - register to try service
      

   4. Selecione Enviar.

   

5. Acesse a página Respostas de Bot, selecione Serviço de Entrega de Refeições da Contoso e selecione Mostrar código.

6. Copie e cole o seguinte trecho na exibição de código:

   # adaptivecardjson_StartTrialForm()
   - ```
   {
       "type": "AdaptiveCard",
       "body": [
           {
               "type": "TextBlock",
               "size": "Medium",
               "weight": "Bolder",
               "text": "Register for a meal plan trial:"
           },
           {
               "type": "Input.Text",
               "placeholder": "Please enter your Name",
               "id": "Name"
           },
           {
               "type": "Input.Text",
               "placeholder": "Please enter your Address",
               "id": "Address",
               "isMultiline": true
           },
           {
               "type": "Input.Number",
               "placeholder": "How many weeks",
               "id": "Weeks"
           },
           {
               "type": "ActionSet",
               "actions": [
                   {
                       "type": "Action.Submit",
                       "title": "Submit",
                       "style": "positive"
                   }
               ]
           }
       ],
       "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
       "version": "1.2"
   }
   ```
   

   Todos os campos de entrada neste Cartão Adaptável têm uma ID exclusiva: Nome, Endereço e Semanas.

   

7. Copie e cole o seguinte código na mesma exibição de código:

   # AdaptiveCard_StartTrialForm()
   [Activity
       Attachments = ${json(adaptivecardjson_StartTrialForm())}
   ]
   

   

Adicionar lógica da conversa

1. Vá para a página Criar no Composer e selecione o gatilho StartTrial.

2. Na tela de criação, selecione Adicionar (+), Fazer uma pergunta e, em seguida, Texto.

3. No painel de propriedades, na seção Respostas de bot, selecione Mostrar código.

   Aviso

   Adicionando a expressão da próxima etapa ao editor de resposta em vez do editor de código resultará no bot respondendo com um JSON bruto em vez de um Cartão Adaptável.

4. Copie e cole a seguinte expressão:

   - ${AdaptiveCard_StartTrialForm()}
   

   

5. Selecione a guia Entrada de usuário no painel de propriedades, faça o seguinte:

   1. Em Propriedade, insira user.name.
   2. Em Valor, insira =turn.activity.value.Name.

   

6. Na tela de criação, selecione Adicionar (+), Gerenciar propriedades e, depois, Definir propriedades.

7. No painel Propriedades, faça o seguinte:

   1. Em Atribuições, selecione Adicionar novo para adicionar uma caixa Propriedade e uma caixa Valor.
   2. Em Propriedade, insira user.address
   3. Em Valor, insira =turn.activity.value.Address.
   4. Selecione Adicionar novo mais uma vez para adicionar outra Propriedade e Valor.
   5. Em Propriedade, insira user.weeks.
   6. Em Valor, insira =turn.activity.value.Weeks.

   

8. Na tela de criação, selecione Adicionar (+) e, depois, Enviar uma resposta.

9. No editor da resposta, copie e cole o seguinte:

   ${user.name} - thanks for starting a ${user.weeks} week trial with us! Your meals will be delivered to this address: ${user.address}.
   

   

10. Na tela de criação, selecione Adicionar (+) e, depois, Iniciar um tópico do Power Virtual Agents.

11. No painel de propriedades, em Nome do diálogo, selecione Fim da conversa.

    

Testar o bot

1. Publicar seu conteúdo do Composerpara disponibilizá-lo em seu bot do Power Virtual Agents.

   Importante

   Selecionar Publicar no Composer torna as mudanças disponíveis para teste, mas não publica automaticamente o seu bot.

   Publique seu bot no Power Virtual Agents para atualizá-lo em todos os canais aos quais ele está conectado.

2. Vá até a página Tópicos do Power Virtual Agents para ver o novo conteúdo do tópico StartTrial.

   

3. Abra o painel Bot de teste e verifique se Rastrear entre tópicos está ativado. Insira a mensagem How do I sign up for a trial? para iniciar sua conversa.