Voiceflow allows you to export the NLU data that you have designed on your Assistant project directly to Dialogflow CX to speed up the hand-off of production-ready data to your NLU provider.
Data Included in Exports
Here is a quick overview of the data that will be imported Dialogflow CX from your Voiceflow Assistant project:
- Entities (including names, values and synonyms)
- Training Phrases (including all entity annotations)
Exporting Data from Dialogflow CX
You can export your data directly from the Dialogflow CX Console, ready for use inside Voiceflow. On your console, open your list of Agents. Open the three-dot menu to the right of your Agent’s name, and select ‘Export’. Choose the data format ‘JSON Package’, and export agent to ‘Download’, and export your agent.
Importing Data into Voiceflow
Once you have the ZIP file contain your Dialogflow CX Agent's NLU data, you can import this data into Voiceflow, in two ways:
On Project Creation
When creating a new project in Voiceflow, you will be asked to select your use case (Launch & Host or Design & Handoff), choose Design & Handoff. The select the channel you are building for (Voice Assistant or Chat Assistant) and the NLU you are building for.
Once you select Dialogflow CX from the options, an upload link will appear, and when you click it, you can select the CSV file you have created.
This will pre-populate your project with the complete training data set contained in your file.
In your NLU Manager
There is a similar import function available in your NLU Manager view, and clicking the ‘Import’ button found in the bottom-left will trigger the same import flow as on Project Create.
Using this import method will upload all new intents, entities and user examples without deleting the current ones. Any intents or entities with the same name will be overwritten by the newer version.
Connecting an Assistant Project to Dialogflow CX Agent
The first step is to create new project, with the NLU set to Dialogflow CX. Once in the project, you will find an Upload button in the top-right corner of the Design Canvas header.
Clicking this will be the primary way to upload your NLU Data to DF CX, each time you wish to upload.
The first time you click on this, it will prompt you to authenticate your Google Account. Sign into your desired account and accept the permissions.
You will then be prompted to connect an agent. To do this, you will need to go to the Dialogflow CX Console, select the Project and the Agent you wish to link to your project. Once you're on the 'Build' tab for that agent, you will need to copy the URL. It should looks something like:
You can then paste this URL into the 'Connect an Agent' modal in your Voiceflow project:
You can then select 'Continue' to initiate your upload.
Uploading New NLU Data Versions to CX
After your initial upload, every time you click the upload button on your project, you will be prompted to provide a version name for your upload:
This will allow you to distinguish between your uploaded version on the Project Versions page.
Selecting Intents for Upload
By default, you will be uploading all the Intents on your project to your CX Agent. If you wish to upload only specific Intents each time, you can select the 'Settings' icon on the 'Upload to Dialogflow CX' modal.
In this menu, you can select specific intents you wish to upload from the dropdown. The selected intents will persist for the next upload, unless you change them.
Additionally, in this menu, you can change the CX Agent that is linked to your Voiceflow project by adding a different Agent's URL here.