Teneo Developers

Generate bulk import files with Discovery

Export concepts, associations and categories

Teneo Discovery offers the option to export selected concepts, associations or categories in the csv format needed to perform Bulk Import in Teneo Studio.

To export selected concepts, associations or categories, follow the below steps:

  • Right-click in the selection of concepts or associations (multi-select by pressing Ctrl while clicking with the mouse), or right-click in the category folder to export to view the context menu, and then select Studio Bulk import format

Select Studio Bulk import format

  • Select which categories and/or subcategories to export

Select categories and subcategories

  • Choose if the concepts, associations and categories should be exported as Language Objects, Entities or Q&A Flows (with Syntax Match Requirements or Class Match Requirements, learn more about Match Requirements)

Select export type

  • If relevant, add a Project prefix, which will be added to all imported items in Teneo Studio

  • Finally, browse to the location where to store the file and click Export.

For information on how to import the file in Teneo Studio, please see here.

Language Object generation

The following fields and values are exported from Teneo Discovery when generating the Language Object Bulk Import format.

Language object nameLanguage object descriptionLanguage object conditionRelative folder path
Name of Concept / Association with the additional suffix:.LEX (for concept with word form=1).LIST (for items with LIST in their name).SYN (for items with SYN in their name).REC (for all other items) Concepts with one of the above suffixes added to their name will keep this suffix in the export, even if the rule doesn’t apply.Note (optional)Word forms (concepts) / Concepts (Associations). Multiple word forms are combined with the followed by operator (+)Discovery \ Language object[Type]

Please note that if the above suffixes (.LEX, .LIST, etc.) are not added to the concept names in Discovery, it is recommended to add them in the csv file to follow current naming conventions.

Entity generation

Concepts residing within the same category folder can be exported as one entity and the name of the category will become the name of the entity in Teneo Studio.

When creating Entities with Teneo Discovery, the following fields and values are exported:

Entity nameRelative folder pathString variable nameEntry
Name of the category folderDiscovery / EntitiesName of the category folderEntry value and value of string variable:Entry values comes from the inputsString variable value comes from the concept name

Information used in Discovery to generate Entities

Q and A pair generation

When exporting categories as Question and Answer (Q&A) pairs, the overlaying category structure will be imported as folders into Teneo Studio.

Categories are converted into folders in Teneo Studio

There are two different options available to export Q&A Flows:

  • Q&A Flows with Syntax Match Requirements, or
  • Q&A Flows with Class Match Requirements.

Q and A Flows with Class Match Requirements

When selecting the option Q&A Flows with Syntax Match Requirements, it is possible to specify if the content of a category should become separate Flows in a folder with the same name as the category, or if all items in a category should become Intent Triggers in one Flow with the same name as the category.

To do so, simply select the categories which should create only one flow with various Intent Triggers under Please select the categories that should be treated as flows.

Deselected categories will create separate Flows with each one Intent Trigger.

Categories Contact and Destinations will be treated as one flow per category

Export only elements with notes

When notes are added to concepts or associations in Teneo Discovery, these will be exported as the answer text for Output nodes in Teneo Studio.

When grouping together several concepts/associations which have notes into one flow, the notes will create additional answers.

Q and A Flows with Class Match Requirements

When selecting the option Q & A Flows with Class Match Requirements, the file - on import to Teneo Studio - generates Flows with Class Match Requirements as well as the Classes.

Note that the inputs in the categories are used both as positive examples of the Intent Trigger, but also as training data for the Class.

Categories' names are used as Flow names

Create one trigger per element

Create one trigger per element

The Create one trigger per element checkbox allows users to choose whether they want to:

  • Create one Q&A Flow per category with one Intent Trigger containing a Class Match Requirement (leave checkbox empty), or
  • Create one Q&A Flow per category with one Intent Trigger per concept / association in the category folder (check the box).

The following fields and values are exported for Q&A pairs:

Flow and Class namesTrigger namePositive examplesSyntax conditionAnswer textRelative folder path
Name of concept / associationName of concept / associationSyntax MR: The top 15 most frequent inputsClass MR: All not duplicated inputsName of concept/association separated with the different match operator (&^) for Syntax MR.Note for Syntax MR (Items without note or exported as class triggers gets the standard answer text)Discovery \ QandAs (if associations belong to a category structure, this will instead be used as relative folder path).

For more information on how to work with Discovery, please see the Discovery section.