Add a new LUIS Intent

Now that you have created a solution for your bot, it's time to add your first dialogue. In Teneo, all dialogues are designed as flows. Flows contain the logic needed to resolve a specific question of the user. They can be simple (e.g. a flow that answers the question "What kind of coffee do you have?") or complex (for example, a flow that helps the user order a coffee beverage), but they always represent some kind of pre-defined conversational pattern.

One of the biggest advantages of LUIS^Teneo is the use of its classifier. This page will describe how to use an intent created and trained in LUIS on Teneo.

Throughout these pages, we will create a bot for Longberry Baristas, a very hip (yet fictitious) coffee bar in New York. We will start with a simple flow to handle the following conversation:

User: What kind of coffee do you have?
Bot: We offer a variety of handcrafted coffee drinks - from espressos to macchiatos to flat whites and more.

To achieve this we will do the following:

  • Create an intent in LUIS.
  • Create a class in Teneo.
  • Create a folder in which we can store our flow.
  • Create a new Teneo flow.
  • Add an answer text.
  • Save and test our flow.

The result will look like this:
Final_form_of_flow

Create a new LUIS intent

We will start off by creating a LUIS intent inside our application which will be used by our Teneo solution.

You will need to do the following:

  1. While inside your LUIS application, create a new intent by pressing 'create'.
  2. Give your intent the name: TELL_ME_ABOUT_YOUR_COFFEE.
  3. Add the following examples:
    • Do you have brewed coffee
    • Do you serve macchiato
    • Do you have cappuccino
    • Tell me about the coffees you have
    • Tell me about your coffee
    • What coffee do you serve?
    • What kinds of coffees do you serve?
    • What kinds of drinks do you sell
    • Which coffees are offered by Longberry Baristas?
    • Which drinks do you have?
    • Which sorts of coffees do you have
  4. Press the 'Train' button located at the top right corner. This will train the intent and score the examples.
  5. Once the training is done press 'Publish' at the top right corner. This so Teneo can retrieve it.

Create the same intent in Teneo

Now it's time to create the same intent as we did for LUIS in the previous step but inside Teneo.

  1. We'll start of by selecting the 'Class Manager' icon in the 'Solution' group in the Ribbon. This will open a new window for the 'Class Manager'.
  2. Select the 'Add Class' button located in the 'Classes' group in the Ribbon.
  3. Give your class the same name as your LUIS intent: TELL_ME_ABOUT_YOUR_COFFEE.
  4. Next, right-click the empty area in the learning example area and paste the inputs (alternatively, you can add them one by one)..
    Do you have brewed coffee
    Do you serve macchiato
    Do you have cappuccino
    Tell me about the coffees you have
    Tell me about your coffee
    What coffee do you serve?
    What kinds of coffees do you serve?
    What kinds of drinks do you sell
    Which coffees are offered by Longberry Baristas?
    Which drinks do you have?
    Which sorts of coffees do you have
  5. Finally press the 'Save' button and close the 'Class Manager' page.

Create a 'Flows' folder

Flows are stored in folders. In the 'Explore' section on the left, you see a number of folders with flows that came out of the box. These flows make sure your bot will understand and respond to greetings, meta-requests (e.g. Can you repeat that?), feedback (e.g. You are great), and conversational small talk (e.g. How are you?). In that way, since you are the owner of this solution, you can change the answers in these flows if you wish.

We will want to store our flows in a separate folder, so let's create that first.

  1. Make sure none of the folders on the left are selected, by clicking in the white area below the folders in the 'Explore' section.
  2. Click the 'Folder' icon in the 'New' group in the Ribbon.
  3. Give your folder a name, for example Flows and hit Enter.

You can add as many folders and subfolders as you like and you can structure them any way you like. This is particularly handy for bots that handle multiple domains.

Create your first flow

Now that we have a folder in which we can store our work, we can create our first flow:

  1. Select the folder where you want to store your flow.
  2. Click the 'Flow' button in the 'New' group in the Ribbon. A new window will open, the flow window.
  3. Enter the name of the flow in the Name field, e.g. User asks about coffees we offer.
  4. Click on the left pointing arrow in the top left corner of the window. This takes you to the flow editor.

As you can see, flows are represented graphically in Teneo. Simple flows just contain a trigger that recognizes the user's intent (the blue box at the top) and an output that contains the bot's answer (the purple box at the bottom). More complex flows contain more elements like multiple triggers, scripts, different outputs etc. We're going to start with a simple flow, so you will only need to populate the trigger and the output that you see in the flow graph.

Create a Teneo flow

Now it's time to create a flow in Teneo where we can use our previous created LUIS intent. To do that we'll need to do the following:

Naming the trigger

  1. Select the trigger.
  2. It's good practice to give flow elements a name, so let's give the trigger a name like Tell me about your coffee.

Adding a Class Match Requirement

It's time to create your own match requirement for Classes and paste in the LUIS intent you created from the previous step.

  1. Select the trigger, this will open up the trigger configuration panel to the right.
  2. Scroll down to 'Match Requirements' and press add.
  3. Select 'Class' and paste TELL_ME_ABOUT_YOUR_COFFEE.

Adding an Answer Text

Next, we'll need to set the bot's answer in the flow.

  1. Select the purple box that is marked Output (the output node) and the output configuration panel will open to the right.
  2. Give the output a name like: We offer a variety of handcrafted coffee drinks...
  3. In the text box replace the text Output with We offer a variety of handcrafted coffee drinks - from espressos to macchiatos to flat whites and more.

Save your flow

Now that we have added everything needed to our first flow, it's time to save it:

  1. Click 'Save' in the top left or use the shortcut Ctrl+S.
  2. In the popup that appears you can leave a short description that will appear in the flow's version history, then click OK.

Adding a description will help you remember the changes you did and will show up in the Flow's version history.

Done! Congratulations! You have created your first LUIS^Teneo flow!

Test your flow

Now it's time to test your work inside Teneo Studio.

  1. Minimize or close the flow you just created.
  2. If the 'Try Out' panel is not visible, make it appear by clicking the 'Try Out' button on the right side of the window.
  3. Because you have just saved your flow with new training examples, Teneo needs to analyze the example inputs to learn from them. While that is happening a notification 'Model training started' is shown. Once the notification says, 'Model training completed', you can test if your newly added flow works. In this case, you can test your flow by asking the following examples:
    • What kind of coffee do you have?
    • Which drinks do you serve?

As you can see, both inputs will trigger your flow. Teneo not only recognizes the exact learning examples you entered but also different variations that express a similar intent.

What's next?

Now that we have created our first flow, let's continue with, Transitions.

Was this page helpful?