This feature is currently in a limited preview. If you would like access, please contact us.
The partial import feature is a powerful tool that allows you to import an assistant file into an existing assistant while giving you control over which parts of the file you want to import or disregard. With this feature, you can selectively import intents, entities, topics, and components, making it easier to manage and update your conversational assistant. Here's a step-by-step guide on how to use this new feature:
Step 1: Prepare your assistant files
Before you can use the partial import feature, make sure you have the assistant files (JSON/.vf file) ready for import. This can be downloaded directly from the canvas following the instructions here.
Step 2: Access the partial import feature
To access the partial import feature, navigate to the assistant you wish to import assistant data to and select Import from the assistant dropdown menu.
Step 3: Select the merge or current options
Once you have the import modal open, you'll be prompted to select which resources of the assistant file you want to import or disregard. The available options generally include intents, entities, topics, and components. You can choose to import all of them, select specific ones to import, or choose to disregard all or some.
There is the option to review the changes between the current assistant and the imported assistant by selecting the name of the resource. This will give you a diff view showing added, updated or deleted properties in the resource objects. Please note:
- only resources that have been updated will be reflected in the modal. This means that if the resource is the exact same, it will not be reflected in the modal,
- the Current checkbox doesn’t exist for resources that don’t already exist on the assistant,
- if the Current checkbox exists, it means you will overwrite the current assistant when Imported is selected.
Step 4: Confirm the import
Before proceeding with the import, review your selections and ensure they align with your intentions. Check that the import options and import/disregard selections are accurate. If everything looks good, confirm the import to proceed.
Step 5: Complete the import
Once you are happy with the selections, click on the Import button within the modal. At this point, the selected parts of the imported file will be merged into the existing assistant file, and the changes will take effect. Verify the changes to ensure that the import was successful and that your assistant functions as expected.
Step 6: Keep track of the versioning
After confirming the import, it's essential to be aware that a version of your assistant will be automatically generated. This version will contain the state of the existing assistant before the import took place. This version can be found in the version's table as shown below, including an automatically generated version name specifying that this version was generated via the import feature and the assistant file that was imported.
Congratulations! You have successfully used the partial import feature to import selected parts of an assistant file into an existing file. This feature allows you to easily manage and update your conversational assistant by selectively importing intents, entities, topics, and components. Make sure to save your changes and continue refining your assistant as needed.