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:
-
*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. -
*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. - *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.