# Intent Ambiguity

If your intents have a very similar training set and potentially compete in classification, this is called "intent ambiguation". It is possible that the AI might not be able to differentiate between them as easily.

![](/files/-MfDgK-8NJ6JoLiQOMrj)

### How it works

Using the example of a music school, the VA (Virtual Assistant) is helping interested new students to sign up for a lesson for their preferred instrument.&#x20;

![](/files/-MfDv_mtCb56F_yzcArc)

The VA will ask the user what instrument they’d like to play and the answer will be most likely along the lines of “I’d like to play the flute”, “I want to play the piano”.&#x20;

However, the training set is very similar and there is a possibility that the AI won’t be able to classify correctly.&#x20;

![](/files/-MfDvR8yKM3_i1rVHXDs)

Therefore, we are going to enable the **intent ambiguation feature**, that allows us to clarify with the user if they meant playing the piano or playing the flute.&#x20;

The feature can be turned on and off in the **Classification node** right below the intents. Once enabled, we have to add a new parameter that will prompt the user for clarification.

{% hint style="info" %}
*Due to the ambiguation in the entity values, you will need to choose a **multi-value parameter**.*

*To do that, upon parameter creation, click on the three dots next to the value and select "Set as multi-value".*
{% endhint %}

![](/files/-MfDvVubjFL0w6ClEXSk)

We will add a **Speak node** or **Collect Input node** where we have to add a phrase prior to the parameter that gives our the intent names, such as “Do you want to” and then we add the parameter.

The parameter, in this case, $INSTRUMENT\_TYPE, will give out the names of the intents. The intents in this agent are named "play the flute" and the other "play the piano" - coming together in this **Speak node**'s prompt as "Do you want to play the flute or play the piano?".&#x20;

![](/files/-MfDvKX4FWdsNP9dCWBy)

To enable the user to clarify, we connect the **Speak node** with the prompt back to the **Listen node** to allow the user's input to be classified again.

![](/files/-MfDvmnTpMV9nxkJu2rr)

{% hint style="info" %}
*Currently, the limit of ambiguation is between the closest two competing intents. Even if you have more than two intents with alike training set, it will only re-prompt the two intents that our algorithm defines as closest to the user's query.*&#x20;
{% endhint %}

{% hint style="danger" %}
***For more information on how to prevent intent ambiguity, please click*** [*<mark style="color:purple;">**here**</mark>*](https://studio.docs.ai.vonage.com/intents#intent-ambiguity)***.***
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://studio.docs.ai.vonage.com/voice/nodes/basic/classification/intent-ambiguity.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
