Reutilizar variáveis entre tópicos
Por padrão, um valor de variável só pode ser usado no tópico em que a variável é criada. Por exemplo, se você criar uma variável UserCity em um tópico Verificar Clima, poderá incluí-la apenas em itens como nós de mensagens no tópico Verificar Clima. Estes se referem a variáveis de Tópico (escopo limitado). No entanto, pode haver cenários em que você desejará usar o mesmo valor em vários tópicos. Os agentes podem se lembrar de um contexto variável quando uma conversa abrange vários tópicos. Por exemplo, um tópico Bem-vindo pode solicitar o nome e o email do cliente. Quando a conversa muda para outro tópico, como um tópico de Reserva de compromisso, convém que o agente se lembre do nome e endereço de email do cliente. No Microsoft Copilot Studio, essas variáveis são chamadas de variáveis de agente. Elas podem ser acessadas por qualquer tópico no agente.
As variáveis de agente são aplicadas durante a sessão de chat atual. Não podem ser transportadas da sessão de chat de um cliente para outro. Você pode especificar quais variáveis devem ser tratadas como variáveis de agente para distingui-las das variáveis de nível de tópico.
Criar uma variável de agente
Para definir uma variável como uma variável de agente, abra-a na tela de criação. Abra o nó Fazer uma pergunta que está armazenando a variável com que deseja trabalhar. No painel Propriedades da Variável, em Uso, selecione Global (qualquer tópico pode acessar). O nome da variável recebe uma sequência de prefixo de agente para diferenciá-la das variáveis de nível de tópico.
Por exemplo, a variável UserName agora é mostrada como Global.UserName. Ao converter uma variável em uma variável de agente, verifique se o nome da variável é exclusivo em todos os tópicos. Se for encontrado um conflito de nome, você precisará renomear a variável antes de salvar a alteração.
Para obter mais informações, consulte Usar variáveis globais em tópicos em um agente.
Definir variáveis de agente
Depois que uma variável de agente é criada, ela fica disponível para todos os tópicos. Ao trabalhar com um nó de mensagem ou pergunta, selecione o botão {x}. Isso exibirá uma lista de todas as variáveis disponíveis nesse tópico. As variáveis são classificadas em ordem alfabética, então, todas as variáveis de agente são agrupadas no menu de variáveis, pois todas começam com agente.
Ao usar um nó de condição, um nó de ação de fluxo ou um nó de habilidade, você também pode ver as variáveis de agente disponíveis neles.
Gerenciar variáveis de agente
Após criar uma variável de agente para usar em vários tópicos, você deve entender onde ela está sendo usada. Você pode ver facilmente onde a variável foi definida pela primeira vez (origem) e os outros tópicos que a estão usando. Isso poderá ser útil se você estiver trabalhando em um novo agente ou se tiver diversas variáveis e ramificações de tópicos complexas.
Há dois itens principais que estão disponíveis no painel Propriedades da Variável.
Referência: vai para o nó em que a variável foi criada inicialmente.
Usada por: exibe todos os tópicos em que a variável é usada para que você possa ir diretamente para o tópico e nó em questão.
Definir o valor de uma variável de agente por meio de fontes externas
Você pode definir uma variável de agente para ser inicializada com uma fonte externa. Isso permite que o agente inicie a conversa com algum contexto.
Por exemplo, um cliente acessa um chat de seu site. Se o usuário estiver conectado em seu site, você já saberá o nome do cliente. Passando essas informações ao agente antes de iniciar a conversa, ele pode ter uma conversa mais inteligente com o cliente, sem precisar perguntar o nome novamente.
Você pode especificar que uma variável pode obter seus valores de uma fonte externa. Abra o painel Propriedades da variável e, na seção Uso, selecione a caixa Fontes externas podem definir valores.
Para obter mais informações sobre como trabalhar com variáveis de agente, consulte Reutilizar variáveis entre tópicos.