> This page is for version Scripted.
> For other versions, use one of these documentation indexes:
> - Generative (default): https://developers.ada.cx/generative/llms.txt
> - Scripted: https://developers.ada.cx/scripted/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.ada.cx/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.ada.cx/_mcp/server.

# Understand the needs, clarification, and not understood answers

## Confidence\[#UUID-670d3b0b-56c2-2ed0-4b05-581ea91daba0_id_360017969974_id_confidence]

Every time a chatter asks a question, the bot must decide which Answer
to provide. The bot compares the chatter's question to the training
questions across all Answers to find the best match. There are three
possible outcomes:

1. The bot is *confident* that there is a clear winner amongst the
   Answers. The bot will respond by providing that particular Answer.

2. The bot is *not completely confident* that there is a clear winner
   amongst a few possible Answers. The bot will respond with **Needs
   Clarification**.

3. The bot isn’t equipped with an Answer (or Training) related to the
   question asked and *is not confident* that it knows how to respond.
   The bot will respond with **Not Understood**.

## Needs Clarification\[#UUID-670d3b0b-56c2-2ed0-4b05-581ea91daba0_id_360017969974_id_h_01F4D7G1Z31D34SFWQFWHWZQTV]

Every bot has a built-in Answer called Needs Clarification. It is a
locked Answer, meaning it is customizable, but cannot be deleted. The
bot will answer with Needs Clarification when the chatter asks a
confusing question, such as:

* A vague question or statement (e.g. “Help!” or “I have a question”)

* A double-barreled question with more than one intent that the bot is
  trained to answer (e.g. “How do I pay my bill on the website or by
  phone?”)

The most likely Answers are determined automatically and then surfaced
as Clarifications. These Clarifications are presented as buttons titled
with the Answer Label of the corresponding Answer.

> **Note**
>
> If the Answer doesn't have an Answer Label in the Answer Settings, the
> button text is the Answer Title instead.

![](/_fern-files/developers.ada.cx/0928f26d58a981acbdab22f5a7984dc5ee7df2e553884ae4a47d79e3af884306/ada.docs.buildwithfern.com/2025-05-28T19:49:52.708Z/versions/assets/image/uuid-716eb3d1-5661-617e-1b56-89e0de1ab238.gif)

An Answer will not be surfaced as Clarifications if:

* It doesn’t have any Training Questions

* It’s a locked Answer

* It’s toggled ‘OFF’

* The Answer Setting ‘Include in Clarifications and Suggestions’ is
  toggled off

How does the bot decide what do display?

* The bot will determine which 3 Answers are most likely to be correct.

* If any of those Answers meet the exclusion criteria above, they will
  not be shown.

* If there is only 1 Answer remaining, the bot displays it as a singular
  option (i.e. as a Clarification button, not the full Answer content).

* If 0 viable options remain, the bot responds with **Not Understood**.

## Not Understood\[#UUID-670d3b0b-56c2-2ed0-4b05-581ea91daba0_id_360017969974_id_not-understood]

Every bot has a built-in Answer called Not Understood. This Answer is
triggered when the bot isn’t confident that it can respond accurately to
a chatter's question. The Not Understood Answer is a locked Answer. This
means that it is customizable, but cannot be deleted. Not Understood
should ask the chatter to rephrase their question and give them the
option to contact support.

Common examples when the bot is not confident and responds with Not
Understood:

* The chatter sends gibberish to the bot

* The question is out of scope (e.g. "Why is the sky blue?")

* The question is relevant, but the content hasn't been created yet
  (content gap)

* The content exists but the training questions are weak/lacking

| Scenarios that trigger “Not Understood”                                                                                              | Suggested fix                                                                                |
| ------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------- |
| The chatter’s question doesn’t align with any Training in the bot, but there’s an existing Answer that could be triggered.           | Add the chatter’s question as a training question to the appropriate Answer in the bot.      |
| The chatter’s question doesn’t align with any Training in the bot, despite it being something that the bot should be able to Answer. | A new Answer should be created and trained to address this gap in content.                   |
| The chatter has asked something that the bot is not expected to Answer, so there is no content (or Training).                        | No action required - the bot shouldn’t be trained to answer questions that are out of scope. |

For tips on how to train the bot, check out [Train a bot](/scripted/docs/build-and-maintain-your-bot/train-and-manage-answers/train-a-bot).

---

Have any questions? Contact your Ada team, or email us at [](<mailto:help@ada.support%20%E2%80%9CHelp Docs inquiry%E2%80%9D>).