{"id":844,"date":"2021-04-23T10:29:17","date_gmt":"2021-04-23T10:29:17","guid":{"rendered":"https:\/\/docs.tellya.ai\/?post_type=ht_kb&#038;p=844"},"modified":"2022-09-26T14:15:55","modified_gmt":"2022-09-26T14:15:55","slug":"intent-importer","status":"publish","type":"ht_kb","link":"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/intent-importer\/","title":{"rendered":"Intent importer"},"content":{"rendered":"\n<h2>Creazione automatica di intenti<\/h2>\n\n\n\n<p>Tellya mette a disposizione la possibilit\u00e0 di creare nuovi intenti in modo semi automatico analizzando una pagina web oppure tramite l\u2019importazione di un file contenente domande e risposte. La funzionalit\u00e0 \u00e8 particolarmente indicata per importare intenti di tipo &#8220;FAQ&#8221; (&#8220;Frequently Asked Questions&#8221;), costituiti quindi da domande e risposte autoconclusive.<\/p>\n\n\n\n<h3>Importazione da pagina web<\/h3>\n\n\n\n<p>Dalla sezione &#8220;Intents Settings&#8221;, nella tab \u201cIntent importer\u201d, selezionando il pulsante &#8220;New analysis&#8221;, l&#8217;opzione &#8220;Import FAQ&#8221; e l\u2019opzione &#8220;Web page&#8221; \u00e8 possibile indicare l&#8217;URL di una pagina web da analizzare, contenente alcune FAQ. L&#8217;analisi, avviabile dal pulsante &#8220;Analyze&#8221;, potrebbe richiedere alcuni istanti, a seconda della complessit\u00e0 della pagina stessa e del contenuto presente in essa.<\/p>\n\n\n\n<p>Al termine del processo di analisi verranno mostrate le coppie di domande e risposte trovate all\u2019interno della pagina web, le quali potranno poi essere salvate come intenti all\u2019interno del motore di NLU.<\/p>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-info\">La qualit\u00e0 e la completezza dei risultati estratti dall\u2019analisi di una pagina web pu\u00f2 variare a seconda della complessit\u00e0 strutturale e dalla ricchezza di contenuti della stessa.<\/p>\n\n\n\n<h3>Importazione da file JSON o CSV<\/h3>\n\n\n\n<p>Dalla sezione &#8220;Intents Setting&#8221;, nella tab \u201cIntent importer\u201d, selezionando il pulsante &#8220;New analysis&#8221;, l&#8217;opzione &#8220;Import FAQ&#8221; e l\u2019opzione &#8220;File&#8221; \u00e8 invece possibile importare le domande e le risposte da utilizzare per creare nuovi intenti direttamente da un file in formato JSON o CSV.<\/p>\n\n\n\n<p>Per ogni intento che si desidera creare \u00e8 possibile specificare una o pi\u00f9 frasi di training e uno o pi\u00f9 &#8220;balloon conversazionali&#8221; in cui suddividere la risposta dell\u2019intento.<\/p>\n\n\n\n<p>Il file JSON deve presentare la seguente struttura:<\/p>\n\n\n\n<div class=\"table-responsive\">\n<table class=\"table api-table\">\n  <thead>\n    <tr>\n      <th scope=\"col\">JSON example<\/th>\n    <\/tr>\n  <\/thead>\n  <tbody>\n    <tr class=\"json-example\">\n      <td>\n        <pre><code>[\n  {\n    <span class=\"str\">\"question\"<\/span>: [\n      <span class=\"str\">\"Prima training phrases intento 1\"<\/span>,\n      <span class=\"str\">\"Seconda training phrases intento 2\"<\/span>\n    ],\n    <span class=\"str\">\"answer\"<\/span>: [\n      <span class=\"str\">\"Primo balloon intento risposta 1\"<\/span>,\n      <span class=\"str\">\"Secondo balloon intento risposta 1\"<\/span>\n    ]\n  },\n  ...\n]\n<\/code><\/pre>\n      <\/td>\n    <\/tr>\n  <\/tbody>\n<\/table>\n<\/div>\n\n\n\n<p>La lista &#8220;question&#8221; dovr\u00e0 contenere tutte le frasi di training da associare all\u2019intento, mentre la lista &#8220;answer&#8221; tutti i balloon conversazionali che comporranno la risposta di tale intento.<\/p>\n\n\n\n<p>In alternativa \u00e8 possibile importare un file in formato CSV, generato sfruttando, ad esempio, un software che permette di salvare fogli elettronici in tale formato.<\/p>\n\n\n\n<p>Il file dovr\u00e0 contenere due &#8220;colonne&#8221; (separate da virgola), una per le frasi di training (con intestazione &#8220;question&#8221;) e una per le risposte (con intestazione &#8220;answer&#8221;), e tante righe quanti sono gli intenti che si desidera importare. Per specificare pi\u00f9 frasi di training o pi\u00f9 risposte per lo stesso intento \u00e8 necessario utilizzare un doppio carattere &#8220;cancelletto&#8221; (##) come separatore. Il file deve quindi presentare una struttura di questo tipo:<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">question,answer\n\"Domanda 1##Domanda 2\",\"Risposta 1##Risposta 2\"\n...<\/pre>\n\n\n\n<p>Al termine del processo di analisi (sia nella modalit\u00e0 &#8220;Web page&#8221;, sia nella modalit\u00e0 &#8220;File&#8221;) verranno mostrate le coppie di &#8220;domanda-risposta&#8221; identificate.<\/p>\n\n\n\n<h3>Salvataggio intenti per Dialogflow ES<\/h3>\n\n\n\n<p>Posizionando il cursore su una delle coppie di &#8220;domanda-risposta&#8221; e selezionando il pulsante &#8220;Save as intent&#8221; viene mostrata una finestra da cui \u00e8 possibile completare la configurazione dell&#8217;intento prima di importarlo all&#8217;interno del motore di NLU:<\/p>\n\n\n\n<ul><li><strong>Name<\/strong>: il nome dell\u2019intento che verr\u00e0 aggiunto all&#8217;interno del motore di NLU<\/li><li><strong>Training Phrases<\/strong>: frasi di training associate all&#8217;intento (\u00e8 possibile modificare, rimuovere o aggiungere frasi di training oltre a quelle estratte dall\u2019analisi)&nbsp;<\/li><li><strong>Text Response<\/strong>: risposte testuali associate all&#8217;intento (\u00e8 possibile modificare, rimuovere o aggiungere risposte testuali)<\/li><\/ul>\n\n\n\n<p>Selezionando l\u2019opzione &#8220;<strong>Save also in Dialogflow<\/strong>&#8221; la risposta dell\u2019intento verr\u00e0 salvata anche nel motore di NLU oltre che all&#8217;interno di Tellya.<\/p>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-info\">Le risposte specificate per gli intenti verranno salvate come risposte di tipo &#8220;Text Response&#8221; per il canale &#8220;Default&#8221;.<\/p>\n\n\n\n<h3>Salvataggio intenti per Dialogflow CX<\/h3>\n\n\n\n<p>Posizionando il cursore su una delle coppie di &#8220;domanda-risposta&#8221; e selezionando il pulsante &#8220;Save as intent&#8221; viene mostrata una finestra da cui \u00e8 possibile completare la configurazione dell\u2019intento prima di importarlo all\u2019interno del motore di NLU:<\/p>\n\n\n\n<ul><li><strong>Name<\/strong>: il nome dell\u2019intento che verr\u00e0 aggiunto all\u2019interno del motore di NLU<\/li><li><strong>Training Phrases<\/strong>: frasi di training associate all\u2019intento (\u00e8 possibile modificare, rimuovere o aggiungere frasi di training oltre a quelle estratte dall\u2019analisi)\u00a0<\/li><\/ul>\n\n\n\n<p>Per poter gestire le risposte delle FAQ in Dialogflow CX bisogna utilizzare le <strong>Route groups<\/strong>, si pu\u00f2 abilitare questa funzione spuntando il flag <em>Manage response as route groups<\/em>.<\/p>\n\n\n\n<p>\u00c8 possibile definire pi\u00f9 coppie Flow e Route Group che permette di creare, tramite un unico import, le stesse route groups su pi\u00f9 flows. Per ogni Flow \u00e8 possibile selezionare una route group gi\u00e0 esistente, tramite search, oppure crearne una nuova.<\/p>\n\n\n\n<p>In questo caso le risposte estratte vengono associate alle route groups e possono essere modificate, rimosse e aggiunte.<\/p>\n\n\n\n<p>Per ogni route groups creata \u00e8 possibile specificare se si vuole utilizzare una transition di tipo \u201cCurrent page\u201d spuntando il flag <em>Set transition as &#8220;current page&#8221;<\/em>.<\/p>\n\n\n\n<p><\/p>\n\n\n\n<p>\u00c8 possibile anche importare pi\u00f9 intenti contemporaneamente selezionando quelli che si desidera importare dalla lista e cliccando su &#8220;Save intents&#8221;; in questo caso non sar\u00e0 possibile specificare il nome per gli intenti (ne verr\u00e0 generato uno automaticamente), n\u00e9 modificare prima dell\u2019importazione le frasi di training o le risposte estratte.<\/p>\n\n\n\n<p>Indipendentemente dalla modalit\u00e0 di analisi scelta, \u00e8 sempre possibile visualizzare anche successivamente il risultato delle diverse analisi eseguite nella sezione &#8220;Intents Settings&#8221; &gt; &#8220;Intents Importer&#8221;.<\/p>\n\n\n\n<h2>Import training phrases<\/h2>\n\n\n\n<p>Tellya mette a disposizione la possibilit\u00e0 di aumentare le frasi di training degli intenti in modo semi automatico tramite l\u2019importazione di un file contenente le training phrases.&nbsp;<\/p>\n\n\n\n<h3>Importazione da file JSON o CSV<\/h3>\n\n\n\n<p>Dalla sezione &#8220;Intents Setting&#8221;, nella tab \u201cIntent importer\u201d, selezionando il pulsante &#8220;New analysis&#8221;, l&#8217;opzione &#8220;Import Training&#8221; \u00e8 possibile importare le frasi di training da utilizzare per arricchire la collezione di training phrases degli intenti direttamente da un file in formato JSON o CSV.<\/p>\n\n\n\n<p>Per ogni intento che si desidera configurare \u00e8 possibile specificare pi\u00f9 frasi di training.<\/p>\n\n\n\n<p>Il file JSON deve presentare la seguente struttura:<\/p>\n\n\n\n<div class=\"table-responsive\">\n<table class=\"table api-table\">\n  <thead>\n    <tr>\n      <th scope=\"col\">JSON example<\/th>\n    <\/tr>\n  <\/thead>\n  <tbody>\n    <tr class=\"json-example\">\n      <td>\n        <pre><code>[\n  {\n    <span class=\"str\">\"question\"<\/span>: [\n      <span class=\"str\">\"Prima training phrases intento 1\"<\/span>,\n      <span class=\"str\">\"Seconda training phrases intento 1\"<\/span>\n    ]\n  },\n  {\n    <span class=\"str\">\"question\"<\/span>: [\n      <span class=\"str\">\"Prima training phrases intento 2\"<\/span>,\n      <span class=\"str\">\"Seconda training phrases intento 2\"<\/span>\n    ]\n  },\n  ...\n]\n<\/code><\/pre>\n      <\/td>\n    <\/tr>\n  <\/tbody>\n<\/table>\n<\/div>\n\n\n\n<p>La lista &#8220;question&#8221; dovr\u00e0 contenere tutte le frasi di training da associare all\u2019intento.<\/p>\n\n\n\n<p>In alternativa \u00e8 possibile importare un file in formato CSV, generato sfruttando, ad esempio, un software che permette di salvare fogli elettronici in tale formato.<\/p>\n\n\n\n<p>Il file dovr\u00e0 contenere una &#8220;colonna&#8221; per le frasi di training (con intestazione &#8220;question&#8221;) e tante righe quanti sono gli intenti che si desidera importare. Per specificare pi\u00f9 frasi di training per lo stesso intento \u00e8 necessario utilizzare un doppio carattere &#8220;cancelletto&#8221; (##) come separatore.<\/p>\n\n\n\n<p>Il file deve quindi presentare una struttura di questo tipo:<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">question\n\"Prima training phrases intento 1##Seconda training phrases intento 1\"\n\"Prima training phrases intento 2##Seconda training phrases intento 2\"\n...<\/pre>\n\n\n\n<p>Al termine del processo di analisi verranno mostrate le frasi identificate.<\/p>\n\n\n\n<p>Posizionando il cursore su una di esse e selezionando il pulsante &#8220;import phrases&#8221; viene mostrata una finestra da cui \u00e8 possibile completare la configurazione dell&#8217;intento prima di importarlo all&#8217;interno del motore di NLU:<\/p>\n\n\n\n<ul><li><strong>Name<\/strong>: il nome dell\u2019intento al quale associare le frasi di training, selezionato tra quelli presenti all\u2019interno del motore di NLU<\/li><li><strong>Training Phrases<\/strong>: frasi di training associate all&#8217;intento (\u00e8 possibile modificare, rimuovere o aggiungere frasi di training oltre a quelle estratte dall\u2019analisi)<\/li><\/ul>\n\n\n\n<p>Indipendentemente dalla modalit\u00e0 di analisi scelta, \u00e8 sempre possibile visualizzare anche successivamente il risultato delle diverse analisi eseguite nella sezione &#8220;Intents Settings&#8221; &gt; &#8220;Intents Importer&#8221;.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Creazione automatica di intenti Tellya mette a disposizione la possibilit\u00e0 di creare nuovi intenti in modo semi automatico analizzando una pagina web oppure tramite l\u2019importazione di un file contenente domande e risposte. La funzionalit\u00e0 \u00e8 particolarmente indicata per importare intenti di tipo &#8220;FAQ&#8221; (&#8220;Frequently Asked Questions&#8221;), costituiti quindi da domande&#8230;<\/p>\n","protected":false},"author":4,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":[],"ht-kb-category":[23],"ht-kb-tag":[],"_links":{"self":[{"href":"https:\/\/docs.tellya.ai\/index.php\/wp-json\/wp\/v2\/ht-kb\/844"}],"collection":[{"href":"https:\/\/docs.tellya.ai\/index.php\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/docs.tellya.ai\/index.php\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/docs.tellya.ai\/index.php\/wp-json\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.tellya.ai\/index.php\/wp-json\/wp\/v2\/comments?post=844"}],"version-history":[{"count":26,"href":"https:\/\/docs.tellya.ai\/index.php\/wp-json\/wp\/v2\/ht-kb\/844\/revisions"}],"predecessor-version":[{"id":1470,"href":"https:\/\/docs.tellya.ai\/index.php\/wp-json\/wp\/v2\/ht-kb\/844\/revisions\/1470"}],"wp:attachment":[{"href":"https:\/\/docs.tellya.ai\/index.php\/wp-json\/wp\/v2\/media?parent=844"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/docs.tellya.ai\/index.php\/wp-json\/wp\/v2\/ht-kb-category?post=844"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/docs.tellya.ai\/index.php\/wp-json\/wp\/v2\/ht-kb-tag?post=844"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}