Exibir uma lista de opções de seleção múltipla no Copilot Studio

Artigo
12/09/2024

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 seu bot desenvolvendo diálogos personalizados com o Bot Framework Composer e, em seguida, adicione-os ao seu bot do Microsoft Copilot Studio.

Neste exemplo, você aprenderá como exibir uma lista de seleção múltipla no Microsoft 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.

Criar um diálogo

No Copilot Studio, abra o bot criado no Exemplo 1. Se você ainda não concluiu o Exemplo 1, consulte Mostrar um Cartão Adaptável no Copilot Studio.
Abra seu bot no Composer. Para obter instruções sobre como fazer isso, consulte Introdução ao Bot Framework Composer.
No Composer, vá para a página Criar. Em seu bot, selecione Mais opções (...) e selecione + Adicionar um diálogo. Em Nome, insira DailySpecials.
Em seu novo diálogo DailySpecials, selecione o gatilho BeginDialog para abrir a tela de criação.
Na tela de criação, selecione Adicionar (+), Gerenciar propriedades e Definir uma propriedade.
No painel de propriedades:
1. Em Propriedade, insira conversation.days_array.
2. Em Valor, altere o tipo para [] array.
3. Em Valor, copie e cole a seguinte matriz
```
["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"]
```

Configurar respostas de bot

Acesse a página Respostas de Bot, selecione DailySpecials e selecione Mostrar código.

Copie e cole o seguinte modelo na exibição de código para criar ofertas diárias para todos os dias da semana.

# DailySpecials(day)
- SWITCH: ${day}
- CASE: ${0}
    - All tofu meals are 10% off on Sundays!
    - Every Sunday, all tofu entrees are 10% off.
- CASE: ${1}
    - All steak options are 10% off on Mondays!
    - Enjoy your Monday with a special offer of 10% off on all steak dishes!
- CASE: ${2}
    - All the chicken meal options are 10% off on Tuesdays!
    - Tuesday special is 10% off on all the chicken dishes!
- CASE: ${3}
    - All the chicken and tofu meal options are 10% off on Wednesdays!
    - Wednesday special is 10% off on all the chicken and tofu dishes!
- CASE: ${4}
    - On Thursdays, get a free delivery in Seattle, Bellevue, and Redmond on all orders over $80!
    - Thursday special is a free delivery on orders over $80 in Seattle, Bellevue, and Redmond.
- CASE: ${5} 
    - Friday special - get a 10% discount on all dishes and delivery is free on all orders over $80!
    - Every Friday, we offer 10% off on all meals and a free delivery on orders over $80!
- CASE: ${6}
    - On Saturdays, we have a free delivery on all orders over $50.
    - Free delivery on all orders over $50 on Saturdays!
- DEFAULT:
    - Holiday special - free delivery anywhere in Seattle, Bellevue and Redmond on orders over $70 today!
    - Holiday Delivery is on us if you are in Seattle, Bellevue and Redmond and your order is over $70 total!

Prompt para entrada de usuário

Acesse a página Criar. No Bot explorer, em DailySpecials, selecione BeginDialog.
Na tela de criação, selecione Adicionar (+), Fazer uma pergunta e Múltipla escolha.
Selecione a ação Entrada de Usuário (Escolha). No painel de propriedades, em Respostas, insira Please select a day:
Selecione a página Entrada de usuário no painel de propriedades, faça o seguinte:
1. Em Propriedade, insira conversation.day_choice.
2. Em Formato de saída, escolha índice para retornar o índice da opção selecionada em vez de um valor.
3. Em Estilo da lista, escolha heroCard para exibir nossa lista de opções verticalmente.
4. Em Matriz de opções, altere o tipo para Escrever uma expressão.
5. Em Matriz de opções, insira =conversation.days_array.

Exibir o especial do dia

Na tela de criação, selecione Adicionar (+) e, depois, Enviar uma resposta.
No painel de propriedades, na seção Respostas de bot, selecione Mostrar código. Copie e cole a seguinte expressão:
```
- ${DailySpecials(conversation.day_choice)}
```
No Bot explorer, vá até o diálogo principal. Selecione Mais opções (...) e, depois, Adicionar novo gatilho.
Na janela Criar um gatilho, faça o seguinte:
1. Em Qual é o tipo deste gatilho?, selecione Intenção reconhecida.
2. Em Qual é o nome deste gatilho?, insira Specials.
3. Em Frases de gatilho, copie e cole o seguinte:
```
-what specials do you have
-any special deals
-do you have discounts
```
4. Selecione Enviar.
No Bot explorer, selecione o gatilho Especiais.
Na tela de criação, selecione Adicionar (+), Gerenciamento de diálogos e Iniciar um novo diálogo ou tópico.
No painel de propriedades, em Nome do diálogo, selecione DailySpecials

Testar o bot

Publicar seu conteúdo do Composerpara disponibilizá-lo em seu bot 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.
Vá para a página Tópicos do Microsoft Copilot Studio para ver seus novos tópicos Especiais e DailySpecials.
Abra o painel Bot de teste e verifique se Rastrear entre tópicos está ativado. Insira a mensagem Do you have any specials? para iniciar sua conversa.

Próxima etapa

Usar a Pesquisa do Bing como fallback no Copilot Studio

Compartilhar via