Dialogflow
note
The Dialogflow integrations requires the usage of the hf
command line tool. See how to install it here.
info
HumanFirst supports importing Dialogflow ES agents into a workspace, but Dialogflow CX isn’t supported at the moment (see a comparison of the editions here). If you are interested in Dialogflow CX support, come give us a shout on our Slack community.
#
Intents#
Importing a Dialogflow agentIn Dialogflow ES, go to the
Export and Import
section of your agent’s settings, then export your agent to a zip file.Unzip the downloaded file.
Open a terminal to the directory in which the agent was unzipped. This directory should contain a file named
agent.json
.Import the agent in a workspace by running:
hf dialogflow import --workspace [workspace id] --clear
Example:
- You may now open the workspace in your browser.
Note: HumanFirst doesn't support entities yet. Importing a Dialogflow agent with entities should work, but exporting them back may not be fully supported. Support for them in the HumanFirst Studio user interface is on the roadmap, so stay tuned !
#
Exporting a Workspacetip
You can track changes that have been done in HumanFirst by initializing a git repository in the directory of your unzipped agent and then committing the initial files originating from Dialogflow. By doing this, you will be able to easily compare the changes by using git diff
.
Open a terminal to the directory in which an exported Dialogflow agent has been unzipped. This directory should contain a file named
agent.json
.Export a HumanFirst workspace into the directory by running:
hf dialogflow export --workspace [workspace id]
Example:
- Zip the agent directory:
zip -r agent.zip .
- In Dialogflow ES, go to the
Export and Import
section of your agent’s settings, click onImport from zip
, select the just-createdagent.zip
file and click on import.
#
Advanced usage- It is possible to mimic the follow-up intents hierarchy when importing the agent into HumanFirst. This will allow you to see the follow-up structure. Since HumanFirst doesn’t support follow-up intents yet, keep in mind that the follow-up structure may not be accurate when importing it back into Dialogflow. Use the
--followup-hierarchy
option at both the import and export to enable this option.