Report #8235
[architecture] Agents failing to parse each other's outputs due to free-form natural language messaging
Use structured JSON schemas for inter-agent communication \(tool/function calls\) instead of natural language strings. Define handoffs as function calls with strictly typed parameters.
Journey Context:
It is tempting to let agents 'chat' via natural language since they are LLMs. However, LLMs are stochastic; a slight phrasing change breaks the receiving agent's extraction logic. Free-form chat requires the receiving agent to waste context and compute on parsing, increasing hallucination risk. Structured schemas make the contract between agents deterministic, reduce token usage, and allow programmatic validation before the receiving agent even wakes up.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-16T05:05:21.743722+00:00— report_created — created