Escolha uma saída que possa ser conferida
Delimite uma tarefa concreta, como localizar datas de vigência em um conjunto de documentos administrativos. Liste quais campos serão utilizados e para qual ação. Evite começar pedindo todas as informações relevantes: essa expressão deixa ao modelo uma seleção que deveria pertencer ao processo. O primeiro produto do trabalho é uma definição de saída que uma pessoa consiga revisar.
O Guia de IA Generativa da SGD e do Serpro destaca limitações das respostas e a necessidade de revisão humana. Na extração, isso significa que uma estrutura aparentemente correta ainda precisa de conferência. Um arquivo pode ter todas as colunas solicitadas e conter um valor que nunca apareceu no documento. A presença do campo não comprova sua fidelidade.
Use um exemplo fictício com documento curto e resultado esperado preparado manualmente. Se a equipe discorda sobre qual data deve preencher uma coluna, resolva a definição antes de testar a IA. O desacordo pode revelar ambiguidade do processo, como confundir assinatura, publicação e início de vigência. A ferramenta não deve decidir silenciosamente qual desses eventos interessa.
Defina campos, unidades e situações de ausência
Para cada campo, descreva significado, tipo, unidade e possibilidade de repetição. Diferencie um valor monetário total de uma parcela, ou uma data mencionada no histórico da data que rege o ato atual. O dicionário de dados municipal ajuda a organizar essas definições para que o resultado tenha interpretação comum entre quem extrai e quem consome.
Defina como representar informação ausente, ilegível e contraditória. Essas situações não devem virar zero, data corrente ou texto presumido. Quando houver dois valores candidatos, preserve a ambiguidade e encaminhe para exame. A orientação deve proibir completar lacunas com conhecimento externo. Extração busca o que está no material autorizado; inferir uma resposta exige outra tarefa e outros critérios.
Se um documento contiver vários objetos, avalie se a saída precisa de uma linha por objeto em vez de uma linha por arquivo. Uma tabela de equipamentos pode ter quantidades e valores diferentes. Achatar tudo em uma única linha pode associar a quantidade de um item ao preço de outro. Estabeleça a unidade de registro e mantenha o vínculo entre os campos.
Prepare o documento e limite a entrada
Confirme autorização da aplicação, finalidade e dados permitidos antes de enviar arquivos. A preparação de documentos para IA trata da cópia de trabalho e da redução de informação desnecessária. Para extrair um período administrativo, talvez não seja preciso enviar assinaturas, contatos pessoais ou anexos alheios à tarefa. Use apenas o contexto suficiente para preservar o significado.
Confira a legibilidade da entrada. Em arquivos digitalizados, o texto reconhecido pode inverter colunas, perder sinais e separar uma condição do valor correspondente. O roteiro de conferência de OCR complementa essa etapa. Quando a representação textual estiver incorreta, marque o arquivo para tratamento adequado em vez de exigir que o modelo reconstrua uma informação que não recebeu.
Identifique versão e origem do documento usado no processamento. Se houver retificação posterior, o resultado anterior precisa continuar associado ao material que o produziu. Não misture páginas de versões diferentes para aumentar a cobertura sem registrar a montagem. A revisão depende de conseguir reabrir a mesma evidência e compreender quais páginas realmente participaram da extração.
Peça evidência junto de cada valor
Uma saída revisável deve relacionar valor, localização e trecho de apoio, conforme as possibilidades do formato. A página pode ajudar, mas não basta quando contém várias tabelas semelhantes. Combine referência do documento, seção ou item e passagem pertinente. O trecho deve permitir conferir o dado sem transformar a planilha de revisão em uma cópia integral de documentos restritos.
O guia prático de prompt da SGD orienta a construção de instruções claras e contextualizadas. Para este caso, descreva campos permitidos, tratamento de ausência e formato da resposta. Solicite que a ferramenta sinalize conflitos em vez de escolher o valor mais plausível. Teste a instrução em materiais distintos; uma boa resposta ao documento de demonstração não comprova funcionamento no conjunto real.
Não trate uma justificativa escrita pelo modelo como evidência suficiente. Reabra o original e verifique se a passagem existe e sustenta o valor. Um assistente pode produzir tanto um campo incorreto quanto uma explicação convincente para ele. A referência torna a revisão possível, mas a conferência é que estabelece a ligação observável entre documento e dado.
Separe validação estrutural e conferência de conteúdo
A validação estrutural verifica se campos, formatos e valores permitidos estão de acordo com o esquema. Uma data impossível, uma unidade desconhecida ou um objeto sem identificador devem interromper a importação. Esses controles são úteis e podem ser automatizados. Ainda assim, uma data válida no calendário pode estar associada ao ato errado e atravessar todas as verificações formais.
A conferência de conteúdo compara saída e evidência. Observe negações, exceções, alterações posteriores e notas de rodapé. Em um exemplo hipotético, o texto prorroga um prazo apenas para determinado grupo. Extrair a nova data e ignorar a condição cria um campo tecnicamente válido, porém inadequado para parte dos registros. Preserve as condições que delimitam o alcance da informação.
Defina quem resolve divergências e o que impede o uso. Campos que afetam direitos, pagamentos ou obrigações exigem tratamento compatível com a consequência. O framework AIE do Governo Digital oferece perguntas para refletir sobre impactos e controles. A avaliação do contexto ajuda a decidir quando revisão integral é necessária e quando um procedimento amostral pode ser justificado institucionalmente.
Monte um conjunto de teste com erros reconhecíveis
Inclua documentos com campo ausente, múltiplas datas, tabelas extensas, aditivos e páginas de baixa qualidade. Prepare resultados esperados antes de observar a resposta da ferramenta. Guarde casos que falharam para verificar regressões após mudanças. Um teste composto apenas por arquivos limpos mede o caminho mais fácil e pode esconder justamente as situações que consomem tempo na rotina.
Meça acerto por campo e por tipo de documento. Um total geral pode parecer bom enquanto uma coluna decisiva apresenta erro frequente. Conte também falsos preenchimentos, ausências corretamente reconhecidas e casos encaminhados à revisão. Quando a ferramenta deveria deixar uma lacuna e inventa um valor, o problema é diferente de simplesmente não localizar uma informação existente.
Avalie o esforço total de conferência. O objetivo pode deixar de ser vantajoso se a equipe precisar procurar cada campo em arquivos longos sem referência útil. Compare o fluxo com a rotina anterior, incluindo preparo, processamento, correção e transferência. Registre as condições do ensaio e evite transformar um ganho pontual de velocidade em promessa de produtividade para todo o órgão.
Entregue o resultado com estado de revisão
Mantenha o resultado extraído em uma etapa intermediária até a aprovação definida. Identifique quais campos estão pendentes, revisados ou rejeitados e quem realizou a conferência. Se o destino aceita apenas valores finais, não envie registros duvidosos usando um valor padrão para satisfazer o formato. A pendência precisa permanecer visível para receber o tratamento adequado.
Antes da transferência, confirme identidade do objeto e compatibilidade de unidade. Teste com registros fictícios se o destino preserva datas, caracteres e casas decimais. Uma extração correta pode ser alterada na importação por conversão automática de planilha. Confira o que ficou gravado, além do arquivo que saiu da ferramenta, sem produzir efeitos reais durante o ensaio.
Ao mudar modelo, instrução ou esquema, execute novamente os casos de teste afetados. Registre a versão do processo associada ao lote e conserve evidências na medida necessária. A página de inteligência artificial e agentes apresenta o posicionamento do Grupo Edge para usos delimitados. Este roteiro não implica disponibilidade de um extrator específico nem integração já implementada.
Guarde uma ficha de aceite do lote extraído
Ao concluir um lote, reúna referência dos documentos, esquema utilizado, versão da instrução, data de processamento e resultado da revisão. Indique quantos registros foram aceitos, quantos permaneceram pendentes e quais campos exigiram correção. Essa ficha pode ser curta, mas precisa permitir que o consumidor saiba o que está autorizado a usar e quais limitações acompanham a entrega.
Faça uma última conferência de amarração: cada linha aponta para o objeto certo, cada campo tem unidade reconhecida e nenhuma pendência foi convertida em informação definitiva. O responsável pelo recebimento deve conseguir repetir a localização de uma evidência selecionada. Se isso não for possível, resolva o vínculo antes de retirar o lote da etapa intermediária.
Perguntas frequentes
Um JSON válido comprova que a extração está correta?
Não. Ele comprova apenas parte da estrutura. Cada valor relevante precisa corresponder à evidência e ao significado definido para o campo.
O que fazer quando o documento contém dois valores possíveis?
Registre a ambiguidade e encaminhe para a revisão definida, preservando as referências. Não escolha silenciosamente um valor por parecer mais provável.

