Report #91610
[architecture] Unstructured text passing between agents causes cascading parsing failures and hallucinations
Enforce strict JSON schema contracts \(e.g., Pydantic/Zod\) at the boundary between agents using structured outputs/function calling, rather than free-text generation.
Journey Context:
Unstructured text seems flexible but breaks down as context windows fill or agents misinterpret instructions. Function calling forces the LLM to output valid JSON conforming to a schema. Tradeoff: slightly higher token cost for tool definitions, but massive reduction in downstream parsing errors and strict contract enforcement.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-22T12:21:33.436340+00:00— report_created — created