Teneo Developers

Trigger Ordering window

Open the Trigger Ordering

The Trigger Ordering window is accessed from the top ribbon of the main Teneo Studio window by selecting Intent Triggers or Prompt Triggers in the Ordering area.

Trigger Ordering buttons

The Prompt Triggers button opens the Prompt Triggers Ordering window; although not explicitly mentioned here, all functionalities also applies to Prompt Triggers, with the exception of the features concerning Suggest Ordering.

Intent Trigger Ordering window

Intent Trigger Ordering window

Tabs

The Intent Trigger Ordering window contains three different tabs:

  • Ordering: provides options to view and restore former versions of the ordering
  • Home: provides options to manage relations
  • Groups allows to manage the Order groups.

Top ribbon

The Home and the Groups tabs divide the management options into different areas, and the two tabs share the following management areas in the top ribbon:

  • Ordering
    • Close: closes the Intent Trigger Ordering window
    • Save: saves changes to the Intent Trigger Ordering
  • Edit
    • Undo: to undo actions performed in the ordering
    • Redo: to redo actions performed in the ordering
  • View
    • Zoom To Fit: fits all Intent Trigger Ordering groups and Intent Triggers in the window
    • Show all: this selection displays both enabled and disabled Intent Triggers
    • Hide disabled: this selection removes disabled Intent Triggers from the view
    • Expand All: expands all order groups
    • Collapse All: collapses all order groups
    • Top to Bottom: displays all related Intent Triggers in islands arranged vertically
    • Left to Right: displays all related Intent Triggers in islands arranged horizontally.

To learn more about the specific options available in the top ribbon and tabs please follow the links: Order Relations, Suggest ordering and Order groups.

Stable Version

The Home tab also includes the Stable Version area in the far right side of the top ribbon, here the user is able to set the current version of the Ordering as stable. To set a previous version of the Ordering as stable version, please see the History section further below.

Note that for a stable solution to work correctly it is mandatory to set a version of the Intent Trigger Ordering and Prompt Trigger Ordering as stable.

Read more about Version Flags.

Panels

The following panels are available in the Intent Trigger Ordering window:

  • Filter (left side)
  • Notifications (left side)
  • Properties (right side)

The panels are all described in the following sections.

Filter panel

Filters can be a great help when ordering the Intent Triggers. There are some very advanced options that can be used to zoom in on exactly those Intent Triggers that the user is interested in.

In the Intent Triggers ordering window, an advanced filter function is available in a tab in the left-side of the window, allowing the user to find, view and work with specific Flow Triggers, especially useful in solutions with numerous Triggers.

There are several ways of filtering the Flow Triggers and the different options, which are explained in more details below, among others include a Search function where the user can search for part of a TLML Syntax, the description as well as positive and negative examples of User Intent.

Filter and Search options

It is possible to add several filters at the same time and the user is also able to enable/disable one or more filters by clicking the enable/disable buttons next to the filter and thereby make the filtering of the Syntax Intent Triggers as precise as possible.

Text filter

A text filter returns Intent Triggers with Flow name or Trigger name containing the word(s) typed in.

Engine match Example

This filter allows to type in a text which is used to match against all triggers; it is like providing a User Intent and checking which triggers it would potentially match.

Engine match TLML Syntax

This filters allows to enter a TLML Syntax condition that will be used to match all positive examples of User Intent against. So, if for example the user only wants to look at the "luggage" knowledge area of the solution, then the user could enter a syntax like %LUGGAGE.NN.SYN to filter on all the User Intents (and the triggers they belong to) that contain the word "luggage" (or a synonym).

The Search filter allows to search for specific strings in:

  • TLML Syntax
  • Description (of the triggers)
  • Positive Intents
  • Negative Intents
Flow filter

The Flow filter allows to filter on the Intent Triggers of a specific Flow.

Folder filter

The Folder filter gives the option to select a Flow folder, and filters on all Intent Triggers contained by the Flows in that folder.

Combine various filters

Using the ALL/ANY option below the Filter, it is possible to configure how the filters should work together to return the wanted set of Triggers; where selecting Any allows to filter on triggers which match any of the specified filters while All filters triggers which match all the defined filters.

The Depth

The Depth refers to seeing only the Trigger that has been filtered or some/all Triggers within the same island (an Island is a relation of Triggers within the same Order group). The default setting for the depth is 1, which means that only the filtered Trigger will be shown by default, by increasing the number the user can see 2 or more Triggers from the same island.

Notifications panel

Notifications can be displayed in the Notifications panel when using the Suggest Ordering feature or for notifications from collaborators.

Properties panel

The Properties panel, available in the right side of the Intent Triggers Ordering window, displays information related to the selected Intent Trigger(s), such as for example Matches, After Matches (if available), location of a selected Intent Trigger, positive and negative examples of User Intent, etc.

Properties panel

It is possible to open Flows and Intent Triggers, or even Language Objects and Entities, by double-clicking the documents' names.

If no Intent Trigger is selected, the Properties panel will display information related to the Ordering, such as number of Order groups, relations and Intent Triggers.

Properties Order summary

Protect relations

If a relation is selected, in the Properties panel, it is possible to see information related to the two Intent Triggers. Additionally, the user can Protect or Un-protect the relation between the two Intent Triggers by clicking the drop down menu Protected/Un-Protected.

Protect relation

History

In the Ordering tab, available in the left-side top of the Intent Trigger Ordering window, the user can navigate to the backstage of the ordering window. Here the user will find an overview of the History of the saved versions of the ordering, by clicking any of the version numbers (in red), the user is able to see that specific version.

Set stable

Selecting a specific revision of the Ordering, the user is able to set the selected version as the stable version by clicking Set Stable in the top of the list.

Restore

When an older version of the ordering is opened, the user has the option to Restore that particular version of the ordering with the Restore button available in the top ribbon of the older ordering version.