Aggiunta delle risposte dell'assistente AI

Modifica online

Questo è un build di prova

Quando viene attivata un'azione, il corpo dell'azione è costituito da una serie di passaggi che compongono la conversazione tra l 'assistente AI e gli utenti. Una parte di ogni fase consiste in ciò che l 'assistente AI comunica al cliente quando la fase viene eseguita.

Per creare la risposta del tuo assistente AI in un solo passaggio, utilizza la sezione "L'assistente dice". Si tratta del testo o del messaggio vocale che l 'assistente AI comunica all'utente in una determinata fase. A seconda della fase, è possibile aggiungere una risposta completa alla domanda dell'utente o porre una domanda successiva.

Puoi inserire una semplice risposta testuale digitando semplicemente il testo che desideri che il tuo assistente AI mostri all'utente. È inoltre possibile aggiungere formattazione e contenuti web, nonché fare riferimento alle informazioni dell'utente utilizzando delle variabili.

Formattazione delle risposte

Utilizzare gli strumenti dell'editor di testo per applicare al testo lo stile dei caratteri, come il grassetto o il corsivo, o per aggiungere collegamenti.

Dietro le quinte, lo stile dei caratteri e la sintassi dei link sono memorizzati in formato Markdown. Se si utilizza l'integrazione della chat web, sono supportati i tag HTML e Markdown. Per ulteriori informazioni, vedere Formattazione di Markdown.

I tag HTML (eccetto i link) vengono rimossi automaticamente dalle risposte di testo inviate alle integrazioni di Facebook, WhatsApp, e Slack, perché questi canali non supportano la formattazione HTML. I tag HTML vengono comunque gestiti nei canali che li supportano (come la chat web) e memorizzati nella cronologia della sessione.

Se si utilizza un'applicazione client personalizzata che non supporta Markdown, non applicare lo stile del testo alle risposte.

Aggiunta e riferimento a variabili

Durante la conversazione, il tuo assistente AI salva le informazioni sotto forma di variabili. Le variabili sono contenitori di valori di dati che diventano disponibili in fase di esecuzione. Il valore di una variabile può cambiare nel tempo. Le variabili comprendono le variabili di azione, che permangono solo durante una determinata azione, e le variabili di sessione, che sono disponibili per qualsiasi azione. Per ulteriori informazioni sulle variabili, consultare la sezione "Gestione delle informazioni durante la conversazione".

Nei risultati forniti dal tuo assistente AI, puoi fare riferimento alle variabili per personalizzare la conversazione o includere informazioni disponibili al momento dell'esecuzione. Per ulteriori informazioni su come fare riferimento alle variabili nelle frasi pronunciate dal tuo assistente AI, consulta la sezione "Utilizzo delle variabili per personalizzare la conversazione ".

Risposte ai test

Per verificare che le risposte dell'assistente AI siano formattate correttamente, puoi utilizzare l'anteprima.

  1. Fare clic sul pulsante Anteprima.

  2. Per avviare l'azione, inserire la prima frase, ad esempio: 'What are your store hours?.

  3. Quando l 'assistente AI risponde, verifica che il messaggio venga visualizzato come previsto, con la formattazione e l'uso delle variabili corretti.

Suggerimenti per l'aggiunta di risposte

  • Utilizza risposte brevi e utili.

  • Nella risposta, rifletti l'intento dell'utente. In questo modo si assicura agli utenti che il bot li capisca o, in caso contrario, si offre loro la possibilità di correggere immediatamente un malinteso.

  • Includere link a siti esterni nelle risposte se la risposta dipende da dati che cambiano frequentemente.

  • Formula attentamente le tue risposte. È possibile cambiare il modo in cui una persona reagisce al sistema in base a come viene formulata la risposta. La modifica di una riga del testo può evitarti di dover scrivere più righe di codice per implementare una soluzione programmatica complessa.

Aggiunta di variazioni

Se i tuoi utenti utilizzano spesso il tuo assistente AI, potrebbero stufarsi di vedere ogni volta gli stessi saluti e le stesse risposte. Puoi aggiungere diverse varianti di risposta in modo che il tuo assistente AI possa rispondere alla stessa richiesta in modi diversi.

