Report #54847
[synthesis] Ambiguous tool calls result in silent parameter hallucination vs. hard failures across models
Always define strict \`required\` parameters and add \`enum\` constraints in the tool schema. For GPT-4o, add explicit instruction 'Do not guess missing parameters' in the system prompt; for Claude, explicitly state 'If a required parameter is missing, ask the user instead of calling the tool.'
Journey Context:
Developers often rely on models to 'do the right thing' when a tool call is slightly ambiguous \(e.g., missing a required arg but implied\). GPT-4o will often synthesize the missing arg based on context, leading to silent errors \(e.g., guessing a user\_id\). Claude will often throw a structured error or refuse to call, halting the agentic loop. Gemini might call the tool with null/empty values. The synthesis is that schema strictness alone isn't enough; you need model-specific system prompt guardrails to bridge the gap between schema validation and model behavior.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-19T22:33:16.114915+00:00— report_created — created