{"id":49914,"date":"2022-12-27T06:49:22","date_gmt":"2022-12-27T06:49:22","guid":{"rendered":"https:\/\/developer.kore.ai\/v10-1\/?p=49914"},"modified":"2023-08-01T09:30:13","modified_gmt":"2023-08-01T08:30:13","slug":"external-nlu-adapters","status":"publish","type":"post","link":"https:\/\/developer.kore.ai\/v10-1\/integrations\/external-nlu-adapters\/","title":{"rendered":"External NLU Adapters"},"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\">\r\n\t<div class=\"wpb_text_column \">\r\n\t\t<div class=\"wpb_wrapper\">\r\n\t\t\t<p>Kore.ai has one of the best NLP engines in the market including the unique Multiengine NLP capability. However, to provide integration flexibility and let the customers use the NLU engine of their preference with other features of the platform, Kore.ai provides an ability to make an external NLU engine co-exist with our built-in NLP engines.<\/p>\n<h2><span class=\"ez-toc-section\" id=\"Overview\">Overview<\/span><\/h2>\n<p>The Kore.ai XO Platform provides an option to configure and enable an external NLU adapter for your Virtual Assistant so that you can easily use the NLU models built and trained on the other engine. Integration with external NLU engines is provided on the platform as an additional helpful feature for Intent and Entity detection. All other functionalities are managed on the Kore.ai XO Platform. When the adapter is enabled, the external engine\u2019s intent or entity detection takes precedence. However, Kore.ai proprietary NLU acts as a fallback, in case the external engine fails to detect an intent or entity. Additionally, you have the option to continue training intents on the XO Platform while also utilizing previously trained intents from the external engine.<\/p>\n<p>The <strong>Build \u2192 Integration \u2192 External NLU<\/strong> page has the list of available adapters<\/p>\n<p><a ref=\"magnificPopup\" href=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20230117111245\/ExternalNLU.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-medium wp-image-51365\" src=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20230117111245\/ExternalNLU.png\" alt=\"\" width=\"600\" height=\"414\" \/><\/a><\/p>\n<div class=\"alert alert-info\"><strong>Note<\/strong>: This is a VA specific configuration. Different VAs in a workspace can use different external NLU engines. In the 10.0 release only the Dialogflow ES adapter is supported. Kore.ai Platform would extend support for other adapters soon.<\/div>\n<h2><span class=\"ez-toc-section\" id=\"Adapter_Configuration\">Adapter Configuration<\/span><\/h2>\n<p>Steps to configure an external NLU adapter:<\/p>\n<ol>\n<li>Click on the <strong>External NLU<\/strong> adapter corresponding to the engine you want to use for intent and entity detection, to configure the settings.<br \/>\n<a ref=\"magnificPopup\" href=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20230124045754\/Dflow.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-medium wp-image-52571\" src=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20230124045754\/Dflow.png\" alt=\"\" width=\"600\" height=\"251\" \/><\/a><\/li>\n<li>Provide the configuration details required for establishing authorized connection between the Kore.ai and the external engine.\n<div class=\"alert alert-info\"><strong>Note<\/strong><span style=\"font-weight: 400;\">: Authorization keys and other parameters configured here are required by the external engine to allow APIs access.<\/div>\n<\/li>\n<li>In the platform specific settings, by default <strong>De-identification of PII data<\/strong> is selected as No as shown in the preceding screenshot.\n<div class=\"alert alert-info\"><strong>Note<\/strong>: De Identification of PII data means removing or masking PII data in order to reduce the risk of disclosure of user\u2019s sensitive information that is connected with the data. If the de-identification of PII is disabled for the External NLU Adapter, any API call being made to the external NLU will send the masked PII data in the payload. If you select the option &#8211; <strong>do not de-identify PII data from the user input<\/strong>, intent or entity detection may not work properly. To know more about PII data, see <a href=\"https:\/\/developer.kore.ai\/v10-1\/docs\/bots\/bot-settings\/pii-data-masking\/\" target=\"_blank\" rel=\"noopener noreferrer\">Redacting Personally Identifiable Information<\/a>.<\/div>\n<\/li>\n<li>Click <strong>Save<\/strong>, to save the configurations.<\/li>\n<li>You can check the External NLU connectivity by clicking <strong>TEST<\/strong>. On successful completion of the test, the following message is displayed.<br \/>\n<a ref=\"magnificPopup\" href=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20230117112244\/Test-1.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-medium wp-image-51373\" src=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20230117112244\/Test-1.png\" alt=\"\" width=\"600\" height=\"485\" \/><\/a><\/p>\n<div class=\"alert alert-info\"><strong>Note<\/strong>: You can configure multiple external adapters but you can enable only one external NLU adapter at a time. You can test the connection for an adapter that has all the mandatory fields configured. The test can be executed even if the adapter is not enabled.<\/div>\n<\/li>\n<li>External NLU can be enabled either by updating the configuration setting to <strong>Yes<\/strong> under the <strong>Enable External NLU Adapter<\/strong> option in the configuration panel, or by using the <strong>Enable\/Disable<\/strong> option that is displayed on clicking the ellipsis icon.\n<div class=\"alert alert-info\"><strong>Note<\/strong>: Starting from <strong>10.1 released on 16-April-2023<\/strong>, the Universal Bots (UB) allows you to link bots that are using external NLU alongside other bots using built-in NLP. However, the UB dialog tasks and linked bot qualification always use Platform&#8217;s built-in NLP.<\/div>\n<p><a ref=\"magnificPopup\" href=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20230124050354\/enableDF.png\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-medium wp-image-52577\" src=\"https:\/\/kore-wordpress.s3.us-east-2.amazonaws.com\/developer.kore.ai\/v10-1\/wp-content\/uploads\/sites\/35\/20230124050354\/enableDF.png\" alt=\"\" width=\"600\" height=\"294\" \/><\/a><\/li>\n<\/ol>\n<div class=\"alert alert-info\"><strong>Note<\/strong><span style=\"font-weight: 400;\">: External NLU is supported only for intent, Entity nodes and FAQs.<\/div>\n<\/li>\n<p>See <a href=\"https:\/\/developer.kore.ai\/v10-1\/integrations\/dialogflow-engine\/\" target=\"_blank\" rel=\"noopener noreferrer\">Dialogflow Engine<\/a> to understand the Dialogflow usage. See <a href=\"https:\/\/developer.kore.ai\/v10-1\/uncategorised\/test-and-debug\/\" target=\"_blank\" rel=\"noopener noreferrer\">Test and Debug<\/a> to know how to test your virtual assistant to validate the external NLU and to understand the conversation behavior.<\/p>\n\r\n\t\t<\/div>\r\n\t<\/div>\r\n<div class=\"ult-spacer spacer-6ae865c85f9c1\" data-id=\"6ae865c85f9c1\" data-height=\"20\" data-height-mobile=\"20\" data-height-tab=\"20\" data-height-tab-portrait=\"\" data-height-mobile-landscape=\"\" style=\"clear:both;display:block;\"><\/div><\/div><\/div><\/div><\/div><\/div><\/section>\n","protected":false},"excerpt":{"rendered":"Kore.ai has one of the best NLP engines in the market including the unique Multiengine NLP capability. However, to provide integration flexibility and let the customers use the NLU engine of their preference with other features of the platform, Kore.ai provides an ability to make an external NLU engine co-exist with our built-in NLP engines....","protected":false},"author":20,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[201],"tags":[],"class_list":["post-49914","post","type-post","status-publish","format-standard","hentry","category-integrations"],"_links":{"self":[{"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/posts\/49914","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/users\/20"}],"replies":[{"embeddable":true,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/comments?post=49914"}],"version-history":[{"count":70,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/posts\/49914\/revisions"}],"predecessor-version":[{"id":58489,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/posts\/49914\/revisions\/58489"}],"wp:attachment":[{"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/media?parent=49914"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/categories?post=49914"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/developer.kore.ai\/v10-1\/wp-json\/wp\/v2\/tags?post=49914"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}