👤 Para administradores de processos, analistas financeiros, gestores de operações e profissionais de pré-vendas que lidam com auditoria de comprovantes, notas fiscais e dados estruturados no Pipefy.
🔑 Disponível para planos que contam com o módulo e créditos de Inteligência Artificial do Pipefy.
🎯 Ensinar a estruturar um agente especialista de IA para leitura de documentos via OCR, validação de regras de negócio com base em políticas internas e triagem automatizada sem perder a governança humana no fluxo.
Esse conteúdo nasceu de mais uma edição da série de treinamentos ao vivo da Pipefy Academy. A sessão foi apresentada por Débora Fernandes, Pre Sales Engineer no Pipefy. Nela, foi demonstrada a criação prática de um agente especialista focado na extração e validação automatizada de comprovantes em um processo corporativo de reembolso de despesas.
Ao terminar a leitura, você vai entender como sair de um prompt genérico para um prompt hiperpersonalizado, como alimentar a IA com bases de conhecimento corporativas e como tratar cenários de exceção (documentos ilegíveis ou despesas fora da política).
📖 O que você vai entender aqui:
O problema que aparece antes de qualquer configuração
Em rotinas de reembolso, conferência de contratos ou cadastro de fornecedores, a validação manual de notas e comprovantes consome um tempo operacional gigantesco do time. Analistas precisam abrir cada anexo, conferir se os valores e datas coincidem com o formulário e verificar manualmente se o gasto respeita as políticas da empresa.
A automação com IA resolve a triagem inicial, mas um erro comum é confiar essa auditoria a um prompt genérico. Sem regras explícitas de checagem, a IA pode alucinar, ler dados parciais de fotos tremidas e aprovar solicitações indevidas.
Framework para guardar: base de conhecimento (políticas claras) + prompt hiperpersonalizado (regras de legibilidade e extração) + Human-in-the-Loop (revisão humana nas exceções).
Pilar 1: Conhecimento e a Construção do Agente Especialista
Para transformar a IA em um analista rigoroso, é necessário definir papel, escopo e repertório.
1. Definindo a persona e o escopo
Diga exatamente qual função a IA assume. Em vez de apenas "Analise este card", configure o escopo: "Você é um analista especialista em validação de documentos financeiros. Seu objetivo é validar comprovantes recebidos e verificar se atendem à política corporativa".
2. Alimentando a base de conhecimento
Para evitar decisões arbitrárias, o agente deve consultar as regras oficiais da empresa:
- Upload de documento em PDF (ex: Política de Reembolso de até 20 MB).
- Ou cadastro via Texto Simples detalhando categorias elegíveis e limites de valor (ex: limite de R$ 80,00 para transporte).
Pilar 2: Habilidades de OCR e leitura de anexos
Para que o agente consiga ler fotos de recibos e arquivos em PDF, é necessário ativar a Skill de leitura de anexos.
- Como funciona o OCR: o motor de Inteligência transforma o conteúdo visual da imagem ou PDF em texto estruturado.
- Mapeamento de saída: configure a IA para preencher campos específicos da fase (ex: Valor Extraído, Data Extraída, Resultado da Análise e Resumo da IA).
Pilar 3: a evolução do prompt
A precisão da validação depende diretamente de como as instruções são escritas.
Exemplo de prompt genérico (Incorreto)
"Leia o comprovante anexado e verifique se o valor e a data batem com o formulário. Se bater, aprove; se não, mande para revisão manual."
Por que falha: Não define qual documento ler primeiro, não trata fotos de baixa qualidade e dá margem para alucinações da IA em comprovantes parciais.
🥇 As 4 regras de ouro do prompt especialista
- Idioma de saída: deixe explícito para responder sempre em Português do Brasil no campo de resumo.
- Extração independente primeiro: o agente deve obrigatoriamente ler o comprovante anexo antes de olhar os dados digitados no formulário.
- Trava rigorosa de legibilidade: se a imagem estiver borrada, tremida ou se apenas parte dos dados puder ser lida com confiança, a instrução exige determinar o documento como ilegível e enviar para revisão humana, proibindo a aprovação.
- Validação múltipla e teto de gastos: se houver múltiplos anexos, o agente deve somar os valores, validar a coerência das datas e checar o teto máximo permitido por categoria na política.
Perguntas da audiência, respondidas ao vivo
Quais são os limites de uso do Document Processing no Pipefy (páginas, formatos e créditos)?
Para a base de conhecimento de documentos (PDFs de políticas), não há limite de páginas, mas há um limite de tamanho de até 20 MB por arquivo (documentos extensos de mais de 100 páginas podem ser comprimidos). Em termos de custos, a execução do agente e a leitura inteligente consomem créditos de IA do seu plano Pipefy (a execução do agente soma o uso do crédito de IA com o processamento de documento).
Antes de avançar, confirme que você entende:
- A importância de treinar a IA com documentos e políticas da empresa.
- A necessidade de instruir o agente a ler o comprovante antes do formulário.
- Como criar regras de legibilidade no prompt para evitar aprovações indevidas.
- O papel do modelo Human-in-the-Loop para tratar exceções enviadas para revisão manual.
