Natural Language: How to Set Up and Use the Natural Language Skill

The Natural Language Skill enables users to build custom natural language understanding models to predict the overall intention of an incoming utterance and extract important information from it.

You will use the Natural Language Skill to build and train a custom natural language understanding model, based on your specific domain and your expected users' utterances. Integrating this with your Tenjin Assistant to process and analyze incoming text in real-time, identifying the intention of the text, and extracting important information from it. Your Tenjin Assistant will perform the desired action based on the intention and extracted information.

Intent Training is where you define all the intents you wish to support and where you can enter phrases/utterances to classify into the intents.

Entities are structured bits of data that can be extracted from what the user types. A list of pre-defined entities is available for selection when pressing the add button within this tab. For example, the Geography entity will look for names of places.

Intent Testing is the bulk testing area. Where tests are carried out over the data to see if the intent listed is the answer returned.The save button within Intent Testing, will save any changes, train the model and re-run the tests.

Test Results, will show a graph of all test runs and show any misalignments where the test utterance did not align with the expected results. Clicking on any highlighted misaligned results will display the detail of that utterance, the expected result, and the actual result. You can then go back to your training data making changes to how your model has been trained to fix any misalignments.

Real usage, allows you to see how and where you can improve your natural language utterances and intents. You can look at how it's being used within your assistant, take that data and feed it into the training and testing data set. You have the option to export the last X number of days' worth (selected from the drop-down Time range button) of your assistant's data usage enabling you to view your utterances and how they have been mapped to the different intents. You also have the functionality to bulk-add this 'real-world' data back into your Intent Testing tab to further train your natural language skill. The bulk-added utterances will be automatically mapped into the intents.

This article covers the following topics:

• How to add the Natural Language Skill
• How to delete the Natural Language Skill
• How to import and export
• How to change the confidence threshold level
• How to add an Intent
• How to edit an Intent
• How to delete Intents

Adding the Natural Language Skill

1. Click the ellipsis (three dots) button, top right of your screen followed by Add Skill.
2. Click Add Natural Language Skill from the list of skills displayed.
3. Enter the details required. Click OK to save.
4. Detailed inline Help is available.

How to Delete your Natural Language Skill

1. Click the ellipsis (three dots) button, top right of your screen followed by Delete.
2. You will be asked to confirm or cancel your choice. Click OK to confirm.

How to Import and Export

1. Click the ellipsis (three dots) button, top right of your screen followed by Import/Export.
2. Note the warning of overriding your existing data.
3. You will be asked to confirm or cancel your choice. Click OK to confirm.

How to Change the Confidence Level Threshold

1. Click the ellipsis (three dots) button, top right of your screen followed by Settings.
2. Note the warning on the screen.
3. You will be asked to confirm or cancel your choice. Click OK to confirm.

How to Add an Intent

1. Click the +Add button on the far right of your screen
2. Select a Project Flow from the drop-down list you wish this intent to be actioned from.
3. Enter your utterances (what the user will type), pressing return to get a new line. e.g if you have selected the weather flow you could type the following utterances:
   
4. Click OK to save

How to Edit an Intent

1. Click the edit button found at the bottom right of the Intent square.
2. Make the necessary changes.
3. You will be asked to confirm or cancel your change. Click OK to confirm.

How to Delete an Intent