👤 Para admins do pipe
🔐 Disponível para todos os planos com AI Credits
🎯 Para processos com validação de comprovantes, notas fiscais ou documentos
Alguém envia um comprovante de pagamento. Um analista abre o arquivo, confere o valor, verifica a data e registra o resultado no sistema. Esse trabalho acontece dezenas de vezes por dia em processos de reembolso, compras e compliance. É repetitivo, escala mal e concentra atenção humana em tarefas que seguem sempre a mesma lógica.
O Document Understanding do Pipefy permite que o AI Agent leia o conteúdo de imagens e PDFs e aplique critérios de validação automaticamente. Não é extração de texto. É julgamento com critério: o agente verifica se o documento atende as condições que você definiu e registra o resultado no card. Ao final deste artigo, você vai saber quando usar essa capacidade, como configurar os critérios certos e onde o processo ainda precisa de revisão humana.
📖 O que você vai aprender aqui:
O que o Document Understanding faz e o que não faz
O agente com Document Understanding consegue ler o conteúdo de PDFs e imagens, extrair informações específicas e aplicar critérios definidos na instrução. PDFs nativos (gerados por sistema) produzem resultados mais precisos. PDFs escaneados e fotos de documentos físicos funcionam, mas com maior risco de erro, especialmente quando a qualidade da imagem é baixa.
O que funciona bem: extrair campos específicos de documentos padronizados, identificar o tipo do documento, verificar presença de informações obrigatórias e preencher campos do card com os dados extraídos.
O agente não garante precisão em: documentos manuscritos, tabelas com estrutura complexa, imagens com baixa resolução ou muito ruído visual, e desenhos técnicos. Para esses casos, o Document Understanding não é a ferramenta adequada sem revisão humana obrigatória.
Uma limitação importante sobre comparação de valores: o agente consegue extrair o valor de um documento e preencher um campo do card, mas comparações numéricas (ex: valor da nota bate com valor do pedido) têm precisão variável. A prática recomendada é usar o agente para extrair o valor e configurar uma automação com fórmula para fazer a comparação.
Três casos de uso e como o agente atua em cada um
-
Comprovante de pagamento em reembolso
O colaborador anexa o comprovante no campo @Comprovante de pagamento. O agente lê o arquivo, extrai o valor e a data, e preenche @Valor extraído e @Data do comprovante. Uma automação separada compara @Valor extraído com @Valor solicitado e registra o resultado em @Status da validação. A separação entre extração e comparação garante mais confiabilidade do que pedir ao agente para fazer as duas coisas na mesma instrução.
-
Nota fiscal em contas a pagar
O agente lê o arquivo anexado no campo @Nota fiscal, extrai os dados relevantes e preenche os campos do card automaticamente. Um comportamento bem configurado consegue atualizar múltiplos campos em uma única execução: CNPJ do emitente, descrição do serviço, valor total, data de emissão e data de vencimento. Se a fatura vencer no mês corrente, o mesmo comportamento pode criar automaticamente um card no pipe de Pagamentos para acionar o time financeiro.
-
Documento de identidade em onboarding
O agente identifica se o documento é RG ou CNH, extrai o nome e verifica se corresponde ao campo @Nome do colaborador. Resultado registrado em @Documento válido (Sim/Não) e @Tipo de documento. Para documentos com data de validade, o agente extrai a data e uma automação verifica se está dentro do prazo.
Nos três casos, o padrão é o mesmo: o agente extrai e preenche campos, as automações fazem as comparações lógicas. Dividir as responsabilidades entre agente e automação produz resultados mais confiáveis e mais fáceis de depurar quando algo sai errado.
Como definir critérios de validação na instrução
A instrução do agente é onde você define o que ele deve verificar. Uma instrução vaga produz resultados inconsistentes. Uma instrução específica produz resultados previsíveis.
Estrutura recomendada para instruções de validação de documento:
O que ler: referencie o campo de anexo com a sintaxe dinâmica. O Document Understanding é ativado automaticamente quando o agente encontra um campo de anexo na instrução.
O que extrair: liste os campos específicos que o agente deve identificar no documento. Seja preciso: "o valor total na linha de rodapé" é melhor que "o valor".
O que preencher: especifique os campos do card que receberão os dados extraídos e os valores aceitos em cada um.
O que fazer quando não consegue ler: sempre inclua uma instrução para o caso de arquivo ilegível, formato não suportado ou informação ausente. Sem isso, o agente deixa campos em branco ou preenche com valores inesperados.
Exemplo de instrução para comprovante de reembolso:
Leia o arquivo em @Comprovante de pagamento.
Extraia o valor total e preencha @Valor extraído.
Extraia a data da transação e preencha @Data do comprovante.
Se o arquivo não puder ser lido, preencha @Status da validação com "Inconclusivo".
Não compare valores. Não mova o card. Não envie notificações.
Quando o agente rejeita um documento válido
Falsos negativos acontecem. Um comprovante com layout fora do padrão, uma nota fiscal com tabela complexa ou uma foto tirada com pouca luz pode gerar resultado incorreto. O processo precisa estar preparado para isso desde a configuração, não como contingência depois.
- Configure uma fase de revisão humana para todos os cards com @Status da validação igual a "Reprovado" ou "Inconclusivo". O agente faz triagem em volume. O analista revisa os casos sinalizados.
- Torne o campo @Motivo obrigatório na instrução do agente para os casos reprovados. O analista precisa saber por que o agente rejeitou antes de revisar o documento.
- Monitore a taxa de inconclusivos nas primeiras semanas. Se um tipo específico de documento gerar muitos resultados incorretos, ajuste a instrução ou oriente os solicitantes sobre o formato de envio esperado.
Arquivos fora dos limites suportados (PDF com mais de 30 páginas, mais de 30 imagens por execução, formatos não suportados) não são processados e não consomem créditos. O agente não registra erro diretamente no card nesses casos. Para ter visibilidade, verifique os Logs de automação no cabeçalho do pipe.
