Adicionar entradas, variáveis e condições
Para o agente Event Contacts, você precisa expandir o número de países/regiões que têm contatos. Em vez de listar todos os países/regions no nó de mensagem, você deseja perguntar ao usuário para qual país/region ele precisa de informações de contato. Para realizar essa tarefa, você usará entradas, variáveis e condições.
Entradas: a resposta do usuário no nó Fazer uma pergunta.
Variáveis - armazene as Entradas a serem usadas nos nós de conversa posteriormente.
Condições - defina a lógica de ramificação com base nas variáveis.
Para o agente, você precisará excluir o nó da mensagem atual porque ele será substituído. Selecione as reticências (...) das opções do nó da mensagem e, em seguida, selecione Excluir.
Adicionar entradas e variáveis com o nó de pergunta
Para adicionar entradas e variáveis com o nó de pergunta, siga estas etapas:
Use o mouse para passar o mouse sobre a metade superior da linha que conecta as Frases de Gatilho ao nó Mensagem. Selecione o ícone Adicionar nó mais + que é exibido e selecione Faça uma pergunta no pop-up de seleção que é exibido quando você seleciona o ícone de adição.
Preencha o nó de pergunta com as seguintes informações:
Faça uma pergunta: digite a frase:
I can help with event contacts. Please tell me which country/region the event is scheduled for.Identificar: selecione Opções de múltipla escolha. O campo Identificar é o local no qual você indica o tipo de resposta que o agente escuta. Outras respostas que você pode selecionar incluem um número ou uma cadeia de caracteres. O agente pode até detectar entidades, como nomes de estado, números de telefone ou endereços. Para saber mais sobre as diferentes opções disponíveis, consulte os links na unidade Resumo no fim deste módulo.
Opções para usuário: insira EUA, Canadá, França e Espanha selecionando + Nova opção entre cada palavra. (Consulte o número 1 na imagem abaixo.)
Observe como a caixa de perguntas parece se mover para a direita da tela de criação à medida que suas opções aumentam e as condições filho preenchem a tela abaixo do painel de perguntas. Para centralizar novamente sua tela, você pode clicar com o botão esquerdo e arrastar a tela, rolar ou usar os controles de exibição no canto inferior esquerdo da tela. Esses controles incluem botões para aumentar/reduzir a ampliação, centralizar novamente a exibição ou até mesmo exibir um minimapa clicável para ajudar você a navegar na tela do agente. (Consulte o número 2 na imagem abaixo.)
Retorne ao nó da pergunta e definiremos o valor Salvar resposta como, no momento mostrado como variável Var (text). Selecione o ícone de edição próximo a Var (text) e um painel de Propriedades da variável é exibido no lado direito da tela. Substitua o valor do Nome de "Var" por "VarCountry" e feche o painel. Observe como o novo nome de variável "VarCountry" preenche os nós Condição abaixo do nó Pergunta.
O Copilot Studio fornece duas variáveis por padrão: agent.UserDisplayName, que fornece o nome do usuário, e agent.UserID, que fornece o nome de entrada do usuário. Usando agent.UserDisplayName, o agente pode chamar o usuário pelo nome para personalizar a experiência. Você também pode usar agent.UserID para criar um nó de condição a fim de executar ações com base no usuário com quem o agente está interagindo.
Para que o agente Event Contacts cumprimente o usuário pelo nome, adicione um novo nó de mensagem no início do agente. Mova sua tela para que você possa exibir o nó Frases de Gatilho e adicione um nó abaixo dele. Para o novo nó, selecione Mostrar uma mensagem. Em seguida, no campo de entrada da mensagem, selecione o menu suspenso {X} inserir variável e selecione agent.UserDisplayName.
- Você pode personalizá-lo ainda mais adicionando "Oi" (com um espaço antes do nome) na frente dele. Salve seu tópico selecionando o botão Salvar na faixa de opções do Copilot Studio.
Nó Condição
Para cada opção de múltipla escolha no nó de pergunta, o Microsoft Copilot Studio cria um novo nó de condição. Você precisa configurar cada nó de condição para fornecer a próxima resposta apropriada na conversa.
Para o agente Event Contacts, você precisa responder com o contato do evento para o país/região. Por exemplo, se o usuário selecionar EUA, o agente deve responder com as informações de contato de Lynne Robbins. Para a primeira entrada, neste caso, EUA, o Copilot Studio não cria automaticamente um novo nó Condição, mas cada condição subsequente criará um novo nó Condição.
| País/Region | Nome | |
|---|---|---|
| EUA | Lynne Robbins | LynneR@contoso.com |
| Canadá | Lidia Holloway | LidiaH@contso.com |
| França | Miriam Graham | MiriamG@contoso.com |
| Espanha | Christie Cline | ChristieC@contoso.com |
Para cada nó de condição, adicione um novo nó de mensagem após a condição que fornece o contato e o endereço de email corretos. Por exemplo, "The event coordinator for France is Miriam Graham at MiriamG@contoso.com."
É possível adicionar outro nó de condição para os EUA, mas, por enquanto, use Todas as outras condições para a mensagem referente ao contato dos EUA.
Para todos os quatro nós de mensagem, você deseja usar o mesmo tópico do sistema Fim da Conversa. O agente já tem esse tópico definido no nó Todas as outras condições. Para vincular outros nós a esse, execute as seguintes etapas:
Depois de um dos nós de mensagem, selecione Adicionar nó mais o símbolo +. Observe como um pequeno círculo é exibido na parte superior da caixa. Se você passar o mouse sobre ele, o círculo mostrará um preenchimento rosa.
Clique com o botão esquerdo e segure e arraste o círculo rosa para o topo do nó Fim sob sua mensagem de condição padrão. Quando você o coloca no lugar certo, um halo rosa é exibido acima do nó. Solte o conector do nó de mensagem ali. Observe como ambos os nós de mensagem agora se conectam ao nó Fim.
Faça o mesmo com os outros dois nós de Mensagem para conectá-los ao nó Fim.
- Para testar o agente, selecione Salvar. Selecione a opção Testar agente se o painel de teste do agente não estiver visível.
Agora você aprendeu a incorporar variáveis padrão e como definir uma variável usando uma condição de entrada. Com essas ferramentas, você pode continuar a desenvolver seu agente.