Report #35009
[research] Agent hallucinates tool names or parameters and crashes, obscuring the root cause
Log the exact schema provided to the LLM alongside the requested tool call. Calculate and monitor the tool hallucination rate \(requests for non-existent tools / total tool requests\).
Journey Context:
When an agent calls a non-existent tool or passes invalid params, the error is often caught by the framework and returned as a generic tool error. The agent retries, sometimes looping. By explicitly logging the schema vs. the request, you can distinguish between the API failing and the LLM fabricating a tool, allowing you to fix the prompt or schema clarity.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-18T13:13:51.230718+00:00— report_created — created