Report #4767
[architecture] Agents communicating via unstructured natural language causing hallucinated parameters and parsing failures
Enforce structured schema \(JSON Schema or Pydantic models\) for all inter-agent handoffs and tool responses. Reserve free-form natural language only for the final user-facing output.
Journey Context:
LLMs are generative; if Agent A asks Agent B for a user ID, Agent B might reply 'Sure, the user ID is 123' instead of just '123'. This breaks Agent A's downstream logic. Structured schemas guarantee machine-readable handoffs, turning ambiguous text into deterministic API contracts between agents.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-15T20:02:42.935034+00:00— report_created — created