{"id":18145,"date":"2019-02-20T11:50:28","date_gmt":"2019-02-20T11:50:28","guid":{"rendered":"\/docs\/bots\/advanced-topics\/bot-management\/"},"modified":"2024-03-14T07:10:27","modified_gmt":"2024-03-14T07:10:27","slug":"bot-management-2","status":"publish","type":"post","link":"https:\/\/developer.kore.ai\/v10-2\/docs\/bots\/bot-settings\/bot-management\/bot-management-2\/","title":{"rendered":"Bot Management"},"content":{"rendered":"<section class=\"l-section wpb_row height_auto\"><div class=\"l-section-h i-cf\"><div class=\"g-cols vc_row type_default valign_top\"><div class=\"vc_col-sm-12 wpb_column vc_column_container\"><div class=\"vc_column-inner\"><div class=\"wpb_wrapper\"><div class=\"ult-spacer spacer-6aec7fd7a2041\" data-id=\"6aec7fd7a2041\" data-height=\"10\" data-height-mobile=\"10\" data-height-tab=\"10\" data-height-tab-portrait=\"\" data-height-mobile-landscape=\"\" style=\"clear:both;display:block;\"><\/div>\r\n\t<div class=\"wpb_text_column \">\r\n\t\t<div class=\"wpb_wrapper\">\r\n\t\t\t<p><span style=\"font-weight: 400;\">This article discusses the main features that allow you to manage your assistant at a high level. These include Importing, Exporting, and Deleting assistants, as well as viewing change logs.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">To learn more about Variables and how to use them, see <\/span><a href=\"https:\/\/developer.kore.ai\/v10-2\/docs\/bots\/bot-settings\/bot-management\/using-bot-variables\/\" target=\"_blank\" rel=\"noopener noreferrer\"><span style=\"font-weight: 400;\">Using Bot Variables<\/span><\/a><span style=\"font-weight: 400;\">.<\/span><\/p>\n<h1><span class=\"ez-toc-section\" id=\"Importing_and_Exporting_Assistants\">Importing and Exporting Assistants<\/span><\/h1>\n<p>Kore.ai allows you to export and import assistant tasks and associated configurations into another assistant. This feature helps you in the migration of bot definitions, cloning of assistants, or maintaining a periodic backup of bot definitions.<\/p>\n<p>This feature is particularly helpful to test various versions of your assistant at different stages of the development process before it is released for end users. The articles in this section help you understand how the <em>Export <\/em>and <em>Import <\/em>features work and how to perform them.<\/p>\n<p><strong>NOTE<\/strong>: Post v8.0 release, the <em>enableNegativePatterns<\/em> flag will be included in \u2018NLP Settings\u2019 under \u2018NLP Data\u2019 in the exported and imported bot definitions. This flag is used to check if the Negative Patterns are enabled\/disabled in the assistant.<\/p>\n<p>Prior to this patch, this flag was part of \u2018NLP Settings\u2019 under \u2018NLP Data\u2019 in the imported bot definitions and \u2018Bot Setting\u2019 under \u2018Setting\u2019 in the exported bot definitions. This change is aimed at streamlining the functionality and might result in the failure to the incremental import of a bot from an export file generated before v8.0.<\/p>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n\r\n\t<div class=\"wpb_text_column \">\r\n\t\t<div class=\"wpb_wrapper\">\r\n\t\t\t\r\n\t\t<\/div>\r\n\t<\/div>\r\n<div class=\"w-separator size_small with_line width_default thick_1 style_solid color_border align_center\"><div class=\"w-separator-h\"><\/div><\/div>\r\n\t<div class=\"wpb_text_column \">\r\n\t\t<div class=\"wpb_wrapper\">\r\n\t\t\t<h2><span class=\"ez-toc-section\" id=\"Importing_an_Assistant\">Importing an Assistant<\/span><\/h2>\n<p>You can import tasks and configurations of a specific assistant into a new or existing assistant using one of these import types:<\/p>\n<ul>\n<li><strong>Full import<\/strong>: Replaces the existing assistant with the imported configurations. Any additional configurations in the target assistant that are not present in the import definition will be deleted. An exception to this rule is the webhook channel, which will be retained even if not present in the import bot definition.\n<div class=\"alert alert-info\"><strong>Note<\/strong>: We strongly recommend you exercise caution and take a backup of the target assistant before importing using this option.<\/div>\n<\/li>\n<li><strong>Incremental import<\/strong>: Upgrades the current assistant with the configurations available in the import file. Any additional configurations available in the target or imported bot are retained. You can select specific bot components to import from the bot tasks, NLP data, and bot settings. Refer to the Bot Items in the Incremental Import table at the end of the article to learn how the imported bot items replace the target bot\u2019s items in incremental import.<\/li>\n<\/ul>\n<p><strong>Before you Begin<\/strong> The <em>config.json<\/em> file consists of bot variables that need values for the target assistant. Share the file with the relevant developers or enter suitable values yourself for the variables before importing the bot definition into a new bot.<\/p>\n<h4>Steps in Importing to an Existing Assistant<\/h4>\n<p>To import a Virtual Assistant, follow these steps:<\/p>\n<ol>\n<li>Open the assistant you want to export<\/li>\n<li>Select the <strong>Deploy<\/strong> tab from the top menu<\/li>\n<li>From the left menu select <strong>Bot Management -&gt; Import &amp; Export<\/strong><\/li>\n<li>On the Import &amp; Export page select the <strong>Import<\/strong> tab<\/li>\n<li>Click the <strong>CHOOSE FILE <\/strong>buttons next to the <strong>BOT DEFINITION FILE<\/strong> field and <strong>BOT CONFIG FILE<\/strong> field, and upload the <em>botDefinition.json<\/em> and <em>config.json<\/em> files respectively.<\/li>\n<li>Optionally, upload the custom script file from the imported assistant if any. The file size is limited to 500kb.<br \/>\n<a ref=\"magnificPopup\" href=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20221003065802\/fullimport.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-large wp-image-47106\" src=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20221003065802\/fullimport-1024x456.png\" alt=\"\" width=\"640\" height=\"285\" srcset=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20221003065802\/fullimport-1024x456.png 1024w, https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20221003065802\/fullimport-300x134.png 300w, https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20221003065802\/fullimport.png 1922w\" sizes=\"auto, (max-width: 640px) 100vw, 640px\" \/><\/a><\/li>\n<li>Select one of these import options: <strong>Full Import<\/strong> or <strong>Incremental Import<\/strong>.<\/li>\n<li>If you select <strong>Full import<\/strong>, the bot definition in the in-development copy will be overwritten with the definition present in the import file.\n<ol>\n<li>If there are one or more additional tasks or languages in the assistant, and if these are not present in the import definition, then these tasks will be marked as deleted and will be removed when the bot is published.<\/li>\n<li>You can choose to auto-publish the assistant post-import.<br \/>\n<a ref=\"magnificPopup\" href=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20210618100344\/botManagement_ImportFull.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-27811\" src=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20210618100344\/botManagement_ImportFull.png\" alt=\"\" width=\"443\" height=\"681\" srcset=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20210618100344\/botManagement_ImportFull.png 443w, https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20210618100344\/botManagement_ImportFull-195x300.png 195w\" sizes=\"auto, (max-width: 443px) 100vw, 443px\" \/><\/a><\/li>\n<\/ol>\n<\/li>\n<li>If you select <strong>Incremental import<\/strong>, you can also choose which components to import.<br \/>\n<a ref=\"magnificPopup\" href=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20240311075038\/XOP-3673-incremental-import-components.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-61449 size-large\" src=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20240311075038\/XOP-3673-incremental-import-components-1024x450.png\" alt=\"\" width=\"640\" height=\"281\" srcset=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20240311075038\/XOP-3673-incremental-import-components-1024x450.png 1024w, https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20240311075038\/XOP-3673-incremental-import-components-300x132.png 300w, https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20240311075038\/XOP-3673-incremental-import-components.png 1919w\" sizes=\"auto, (max-width: 640px) 100vw, 640px\" \/><\/a><\/p>\n<ul>\n<li><strong>Bot Tasks: <\/strong>Here is where you can select to import Tasks only (with or without comments), Knowledge Graph, Small Talk or Digital Forms.\n<p><strong>Note<\/strong>: If you want to import one or more Bot Tasks, also select the <strong>NLP Data<\/strong> settings, as they are linked. For example, the utterances assigned to dialog tasks are not imported if you don\u2019t select the NLP Data settings, causing problems in identifying the dialog properly.<\/li>\n<li><strong>NLP Data: <\/strong>This is where you can import NLP Settings, Utterances, Patterns and Standard Responses. ML Utterances and Patterns can either be Appended or Replaced.\n<ul>\n<li><strong><em>Append<\/em> <\/strong>can be used when the utterances present in the file should be imported into the assistant and any additional utterances in the bot should be retained (this is the default behavior)<\/li>\n<li><em><strong>Replace<\/strong> <\/em>can be used when the utterances present in the file should be imported into the assistant. Any additional utterances\u00a0will be removed.\n<ul>\n<li>In case you are importing Tasks too, the additional utterances related to tasks being imported will be removed.<br \/>\n<a ref=\"magnificPopup\" href=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20221003065820\/incremental-utterances.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-large wp-image-47118\" src=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20221003065820\/incremental-utterances-1024x456.png\" alt=\"\" width=\"640\" height=\"285\" srcset=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20221003065820\/incremental-utterances-1024x456.png 1024w, https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20221003065820\/incremental-utterances-300x134.png 300w, https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20221003065820\/incremental-utterances.png 1922w\" sizes=\"auto, (max-width: 640px) 100vw, 640px\" \/><\/a><\/li>\n<\/ul>\n<\/li>\n<li>\n<div>\n<div>The imported Traits, Synonyms and Concepts will replace those in the target bot. Rules can be imported along with their tagged dialog tasks.<\/div>\n<\/div>\n<\/li>\n<\/ul>\n<\/li>\n<li style=\"font-weight: 400;\"><strong>Settings<\/strong><span style=\"font-weight: 400;\">: Bot Settings, Bot Variables and Voice Call Properties.<\/span><\/li>\n<li style=\"font-weight: 400;\"><strong>Custom Dashboards<\/strong><span style=\"font-weight: 400;\"> &#8211; This is useful in case you have created custom dashboards under the Analyze section and you want to import these to the new VA as well.\u00a0<\/span><\/li>\n<li>On the confirmation dialog that opens, click <strong>Backup <\/strong>to download the existing assistant configuration.\n<div class=\"alert alert-info\"><strong>Note<\/strong>: While backing up is an optional choice, we strongly recommend you do so, especially when choosing Full Import, as you cannot recover the configurations after the imported assistant replaces them.<\/div>\n<p><a ref=\"magnificPopup\" href=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20221003065815\/incremental-import-backup.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-large wp-image-47115\" src=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20221003065815\/incremental-import-backup.png\" alt=\"\" width=\"474\" height=\"526\" srcset=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20221003065815\/incremental-import-backup.png 584w, https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20221003065815\/incremental-import-backup-270x300.png 270w\" sizes=\"auto, (max-width: 474px) 100vw, 474px\" \/><\/a><\/li>\n<\/ul>\n<\/li>\n<li>Click <strong>Proceed <\/strong>to start the import.<\/li>\n<li>After the import is completed, the following success message appears. Click <strong>Done<\/strong>.\n<p><strong>Note<\/strong>: Bot import would fail if the assistant has been restored but not published after the restore.<\/li>\n<\/ol>\n<h3><span class=\"ez-toc-section\" id=\"Creating_a_New_Assistant_Using_the_Import_Option\">Creating a New Assistant Using the Import Option<\/span><\/h3>\n<p><span style=\"font-weight: 400;\">To import a VA while creating it, follow these steps:<\/span><\/p>\n<ol>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">On the landing page, click <\/span><strong>New Bot<\/strong><span style=\"font-weight: 400;\">.<a ref=\"magnificPopup\" href=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20230320095606\/new-bot-2.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-56156\" src=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20230320095606\/new-bot-2.png\" alt=\"\" width=\"1919\" height=\"425\" srcset=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20230320095606\/new-bot-2.png 1919w, https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20230320095606\/new-bot-2-300x66.png 300w, https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20230320095606\/new-bot-2-1024x227.png 1024w\" sizes=\"auto, (max-width: 1919px) 100vw, 1919px\" \/><\/a> <\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">In the <\/span><strong>Create New Bot<\/strong><span style=\"font-weight: 400;\"> window, select <\/span><strong>Import a Bot<\/strong><span style=\"font-weight: 400;\">.<br \/>\n<\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Enter a <\/span><strong>Name<\/strong><span style=\"font-weight: 400;\">.\u00a0<\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Select an icon or click the <\/span><strong>+<\/strong><span style=\"font-weight: 400;\"> icon to upload your own. Images should be in PNG format and should not exceed 40&#215;40 pixels. The file size is limited to 80kb.\u00a0<\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Upload the <\/span><strong>Bot Definition File<\/strong><span style=\"font-weight: 400;\">.<\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Upload the <\/span><strong>Bot Config File<\/strong><span style=\"font-weight: 400;\">.<\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Upload the <\/span><strong>Custom Script File<\/strong><span style=\"font-weight: 400;\">. The file size is limited to 500kb.<\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Click <\/span><strong>Import <\/strong><span style=\"font-weight: 400;\">when ready.<br \/>\n<a ref=\"magnificPopup\" href=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20230320095557\/import-2.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-56150\" src=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20230320095557\/import-2.png\" alt=\"\" width=\"650\" height=\"460\" srcset=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20230320095557\/import-2.png 1001w, https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20230320095557\/import-2-300x212.png 300w\" sizes=\"auto, (max-width: 650px) 100vw, 650px\" \/><\/a><br \/>\n<\/span><\/li>\n<\/ol>\n<h3><span class=\"ez-toc-section\" id=\"Components_in_the_Incremental_Import\">Components in the Incremental Import<\/span><\/h3>\n<table>\n<thead>\n<tr>\n<th><span style=\"font-weight: 400;\">COMPONENT<\/span><\/th>\n<th><span style=\"font-weight: 400;\">DESCRIPTION<\/span><\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Tasks with the same Reference ID<\/td>\n<td>Imported tasks replace the tasks in the target assistant and their status changes to Configured, regardless of their current status (including Suspended and Rejected tasks).<\/td>\n<\/tr>\n<tr>\n<td>Tasks in the source assistant with a different Reference ID<\/td>\n<td>These tasks are created in the target assistant with the same Reference ID.<\/td>\n<\/tr>\n<tr>\n<td>Tasks in the target assistant with a different Reference ID<\/td>\n<td>These tasks stay intact.<\/td>\n<\/tr>\n<tr>\n<td>Utterances, Patterns, and Task-level Synonyms<\/td>\n<td>Imported utterances, patterns, and task-level synonyms replace the ones in the target assistant and apply them to the imported tasks. Published models in the target assistant stay intact.<\/td>\n<\/tr>\n<tr>\n<td>Knowledge Graph, Bot Synonyms and Standard Responses<\/td>\n<td>Existing knowledge graph, bot synonyms, and standard responses in the target assistant are replaced with the imported ones.<\/td>\n<\/tr>\n<tr>\n<td>Synonyms, Concepts, and Traits<\/td>\n<td>They are imported from the source bot along with all their underlying terms, and replace the ones in the target bot.<\/td>\n<\/tr>\n<tr>\n<td>Rules<\/td>\n<td>Rules will be imported only if their tagged dialog tasks are imported.<\/p>\n<p><strong>Note: <\/strong>On-Prem customers can import the NLP components (Synonyms, Concepts, Rules, Traits) from a source bot of a higher version to a target bot of a lower version by checking the <strong>NLP Settings<\/strong> checkbox. However, Rules won&#8217;t import unless the tagged dialog tasks are also imported.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n<div class=\"w-separator size_small with_line width_default thick_1 style_solid color_border align_center\"><div class=\"w-separator-h\"><\/div><\/div>\r\n\t<div class=\"wpb_text_column \">\r\n\t\t<div class=\"wpb_wrapper\">\r\n\t\t\t<h2><span class=\"ez-toc-section\" id=\"Exporting_an_Assistant\">Exporting an Assistant<\/span><\/h2>\n<p>You can export a bot\u2019s definition and configuration using the Export option.<\/p>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n<div class=\"w-message color_yellow\"><div class=\"w-message-body\"><p><b>Important<\/b>: Export from a lower (not an end-of-life) version to a higher supported version is allowed for all the virtual assistants. However, a VA export from a higher environment and import to an environment running a lower version or lower patch is not supported.<\/p><\/div><\/div>\r\n\t<div class=\"wpb_text_column \">\r\n\t\t<div class=\"wpb_wrapper\">\r\n\t\t\t<p>When you export a assistant, it downloads a zipped file with the following parameters:<\/p>\n<ul>\n<li><strong>botDefinition.json<\/strong>: Includes metadata, tasks, bot and task-level synonyms, utterances, patterns, knowledge graph, standard responses, flows, and IDPs. You can select specific items to export from tasks, NLP data &#8211; NLP settings, utterances, standard responses &#8211; and Settings &#8211; bot settings, variables, IVR settings- while exporting the assistant.<\/li>\n<li><strong>config.json<\/strong>: Includes bot settings, bot variables, and IVR settings.<\/li>\n<li><strong>Icon.png<\/strong>: Includes the assistant icon.<\/li>\n<li><strong>&lt;<\/strong><strong><em>Custom ScriptFile Name<\/em>.js&gt; (if available)<\/strong>: Includes a script file with JavaScript functions. When you upload this file, you can access the functions in the file from anywhere in the assistant.<\/li>\n<\/ul>\n<div class=\"alert alert-info\"><strong>Note<\/strong>: The assistant and its components are given unique Reference IDs during export. These IDs help the platform to identify matching tasks in the target bot and update them.<\/div>\n<h3><span class=\"ez-toc-section\" id=\"Export_Modes\"><strong>Export Modes<\/strong><\/span><\/h3>\n<p>You can export assistants in two modes: <strong>Published<\/strong> and <strong>Latest Version<\/strong>. Depending on the mode that is selected, the corresponding versions of the tasks are exported. You can select specific components to export from the tasks, NLP data, and bot settings in both the modes. Further individual Tasks can also be selected.<\/p>\n<h4><strong>Published Mode<\/strong><\/h4>\n<p>When you export a VA in the Published mode, only the published versions of the tasks are exported, regardless of any other existing versions. For example, if a VA consists of a published version of a task and also version in Upgrade in Progress, only the published version gets exported. Refer to the table below to understand which versions of the tasks are exported in the Published mode:<\/p>\n<table>\n<thead>\n<tr>\n<th>Task<\/th>\n<th>Status<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><strong>In Progress<\/strong><\/td>\n<td>Not exported If a task is in progress for development, it isn\u2019t exported in the Published mode.<\/td>\n<\/tr>\n<tr>\n<td><strong>Configured<\/strong><\/td>\n<td>Not exported If the task configuration is complete but not published for use, it doesn\u2019t get exported in the Published mode.<\/td>\n<\/tr>\n<tr>\n<td><strong>Published<\/strong><\/td>\n<td>Exported All published tasks get exported<\/td>\n<\/tr>\n<tr>\n<td><strong>Upgrade in Progress<\/strong><\/td>\n<td>Not exported Task upgrade configurations that are in progress do not get exported. Only the published configurations get exported.<\/td>\n<\/tr>\n<tr>\n<td><strong>Rejected<\/strong><\/td>\n<td>Not exported Task configurations rejected by admins do not get exported.<\/td>\n<\/tr>\n<tr>\n<td><strong>Suspended<\/strong><\/td>\n<td>Not exported Suspended tasks do not get exported.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<div class=\"alert alert-info\"><strong>Note<\/strong>: In Dialog tasks, only the nodes in the Published status get exported.<\/div>\n<h4><strong>Latest Version<\/strong><\/h4>\n<p>When you export a VA in the Latest mode, the latest versions of the\u00a0 tasks get exported, regardless of their publishing status. For example, if a VA consists of a published version of a task and also the version in Upgrade in Progress, the Upgrade in Progress version gets exported, whereas if it just has a Configured version, the configured version is exported. Refer to the table below to understand which versions of the tasks are exported in the Latest mode:<\/p>\n<table>\n<thead>\n<tr>\n<th>Task<\/th>\n<th>Status<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><strong>In Progress<\/strong><\/td>\n<td>Exported if it is the only available version Not Exported if a later version exists<\/td>\n<\/tr>\n<tr>\n<td><strong>Configured<\/strong><\/td>\n<td>Exported if it is the only available version Not Exported if a later version exists<\/td>\n<\/tr>\n<tr>\n<td><strong>Published<\/strong><\/td>\n<td>Exported if it is the only available version Not Exported if a later version exists<\/td>\n<\/tr>\n<tr>\n<td><strong>Upgrade in Progress<\/strong><\/td>\n<td>Exported regardless of any other task version in the assistant<\/td>\n<\/tr>\n<tr>\n<td><strong>Rejected<\/strong><\/td>\n<td>Not exported Task configurations rejected by admins do not get exported<\/td>\n<\/tr>\n<tr>\n<td><strong>Suspended<\/strong><\/td>\n<td>Not exported Suspended tasks do not get exported<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h4><strong>Steps in Exporting the Assistant<\/strong><\/h4>\n<ol>\n<li>Open the assistant you want to export<\/li>\n<li>Select\u00a0<strong>Deploy<\/strong> tab from the top menu<\/li>\n<li>From the left menu select <strong>Bot Management -&gt; Import &amp; Export<\/strong><\/li>\n<li>On the Import &amp; Export page, select the <strong>Export<\/strong> tab<\/li>\n<li>In the Export tab, select either <strong>Published <\/strong>or <strong>Latest Version <\/strong>exporting mode.<\/li>\n<li>By default, all the components are selected for export. Deselect the items that you do not want to export.<a ref=\"magnificPopup\" href=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20240311075254\/XOP-3673-incremental-export-components.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-61452 size-large\" src=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20240311075254\/XOP-3673-incremental-export-components-1024x451.png\" alt=\"\" width=\"640\" height=\"282\" srcset=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20240311075254\/XOP-3673-incremental-export-components-1024x451.png 1024w, https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20240311075254\/XOP-3673-incremental-export-components-300x132.png 300w, https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20240311075254\/XOP-3673-incremental-export-components.png 1920w\" sizes=\"auto, (max-width: 640px) 100vw, 640px\" \/><\/a><\/li>\n<li>For Tasks, you can further choose to export only select tasks. By default All Tasks are selected. Click the All Tasks link to open <strong>Select Tasks<\/strong> dialog to choose the tasks you want to export.<\/li>\n<\/ol>\n<div class=\"alert alert-info\"><strong>Note<\/strong>: If you want to export one or more Bot Tasks, also select the <strong>NLP Data<\/strong> settings, as they are linked. For example, the utterances assigned to dialog tasks are not exported if you don\u2019t select the NLP Data settings, causing problems in identifying the dialog properly.<\/div>\n<ol start=\"8\">\n<li>You can also choose to\u00a0<strong>Include dependent tasks<\/strong> or not for export. The existence of these will be checked before import and the import will fail if the dependent tasks are missing. These dependent tasks include the following:<\/li>\n<\/ol>\n<ul>\n<li>Linked Dialogs i.e. dialog nodes present in the definition of another dialog;<\/li>\n<li>Dialogs linked in defining \u2018Behavior on Exceeding Retries\u2019 for IVR Properties of any node of the dialog;<\/li>\n<li>Dialog linked as part of sub-intent \/ interruption settings;<\/li>\n<li>Any other scenario where a dialog execution could fail if a dependent task is not included;<\/li>\n<\/ul>\n<p><a ref=\"magnificPopup\" href=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20221003065758\/export-tasks.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-large wp-image-47102\" src=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20221003065758\/export-tasks-1024x456.png\" alt=\"\" width=\"640\" height=\"285\" srcset=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20221003065758\/export-tasks-1024x456.png 1024w, https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20221003065758\/export-tasks-300x134.png 300w, https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20221003065758\/export-tasks.png 1922w\" sizes=\"auto, (max-width: 640px) 100vw, 640px\" \/><\/a><\/p>\n<ol>\n<li style=\"list-style-type: none;\">\n<ol>\n<li style=\"list-style-type: none;\">\n<ol start=\"9\">\n<li>Click <strong>Export<\/strong>. The export happens in the background and the <strong>Download<\/strong> button gets activated after it is complete. Click <strong>Download<\/strong> to download the file to your local computer.<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n<\/li>\n<\/ol>\n<h3><span class=\"ez-toc-section\" id=\"Exported_Bot_Components\">Exported Bot Components<\/span><\/h3>\n<p>When you export a VA, the following components get exported, depending on your Latest or Published Mode selection:<\/p>\n<table style=\"height: 735px;\">\n<thead>\n<tr style=\"height: 18px;\">\n<th style=\"height: 18px; width: 612.667px;\" colspan=\"2\"><span style=\"font-weight: 400;\">Tasks<\/span><\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr style=\"height: 82px;\">\n<td style=\"height: 82px; width: 101.514px;\">Tasks Only<\/td>\n<td style=\"height: 82px; width: 505.375px;\">\n<ul>\n<li>Task Definition (Action, Alert, Information, and Dialog)<\/li>\n<li>Synonyms (Task, Field,\u00a0and Entity)<\/li>\n<li>Patterns (Task, Field, and Entity)<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n<tr style=\"height: 36px;\">\n<td style=\"height: 36px; width: 101.514px;\">Knowledge Graph<\/td>\n<td style=\"height: 36px; width: 505.375px;\">Knowledge Graph definition along with the associated synonyms and classes.<\/td>\n<\/tr>\n<\/tbody>\n<thead>\n<tr style=\"height: 18px;\">\n<th style=\"height: 18px; width: 612.667px;\" colspan=\"2\"><span style=\"font-weight: 400;\">NLP Data<\/span><\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr style=\"height: 191px;\">\n<td style=\"height: 191px; width: 101.514px;\">NLP Settings<\/td>\n<td style=\"height: 191px; width: 505.375px;\">The Advanced NLP Settings and Ignore words and Field memory. The Advanced NLP Settings ( Natural Language &gt; Advanced Settings) include the following:<\/p>\n<ul>\n<li>Auto-train settings for ML Utterances<\/li>\n<li>Multiple intent detection settings<\/li>\n<li>Threshold and Configurations settings for\n<ul>\n<li>Fundamental meaning<\/li>\n<li>Knowledge Graph<\/li>\n<li>Machine Learning<\/li>\n<\/ul>\n<\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\">Concepts, Synonyms, and traits, even if no tasks are specifically selected<\/li>\n<li>Rules, only if you are exporting the corresponding dialog tasks too.<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n<tr style=\"height: 18px;\">\n<td style=\"height: 18px; width: 101.514px;\">Utterances<\/td>\n<td style=\"height: 18px; width: 505.375px;\">All the utterances of all the enabled languages<\/td>\n<\/tr>\n<tr style=\"height: 36px;\">\n<td style=\"height: 36px; width: 101.514px;\">Standard Responses<\/td>\n<td style=\"height: 36px; width: 505.375px;\">All the standard responses of the assistant in all enabled languages<\/td>\n<\/tr>\n<\/tbody>\n<thead>\n<tr style=\"height: 18px;\">\n<th style=\"height: 18px; width: 612.667px;\" colspan=\"2\"><span style=\"font-weight: 400;\">Settings<\/span><\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr style=\"height: 264px;\">\n<td style=\"height: 264px; width: 101.514px;\">Bot Settings<\/td>\n<td style=\"height: 264px; width: 505.375px;\">The following information from Bot Settings page:<\/p>\n<ul>\n<li>General Settings<\/li>\n<li>Bot name, description, and bot synonyms for each enabled language<\/li>\n<li>Language selection time frame (Bot Settings &gt; Language Management)<\/li>\n<li>Welcome message<\/li>\n<li>Hold and Resume settings (Bot level)<\/li>\n<li>Custom Script file<\/li>\n<li>Tenancy URLs<\/li>\n<li>Error messages<\/li>\n<li>Task setup and execution settings (for executing tasks using UI forms).<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n<tr style=\"height: 36px;\">\n<td style=\"height: 36px; width: 101.514px;\">Bot Variables<\/td>\n<td style=\"height: 36px; width: 505.375px;\">All the global and content variables present in the assistant along with their values.<\/td>\n<\/tr>\n<tr style=\"height: 18px;\">\n<td style=\"height: 18px; width: 101.514px;\">IVR settings<\/td>\n<td style=\"height: 18px; width: 505.375px;\">All the IVR settings for the assistant (Bot Settings &gt; IVR settings).<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n<div class=\"w-separator size_small with_line width_default thick_1 style_solid color_border align_center\"><div class=\"w-separator-h\"><\/div><\/div>\r\n\t<div class=\"wpb_text_column \">\r\n\t\t<div class=\"wpb_wrapper\">\r\n\t\t\t<h2><span class=\"ez-toc-section\" id=\"Universal_and_Child_Bot_Scenarios\">Universal and Child Bot Scenarios<\/span><\/h2>\n<p>When exporting and importing universal and child VAs from a source environment to a destination environment, you should ensure the following:<\/p>\n<ul>\n<li>All the child bots are imported before the universal bot.<\/li>\n<li>When creating child bots, they propagate from the same source environment.<\/li>\n<\/ul>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n<div class=\"w-separator size_small with_line width_default thick_1 style_solid color_border align_center\"><div class=\"w-separator-h\"><\/div><\/div>\r\n\t<div class=\"wpb_text_column \">\r\n\t\t<div class=\"wpb_wrapper\">\r\n\t\t\t<h1><span class=\"ez-toc-section\" id=\"Deleting_an_Assistant\">Deleting an Assistant<\/span><\/h1>\n<p>You cannot delete a VA if any of the tasks are Published. Once you publish a task, the Bots Admin must approve and assign it to users. The developer cannot delete assigned tasks. To delete a published task, the Bots Admin needs to suspend the task. Also, you cannot delete a VA if it is part of a published flow. You must delete the flow or remove the assistant from the flow before attempting to delete it.<\/p>\n<p>To delete a Virtual Assistant:<\/p>\n<ol>\n<li>Open the assistant you want to delete<\/li>\n<li>Select the\u00a0<strong>Deploy<\/strong> tab from the top menu<\/li>\n<li>From the left navigation under the <strong>Bot Management<\/strong> menu, click <strong><span style=\"color: #ff0000;\">Delete Bot<\/span><\/strong>.<br \/>\n<a ref=\"magnificPopup\" href=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20221003065837\/delete-va.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-large wp-image-47130\" src=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20221003065837\/delete-va-1024x456.png\" alt=\"\" width=\"640\" height=\"285\" srcset=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20221003065837\/delete-va-1024x456.png 1024w, https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20221003065837\/delete-va-300x134.png 300w, https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20221003065837\/delete-va.png 1922w\" sizes=\"auto, (max-width: 640px) 100vw, 640px\" \/><\/a><\/li>\n<\/ol>\n<table style=\"width: 100%; border-collapse: collapse; background-color: #f8c4c5; height: 18px;\">\n<tbody>\n<tr style=\"height: 18px;\">\n<td style=\"width: 100%; height: 18px;\"><strong>WARNING<\/strong><span style=\"font-weight: 400;\">: <\/span><span style=\"font-weight: 400;\">All the configurations will be lost and there is no way to restore your assistant after deletion. Please exercise caution when using this feature.<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n<div class=\"w-separator size_small with_line width_default thick_1 style_solid color_border align_center\"><div class=\"w-separator-h\"><\/div><\/div>\r\n\t<div class=\"wpb_text_column \">\r\n\t\t<div class=\"wpb_wrapper\">\r\n\t\t\t<h1><span class=\"ez-toc-section\" id=\"Viewing_the_Change_Log\">Viewing the Change Log<\/span><\/h1>\n<p>After creating a VA, you may need to edit it for various reasons such as changing its settings, adding tasks, enabling channels, and add flows. To track all the changes made to a VA, you can view the <strong>Change Logs<\/strong>, which show a chronological list of modifications to your assistant. It consists of all the changes from the initial save of your assistant to the last update. To view the changelog for a VA, follow these steps:<\/p>\n<ol>\n<li>Select\u00a0<strong>Deploy<\/strong> tab from the top menu<\/li>\n<li>From the left menu click <strong>Change Logs<\/strong>.<br \/>\n<a ref=\"magnificPopup\" href=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20221003065825\/changelogs.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-large wp-image-47121\" src=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20221003065825\/changelogs-1024x456.png\" alt=\"\" width=\"640\" height=\"285\" srcset=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20221003065825\/changelogs-1024x456.png 1024w, https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20221003065825\/changelogs-300x134.png 300w, https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-2\/wp-content\/uploads\/sites\/45\/20221003065825\/changelogs.png 1922w\" sizes=\"auto, (max-width: 640px) 100vw, 640px\" \/><\/a><\/li>\n<li><span style=\"font-weight: 400;\">On the Change Logs page, you will notice the following; <\/span><\/li>\n<\/ol>\n<ul>\n<li>The list is sorted in reverse chronological order.<\/li>\n<li>Each page displays the ten most recent changes and the name of the user that made the change, followed by the change synopsis, and the timestamp of the applied change.<\/li>\n<li>Logs of the Publish Event are consolidated for all selected tasks, with the tasks listed in case all tasks are not selected for publishing along with the Publish Comments.<\/li>\n<\/ul>\n<p>Following actions can be performed on the logs:<\/p>\n<ul>\n<li>Using the <strong>search<\/strong> text box, you can enter any text and the platform will search for that text in the change description and the logs fulfilling the search criteria would be displayed.<\/li>\n<li>The <strong>filter<\/strong> option can be used to filter based on:\n<ul>\n<li>Developer Name collaborating on the assistant;<\/li>\n<li>Date Range either past 24 hrs, past 7 days, or custom date by specifying the start and end date. By default,\u00a0 changes from all developers in the past 24 hours would be displayed.<\/li>\n<\/ul>\n<\/li>\n<li>The <strong>export<\/strong> icon can be used to Export the changelog in CSV format. The logs displayed after applying the search and filter criteria would be downloaded.<\/li>\n<\/ul>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n<div class=\"w-separator size_small with_line width_default thick_1 style_solid color_border align_center\"><div class=\"w-separator-h\"><\/div><\/div><\/div><\/div><\/div><\/div><\/div><\/section><section class=\"l-section wpb_row height_auto\"><div class=\"l-section-h i-cf\"><div class=\"g-cols vc_row type_default valign_top\"><div class=\"vc_col-sm-12 wpb_column vc_column_container\"><div class=\"vc_column-inner\"><div class=\"wpb_wrapper\">\r\n\t<div class=\"wpb_text_column \">\r\n\t\t<div class=\"wpb_wrapper\">\r\n\t\t\t\r\n\t\t<\/div>\r\n\t<\/div>\r\n<\/div><\/div><\/div><\/div><\/div><\/section>\n","protected":false},"excerpt":{"rendered":"This article discusses the main features that allow you to manage your assistant at a high level. These include Importing, Exporting, and Deleting assistants, as well as viewing change logs. To learn more about Variables and how to use them, see Using Bot Variables. Importing and Exporting Assistants Kore.ai allows you to export and import...","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[21],"tags":[],"class_list":["post-18145","post","type-post","status-publish","format-standard","hentry","category-bot-management"],"_links":{"self":[{"href":"https:\/\/developer.kore.ai\/v10-2\/wp-json\/wp\/v2\/posts\/18145","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/developer.kore.ai\/v10-2\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/developer.kore.ai\/v10-2\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/developer.kore.ai\/v10-2\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/developer.kore.ai\/v10-2\/wp-json\/wp\/v2\/comments?post=18145"}],"version-history":[{"count":38,"href":"https:\/\/developer.kore.ai\/v10-2\/wp-json\/wp\/v2\/posts\/18145\/revisions"}],"predecessor-version":[{"id":61540,"href":"https:\/\/developer.kore.ai\/v10-2\/wp-json\/wp\/v2\/posts\/18145\/revisions\/61540"}],"wp:attachment":[{"href":"https:\/\/developer.kore.ai\/v10-2\/wp-json\/wp\/v2\/media?parent=18145"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/developer.kore.ai\/v10-2\/wp-json\/wp\/v2\/categories?post=18145"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/developer.kore.ai\/v10-2\/wp-json\/wp\/v2\/tags?post=18145"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}