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 Copilots podem lembrar um contexto de 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 passar para outro tópico, como um tópico de Reserva de compromisso, talvez você queira que o copiloto lembre o nome e o endereço de email do cliente. No Microsoft Copilot Studio, essas variáveis são referidas como variáveis do copiloto. Elas podem ser acessadas por qualquer tópico no copiloto.
As variáveis do Copilot 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 copiloto para distingui-las das variáveis de nível de tópico.
Criar uma variável de copiloto
Para definir uma variável como uma variável de copiloto, 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 copiloto 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 copiloto, 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 copiloto.
Definir variáveis de copiloto
Depois que uma variável de copiloto 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}. Isso exibirá uma lista de todas as variáveis disponíveis nesse tópico. As variáveis são classificadas em ordem alfabética; portanto, todas as variáveis do copiloto são agrupadas no menu de variáveis, pois todas começam com copiloto.
Ao usar um nó de condição, um nó de ação de fluxo ou um nó de habilidade, você também poderá ver as variáveis de copiloto disponíveis.
Gerenciar variáveis de copiloto
Após criar uma variável copiloto para usar em vários tópicos, você deverá 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 copiloto ou se tiver diversas variáveis e uma ramificação complexa de tópicos.
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 copiloto com base em origens externas
Você pode definir uma variável de copiloto para ser inicializada com uma fonte externa. Isso permite que o copiloto 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 copiloto 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 copiloto, consulte Reutilizar variáveis entre tópicos.