Add new Trigger
To add one or more new Intent Triggers to a Flow, simply click Add Trigger in the Flow's top ribbon and proceed by defining the Trigger properties as described in the following sections.
Read more about Multiple Flow Triggers
Define Trigger properties
To define the properties of an Intent Trigger, first select the Intent Trigger node in the Flow graph to open the Trigger panel in the right-side of the window.
The Examples section is automatically expanded, while other sections are collapsed until the user clicks to add properties in these sections.
Below sections describes the different options available to define the properties of an Intent Trigger.
In the Trigger section, the user is encouraged to add a Name and a Description to the Intent Trigger.
In the Examples section it is possible to add Positive Examples and/or Negative Examples.
The positive examples are meant to be examples of user inputs which should trigger this particular Intent Trigger, while the negative examples are user inputs which should not trigger this particular Intent Trigger.
- Add positive/negative examples by writing the example in the text field Enter an Example, then either click the green + button or press Enter.
- Edit a positive/negative example by either double clicking the example to edit or selecting the example and clicking the pencil icon, when done editing then press Enter
- Delete a positive/negative example by selecting the example and clicking the red cross in the top of the Examples list
- Filter examples by using the text filter Filter Examples available below the list of positive or negative examples
- Include in Auto-tests this tick box gives the user the option to exclude/include the positive and negative examples of the Intent Trigger when running flow and solution Auto-tests.
When the user has added one or more examples, the Generate button will appear in the Match Requirement section of the Trigger. Pressing the button will have the system generating a draft of the implementation of the Trigger based on the entered positive examples.
Match Requirement types
Match Requirements are added to an Intent Trigger by clicking Add and selecting the wanted Match Requirement Type from the displayed menu.
The available Match Requirements include:
- Class Match Requirement
- Condition Match Requirement
- Entity Match Requirement
- Language Object Match Requirement
- Script Match Requirement
- Context Match Requirement
Further information about the Match Requirements is available in the Match Requirement section.
Data Actions are added to an Intent Trigger by clicking Add and selecting the wanted Data Action type from the displayed menu.
- Entity Data Action
- Language Object Data Action
- Script Data Action
- Listener Data Action
Read more about Data Actions here.
The Triggering section of the Trigger provides the user with an option to set the Ordering Group of the Intent Trigger directly from the Flow without having to open the Intent Trigger Ordering.
In the Advanced Options, the user is presented with the following options:
- Trigger only once per session
- Test sentences from: Last to first / First to last
The above options allow the user to select if the Intent Trigger should only match once per session as, per default, an Intent Trigger is allowed multiple matches per session and if the sentences should be tested Last to first or First to last.
Change sentence test order
To change the test sentence order, follow the below steps:
- Select the Intent Trigger (or Transition) in the Flow graph
- In the right side panel, in the Triggering section, expand the Advanced Options
- Under Test sentences from, select either Last to first (Default) or First to last
- Remember to Save the Flow to save the modifications.
Learn more about the Sentence test order in the Knowledge Base.
Metadata can be assigned to Flows (backstage panel: Flow tab > Metadata) and to Flow nodes, such as Intent Triggers, and Transitions.
To add Metadata to an Intent Trigger (or any other Flow node), simply follow the below steps:
- Click the Add button available in the Metadata section of the Trigger (or other relevant Flow node)
- Select the wanted Metadata definition by clicking the down-arrow; this will display a menu with all the available definitions
- Then, click the down-arrow below to select an appropriate value
- Alternatively, toggle between string value/script value to add a script expression (</> button available next to the value field)
- To assign another metadata definition to the Intent Trigger, repeat the above steps
- Remember to Save the Flow to preserve the changes.
; (semicolon) is not supported in script expressions for composite metadata.
To watch a Metadata in the solution, click the button with an eye next to the definition of the Metadata. This will highlight the Metadata assignation in various places of Teneo Studio, such as the Flow graph and the informative message appearing when hoovering over a Flow in the Solution Explorer.
Read more about Metadata here.