Your first flow

Now that you have created a solution for your bot, it's time to add your first dialog. In Teneo, all dialogs 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.

Throughout these pages, we'll create a bot for Longberry Baristas, a very hip (yet fictitious) coffee bar in New York. We'll 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 a folder in which we can store our flow.
  • Add a new flow.
  • Provide example inputs to recognize the user's intent.
  • Add an answer text.
  • Save and test our flow.

The end result will look like this: End result of your first flow

Before you continue, make sure you are logged in to Studio and have opened the solution you created earlier.

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 smalltalk (e.g. How are you?). By 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 recognises 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.

Populate the trigger

Triggers are used to recognize inputs from the user that express a similar intent. In our case, we will want this flow to trigger when the user says something like 'What coffee do you sell?' or 'Which coffees do you serve?'. In Teneo we do this by adding example inputs to the trigger:

  1. Select the trigger.
  2. Select the 'Learning Examples' button on the right side of your window.
  3. In the pane that appears, enter this example in the 'Enter an Example' field: What kind of coffee do you have?, then hit the 'plus' icon beside it or hit Enter.

Now, you can repeat the step above to add more examples one by one, but you can also paste multiple examples in one go:

  1. Copy the examples below:
    Do you have brewed coffee
    Do you serve macchiato
    Do you have cappuchino
    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
  2. Next, right-click the area below the learning example you added earlier and paste the inputs (alternatively, you can click the tab called 'Positive' and hit Ctrl+V to paste them).
  3. It's good practice to give flow elements a name, so let's give the trigger a name like What kind of coffee do you have?.

That's it, you have added the training data and named your first trigger!

Add an answer text

Next, we'll need to set the bot's answer in the flow. There are many options to define the bot's response. For now, we'll focus on the answer text only.

  1. Click the purple box that is marked Answer 1 (the Output node).
  2. Make sure that the 'Answers' button on the right side of your window is highlighted.
  3. In the text box replace the text Answer 1 with We offer a variety of handcrafted coffee drinks - from espressos to macchiatos to flat whites and more.
  4. Give the output a name (the name field for flow elements is located at the bottom of the screen), e.g.: We offer a variety of handcrafted coffee drinks...

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 short-cut 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.

Done! Congratulations! You have created your first 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 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.

Where to go next?

You have just created your first flow, so you have already seen a few important concepts in Teneo:

  • Flows: which contain the logic to resolve a specific question of the user.
  • Folders: where you can store your flows,
  • Triggers: to recognize the users input or intent,
  • Outputs: to provide the bot's response, and
  • Try out: which you use to test your flows.

Let's now create another flow that introduces some other concepts. Let's create an interactive flow.

Was this page helpful?