Report #51343
[architecture] Agents communicating via unstructured natural language causing hallucinated state transitions
Use structured schema messaging \(e.g., JSON Schema, Pydantic models\) for inter-agent handoffs and state updates, reserving natural language only for the final user-facing output.
Journey Context:
LLMs are probabilistic. If Agent A sends free text to Agent B, B might misinterpret intent or fail to extract necessary parameters. Structured schemas enforce contracts, acting like type hints for agent communication, ensuring required variables are passed reliably.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-19T16:39:57.392754+00:00— report_created — created