NLU Management

How to manage your Assistant's NLU data.

NLU Data Import & Export

How to import data from your NLU provider, and export back out

Importing NLU Models (Intents, Entities and Utterances)

To kick-start your design process, and maintain consistency between your projects and your production Assistant, you can import your Intent, Entity and Utterance data directly from your NLU.

As part of the project creation flow and in the NLU Manager, you can import the export files generated from the supported NLUs:

  • Amazon Lex V1 (.json in a .zip)
  • Dialogflow ES (.json in a .zip)
  • IBM Watson (.json)
  • Microsoft LUIS (.json in a .zip)
  • Rasa (.yaml in a .zip)
  • Salesforce Einstein (.csv)
  • Amazon Lex (.json in a .zip)
  • Nuance Mix (.xml)
Tip: We also support a generalized format - Voiceflow (.csv) - if you want to map your data and import it from another provider, or to import un-categorized training data.

Import on Project Creation

When you create a new project, you will have the option to seed your project with your NLU data by selecting an import.

After you have selected the Channel and NLU you are working with, you will see a link appear to upload your data. Select your NLU's file export, and it will import the Intents, Entities and Utterances contained within it.

Once the model import is complete, you will notice a toast notification/confirmation of the status of the import, such as the number of intents imported. You will also notice the section under the NLU selection box update with this data, and additional information such as number of entities imported.

Tip: Once project creation is completed & you are taken to the Canvas, navigate to the NLU Manager (shortcut M). You can verify and check that the NLU Model data imported successfully/correctly (ie. Intents, Utterances and/or Entities)

More information on this process can be found under NLU Selection in the Project Creation docs found here.

Import in the NLU Manager

In your Assistant project's NLU Manager, you will have the ability to upload NLU data directly from the export files of your NLU provider, or from a generic CSV. Any data that you import here will be merged into your existing model's data -- Intents that exist in your model will have their Utterances updated, and any new Intents or Entities contained in your import will be added to your existing data.

NLU Data - Exports

To export your project's data in supported NLP/NLU formats, ensure you are on a Chat Assistant or Voice Assistant project and navigate to the Share button on your project/canvas top bar.

Then navigate to Export As and toggle the NLU Data option and select the export that best fits your use case.

Voiceflow NLU (CSV)

With a Voiceflow NLU (Voiceflow CSV) export, you will receive your project's intent and utterance data in a generic CSV format. 

Tip: You have the opportunity to import specific intents or the entire model with the Configuration section.

With the Voiceflow CSV export file, there are two columns: Intent Name (including built-in intents and associated custom utterances) and Utterances (categorized in the intent). Any entities used within utterances are indicated as curly braces '{', just as they would be on the Voiceflow Creator Tool.

You can use this data to unlock and allow you to get your Voiceflow NLU data in a simply formatted way for handoff to team members, or to convert it into the desired format required to import it to your NLU or another 3rd party tool.

Amazon Lex V1

Exporting project content into the Amazon Lex V1 format provides a master (.zip) file with each one of your project's intents nested in the .zip file, with each intent as its own unique (.zip) file.

You are then able to import your intents into the Amazon Lex console, under the Intents menu. You can individually import the intent files (.zip) into the Amazon Lex console and all the associated utterance data. You can also upload slot types and slot values under the Slot types menu in the Amazon Lex console.

Note: The import process with Amazon Lex only works with the V1 Console, as this is a V1 Export. Ensure you do NOT 'Switch to the new Lex V2 console' option found on the sidebar.

IBM Watson

With IBM Watson NLU/NLP exports, you receive a .json file export which contains your project's defined intent data.

In the Watson Assistant Dashboard, you will navigate to the Skills tab and Create skill or navigate to an already created skill. You can then navigate to the menu associated with the skill by clicking the three-dots () and select Upload.

This is where you can upload the IBM Watson export (.json) from Voiceflow directly here and overwrite your full skill. This will populate your skill on IBM Watson and directly upload your Voiceflow project's intent and entity data.

Note: You'll need to make sure your Watson Assistant instance is switched to the “Classic Experience” in the account menu. Ensure that the version of the Watson Assistant being used is NOT set to the “new experience”.

Salesforce Einstein

With a Salesforce Einstein export from Voiceflow, you will receive a (.csv) export of your project's model. This will usually be a four-column export with the Intents, Utterances and language(s) contained within your project.

Within Salesforce, log into Data Loader to follow the steps to import the (.csv) Voiceflow export and map the columns to the data types within Salesforce Einstein. This should be a straightforward process as the export will line up (one-to-one) and intents should map without issues. Please note that there is no import option for entities in Salesforce Einstein.

More information on the Salesforce Einstein import process is found here.

Nuance Mix

With Voiceflow's export for Nuance Mix, you will download a (.trsx.xml) copy of all your projects NLU model data. This file will include all intent, utterance, entity and entity value data.

In your Nuance Mix Dashboard, select a project you'd like to upload the data to, and then open the Import/Export tab on the right. Select the ".trsx, .xml, .zip" import option, and select your export in the file selector. This will overwrite all data on your project.

More information on the Nuance Mix import process can be found here.

Other docs in this section