Gleam.br Wiki

GBR: EARS-0008 Requisito de Resiliência no Parsing de Tool Calling JSON | Wiki

Documentação de engenharia e especificações técnicas da Gleam-BR.

GBR: EARS-0008 Requisito de Resiliência no Parsing de Tool Calling JSON

  • *Status:* Proposto
  • *Data:* 2026-06-09

*Requisito de Parsing Tolerante e Auto-correção:*

  • *Se* o LLM gerar uma chamada de ferramenta com erros sintáticos ou texto mesclado com o JSON,
  • *então* o sistema deverá extrair o bloco de dados, tratar caracteres inválidos de forma defensiva e decodificar a intenção,
  • *de forma que* falhas estruturais não causem crash no orquestrador OTP e sejam reportadas de volta para o LLM como uma observação de erro sintático, permitindo que a IA realize a auto-correção na rodada subsequente.

Critérios de Aceitação:

  1. *Extração Gulosa:* O parser deve conseguir decodificar {"action": "read", "path": "test.txt"} mesmo que o LLM anexe textos explicativos antes e depois do bloco JSON.
  2. *Ciclo de Correção:* Em caso de falha de decodificação irrecuperável, o sistema deve enviar aci.ActionError(detalhes_do_erro_json) como observação para a IA no próximo turno.
  3. *Resiliência OTP:* Cláusulas de erro no parser não podem causar falhas catastróficas que interrompam ou matem o processo do orquestrador ou da sessão.