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 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 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 (Conflicting Changes).

Conflicting Changes

Teneo Studio supports multiple developers working with the Intent Trigger Ordering at the same time; it is though recommended to work in different order groups to avoid conflicts.

When the Intent Trigger Ordering window is opened, it loads a local copy of the current Intent Trigger Ordering from the Teneo backend server and work on the (local) copy does not affect anything on the server until the developer saves the changes.

When multiple developers work on the ordering at the same time, notifications may arise when another developer saves changes which affect the work of the current developer. If there are conflicts between what was recently saved to the server and what the current developer is doing, the changes must be accepted before the current developer can save the local copy to the server. This may imply that the developer has to undo some of the changes performed earlier.

Teneo Studio informs the developer through the Notifications panel and pop-up messages when overlaps or conflicts in changes occur. And the developer is able to either accept the changes performed by another developer or alternatively contact the other developer(s) to resolve the conflicts together.

Before the notification come in, an alert will be displayed and when clicking OK, receipt of the message is confirmed and the message is displayed in the Notifications panel.

Harmless changes, such as the addition of a new trigger, are pushed through on the view of ordering automat

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 User Intents, 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.