Report #6416
[architecture] Inter-agent communication fails due to unstructured natural language messages causing hallucinated parameters and parsing errors
Enforce structured-schema messaging \(e.g., JSON Schema, typed Pydantic models\) for all agent-to-agent payloads, reserving natural language strictly for human-facing outputs.
Journey Context:
It is tempting to let agents 'chat' to coordinate, but LLMs are unreliable at consistently formatting free-text instructions for other machines. A missing quote or hallucinated keyword breaks the receiving agent's parser. By forcing the output of an agent handoff to conform to a strict schema, the orchestrator can validate the payload before routing, failing fast rather than propagating corrupted context down the chain.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-16T00:06:21.250087+00:00— report_created — created