CASO DE USO EM PRODUÇÃO

API de IA para automatizar processos

Um fluxo de contas a pagar lê a fatura, compara com o pedido, pede para classificar diferenças e encaminha à aprovação ou abre um chamado. O estado fica no banco de dados, não no histórico de chat.

Automação por etapas com tentativas, verificações e estado final
API de IA para automatizar processos

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 principalgpt-5.6-terraTerra cuida da decisão delimitada com o raciocínio necessário para classificar políticas e exceções.
Modelo alternativogemini-2.5-flashUse Gemini 2.5 Flash para classificações delimitadas que passem na validação. Encaminhe novas exceções ao Sol ou a uma pessoa sem ampliar as permissões do modelo.
Modelo para tarefas mais difíceisgpt-5.6-solUse só se a rota principal não atingir o limite de qualidade ou complexidade
Formato esperadoJSON validadoUma classificação estruturada, ID da regra, explicação e motivo de revisão quando necessário.
01
Exemplo

Automação de processos em produção

Um fluxo de contas a pagar lê a fatura, compara com o pedido, pede para classificar diferenças e encaminha à aprovação ou abre um chamado. O estado fica no banco de dados, não no histórico de chat.

O modelo decide apenas a classificação ambígua. Análise, cálculos, duplicidades, gravações, tentativas e prazos seguem lógica determinística. Toda gravação externa leva uma chave de idempotência.

02
Arquitetura

Como funciona o processo de automação de processos

  • Salve o estado e referências imutáveis de entrada.
  • Analise e compare com lógica determinística.
  • Chame o modelo só para a decisão ambígua.
  • Valide a decisão pelas políticas e regras de confiança.
  • Salve o próximo estado sem duplicatas ou encaminhe à revisão.
03
Requisição de API

Chame gpt-5.6-terra 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": "gpt-5.6-terra",
    "messages": [
      {"role": "system", "content": "Classify the invoice discrepancy using the supplied policy. Return MATCH, REVIEW, or REJECT with the exact policy rule. Do not perform any external action."},
      {"role": "user", "content": "Classify this invoice and purchase-order discrepancy."}
    ],
    "response_format": {"type": "json_object"}
  }'
04
Escolha do modelo

Por que gpt-5.6-terra é o modelo principal

Terra cuida da decisão delimitada com o raciocínio necessário para classificar políticas e exceções.

Use Gemini 2.5 Flash para classificações delimitadas que passem na validação. Encaminhe novas exceções ao Sol ou a uma pessoa sem ampliar as permissões do modelo.

05
Aceitação

Testes de aceitação de automação de processos

MétricaCondição de aprovação
Conclusão de ponta a pontaO fluxo registra sucesso após cumprir todas as etapas obrigatórias
Taxa de gravações duplicadasNovas tentativas não duplicam mensagens, chamados, pagamentos nem atualizações
Taxa de intervenção manualSó exceções previstas exigem uma pessoa para retomar o fluxo
Custo e duração por fluxoExecuções bem-sucedidas respeitam o orçamento de tempo e custo
06
Tratamento de falhas

Falhas a tratar antes de publicar

  • Usar o chat para guardar o estado
  • Repetir gravações sem idempotência
  • Dar permissões desnecessárias
  • Não prever um fim para falhas
07
Saída

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

Uma classificação estruturada, ID da regra, explicação e motivo de revisão quando necessário.

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

Onde guardar o estado do fluxo?

Guarde no banco de dados ou motor de fluxos; envie ao modelo só o estado relevante.

O que deve ser idempotente?

Toda gravação externa que possa ser repetida: mensagens, chamados, pagamentos e atualizações.

Quando parar as novas tentativas?

Limite as tentativas e encaminhe falhas definitivas à revisão com dados de recuperação.

Teste esta configuração com seus dados

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

Comparar modelos