Compartilhar via

Usar o Copilot para criar e editar fórmulas do Power Fx

  • Artigo

Copilot é um recurso de IA que o Power Apps Studio ajuda você a criar e modificar fórmulas do Power Fx rapidamente. Você pode usar o Copilot na barra de fórmulas para explicar fórmulas do Power Fx em linguagem natural ou gerar fórmulas do Power Fx a partir de linguagem natural ou comentários do código.

Pré-requisitos

O Copilot deve estar habilitado para seu ambiente e locatário. Para obter mais informações, consulte Habilitar ou desabilitar o Copilot (versão preliminar) no Power Apps.

Explicar uma fórmula

Use o Copilot na barra de fórmulas para entender o que uma fórmula está fazendo na linguagem simples.

  1. Selecione um controle e sua propriedade correspondente. Por exemplo, um controle de rótulo com a propriedade Text.

  2. Na barra de fórmulas, selecione a lista suspensa próxima do rótulo do campo fx para ver e escolha Explicar esta fórmula.

    Captura de tela do menu de funcionalidade Copilot mostrando o item Explicar esta fórmula.

    Como alternativa, você pode selecionar um subconjunto de uma fórmula e, em seguida, selecionar a lista suspensa próxima do rótulo do campo fx e escolher Explicar esta seleção para explicar apenas essa parte.

    Captura de tela da opção Copilot para Explicar esta seção, mostrando parte da fórmula realçada pelo usuário.

    O Copilot fornece uma explicação da fórmula, você pode copiar e inserir como um comentário de código ou compartilhar com outros criadores que estejam trabalhando no mesmo aplicativo. Quando Copilot explica uma seleção, ele pode adicionar contexto se isso for importante para a explicação.

    Captura de tela da explicação de Copilot de uma fórmula.

Limitações conhecidas da explicação de fórmulas

  • O tamanho máximo de uma explicação de fórmula é 5.000 caracteres. Se a fórmula exceder esse limite, use uma explicação parcial para garantir que ela funcione.
  • O Copilot só reconhece as propriedades padrão no Power Apps.
  • O Copilot não reconhece funções definidas pelo usuário.

Observação

O conteúdo gerado por IA pode ser impreciso e deve ser verificado quanto à precisão.

Gerar fórmulas a partir de comentários de código

O Copilot pode gerar fórmulas do Power Fx a partir de comentários de código na barra de fórmulas. Você mesmo pode aceitar a sugestão ou digitar a fórmula. Os comentários de código de fórmula também podem servir como documentação para suas fórmulas, bem como os comentários de código comuns.

  1. Com seu aplicativo de tela aberto para edição, digite um comentário de código usando // ou /* na barra de fórmulas.

    Captura de tela de um comentário digitado na barra de fórmulas do Copilot.

    Aguarde alguns segundos para que Copilot gere uma sugestão de fórmula ou pressione Enter para gerá-la imediatamente.

  2. Pressione Tab no teclado para aceitar e usar a fórmula sugerida. Você também pode digitar a sugestão.

    Captura de tela de um comentário com uma fórmula sugerida.

A sugestão permanecerá até que você selecione outro lugar ou digite um caractere que não corresponda à sugestão.

Você pode manter os comentários usados para gerar fórmulas do Power Fx na barra de fórmulas como documentação, semelhante aos comentários de código tradicionais.

Observação

  • Se o Copilot não fornecer uma sugestão, ele não poderá gerar uma fórmula com base no seu comentário. Tente reformular o comentário.
  • Recomendamos colocar entre aspas os elementos que você deseja incluir em sua fórmula, como "Button1.text".

Limitações conhecidas da geração de fórmulas a partir de comentários de código

  • O Copilot funciona em um controle e propriedade singulares, e não faz alterações em outros controles ou propriedades para obter o resultado desejado.
  • O Copilot não leva em conta o texto da fórmula existente.
  • O Copilot só reconhece as propriedades padrão no Power Apps.
  • O Copilot não reconhece funções definidas pelo usuário.
  • Os comentários de código funcionam somente com funções gerais do Power Fx e não com funções específicas Power Apps, como Navigate().
  • O painel avançado não desencadeia sugestões.
  • As fórmulas existentes para essa propriedade não estão incluídas na sugestão.

Criar uma fórmula (versão preliminar)

