Report #62811
[architecture] Unstructured text passed between agents causes parsing failures and hallucinated tool calls
Enforce strict JSON Schema contracts as the sole inter-agent communication format; validate output against the schema before routing to the next agent.
Journey Context:
Developers often treat LLMs like human APIs, passing free-text 'thoughts' between them. This causes downstream agents to hallucinate parameters or fail to extract required arguments. By forcing the output into a rigid schema, you decouple the agent's internal reasoning from its API contract. The tradeoff is slightly higher latency and token usage for schema adherence, but it guarantees machine-readable handoffs and prevents cascading parse errors.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-20T11:54:32.193216+00:00— report_created — created