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 as conversas englobarem 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 globais. Elas podem ser acessadas por qualquer tópico no agente.

As variáveis globais são aplicadas somente durante a sessão de chat atual. Elas 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 globais para distingui-las das variáveis de nível de tópico.

Criar uma variável global

Para definir uma variável como global, selecione a variável diretamente em um nó ou no menu Variáveis na barra de menus superior. Normalmente, você navegaria até o nó Pergunta, que faz referência primeiro à variável com a qual deseja trabalhar.

No painel Propriedades da variável, em Uso, selecione Global (qualquer tópico pode acessar). O nome da variável recebe o prefixo Global 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 de tópico em uma variável global, 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 globais

Depois que uma variável global for criada, ela estará disponível para todos os tópicos. Ao trabalhar com um nó de mensagem ou pergunta, selecione o botão {x} e navegue até a guia Personalizado. Isso exibe uma lista de todas as variáveis disponíveis no tópico atual. As variáveis são ordenadas em ordem alfabética e agrupadas por seu tipo de Uso, ou seja, Global e Tópico.

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 globais disponíveis neles.

Gerenciar variáveis globais

Quando você cria uma variável global para uso em vários tópicos, é essencial compreender onde ela é aplicada. Você pode localizar facilmente onde a variável foi inicialmente definida verificando Referência e identificar outros tópicos que a usam selecionando Exibir todas as referências. Esse recurso é especialmente útil ao desenvolver um novo agente ou ao gerenciar várias variáveis em ramificações de tópicos complexas.

A seção Referências fornece duas opções principais:

• Referência: mostra onde a variável está definida no momento.

• Exibir Todas as Referências: lista todos os tópicos e nós onde a variável é usada, permitindo que você navegue diretamente para cada tópico e nó referenciados.

Definir o valor de uma variável global a partir de fontes externas

Você pode definir uma variável global 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 globais, confira Reutilizar variáveis entre tópicos.