Puoi scegliere di ruotare le variazioni di risposta in sequenza o in ordine casuale. Per impostazione predefinita, le risposte vengono ruotate in sequenza, come se fossero scelte da un elenco ordinato.

Per aggiungere variazioni alla risposta:

  1. In Assistant, clicca sull'icona "Aggiungi varianti Aggiungere variazioni di risposta di risposta".

  2. Per il tipo di variazione di risposta, scegliere se ruotare le variazioni di risposta in sequenza o in ordine casuale. Per ulteriori informazioni, vedere Sequenziale o casuale.

Varianti di risposta

  1. Aggiungere ogni variante nel proprio campo. Ad esempio:

Tabella 1. Esempi di variazioni nelle risposte

Numero di risposte

Variante

Risposta 1

Come possiamo aiutarti?

Risposta 2

Cosa posso fare per voi oggi?

Risposta 3

Mi dica in cosa posso aiutarla.

Risposta 4

Posso aiutarla?

  1. Al termine, fare clic su Applica. Le variazioni appaiono come un blocco all'interno della scritta Assistant. È possibile fare clic sull'icona Modifica per aggiornare le variazioni o sull'icona Elimina per rimuovere tutte le variazioni. Inoltre, è possibile aggiungere più serie di variazioni di risposta a un passo.

Variazioni di risposta nell'assistente dice

In ordine sequenziale o casuale

Per il tipo di variazione della risposta, è possibile scegliere Sequenziale o Casuale.

Sequenziale restituisce la prima variazione di risposta la prima volta che viene attivata l'azione, la seconda variazione di risposta la seconda volta che viene attivata l'azione e così via, nello stesso ordine in cui sono state inserite le variazioni. Le risposte vengono restituite nell'ordine seguente quando il nodo viene elaborato:

  • Prima volta:

   How can I help you?

  • Seconda volta:

   What can I do for you today?

  • Terza volta:

   Tell me what I can help with.

  • Quarta volta:

   Can I help you?

Seleziona casualmente la variante la prima volta che viene attivata l'azione e seleziona casualmente un'altra variante la volta successiva, ma senza ripetere consecutivamente la stessa variante. Questo esempio mostra l'ordine in cui potrebbero apparire le risposte:

  • Prima volta:

   Tell me what I can help with.

  • Seconda volta:

   Can I help you?

  • Terza volta:

   How can I help you?

  • Quarta volta:

   What can I do for you today?

Risposte dei media

Oltre alle risposte testuali, è possibile utilizzare altri _tipi di risposta_ per inviare risposte che includono elementi multimediali o interattivi.

L'editor di azioni supporta i seguenti tipi di risposta ai media:

  • Image: incorpora un'immagine nella risposta. Il file immagine di origine deve essere ospitato in un'ubicazione e deve avere un URL che tu possa utilizzare per farvi riferimento. Non può essere un file che viene memorizzato in una directory che non è accessibile pubblicamente.

  • Video: Incorpora un lettore video nella risposta. Il video sorgente deve essere ospitato da qualche parte, sia come video riproducibile su un servizio di streaming video supportato, sia come file video con un URL che si può usare per fare riferimento. Non può essere un file che viene memorizzato in una directory che non è accessibile pubblicamente.

  • Audio: Incorpora un clip audio nella risposta. Il file audio di origine deve essere ospitato da qualche parte e deve avere un URL che si possa usare come riferimento. Non può essere un file che viene memorizzato in una directory che non è accessibile pubblicamente.

  • iframe: Incorpora il contenuto di un sito web esterno, come un modulo o un altro componente interattivo, direttamente all'interno della chat. Il contenuto sorgente deve essere pubblicamente accessibile tramite HTTP e deve poter essere incorporato come elemento HTML iframe .

Le integrazioni di canali diversi hanno funzionalità diverse per la visualizzazione delle risposte dei media. Per vedere quali integrazioni di canale supportano quali tipi di risposta, vedere Supporto dell'integrazione di canale per i tipi di risposta.

Se si desidera definire risposte diverse, personalizzate per canali diversi, è possibile farlo modificando la risposta tramite l'editor JSON. Per ulteriori informazioni, consultare la sezione Destinazione di integrazioni specifiche.

