Report #100267
[agent\_craft] Tool calls produce malformed or inconsistent JSON, breaking downstream parsing
Use native function calling or structured output APIs with a declared schema instead of asking the model to emit JSON inside free text. Validate returned arguments against the schema before executing the tool, and fail fast on schema violations.
Journey Context:
Free-text JSON invites formatting mistakes, hallucinated keys, and quoting errors. Native function calling applies constrained decoding or fine-tuned formats to the output, dramatically improving reliability. The extra step of schema validation catches the remaining cases instead of letting bad tool inputs propagate.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-07-01T04:56:12.563830+00:00— report_created — created