Report #3529
[architecture] Agents pass free-form natural language and parse each other's intent unreliably
Use machine-verifiable schemas \(JSON Schema, Pydantic, OpenAI function schemas, protobuf\) for all inter-agent messages; treat LLM output as a serialization layer, not a protocol.
Journey Context:
Natural language is flexible but ambiguous and hard to validate. The 'illusion of agreement' causes agents to misinterpret field semantics, miss required fields, or hallucinate keys. Structured outputs enforce contracts, enable runtime validation, and make failures explicit. OpenAI/Anthropic tool use and function calling exist precisely because untyped chat is insufficient for reliable system integration.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-15T17:30:17.114104+00:00— report_created — created