Teneo Query Language
Teneo Query Language (TQL) allows you to analyze the conversational logs generated by your published bot. You can think of it as a tool similar to SQL in that it helps you to examine, analyze, and understand huge amounts of data. TQL offers a versatile syntax to extract information about how users interacted with your system.
With our own TQL, developers can:
- See what users are saying to your bot;
- Troubleshoot and improve conversations;
- Generate important KPIs such as amount of traffic, Safetynet occurrences, etc.;
- Locate particular constellations of events, e.g. a variable changing while a particular flow was active;
- And more!
This diagram illustrates how Teneo, a dashboard, or any other client application interacts with a Log Data Source contained in the Inquire backend.
Data hierarchy
| Concept | Description | Access prefix |
|---|---|---|
| Property | The basic queryable elements in the data: can be located in sessions, transactions, or events | - |
| Session | A collection of transactions documenting a user's interactions with the system | s. |
| Transaction | A collection of events starting with a request (user input) and ending with the bot's response | t. |
| Event | A record of the entire path through the solution leading to a response | e. |
Query syntax
The Teneo Query Language, TQL, provides a versatile set of possibilities for exploring your data. At first glance, a typical query might appear overwhelming, because of the special syntax and the amount of notation used. However, once you know how to read a query, it will start to become second nature.
Let's take a commonly used query as a starting point and break it down into its individual parts:
la s.id, t.e.userInput, t.e2.answerText: t.e.userInput != "" limit 30
The result of the query is to list 30 input/output pairs, along with the ID of the session they belong to:
Please visit the pages under Query Syntax to discover more detailed information about the various parts of this query, as well as additional possibilities in formulating your own queries.
How to's
In the How to pages we show you various useful kinds of queries that you can run using TQL. These are the kinds of queries that nearly every project will need at some point or another. The use cases we cover include how to:
- Locate and view a session
- Troubleshoot the Safetynet
- Query variables
- Explore session statistics
- Use relative dates in queries
- Find stuck flows
- Make use of sub queries
- Make use of skip constraints
Navigate to the Log Data Source and write your query
Here are some quick steps to guide you to the Log Data Source where you can write your queries. We also show this in one of our videos under analyze log data.
-
Open your published solution, navigate to Optimization, and select the tab Log Data.
-
Under Manage Source select the option Open.
-
Now you are viewing the LDS and can write your queries or run pre-defined queries, etc.
-
If you want to examine details of a specific session, click the button labeled New Session Viewer Tab.