{"id":149,"date":"2020-11-06T15:07:49","date_gmt":"2020-11-06T15:07:49","guid":{"rendered":"https:\/\/docs.tellya.ai\/?post_type=ht_kb&p=149"},"modified":"2022-03-14T10:00:21","modified_gmt":"2022-03-14T10:00:21","slug":"design-overview","status":"publish","type":"ht_kb","link":"https:\/\/docs.tellya.ai\/index.php\/knowledge-base\/design-overview\/","title":{"rendered":"Process flows overview"},"content":{"rendered":"\n

La sezione Design consente di definire e personalizzare il comportamento dell\u2019agente virtuale, configurando le diverse tipologie di servizi e tecnologie da integrare all\u2019interno del flusso di processo che parte dalla richiesta, testuale o vocale, dell\u2019utente finale e si conclude con la risposta fornita dall\u2019agente virtuale.<\/p>\n\n\n\n

Per rendere possibile ci\u00f2, viene messa a disposizione un\u2019area di lavoro in cui posizionare e configurare singoli componenti da integrare e alcune sezioni specifiche che permettono di attivare e personalizzare comportamenti a livello di singoli intenti.<\/p>\n\n\n\n

L\u2019area di lavoro della sezione Process Flows consente di definire i singoli step del processo di elaborazione della richiesta inviata dall\u2019utente finale all\u2019agente virtuale, posizionare singoli elementi atomici, denominato connettori, i quali permettono di invocare specifici servizi, sistemi o tecnologie.<\/p>\n\n\n\n

Ogni flusso di elaborazione prende il nome di journey<\/em>, a cui pu\u00f2 essere associata un singolo motore di NLU (es. Dialogflow) e un numero arbitrario di connettori che verranno processati nell\u2019ordine in cui vengono disposti all\u2019interno dell\u2019area di lavoro (dall\u2019alto verso il basso) ogni volta che l\u2019agente virtuale viene invocato.<\/p>\n\n\n\n

Come creare una nuova journey<\/h3>\n\n\n\n

Per definire una nuova journey \u00e8 necessario selezionare il bottone posto nella barra inferiore dell\u2019area di lavoro e specificare un nome che identifichi la journey stessa ed un\u2019eventuale descrizione.<\/p>\n\n\n\n

Inoltre \u00e8 necessario stabilire se tipologia di journey che si intende creare, abilitando o meno la configurazione come \u201cFulfillment Journey\u201d e se tale journey possa essere o meno invocata dall\u2019esterno (\u201cPublic\u201d).<\/p>\n\n\n\n

Una journey non \u201cPublic\u201d potr\u00e0 essere invocata e testata unicamente all\u2019interno della piattaforma Tellya (tale configurazione pu\u00f2 essere modificata anche in seguito).<\/p>\n\n\n\n

Creazione di una Fulfillment Journey<\/h4>\n\n\n\n

In determinate progettualit\u00e0, Tellya non deve frapporsi tra il Front End ed il motore di NLU, ma bens\u00ec dovr\u00e0 posizionarsi e agire solo in seguito all\u2019interrogazione di tale motore. Sar\u00e0 quindi un sistema esterno ad invocare il motore di NLU, il quale a sua volta dovr\u00e0 invocare Tellya in modo da effettuare eventuali attivit\u00e0 di processing configurate all\u2019interno della journey.<\/p>\n\n\n\n

Per rendere possibile questo comportamento \u00e8 necessario creare una \u201cFulfillment Journey\u201d, abilitato tale opzione in fase di creazione di una “Standard Journey”.<\/p>\n\n\n\n

Una \u201cStandard Journey\u201d non pu\u00f2 essere convertita in \u201cFulfillment Journey\u201d dopo la sua creazione e non \u00e8 neanche possibile il viceversa: \u00e8 necessario eliminare la journey e crearne una nuova.<\/p>\n\n\n\n

Configurazione di una Fulfillment Journey<\/h4>\n\n\n\n

Dopo aver creato una Fulfillment Journey \u00e8 necessario procedere alla sua configurazione selezionando l\u2019agente che invocher\u00e0 tale journey.<\/p>\n\n\n\n

Tale configurazione pu\u00f2 essere eseguita selezionando l\u2019alert che viene mostrato nella parte superiore dell\u2019area di lavoro (\u201cFulfillment Journey\u201d) quando in una Fulfillment Journey non \u00e8 stato ancora configurato un agente, oppure selezionando l\u2019icona dell\u2019ingranaggio posta in basso a destra e successivamente la sezione \u201cFulfillment\u201d della finestra visualizzata.<\/p>\n\n\n\n

In questa sezione si trovano l\u2019url da chiamare e l\u2019apiKey che vanno inseriti nell\u2019agente al momento della configurazione.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

L\u2019agente associato ad una Fulfillment Journey pu\u00f2 essere modificato in qualasisi momento, scegliendo tra quelli previsti all\u2019interno del proprio account Tellya.<\/p>\n\n\n\n

Dialogflow ES<\/h5>\n\n\n\n

Se si utilizza Google Dialogflow ES come motore di NLU \u00e8 necessario accedere alla console<\/a> e configurare nella sezione \u201cFulfillment\u201d le informazioni relative al Webhook, in particolare URL e l\u2019apiKey della journey che si desidera invocare.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Nel caso in cui si utilizzino delle API Beta di DIalogflow bisogna disabilitarle per poter utilizzare la Fulfillment Journey. <\/p>\n\n\n\n

Dialogflow CX<\/h5>\n\n\n\n

Se si utilizza Google Dialogflow CX come motore di NLU \u00e8 necessario accedere alla console<\/a> e configurare nella sezione \u201cWebhooks\u201d le informazioni relative al Webhook, in particolare URL e l\u2019apiKey della journey che si desidera invocare.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Per entrambe le configurazioni si possono inserire come Headers opzionali:<\/p>\n\n\n\n