Why does my model ignore the tool I defined?
Common causes of ignored tools
If the description is generic or overlaps with another tool, the model may prefer a direct answer. A system prompt that tells the model to answer without tools can also block calls. Check whether any other instruction discourages tool use.
Some APIs let you force or suggest a tool choice. Those settings vary by provider, so confirm how your provider handles tool selection before you rely on it.
Checking the request
Print the exact request your code sends, including the tools list. A missing field, a malformed schema or a tool outside the allowed list will cause quiet failures. Compare it with the provider's documentation example to spot differences.
Test with a simple prompt that clearly needs the tool. If the model still ignores it, reduce the number of tools and try again to see whether the list is too crowded. Log the tool list the model received so you can confirm it matches what you expected.
- Check the description for clarity and fit.
- Remove conflicting instructions from the prompt.
- Verify the tools list in the raw request.
- Test with fewer tools to isolate the problem.
Common mistakes
- Adding many similar tools and expecting the model to pick the right one every time.
- Changing the prompt without checking the actual request payload.