Modificando le risposte nell'editor JSON, si può accedere a più tipi di risposta per gestire interazioni specifiche del canale.

Per ulteriori informazioni su come modificare le risposte utilizzando l'editor JSON, consultare la sezione "Definizione delle risposte tramite l'editor JSON".

Aggiungere una risposta con immagine

Aggiungere una risposta Immagine per visualizzare un'immagine al cliente.

Il tipo di risposta Immagine è supportato dalle seguenti integrazioni di canale:

  • Chat web

  • SMS

  • Slack

  • Microsoft Teams

  • Linkedin

  • WhatsApp

Per aggiungere una risposta di tipo Immagine, completare i seguenti passaggi:

  1. Nel campo " Assistente dice ", clicca sull'icona Immagine Immagine.

  2. Nel campo Source URL, digitare l'indirizzo completo URL dell'immagine ospitata.

L'immagine deve essere in formato " JPEG, " GIF o " PNG. Il file immagine deve essere memorizzato in una posizione pubblicamente indirizzabile da https: URL (ad esempio https://www.example.com/assets/common/logo.png).

Per accedere a un'immagine archiviata su IBM Cloud®Cloud Object Storage, abilita l'accesso pubblico al singolo oggetto di archiviazione dell'immagine, quindi fai riferimento ad esso specificando l'origine dell'immagine con una sintassi simile a questa: https://s3.eu.cloud-object-storage.appdomain.cloud/your-bucket-name/image-name.png.

  1. Specificare facoltativamente un titolo, una descrizione e un testo alt dell'immagine negli appositi campi. Nell'integrazione della chat web, il titolo e la descrizione vengono visualizzati insieme all'immagine.

I riferimenti alle variabili non sono supportati. Alcuni canali di integrazione ignorano i titoli o le descrizioni.

  1. Fare clic su Applica.

Aggiungere una risposta audio

Aggiungere una risposta audio per includere parole parlate o altri contenuti udibili. Nella chat web, una risposta audio viene visualizzata come un lettore audio incorporato. Nell'integrazione telefonica, viene riprodotta una risposta audio al telefono.

Il tipo di risposta Audio è supportato dalle seguenti integrazioni di canale:

  • Chat web

  • Telefono

  • SMS

  • Slack

  • Linkedin

  • WhatsApp

Per aggiungere una risposta audio, completare i seguenti passaggi:

  1. Nel campo " Dice l'assistente ", clicca sull'icona Audio Audio.

  2. Nel campo Sorgente URL, digitare l'indirizzo completo URL del clip audio ospitato:

    • Per collegarsi direttamente a un file audio, specificare URL a un file in qualsiasi formato standard, come MP3 o WAV. Nella chat web, il clip audio collegato viene visualizzato come un lettore audio incorporato.

    • Per collegarsi a un clip audio su un servizio di hosting audio supportato, specificare URL al clip audio. Nella chat web, il clip audio collegato viene visualizzato utilizzando il player incorporabile del servizio di hosting.

Specificare l'indirizzo URL che si desidera utilizzare per accedere al file audio nel browser (ad esempio, https://soundcloud.com/ibmresearch/fallen-star-amped). Non è necessario convertire il sito URL in un formato incorporabile; la chat web lo fa automaticamente.

È possibile incorporare l'audio ospitato sui seguenti servizi:

  1. Specificare facoltativamente un titolo, una descrizione e un testo alt negli appositi campi. Nell'integrazione della chat web, il titolo e la descrizione vengono visualizzati insieme al lettore audio.

I riferimenti alle variabili non sono supportati. Alcuni canali di integrazione ignorano i titoli o le descrizioni.

Aggiungere una risposta video

Aggiungete una risposta video per visualizzare una dimostrazione, una clip promozionale o altri contenuti video. Nella chat Web, una risposta video viene visualizzata come un lettore video incorporato.

Il tipo di risposta Video è supportato dalle seguenti integrazioni di canale:

  • Chat web

  • SMS

  • Slack

  • Linkedin

  • WhatsApp

