Como Usar Prompts de IA no Power Apps para Analisar Imagens e Documentos

Uma das perguntas mais frequentes de desenvolvedores Power Apps é: como usar IA diretamente no Power Apps Canvas, sem depender de serviços externos? A resposta está nos prompts de IA da Power Platform — uma funcionalidade do AI Builder que permite criar prompts personalizados que recebem parâmetros (imagens, documentos, textos) e retornam resultados gerados por IA, diretamente dentro da sua aplicação.

Neste artigo, você vai aprender como criar um prompt de IA na Power Platform, conectá-lo ao Power Apps Canvas e usar a função Predict() para analisar imagens, documentos e executar cálculos — tudo dentro da casinha da Microsoft, sem APIs externas.

Como Funciona a Integração de IA no Power Apps Canvas

A integração de IA no Power Apps Canvas usa o AI Builder da Power Platform. O fluxo funciona assim:

1. Você cria um prompt personalizado no AI Builder (com parâmetros variáveis)
2. O prompt é publicado e fica disponível como um conector de modelo de IA no Power Apps
3. Dentro do app Canvas, você adiciona o conector do modelo e usa a função Predict() para chamar o prompt
4. O resultado é retornado como um registro com a resposta da IA

O grande diferencial é que você usa a infraestrutura de IA da Microsoft — sem precisar de chaves de API externas, sem Azure OpenAI separado, sem código complexo. Tudo dentro do mesmo ambiente da Power Platform.

Criando um Prompt Personalizado no AI Builder

O primeiro passo é criar o prompt que será chamado pela aplicação. No AI Builder (disponível no portal make.powerapps.com), você pode criar prompts com parâmetros variáveis:

• Parâmetro do tipo imagem: para analisar fotos, capturas de tela ou documentos escaneados
• Parâmetro do tipo texto: para processar dados textuais dinâmicos
• Parâmetro do tipo arquivo/documento: para extrair informações de PDFs e docs

Exemplo prático: um prompt que recebe uma imagem e retorna uma descrição em 50-60 palavras. Você define o template do prompt com o parâmetro embutido, e o AI Builder usa o modelo de linguagem padrão (GPT) para processar a resposta.

Dica importante: Mantenha o modelo padrão (Standard) — não troque para modelos personalizados do Azure AI Foundry a não ser que tenha uma necessidade muito específica. O modelo padrão já entrega excelentes resultados para a maioria dos casos de uso.

Conectando o Prompt ao Power Apps Canvas

Com o prompt criado e publicado no AI Builder, você pode conectá-lo ao seu app Canvas:

• Abra o seu aplicativo Canvas no Power Apps Studio
• No painel de dados/conectores, busque por Modelos de IA
• Adicione o conector do prompt que você criou — cada prompt publicado aparece como um modelo separado
• O conector fica disponível para ser chamado em qualquer fórmula do app

Após adicionar o conector, você pode usá-lo em botões, campos ou qualquer elemento do app que suporte fórmulas Power Fx.

Usando a Função Predict() para Chamar o Prompt

A chamada ao prompt dentro do Power Apps usa a função Predict(). No exemplo com análise de imagem:

• Adicione um componente Adicionar Imagem ou Upload de Imagem na tela
• Adicione um botão para acionar a chamada ao prompt
• No evento OnSelect do botão, você capture a imagem do uploader com uma variável: Set(varImagem, UploadImagem1.Media)
• Em seguida, chame o prompt via Predict(): Set(varResultado, NomeDoSeuPrompt.Predict(varImagem))
• O resultado retorna um registro (record) com propriedades: FinishReason (motivo da conclusão) e Text (o conteúdo gerado pela IA)
• Para exibir o texto na tela, acesse: varResultado.Text

É fundamental nomear bem seus parâmetros no AI Builder — o nome que você dá ao parâmetro no prompt é exatamente o que aparece como argumento da função Predict() no Power Apps. Nomes claros evitam confusão na hora de usar.

Exemplos Práticos de Uso com IA no Power Apps

A combinação de prompts com parâmetros e o Predict() abre muitas possibilidades:

• Análise de imagens: o usuário fotografa um produto e o app retorna descrição, categoria ou prazo de validade
• Leitura de documentos: o usuário faz upload de uma nota fiscal e o app extrai fornecedor, valor e data automaticamente
• Análise de sentimentos: o usuário cola um texto de feedback e o app classifica como positivo, neutro ou negativo
• Geração de conteúdo: o app recebe dados de um registro (nome, produto) e gera automaticamente um e-mail ou proposta
• Cálculos com linguagem natural: o usuário descreve um problema e o prompt retorna o resultado processado

Custos e Licenciamento

Um ponto importante: o uso do AI Builder/prompts de IA no Power Apps consome Copilot Credits (anteriormente chamados de AI Builder Credits — foram unificados). Além disso:

• O usuário que executa o app precisa ter acesso premium (Power Apps Premium ou similar)
• Cada chamada ao Predict() consome créditos de acordo com o modelo e o tamanho da resposta
• Verifique o consumo de Copilot Credits no portal de administração da Power Platform

Perguntas Frequentes

Posso usar prompts de IA no Power Apps sem o AI Builder?

Não diretamente com a função Predict(). Os prompts personalizados e modelos de IA nativos do Power Apps dependem do AI Builder. Para integrar IA sem AI Builder, a alternativa é chamar uma API externa (como Azure OpenAI) via conector HTTP, o que exige configuração adicional e credenciais separadas.

Quais tipos de arquivos posso passar para o prompt no Power Apps?

Atualmente, os prompts do AI Builder suportam imagens (JPEG, PNG), documentos (PDF, Word) e texto. O tipo de parâmetro é definido na criação do prompt no AI Builder. Cada tipo de parâmetro tem suas próprias restrições de tamanho — verifique a documentação oficial para os limites atuais.

Como exibir o resultado da IA em uma Label no Power Apps?

O resultado do Predict() é um registro com propriedade Text. Para exibir em um Label, use na propriedade Text da Label: varResultado.Text (onde varResultado é a variável onde você armazenou o resultado). Você também pode concatenar com outros textos: “Resultado: ” & varResultado.Text

O prompt de IA pode ser reutilizado em múltiplos apps?

Sim. Um prompt publicado no AI Builder fica disponível para todos os aplicativos e fluxos do mesmo ambiente. Você cria o prompt uma vez e pode conectá-lo em múltiplos apps Canvas, Power Automate flows ou até em outros recursos da Power Platform que suportem conectores de modelos de IA.

O usuário final precisa de licença especial para usar o app com IA?

Sim. O uso de recursos de IA via AI Builder exige que o usuário tenha acesso premium no Power Apps. Isso porque o AI Builder é um componente premium da Power Platform. Verifique se os usuários finais do seu app possuem o plano adequado antes de implementar a funcionalidade.

Conclusão

Integrar prompts de IA ao Power Apps Canvas com o AI Builder é uma das formas mais diretas de adicionar inteligência artificial às suas aplicações dentro do ecossistema Microsoft, sem código complexo e sem depender de serviços externos. Com a função Predict(), você passa parâmetros dinâmicos — imagens, documentos, textos — e obtém respostas geradas por IA diretamente na sua aplicação.

As possibilidades são amplas: análise de imagens, leitura de documentos, geração de conteúdo, classificação de textos. O limite é a criatividade. O ponto de atenção fica para o licenciamento — Copilot Credits e acesso premium são necessários.

Assista ao vídeo completo acima para ver o passo a passo ao vivo, incluindo a criação do prompt, a conexão ao app e o teste com imagens reais.