Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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:
- Para variáveis de sistema, use
System. - Para variáveis globais, use
Global. - Para variáveis de tópico, use
Topic.
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.
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.
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.
Crie um tópico e adicione um nó Pergunta.
Para Digite uma mensagem, digite "Qual é o seu nome?".
Em Identificar, selecione a entidade Nome da pessoa.
Marque a caixa em Salvar resposta do usuário como e, em seguida, selecione a variável
Var1e nomeie-acustomerName.No nó Pergunta, selecione + e, em seguida, selecione Definir um valor de variável.
Selecione a caixa em Definir variável e, em seguida, selecione Criar novo e nomeie-o
capsName.Na caixa Para valor , selecione a seta > e, em seguida, selecione o separador Fórmula.
Na caixa fx , digite
Upper(Text(Topic.customerName))e, em seguida, selecione Inserir.
No nó Pergunta , selecione + e, em seguida, selecione Enviar uma mensagem.
Digite "HELLO ", selecione {x} e, em seguida, selecione
capsName.
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.
Crie um tópico e adicione um nó Pergunta.
Para Inserir uma mensagem, digite "Data da reserva?".
Em Identificar, selecione a entidade Data e hora.
Marque a caixa em Salvar resposta do usuário como e, em seguida, selecione a variável
Var1e nomeie-abookingDate.
Selecione o ícone Adicionar nó
abaixo do nó Questão e, em seguida, selecione Adicionar uma condição.Selecione os três pontos (...) do nó Condição e depois selecione Alterar para fórmula.
Na caixa Função , selecione a seta > e, em seguida, selecione o separador Fórmula .
Substitua o conteúdo da caixa fx pela fórmula
Topic.bookingDate > (DateAdd (Now(), 14))e, em seguida, selecione Inserir.No nó Condição, adicione um nó Mensagem e introduza a mensagem "É legível para um desconto".
No nó Todas as Outras Condições , adicione um nó Mensagem e insira a mensagem "Desculpe, você não se qualifica para um desconto".