Skip to content

Packages

Version badge

Introduction

Packages allow you to export and import individual resources like Flows or Lexicons in order to share those assets with other teams. Packages automatically contain their direct dependencies and can be shared as a portable zip archive once downloaded.

You either can create a package for a single resource, or multiple resources.

Resources are for example Flows, Endpoints, Intents, Lexicons, Playbooks, Connections, NLU Connectors,…

What resources can be Exported in a Package?

The following agent resources can be included in a package:

Creating Packages with a single Resource

To create a Package from a single resource, navigate to a resource list, e.g. "Flows", click the "secondary menu button" at the right side of the item, then click "Export as package" in the menu.

This will start a "create package" task and you will be notified the package has been created. Once the task finished, you can download the package by clicking the link in the task menu. Clicking the link will open a file-save dialog in your browser - select a location in order to start the download.

Creating Packages with multiple Resources

Besides exporting or importing single resources in packages, you can also export multiple resources at the same time. Navigate to "Packaging" in the "Management" section of the agent sidebar. This will open our packaging tool.

Here you can start Exporting or Importing a Package.

Version badge

Export

As of Release v4.5.0, you can select one / many / all resources by activating the corresponding checkboxes for each resource via click. Then set the name, create the package, and start the download. You can also use our search capability to quickly identify and search for the resource you want to export.

Import

Similar to the export, the import of packages is straightforward. Simply drag&drop a package on the area at the top of the packaging tool or use the file selection functionality. Your package will be uploaded and processed by Cognigy.AI. Once analyzed, the packaging tool will display the contents of the package and you can go forward and import them.

Version badge

Import Configuration

As of v4.5.0, importing a package will show you conflict resolution options in case e.g. name conflicts occur. You can either select a conflict resolution strategy for the complete import or per resource.

Locale Mapping

If the Package contains a Flow for import, you will need to provide a Locale Mapping for each Locale from the Package. You can decide between mapping a Package Locale to an Agent Locale or not import it. However, it is mandatory to map the Primary Locale from the Package to the Primary Locale of the Agent.

Conflict Management

In case your Agent already contains the Resources from the Package, you will need to decide how Cognigy.AI should handle the duplicates. You can either select a conflict resolution method for all resources or for each resource independently. Currently, we support importing a resource "as a copy" or by "replacing" the existing version.

Once you have selected a conflict resolution strategy, click on "Import" in order to start the package import.

Back to top