Teneo Developers

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.

TQL conceptual

Data hierarchy

ConceptDescriptionAccess prefix
PropertyThe basic queryable elements in the data: can be located in sessions, transactions, or events-
SessionA collection of transactions documenting a user's interactions with the systems.
TransactionA collection of events starting with a request (user input) and ending with the bot's responset.
EventA record of the entire path through the solution leading to a responsee.

TQL - conceptual relations

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

TQL - Query Syntax Annotate

The result of the query is to list 30 input/output pairs, along with the ID of the session they belong to: TQL - Query result

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:

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.

  1. Open your published solution, navigate to Optimization, and select the tab Log Data. TQL - List LDS

  2. Under Manage Source select the option Open. TQL  - Open LDS

  3. Now you are viewing the LDS and can write your queries or run pre-defined queries, etc. TQL - LDS View

  4. If you want to examine details of a specific session, click the button labeled New Session Viewer Tab.