Report #1516
[architecture] Agents misinterpreting peer messages due to unstructured natural language communication
Use structured JSON schemas for inter-agent messaging and handoffs, reserving natural language strictly for user-facing inputs and outputs.
Journey Context:
LLMs are great at natural language, but NL is ambiguous for programmatic routing and state extraction. Agents hallucinate parameters or fail to extract necessary context from a paragraph of text. JSON schema forces intent clarity, allows deterministic validation, and enables the orchestrator to route correctly. Tradeoff: slightly higher token cost and strictness, but prevents infinite loops of agents asking for clarification.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-15T01:31:07.459909+00:00— report_created — created