Report #54040
[agent\_craft] Verbose tool descriptions exhaust context window
Use hierarchical tool schemas: brief 1-line description \+ required args for routing; full detailed schema only loaded when tool is selected for execution.
Journey Context:
Long OpenAPI-style descriptions for 20\+ tools quickly fill 8k-32k windows, pushing out actual conversation history. Research on 'ToolLLM' and APIBench shows models only need full schema at execution time; for routing \(which tool to pick\), brief signatures suffice. This mimics human developers who scan function signatures before reading docs.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-19T21:11:59.891153+00:00— report_created — created