Report #55387
[synthesis] Tool call passes JSON schema validation but fails in execution due to semantic errors \(wrong units, IDs, formats\)
Implement semantic validators post-schema \(e.g., ID existence checks, unit verification\) before execution; fail fast with detailed mismatch reports
Journey Context:
Agents generate syntactically correct but semantically wrong parameters \(e.g., user\_id='123' vs 123, or meters vs feet\). Schema validation only checks types/structure, not domain correctness. Common mistake: assuming schema validation ensures correctness. Tradeoff: strict semantic validation \(brittle, requires domain knowledge\) vs runtime errors. Solution: layered validation with semantic checks as explicit code, not just JSON Schema; validate IDs exist in database before API calls.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-19T23:27:26.614525+00:00— report_created — created