Per aggiungere una risposta video, completare i seguenti passaggi:

  1. Nel campo "Dice l'assistente ", clicca sull'icona Video Video.

  2. Nel campo Source URL, digitare l'indirizzo completo URL del video ospitato:

    • Per collegarsi direttamente a un file video, specificare URL a un file in qualsiasi formato standard, come MPEG o AVI. Nella chat web, il video collegato viene visualizzato come un lettore video incorporato.

I video in streaming HLS (.m3u8) e DASH (MPD) non sono supportati.

  • Per collegarsi a un video ospitato su un servizio di hosting video supportato, specificare il link URL al video. Nella chat web, il video collegato viene visualizzato utilizzando il player incorporabile del servizio di hosting.

Specificare l'indirizzo URL che si desidera utilizzare per visualizzare il video nel browser (ad esempio, https://www.youtube.com/watch?v=52bpMKVigGU). Non è necessario convertire il sito URL in un formato incorporabile; la chat web lo fa automaticamente.

È possibile incorporare video ospitati sui seguenti servizi:

  1. Specificare facoltativamente un titolo, una descrizione e un testo alt del video negli appositi campi. Nell'integrazione della chat web, il titolo e la descrizione vengono visualizzati insieme al lettore video.

I riferimenti alle variabili non sono supportati. Alcuni canali di integrazione ignorano i titoli o le descrizioni.

  1. Se si desidera scalare il video a una dimensione di visualizzazione specifica, specificare un numero nel campo Altezza base.

Aggiunta di una risposta iframe

Aggiungere una risposta iframe per incorporare il contenuto di un altro sito web direttamente all'interno della finestra di chat come elemento HTML 'iframe. Una risposta iframe è utile se si vuole consentire ai clienti di interagire con un servizio esterno senza lasciare la chat. Ad esempio, si può utilizzare una risposta iframe per visualizzare i seguenti esempi all'interno della chat web:

  • Una mappa interattiva su Google Maps

  • Un sondaggio che utilizza l' SurveyMonkey

  • Modulo per effettuare prenotazioni tramite OpenTable

  • Un modulo per la pianificazione degli appuntamenti che utilizza Calendly

Nella chat web, l'iframe può essere incluso in due modi:

  • Come una scheda di anteprima che descrive il contenuto incorporato. I clienti possono fare clic su questa scheda per visualizzare la cornice e interagire con il contenuto.

  • Inline, cioè all'interno della conversazione. Questa opzione è adatta per i contenuti iframe più piccoli.

Il tipo di risposta iframe è supportato dalle seguenti integrazioni di canale:

  • Chat web

  • Linkedin

Per aggiungere un tipo di risposta iframe, completare i passaggi seguenti:

  1. Nel campo "Assistant says ", clicca sull'icona dell'iframe (iframe).

  2. Aggiungere l' URL completo al contenuto esterno nel campo sorgente dell'iframe.

L'indirizzo URL deve specificare il contenuto che può essere incorporato in un elemento HTML iframe . Siti diversi hanno restrizioni diverse per l'incorporazione di contenuti e processi diversi per la generazione di URL incorporabili. Un elemento incorporabile URL è un elemento che può essere specificato come valore dell'attributo src dell'elemento iframe .

Ad esempio, per incorporare una mappa interattiva che utilizza Google Maps, è possibile utilizzare l'API Embed Google Maps. Per ulteriori informazioni, consulta la panoramica sull'API Maps Embed. Altri siti hanno processi diversi per la creazione di contenuti incorporabili.

Per i dettagli tecnici sull'utilizzo Content-Security-Policy: frame-src della funzione che consente di incorporare i contenuti del sito web nel proprio assistente AI, consultare CSP: frame-src.

  1. Aggiungere facoltativamente un titolo descrittivo nel campo Titolo.

Nella chat Web, il titolo aggiunto viene visualizzato nella scheda di anteprima. Il cliente fa clic sulla scheda di anteprima per visualizzare il contenuto esterno.

Se non si specifica un titolo, la web chat tenta di recuperare i metadati dal sito URL specificato e visualizza il titolo del contenuto secondo le specifiche dell'origine.

I riferimenti alle variabili non sono supportati.

  1. Per mostrare l'iframe nel flusso della conversazione, anziché come scheda di anteprima, impostare Visualizza iframe in linea su On. È anche possibile impostare l'altezza dell'iframe. L'impostazione predefinita è 180 pixel.

