CASO DE USO EM PRODUÇÃO

API de IA para extrair dados estruturados

Um processo extrai fornecedor, número da fatura, moeda, total, impostos e vencimento de faturas recebidas por e-mail. Gemini 2.5 Flash recebe texto OCR e indicações de layout e deve retornar um objeto JSON com versão.

Campos do documento convertidos em JSON validado
API de IA para extrair dados estruturados

Implementação para produção

API, modelo principal e configuração alternativa

Escolha para produçãoRecomendaçãoPor quê
APIPOST /v1/chat/completionsRequisição do servidor compatível com OpenAI
Modelo principalgemini-2.5-flashGemini 2.5 Flash é a rota principal de extração em alto volume no catálogo atual.
Modelo alternativogpt-5.6-terraUse Terra se funcionar melhor com um tipo específico de documento. Encaminhe a Gemini 2.5 Pro documentos longos ou com layout complexo.
Modelo para tarefas mais difíceisgemini-2.5-proUse só se a rota principal não atingir o limite de qualidade ou complexidade
Formato esperadoJSON validadoJSON invoice.v3 estrito, com campos tipados, null para dados ausentes e fonte por valor.
01
Exemplo

Extração de dados estruturados em produção

Um processo extrai fornecedor, número da fatura, moeda, total, impostos e vencimento de faturas recebidas por e-mail. Gemini 2.5 Flash recebe texto OCR e indicações de layout e deve retornar um objeto JSON com versão.

Campos ausentes ficam como null. Totais ambíguos incluem valores candidatos e suas fontes. O processo valida tipos e cálculos antes de aceitar o registro; falhas vão para correção ou revisão.

02
Arquitetura

Como funciona o processo de extração de dados estruturados

  • Aplique OCR e preserve os trechos de origem.
  • Envie a versão do esquema com o documento.
  • Peça JSON estrito com null para dados ausentes.
  • Valide esquema, moeda, totais, datas e fontes.
  • Aceite, corrija uma vez ou encaminhe à revisão humana.
03
Requisição de API

Chame gemini-2.5-flash pela LLMFly AI

Envie a requisição pelo servidor. Troque o conteúdo e os esquemas de exemplo pelos dados e ferramentas do aplicativo.

request.example
curl https://app.llmfly.ai/v1/chat/completions \
  -H "Authorization: Bearer $LLMFLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-2.5-flash",
    "messages": [
      {"role": "system", "content": "Extract one invoice into the supplied JSON schema. Use null for absent fields. Include a source span for every non-null value. Never guess."},
      {"role": "user", "content": "Extract this invoice using schema invoice.v3."}
    ],
    "response_format": {"type": "json_object"}
  }'
04
Escolha do modelo

Por que gemini-2.5-flash é o modelo principal

Gemini 2.5 Flash é a rota principal de extração em alto volume no catálogo atual.

Use Terra se funcionar melhor com um tipo específico de documento. Encaminhe a Gemini 2.5 Pro documentos longos ou com layout complexo.

05
Aceitação

Testes de aceitação de extração de dados estruturados

MétricaCondição de aprovação
Taxa de respostas com esquema válidoA resposta cumpre o esquema versionado sem correção
Precisão e recuperação por campoCada campo crítico cumpre suas metas de precisão e recuperação
Taxa de valores sem respaldoCada valor tem uma fonte ou uma regra explícita de cálculo
Custo por registro aceitoGeração, validação, correção e revisão respeitam o orçamento
06
Tratamento de falhas

Falhas a tratar antes de publicar

  • Confundir JSON válido com dados corretos
  • Adivinhar campos ausentes
  • Alterar esquemas sem versões
  • Esconder erros críticos na média
07
Saída

Saída e histórico de execução

JSON invoice.v3 estrito, com campos tipados, null para dados ausentes e fonte por valor.

Registre ID do modelo e da requisição, tokens, novas tentativas, validação e decisão final em cada execução de produção.

Dúvidas frequentes

JSON válido basta?

Não. Valide o esquema e compare cada valor extraído com sua fonte.

Como representar valores ausentes?

Defina o contrato: por exemplo, null para dados ausentes e um estado separado para ambiguidade.

Qual métrica importa mais?

Informe precisão e recuperação por campo, principalmente nos que acionam ações.

Teste esta configuração com seus dados

Compare principal e alternativo com as mesmas requisições, ferramentas e regras de validação.

Comparar modelos