Exibir um formulário com um botão Enviar no Copilot Studio

Observação

Este artigo é aplicável apenas aos chatbots clássicos. Para estender agentes criados no Copilot Studio, você não precisa usar o Bot Framework Composer. Todos os recursos descritos neste artigo estão disponíveis para agentes, diretamente em Copilot Studio.

Aprimore o chatbot clássico desenvolvendo caixas de diálogo personalizadas com o Bot Framework Composer e adicione-as ao copiloto criado no Copilot Studio.

Neste exemplo, você aprenderá como exibir um formulário com um botão Enviar no Copilot Studio 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 Microsoft Copilot Studio. É necessário ter uma licença de avaliação ou integral do Microsoft Copilot Studio.

Pré-requisitos

• Mostrar um Cartão Adaptável no Copilot Studio.
• Exibir uma lista de opções de seleção múltipla no Copilot Studio.
• Usar a Pesquisa do Bing como fallback no Copilot Studio

Criar um gatilho

1. No Copilot Studio, abra o copiloto do Exemplo 3. Se você ainda não concluiu o Exemplo 3, consulte Usar o Bing Search como fallback no Copilot Studio.

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 Microsoft Copilot Studio.

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 copilotos do Copilot Studio.

   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 Microsoft Copilot Studio para atualizá-lo em todos os canais aos quais ele está conectado.

2. Vá até a página Tópicos do Copilot Studio 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.