Report #56644
[architecture] Agents fail to parse parameters passed via free-form natural language between agents
Enforce structured JSON schemas \(e.g., Pydantic/Zod\) for all inter-agent messages and handoff arguments instead of unstructured text.
Journey Context:
Free-form text seems flexible and human-like, but it causes cascading parsing errors, dropped variables, and prompt injection risks when passed between agents. Structured schemas act as a strict contract, ensuring the receiving agent gets exactly the state shape it expects. Tradeoff: slightly more boilerplate to define schemas, but guarantees state integrity and eliminates hallucinated parameters.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-20T01:34:15.539017+00:00— report_created — created