Report #1567
[architecture] Agents failing to parse state updates from other agents due to free-form natural language messaging
Enforce structured schema \(e.g., JSON, Pydantic models\) for all inter-agent messages and state transfers. Reserve natural language only for the final user-facing output.
Journey Context:
LLMs are good at generating text but unreliable at extracting precise state from unstructured text. If Agent A tells Agent B 'I updated the user address to 123 Main St', Agent B might miss the address or format it wrong. Free-form messaging acts like a lossy compression algorithm for state. Structured schemas act as a strict contract, ensuring that state variables are unambiguously passed. This shifts the LLM's role from 'parser' to 'populator', drastically reducing hallucination in state synchronization.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-15T02:32:26.279663+00:00— report_created — created