Criar expressões usando o Power Fx

Importante

As capacidades e os recursos do Power Virtual Agents agora fazem parte do Microsoft Copilot Studio após investimentos significativos em IA generativa e integrações aprimoradas no Microsoft Copilot.

Alguns artigos e capturas de tela podem fazer referência ao Power Virtual Agents enquanto atualizamos a documentação e o conteúdo do treinamento.

O Power Fx é uma linguagem de fórmula com pouco código que usa fórmulas de forma semelhante ao Excel. Use o Power Fx para criar lógica complexa que permite que seus copilotos manipulem dados. Por exemplo, uma fórmula do Power Fx pode definir o valor de uma variável, analisar uma string ou usar uma expressão em uma condição. Para obter mais informações, consulte a documentação Visão geral do Power Fx e a referência de fórmulas.

Observação

As fórmulas do Power Fx no Microsoft Copilot Studio usam numeração no estilo americano. Ou seja, o separador decimal é um ponto, como em 12,567.892. Isso significa que os parâmetros do Power Fx devem ser separados por vírgulas (,).

Pré-requisitos

• Criar e editar tópicos
• Usar variáveis

Usar variáveis em uma fórmula

Para usar uma variável em uma fórmula do Power Fx, você deve adicionar um prefixo ao nome para indicar o escopo da variável:

• Para variáveis do sistema, use System.
• Para variáveis globais, use Global.
• Para variáveis de tópicos, use Topic.

Por exemplo, para usar a variável de sistema Conversation.Id em uma fórmula, você precisa se referir a ela como System.Conversation.Id.

Usar valores literais em uma fórmula

Além de usar variáveis em uma fórmula do Power Fx, você pode inserir valores literais. Para usar um valor literal em uma fórmula, você deve inserir o valor no formato que corresponde ao seu tipo. A tabela a seguir lista os tipos de dados e o formato de seus valores literais correspondentes.

Tipo	Exemplos de formato
Cadeia de caracteres	"hi", "hello world!", "copilot"
Booliano	Apenas true ou false
Número	1, 532, 5.258, -9201
Tabela	[1], [45, 8, 2], ["cats", "dogs"]
Registro	{ id: 1 }, { message: "hello" }, { name: "John", info: { age: 25, weight: 175 } }
DateTime	Time(5,0,23), Date(2022,5,24), DateTimeValue("May 10, 2022 5:00:00 PM")
Opção	Incompatível
Em branco	Somente Blank()

Usar o Power Fx para definir uma variável

Neste exemplo, usaremos uma expressão do Power Fx para armazenar o nome do cliente e exibi-lo em letras maiúsculas.

1. Crie um tópico e adicione um nó Pergunta.

2. Para Inserir uma mensagem, insira What is your name?.

3. Em Identificar, selecione a entidade pré-criada Nome da pessoa.

4. Selecione a caixa em Salvar resposta como,depois selecione a variável Var1 e nomeie-a como customerName.

   

5. Dentro do nó Pergunta, selecione + e Definir um valor de variável.

6. Selecione a caixa em Definir variável, depois selecione Criar uma nova e nomeie-a como capsName.

7. Na caixa Valor de destino, selecione a seta >, depois selecione a guia Fórmula.

8. Na caixa fx, insira Upper(Text(Topic.customerName)) e selecione Inserir.

   

9. Dentro do nó Pergunta, selecione + e Enviar uma mensagem.

10. Insira HELLO , selecione {x} depois escolha capsName.

    

Usar uma fórmula do Power Fx como condição

Para avaliar expressões mais complexas, configure nós de Condição para usar nas fórmulas do Power Fx.

Neste exemplo, o copiloto determina se uma data de reserva se qualifica para um desconto. Para isso, ele verifica se já se passaram 14 dias ou mais entre a data atual e a data de reserva fornecida pelo cliente.

1. Crie um tópico e adicione um nó Pergunta.

2. Para Inserir uma mensagem, insira Booking date?.

3. Em Identificar, selecione a entidade Data e hora.

4. Selecione a caixa em Salvar resposta como,depois selecione a variável Var1 e nomeie-a como bookingDate.

   

5. Selecione o ícone + e selecione Adicionar uma condição.

6. Dentro do nó Condição, selecione o Menu de nó (⋮), depois selecione Alterar para fórmula.

   

7. Na caixa Função, selecione a seta >, depois selecione a guia Fórmula.

8. Substitua o conteúdo da caixa fx pela fórmula Topic.bookingDate > (DateAdd (Now(), 14)) e selecione Inserir.

9. Dentro do nó Condição, adicione um nó Enviar uma mensagem e digite a mensagem You qualify for a discount.

10. Dentro do nó Todas as outras condições, adicione um nó Enviar uma mensagem e digite a mensagem Sorry, you don't qualify for a discount.