Trabalhar com variáveis
Microsoft Copilot Studio permitem armazenar informações importantes inseridas pelo cliente para uso posterior por meio de variáveis. Por exemplo, você pode salvar o nome de um cliente em uma variável chamada UserName. Essa variável pode ser inserida em nós de conversa para criar uma experiência mais pessoal para o cliente. Por exemplo, inserindo a variável em um nó de mensagem, o agente poderá se dirigir ao cliente pelo nome conforme a conversa prossegue.
As variáveis podem ser usadas para rotear os clientes dinamicamente em diferentes caminhos de conversa. Elas também podem ser adicionadas a fluxos do Power Automate ou habilidades do Bot Framework como parâmetros de entrada. Por exemplo, a cidade em que o cliente reside pode ser armazenada em uma variável. Quando um fluxo do Power Automate é executado, a variável pode ser passada como um parâmetro de entrada para garantir que o serviço meteorológico obtenha a previsão correta.
Vários tipos de variáveis estão associados a entidades prontas para uso e personalizadas definidas no agente. Para sua referência, está disponível uma lista completa de tipos de entidades e variáveis.
Criar variáveis
As variáveis são criadas automaticamente quando você adiciona um nó de pergunta a um tópico. Por padrão, quando um nó de pergunta for inserido, ele será criado com opções de Múltipla escolha. No entanto, qualquer entidade predefinida ou personalizada pode ser usada selecionando-a em identificar.
Renomear uma variável
Quando uma variável é criada automaticamente, recebe um nome padrão, ou algo como var. Isso não é descritivo. Se quiser, você pode renomear uma variável selecionando-a e inserindo um novo nome. Isso facilitará a identificação posteriormente, quando necessário.
Passar variáveis entre tópicos
Uma ação comum em um agente do Microsoft Copilot Studio é redirecionar de um tópico para outro, como enviar alguém para o tópico Store Hours depois da saudação. Ao redirecionar para outro tópico, você pode passar valores para variáveis no tópico de destino. Também é possível passar valores novamente para variáveis no tópico original. Passar variáveis entre tópicos é especialmente útil quando você já tem informações de que o tópico necessita. Os usuários apreciarão não ter que responder às perguntas novamente. Por exemplo, se você já tiver capturado o nome do usuário no tópico de Saudação e souber que o nome será usado no tópico Store Hours para o qual está redirecionando. Você pode passar facilmente o nome de usuário para o tópico Store Hours ao redirecionar para o tópico.
Receber valores de outros tópicos
Quando você define uma variável em um tópico (por exemplo, inserindo um nó de pergunta), a resposta do usuário para as perguntas é preenchida para a variável associada a essa pergunta. Como você já tem o valor, não há motivo para fazer a pergunta novamente. Nesses casos, você pode definir a variável como Receber valores de outros tópicos.
Isso significa que, quando outro tópico redirecionar para esse, ele poderá passar uma variável para essa variável e ignorar a pergunta. A experiência do usuário ao falar com o agente é simples.
Ao configurar o nó de redirecionamento, você precisará definir a variável que deseja preencher no tópico de destino. Depois de especificar a variável que você deseja definir no tópico de destino, especifique o valor do tópico atual que será usado. Por exemplo, na imagem abaixo, estamos redirecionando para um tópico chamado Restaurant list. A variável Area no tópico da lista de restaurantes está sendo definida como uma variável de texto chamada Var do tópico de redirecionamento.
Para obter mais informações e instruções detalhadas sobre o recebimento de valores de outros tópicos, consulte Receber valores de outros tópicos.
Retornar valores aos tópicos originais
Quando um tópico faz uma pergunta ou obtém uma variável de uma ação de alguma outra maneira, a variável pode ser retornada ao tópico original que redirecionou a ela.
Nesse caso, a variável também se tornará parte do tópico original e poderá ser usada como qualquer outra variável. Isso ajuda a construir o tópico de forma que as informações obtidas pelo agente estejam disponíveis entre tópicos, reduzindo a necessidade de variáveis globais. Discutiremos as variáveis globais na próxima unidade.
Para obter mais informações e instruções passo a passo, consulte Retornar valores aos tópicos originais.
Para saber mais sobre como trabalhar com variáveis, consulte Usar variáveis.