Dettagli tecnici: iframe sandboxing

I contenuti caricati in un iframe dalla chat web sono sottoposti a "sandboxing", il che significa che le autorizzazioni sono limitate per ridurre le vulnerabilità di sicurezza. La chat web utilizza sandbox l'attributo iframe dell'elemento per concedere solo le seguenti autorizzazioni:

Autorizzazione

Descrizione

allow-downloads

Consente di scaricare i file dalla rete, se il download viene avviato dall'utente.

allow-forms

Consente l'invio di moduli.

allow-scripts

Consente l'esecuzione di script, ma _non_ l'apertura di finestre pop-up.

allow-same-origin

Consente al contenuto di accedere al proprio archivio dati (come i cookie) e permette un accesso limitato alle API JavaScript.

Uno script eseguito all'interno di un iframe in modalità sandbox non può modificare alcun contenuto al di fuori dell'iframe, _se_ la pagina esterna e l'iframe hanno origini diverse. Fai attenzione se utilizzi una risposta iframe per incorporare contenuti che hanno la stessa origine della pagina in cui è ospitato il tuo widget di chat web. In questa situazione, il contenuto incorporato può sconfiggere il sandboxing e accedere al contenuto esterno alla cornice. Per ulteriori informazioni su questa potenziale vulnerabilità, consultare la documentazione sandbox relativa all'attributo.

Dettagli tecnici: scheda iframe di anteprima

Il tipo di risposta 'iframe nella chat web visualizza la scheda Anteprima, che include un'immagine, un titolo e una descrizione della pagina web che l'utente visita nella chat web.

Per visualizzare un'immagine, un titolo e una descrizione nella scheda Anteprima, la pagina web ha bisogno dei seguenti tag '<meta> all'interno del tag '<head>:

<meta property="og:image" content="https://.../image.jpg" />
<!--or-->
<meta property="og:image:url" content="https://.../image.jpg" />

<meta property="og:title" content="The webpage title" />
<meta property="og:description" content="The webpage description" />

Le proprietà dei metadati qui specificate derivano dal protocollo Open Graph.

I metadati sono facoltativi. La web chat visualizza una scheda di anteprima con l'url della pagina web e i metadati che la web chat ha recuperato con successo.

Risposta alla pausa

Utilizza una risposta "Pausa" per far sì che il tuo assistente IA attenda un intervallo di tempo specificato prima di fornire la risposta successiva. Questa pausa consente di completare la richiesta, oppure agisce come un agente in carne e ossa che fa una pausa tra una risposta e l'altra. La pausa deve avere una durata compresa 0 tra e 60 secondi; è possibile specificare valori decimali per configurare la pausa fino a milliseconds.

La risposta Pause viene solitamente utilizzata in combinazione con altre risposte. Per impostazione predefinita, durante la pausa viene visualizzata un'animazione dell'indicatore di digitazione per simulare un agente in carne e ossa.

Il tipo di risposta Pausa è supportato dalle seguenti integrazioni di canale:

  • Chat web

  • Linkedin

  • WhatsApp

Nel canale telefonico, è possibile inserire una pausa includendo break l'elemento SSML nell'output dell'assistente AI. Per ulteriori informazioni, consultare il Text to Speech documentazione.

Per aggiungere una risposta di pausa:

  1. Nel campo "L'assistente dice ", clicca sull'icona Sospendi Pausa.

  2. Nel campo Durata, inserire la durata della pausa in 'seconds.

La durata non deve essere superiore a '60 seconds. Inoltre, è possibile inserire i decimali di 'second nel campo Durata per mettere in pausa la risposta fino a 'milliseconds. Ad esempio, se si immette " 10.50 seconds, la risposta si ferma per " 10500 milliseconds. In genere i clienti sono disposti ad aspettare circa 8 secondi prima che qualcuno inserisca una risposta.

  1. L'indicatore di digitazione è impostato su On per impostazione predefinita. Se lo si desidera, è possibile impostarlo su Off.

Aggiungi un altro tipo di risposta, ad esempio un tipo di risposta di testo, dopo la pausa per indicare chiaramente che la pausa è terminata.