Report #78743
[agent\_craft] Defining dozens of tools in the system prompt consumes too much context and confuses the agent, leading to poor tool selection
Use a tool router: provide the agent with a small set of meta-tools \(e.g., search\_code, run\_code, edit\_file\) rather than granular tools for every specific API, or dynamically inject only the tools relevant to the current step.
Journey Context:
Every tool definition in the prompt consumes tokens and increases the search space for the model's next-token prediction. If an agent has 50 tools, it will often pick the wrong one or fail to follow the main instructions. By reducing the toolset to a few highly capable, composable tools \(like a shell or a generic API caller\), or by using a first-stage retrieval model to select 3-5 relevant tools before calling the LLM, you preserve context for the actual task reasoning.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-21T14:46:02.969031+00:00— report_created — created