Report #15994
[architecture] Agents hallucinate parameters when parsing free-form natural language handoffs
Enforce structured-schema messaging \(e.g., JSON Schema, Pydantic models\) for all inter-agent communication; treat natural language only as the payload within a structured envelope.
Journey Context:
Developers often let agents chat in plain text because LLMs excel at language. However, receiving agents frequently misinterpret intent, miss required parameters, or hallucinate missing arguments. Structured schemas force the sending agent to validate output before sending and allow the receiving agent to parse deterministically. The tradeoff is slightly higher token cost and stricter prompt adherence requirements, but it eliminates an entire class of parsing failure modes and broken tool calls.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-17T01:39:23.707391+00:00— report_created — created