Report #76044
[architecture] Agents communicating via unstructured natural language causing hallucinated function calls and parsing failures
Enforce structured schema \(JSON Schema/Pydantic\) for inter-agent messaging; use natural language only for user-facing outputs.
Journey Context:
LLMs are bad at consistently formatting free-text for machine consumption. One missed comma or hallucinated key breaks the receiving agent's parser. Developers think 'they are LLMs, they speak English,' but inter-agent communication is an API, not a chat. Tradeoff: slightly more rigid and requires schema maintenance, but eliminates an entire class of parsing errors and retry loops.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-21T10:13:49.519482+00:00— report_created — created