Automation V3: Intent Validator
This API validates whether a given utterance accurately expresses a specified intent. It provides a consistent way to test Natural Language Understanding behavior and confirm intent recognition.
Inputs
- Intent (Text, Mandatory)
The intent that the utterance will be evaluated against. - Utterance (Text, Mandatory)
The user input or example phrase to validate.
Output
The API returns a single result value indicating whether the utterance matches the intent:
- true
The utterance clearly expresses the intent. - false
The utterance clearly does not express the intent. - unknown
The relationship between the utterance and the intent is:- Unclear or ambiguous
- Lacking sufficient context
- Inappropriate, nonsensical, irrelevant, or out of scope
Important:
- The response will be only one of these values: true, false, or unknown.
- No explanations or justifications should be included in the response.
Examples
| Intent | Utterance | Output |
| book flight | I need to book a flight to Mumbai tonight. | true |
| cancel reservation | Can I make a new reservation for next week? | false |
| track order | Where is my package? I ordered it yesterday. | true |
| make payment | Should I bring cash or card? | unknown |
| reset password | You’re so stupid, fix my life! | unknown |
| find nearby restaurants | Aliens are watching me through the microwave. | unknown |
| get weather update | What’s the best way to cook pasta? | unknown |
Result Handling
- The result value is saved into the Result Name attribute of the TestAPI.
- This allows further automated processing or assertions in the test workflow.