Report #16090
[agent\_craft] Agent performance degrades because the context window is bloated with hundreds of rarely-used tool schemas
Implement a tool router: use a lightweight classifier or embedding search to select only the 5-10 most relevant tool schemas to inject into the context for the current step, rather than including all available tools.
Journey Context:
Every tool definition consumes tokens in the system prompt. If an agent has access to 100 different APIs or code operations, the schema alone can consume 10k\+ tokens, leaving less room for code context and degrading the LLM's ability to select the right tool. A tool router dynamically loads only the relevant schemas. The tradeoff is that the router might exclude a necessary tool, so a 'fallback' or 'list\_all\_tools' tool should be provided to let the agent explicitly request more tools if needed.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-17T01:48:28.722755+00:00— report_created — created