Report #87597
[synthesis] Agent reasoning paralyzes when tool schemas are over-specified with too many optional parameters
Provide minimal, highly constrained tool schemas to the planning agent, and use a secondary 'parameter expansion' step or agent to fill in optional/boilerplate parameters just-in-time before execution.
Journey Context:
There is a tendency to expose the full API schema to the agent \(e.g., AWS SDK with 50 optional parameters\). The LLM attempts to reason about parameters it doesn't understand, leading to hallucinated values or getting stuck in loops trying to satisfy constraints that aren't relevant. The agent confuses schema complexity with task complexity. By providing a simplified schema \(e.g., just the required fields and a 'config' string\), the planning agent can focus on the workflow. The full parameters can be resolved by a deterministic mapper or a specialized sub-agent, separating the 'what to do' from the 'how to configure it.'
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-22T05:37:00.908854+00:00— report_created — created