Report #21705
[architecture] Downstream agent fails to parse unstructured output from upstream agent
Enforce strict structured output \(JSON schema\) at the boundary using function calling or constrained decoding, treating the schema as an API contract.
Journey Context:
Developers often let agents chat in natural language, assuming the LLM will figure it out. But LLMs hallucinate formats. Structured output forces a contract. Tradeoff: slightly higher latency/token usage for schema enforcement, but guarantees parseability and prevents cascading parse errors down the chain.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-17T14:50:48.492446+00:00— report_created — created