[Esta seção faz parte da documentação de pré-lançamento e está sujeita a alterações.]

No menu suspenso do Copilot na barra de fórmulas, agora você pode gerar uma fórmula usando linguagem natural para fazer uma solicitação discreta.

Observação

O recurso Copilot para fórmulas permanece ativado por padrão. Para desativá-lo, você pode localizar a configuração com seu aplicativo aberto. Vá até Configurações/Atualizações/Visualização e encontre a opção Copilot para fórmulas. A desativação da configuração faz com que a opção de menu Criar uma fórmula (versão preliminar) desapareça do menu suspenso Copilot da barra de fórmulas.

Usar Copilot para criar uma fórmula a partir de uma solicitação discreta

  1. Selecione um controle, como um rótulo de texto, e a propriedade correspondente, como Text.

  2. Na barra de fórmulas, selecione o Menu de funcionalidades do Copilot>Criar uma fórmula.

    Captura de tela da funcionalidade Criar uma Fórmula mostrando um exemplo de entrada.

  3. Na caixa de texto do Copilot, digite sua solicitação, como mostrar o dia da semana de hoje.

  4. Selecione a seta Criar para enviar a solicitação.

  5. O Copilot tenta criar uma fórmula. Selecione Aplicar para inserir a fórmula na mesma posição da interface do Copilot ou atualize e reenvie a solicitação.

    Captura de tela da funcionalidade Criar uma Fórmula mostrando a fórmula recomendada.

    Você vê o resultado depois de aplicar a fórmula.

    Captura de tela que mostra o dia da semana em um rótulo de texto.

Observação

As mesmas limitações se aplicam à criação de fórmulas a partir de uma solicitação discreta como ao gerar fórmulas a partir de comentários de código.

IA Responsável

Entenda as opções que você tem ao trabalhar com a IA. Saiba mais em Perguntas frequentes sobre o uso responsável da IA no Power Apps. Avalie as Perguntas frequentes sobre o Copilot do Power Fx para ver perguntas especificamente relacionadas a essa funcionalidade.

Suporte a Idiomas

A tabela a seguir lista os idiomas disponíveis para os recursos do copiloto da barra de fórmulas, que se baseia nas configurações do ambiente e do navegador do Power Platform.

Name Código do Idioma Funcionalidade com Suporte
Inglês en-US Explicar uma fórmula, Comentar fórmulas geradas, Criar uma fórmula
Chinês (simplificado) - China zh-Hans Explicar uma fórmula, Comentar fórmulas geradas
Tcheco - República Tcheca cs-CZ Explicar uma fórmula, Comentar fórmulas geradas
Dinamarquês - Dinamarca da-DK Explicar uma fórmula, Comentar fórmulas geradas
Holandês - Países Baixos nl-NL Explicar uma fórmula, Comentar fórmulas geradas
Finlandês - Finlândia fi-FI Explicar uma fórmula, Comentar fórmulas geradas
Francês - França fr-FR Explicar uma fórmula, Comentar fórmulas geradas
Alemão - Alemanha de-DE Explicar uma fórmula, Comentar fórmulas geradas
Grego - Grécia el-GR Explicar uma fórmula, Comentar fórmulas geradas
Italiano - Itália it-IT Explicar uma fórmula, Comentar fórmulas geradas
Japonês - Japão ja-JP Explicar uma fórmula, Comentar fórmulas geradas
Coreano - Coreia do Sul ko-KR Explicar uma fórmula, Comentar fórmulas geradas
Norueguês (Bokmål) - Noruega nb-NO Explicar uma fórmula, Comentar fórmulas geradas
Polonês - Polônia pl-PL Explicar uma fórmula, Comentar fórmulas geradas
Português - Brasil pt-BR Explicar uma fórmula, Comentar fórmulas geradas
Russo - Rússia ru-RU Explicar uma fórmula, Comentar fórmulas geradas
Espanhol (Tradicional) - Espanha es-ES Explicar uma fórmula, Comentar fórmulas geradas
Sueco - Suécia sv-SE Explicar uma fórmula, Comentar fórmulas geradas
Tailandês - Tailândia th-TH Explicar uma fórmula, Comentar fórmulas geradas
Turco - Turquia tr-TR Explicar uma fórmula, Comentar fórmulas geradas

Fórmulas geradas por comentários do Copilot (vídeo)