O Code Interpreter na Power Platform chegou para mudar a forma como desenvolvemos soluções inteligentes com baixo código. Agora é possível executar Python diretamente nos prompts do AI Hub — o mesmo mecanismo que o ChatGPT usa internamente para gerar documentos, realizar cálculos complexos e interagir com dados. Neste artigo você aprende passo a passo como habilitar esse recurso, criar um prompt que gera arquivos DOCX e entende o que acontece por trás dos panos.
O Que é o Code Interpreter na Power Platform?
Os prompts de IA no AI Hub da Power Platform permitem que desenvolvedores criem lógicas de inteligência artificial reutilizáveis tanto no Power Apps Canvas quanto no Power Automate. Esses prompts funcionam enviando uma instrução em linguagem natural para um modelo de IA (como o GPT-4.1 mini) e recebendo uma resposta textual ou estruturada.
O Code Interpreter vai além: ele permite que o modelo de IA gere e execute código Python internamente para chegar ao resultado. Isso é exatamente o que acontece quando você pede ao ChatGPT para criar um arquivo Word ou calcular algo com precisão — ele cria o código, roda, e entrega o arquivo ou o resultado final.
- Execução de cálculos complexos com precisão numérica
- Geração de arquivos Office (DOCX, XLSX) com conteúdo dinâmico
- Leitura e escrita de tabelas no Dataverse
- Processamento de dados estruturados direto no fluxo do Power Automate
Antes desse recurso, os prompts se limitavam a responder com texto. Agora eles podem gerar artefatos reais, o que representa um salto significativo para quem constrói aplicações profissionais na Power Platform.
Como Habilitar o Code Interpreter nos Prompts do AI Hub
Habilitar o interpretador de código é simples e leva menos de um minuto. Veja o caminho completo:
- Acesse o Power Apps ou o Power Automate e abra o seu ambiente.
- No menu lateral, localize AI Hub (ou Prompts de IA, dependendo da versão do ambiente).
- Abra um prompt existente ou crie um novo.
- Clique nos três pontos (⋯) no canto superior direito do editor de prompt.
- Selecione Settings (Configurações).
- Ative a opção Enable Code Interpreter.
- Confirme clicando em OK.
Pronto. A partir desse momento, qualquer instrução enviada para o prompt poderá acionar a execução de código Python pelo modelo de IA, de forma transparente para o usuário final da aplicação.
Importante: as execuções feitas no botão Testar do editor de prompts não consomem créditos de IA (Copilot Credits). Só consomem quando o prompt é chamado a partir de um app ou fluxo em produção.
Code Interpreter Power Platform: Criando um Prompt que Gera DOCX
Agora vamos ao caso prático mais pedido: gerar um arquivo Word (.docx) com conteúdo dinâmico passado por variável.
Configurando o Prompt
No editor de prompts, crie um novo prompt com a instrução abaixo:
Gere um arquivo Word para mim.
Coloque a seguinte palavra no documento: {TextoDoWord}Aqui, {TextoDoWord} é uma variável dinâmica que será substituída pelo valor real toda vez que o prompt for chamado — seja pelo Power Apps ou pelo Power Automate.
Configurando o Output
Por padrão, o output do prompt é do tipo Text. Para receber o arquivo gerado, altere o tipo de saída para Documento (File/Document). Isso permite que o resultado seja um arquivo binário (o .docx), e não apenas uma string de texto.
Testando Com e Sem o Code Interpreter
Esta comparação é fundamental para entender o valor do recurso:
- Com Code Interpreter ativado: o modelo gera o código Python que cria o arquivo Word usando bibliotecas como
python-docx, executa o código internamente e retorna o arquivo .docx pronto para download ou salvamento. - Sem Code Interpreter: ao tentar gerar um arquivo, o modelo responde com uma mensagem de erro como “Não posso criar arquivos diretamente” — porque ele não tem mecanismo de execução disponível.
Essa diferença torna o Code Interpreter indispensável para qualquer prompt que precise entregar um artefato concreto além de texto simples.
O Que Acontece Por Trás: Execução de Python no AI Hub
Uma das partes mais interessantes é a transparência sobre o que ocorre internamente. Ao ativar o Code Interpreter e testar um prompt, você pode visualizar os Run Details (Detalhes de Execução) e verá que o modelo gerou e executou um trecho de código Python.
Isso é exatamente o mesmo mecanismo que o ChatGPT usa quando você pede para ele criar um arquivo ou fazer um cálculo preciso. O modelo:
- Interpreta sua instrução em linguagem natural (português, inglês etc.)
- Traduz para um código Python equivalente
- Executa o código em um ambiente seguro e isolado
- Retorna o resultado ou o arquivo gerado
Isso significa que você não precisa escrever código Python para se beneficiar do recurso. Basta descrever o que quer em português e o modelo cuida do resto. E se você quiser passar um bloco de código Python diretamente no prompt, isso também funciona — o Code Interpreter vai executá-lo fielmente.
Integração com Dataverse e Power Apps Canvas
Além de gerar documentos, o Code Interpreter Power Platform permite interações diretas com tabelas do Dataverse. Isso abre possibilidades como:
- Ler dados de uma tabela, processá-los com Python e gravar os resultados de volta
- Gerar relatórios em Excel ou Word com dados do Dataverse via prompt
- Executar transformações de dados complexas que seriam difíceis apenas com fórmulas Power FX
No Power Apps Canvas, o fluxo é direto: o usuário interage com a interface, o app chama o prompt com os parâmetros definidos e recebe o arquivo ou resultado de volta — tudo dentro da mesma experiência low-code.
Boas Práticas ao Usar o Code Interpreter
- Use variáveis para conteúdo dinâmico — nunca fixe textos no prompt; passe tudo via parâmetros para reutilizar o prompt em diferentes contextos.
- Defina o tipo de output corretamente — se espera um arquivo, configure o output como documento; se espera texto, use Text.
- Teste sempre antes de produção — os testes no editor não consomem créditos; use-os para validar o comportamento com diferentes entradas.
- Monitore o consumo de créditos — prompts com Code Interpreter tendem a consumir mais Copilot Credits por execução, pois envolvem geração e execução de código.
- Combine com Power Automate — para salvar automaticamente os arquivos gerados no SharePoint, OneDrive ou enviar por e-mail.
Perguntas Frequentes
O Code Interpreter da Power Platform é o mesmo do ChatGPT?
Funcionalmente sim — ambos permitem que o modelo de IA gere e execute código Python internamente para entregar resultados que vão além do texto puro. A diferença é o ambiente: no ChatGPT você usa via interface web, enquanto na Power Platform você incorpora esse poder diretamente em seus apps e fluxos de automação.
Preciso saber Python para usar o Code Interpreter na Power Platform?
Não. Você pode escrever as instruções completamente em português e o modelo irá gerar e executar o código Python necessário por trás dos panos. O conhecimento de Python é opcional — útil se quiser passar blocos de código diretamente no prompt, mas não obrigatório para o uso padrão.
O Code Interpreter consome Copilot Credits?
As execuções de teste no editor de prompts são gratuitas. Em produção (chamadas a partir de apps ou fluxos), sim — cada execução consome Copilot Credits. Prompts com Code Interpreter tendem a consumir um pouco mais por execução em comparação a prompts de texto simples, devido à etapa de geração e execução de código.
É possível gerar outros formatos além de DOCX?
Sim. Como o mecanismo por trás é Python, o modelo pode gerar qualquer formato que bibliotecas Python suportem: planilhas Excel (.xlsx), CSVs, PDFs e outros formatos estruturados. O suporte prático depende das bibliotecas disponíveis no ambiente de execução da Microsoft.
Como o Code Interpreter interage com o Dataverse?
Prompts com Code Interpreter habilitado podem ler e gravar dados em tabelas do Dataverse diretamente, usando a integração nativa do AI Hub. Isso permite criar fluxos de processamento de dados que combinam IA generativa com persistência no banco de dados do ambiente Power Platform.
Conclusão
O Code Interpreter na Power Platform representa uma evolução significativa dos prompts do AI Hub. Ao permitir a execução de Python internamente, a Microsoft habilitou casos de uso que antes exigiriam serviços externos ou codificação complexa: geração de documentos Office, processamento de dados e integração com Dataverse — tudo dentro do ecossistema low-code.
Se você ainda não testou esse recurso, o ponto de entrada é simples: abra qualquer prompt no AI Hub, vá em Settings e ative o Enable Code Interpreter. O tutorial completo com demonstração prática está no vídeo acima — vale muito os 9 minutos de visualização.
Ficou com alguma dúvida ou quer ver casos de uso mais avançados com Code Interpreter e Power Automate? Deixe nos comentários!