Course contentsShow
← AI Engineering
Lesson 582 of 1,88614. Function Calling and Tool UseFree lesson

Handling Ambiguous Tool Requests

Detect when multiple tools could apply and prompt for clarification or use confidence thresholds.

Handling Ambiguous Tool Requests

You'll learn: How to detect when an LLM's tool request could match multiple functions and handle the ambiguity gracefully.

The Problem of Ambiguity

When an LLM has access to many tools, user queries can sometimes match multiple functions equally well. Imagine asking "What's the weather like?" when you have both a get_current_weather and a get_weather_forecast function—the model might struggle to pick the right one, or worse, pick arbitrarily.

Think of it like: A waiter asking "Which pasta?" when you just said "I'll have pasta" and they have five options. Good service means recognizing the ambiguity and asking for clarification.

Detection Strategies

Confidence thresholds: If your system exposes tool selection confidence scores (some providers do), you can detect when multiple tools score similarly (e.g., both above 0.7 but within 0.1 of each other). This signals ambiguity.

Multiple tool calls: When the LLM returns parallel function calls that seem redundant or contradictory, that's a red flag.

Pattern matching: Look for vague user queries combined with semantically similar tool descriptions in your registry.

Resolution Approaches

When ambiguity is detected:

  1. Prompt for clarification: Return a message asking the user to be more specific rather than executing a potentially wrong tool
  2. Present options: "I found two relevant tools—did you want X or Y?"
  3. Execute most conservative: Choose the tool with fewer side effects or lower cost
  4. Use context: Previous conversation history might reveal intent

Key Takeaway: Ambiguous tool requests require detection mechanisms (confidence thresholds, pattern analysis) and resolution strategies (user clarification, context-aware selection) to avoid executing the wrong function and degrading user experience.