Partilhar via


Criar expressões usando Power Fx

Power Fx é uma linguagem low-code que usa fórmulas semelhantes ao Excel. Use o Power Fx para criar uma lógica complexa que permite que seus agentes manipulem dados. Por exemplo, uma fórmula Power Fx pode definir o valor de uma variável, analisar uma cadeia de caracteres ou usar uma expressão em uma condição. Para obter mais informações, consulte a visão geral do Power Fx e a referência de fórmulas.

Observação

As fórmulas Power Fx no Copilot Studio usam numeração no estilo dos EUA. Ou seja, o separador decimal é um ponto final ou ponto, como em 12,567.892. Isso significa que você deve usar vírgulas (,) como separadores de parâmetros para suas fórmulas Power Fx.

Pré-requisitos

Usar variáveis em uma fórmula

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

Por exemplo, para usar a variável Conversation.Id de sistema em uma fórmula, consulte a variável de sistema como System.Conversation.Id.

Captura de ecrã do painel de fórmulas Enter com uma expressão que contém uma variável de sistema.

Usar valores literais em uma fórmula

Além de usar variáveis em uma fórmula Power Fx, você pode inserir valores literais. Para usar um valor literal em uma fórmula, você deve inseri-lo 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 formatos
Cordão "hi", "hello world!", "copilot"
booleano Apenas true ou false
Número 1, 532, 5.258,-9201
Registo e Tabela [1], [45, 8, 2], ["cats", "dogs"], { id: 1 }, { message: "hello" }, { name: "John", info: { age: 25, weight: 175 } }
Data e Hora Time(5,0,23), Date(2022,5,24), DateTimeValue("May 10, 2022 5:00:00 PM")
Escolha Não suportado
Em branco Apenas Blank()

Fórmulas comuns "Power Fx"

A tabela a seguir lista os tipos de dados e as fórmulas Power Fx que você pode usar com cada tipo de dados.

Tipo Fórmulas do Power Fx
Cordão Função de texto
Funções Concat e Concatenate
Função Len
Funções Lower, Upper e Proper
Funções IsMatch, Match e MatchAll
Funções EndsWith e StartsWith
Função Find
Funções Replace e Substitute
booleano Função booleana
Funções And, Or e Not
Funções If e Switch
Número Funções Decimal, Float e Value
Funções Int, Round, RoundDown, RoundUp e Trunc
Registo e Tabela Funções Concat e Concatenate
Funções Count, CountA, CountIf e CountRows
Função ForAll
Funções First, FirstN, Index, Last e LastN
Funções de filtro, pesquisa e localizar
Função JSON
Função ParseJSON
Data e Hora Funções Date, DateTime e Time
Funções DateValue, TimeValue e DateTimeValue
Funções Dia, Mês, Ano, Hora, Minuto, Segundo e Dia da Semana
Funções Now, Today, IsToday, UTCNow, UTCToday, IsUTCToday
Funções DateAdd, DateDiff e TimeZoneOffset
Função de texto
Em branco Funções Blank, Coalesce, IsBlank e IsEmpty
Funções Error, IfError, IsError, IsBlankOrError

Usar Power Fx para definir uma variável

Neste exemplo, uma expressão Power Fx armazena e produz o nome do cliente em letras maiúsculas.

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

  2. Para Digite uma mensagem, digite "Qual é o seu nome?".

  3. Em Identificar, selecione a entidade Nome da pessoa.

  4. Marque a caixa em Salvar resposta do usuário como e, em seguida, selecione a variável Var1 e nomeie-a customerName.

  5. No nó Pergunta, selecione + e, em seguida, selecione Definir um valor de variável.

  6. Selecione a caixa em Definir variável e, em seguida, selecione Criar novo e nomeie-o capsName.

  7. Na caixa Para valor , selecione a seta > e, em seguida, selecione o separador Fórmula.

  8. Na caixa fx , digite Upper(Text(Topic.customerName))e, em seguida, selecione Inserir.

    Captura de ecrã de uma fórmula do Power Fx num nó Definir uma Variável com o separador Fórmula realçado.

  9. No nó Pergunta , selecione + e, em seguida, selecione Enviar uma mensagem.

  10. Digite "HELLO ", selecione {x} e, em seguida, selecione capsName.

    Captura de ecrã do nó Mensagem com uma mensagem definida.

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

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

Neste exemplo, o agente determina se uma data de reserva se qualifica para um desconto. Para fazer isso, ele verifica se a data da reserva fornecida pelo cliente é de 14 dias ou mais a partir da data atual.

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

  2. Para Inserir uma mensagem, digite "Data da reserva?".

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

  4. Marque a caixa em Salvar resposta do usuário como e, em seguida, selecione a variável Var1 e nomeie-a bookingDate.

    Captura de tela de um nó Pergunta com uma entidade de data e hora escolhida e uma variável definida.

  5. Selecione o ícone Adicionar nó abaixo do nó Questão e, em seguida, selecione Adicionar uma condição.

  6. Selecione os três pontos (...) do nó Condição e depois selecione Alterar para fórmula.

  7. Na caixa Função , selecione a seta > e, em seguida, selecione o separador Fórmula .

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

  9. No nó Condição, adicione um nó Mensagem e introduza a mensagem "É legível para um desconto".

  10. No nó Todas as Outras Condições , adicione um nó Mensagem e insira a mensagem "Desculpe, você não se qualifica para um desconto".

    Captura de tela dos nós de mensagem condicional.