Test del dialogo

Mentre si lavora alla finestra di dialogo, è possibile testarla in qualsiasi momento per vedere come risponde all'input.

Le query inviate tramite il pannello "Prova" generano chiamate API /message, ma non vengono registrate e non comportano costi.

1. Dalla pagina Finestra di dialogo, fare clic su Provalo.

2. Nel riquadro di chat, immetti un testo e premi Invio.

3. Controlla la risposta per vedere se il dialogo ha interpretato correttamente il tuo input e scelto la risposta appropriata.

   La finestra di chat indica quali intenti ed entità sono stati riconosciuti nell'input.

   

4. Per visualizzare gli intenti principali riconosciuti, passa con il mouse sull'icona dell'occhio visualizzata accanto all'intento con il punteggio di confidenza più alto.

5. Se la risposta non è quella che ti aspettavi, puoi eseguire le azioni riportate di seguito dal riquadro "Try it out":

   • Se vuoi modificare un'entità che viene riconosciuta nell'input, fai clic sul nome entità per aprirla nella pagina Entities.
   • Se viene riconosciuto l'intento errato, puoi fare clic sulla freccia accanto al nome intento per correggerlo oppure contrassegnare l'argomento come irrilevante. Per ulteriori informazioni, vedi Apportare dei miglioramenti ai dati di apprendimento.

6. Se si desidera sapere quale nodo della struttura di dialogo ha attivato una risposta, fare clic sull'icona accanto ad esso.

   Il nodo di origine viene attivato e viene evidenziata la rotta utilizzata dal tuo assistente nella struttura ad albero per raggiungerlo. Rimane evidenziata fino a quando non esegui un'altra azione, ad esempio se inserisci un nuovo input di test.

7. Per controllare o impostare il valore di una variabile di contesto, fai clic sul link Gestisci contesto.

   Vengono visualizzate tutte le variabili di contesto definite nel dialogo.

   Inoltre, sono elencate le seguenti variabili di contesto:

   • $timezone: Il riquadro Prova ottiene le informazioni sul locale dell'utente dal browser Web e le utilizza per impostare la variabile di contesto $timezone. Questa variabile di contesto consente di gestire meglio i riferimenti di tempo negli scambi di dialogo di test.
   • $metadata: questa variabile di contesto contiene una coppia nome - valore ID utente. Poiché nessun user_id è specificato per impostazione predefinita nel riquadro Provalo, il conversation_id viene utilizzato come valore user_id. Al runtime, il valore ID viene generalmente passato all'assistente da qualsiasi integrazione che stai utilizzando. Se si progetta un'applicazione personalizzata, impostare questo valore da soli.

   Puoi aggiungere una variabile e impostarne il valore per vedere come il dialogo risponde nel turno di dialogo di test successivo. Questa funzionalità è utile se, ad esempio, il dialogo è configurato per mostrare risposte diverse in base a un valore di variabile di contesto fornito dall'utente.

   1. Per aggiungere una variabile di contesto, specificare il nome della variabile e premere Invio.
   2. Per definire un valore predefinito per la variabile di contesto, individuare la variabile di contesto aggiunta nell'elenco e specificarne il valore.

   Per ulteriori informazioni, vedi Variabili di contesto.

8. Continua a interagire con il dialogo per vedere come fluisce la conversazione.

   • Per trovare e inviare nuovamente un'espressione di test, puoi premere il tasto Su per scorrere i tuoi input recenti.
   • Per rimuovere le espressioni di test precedenti dal riquadro di chat e ricominciare, fai clic sul link Cancella. Questa azione non solo rimuove le espressioni e le risposte di test, ma cancella anche i valori di qualsiasi variabile di contesto impostata in seguito alle tue interazioni con il dialogo.

Ricerca nel dialogo

È possibile effettuare una ricerca nella finestra di dialogo per trovare uno o più nodi di dialogo che menzionano una parola o una frase.

1. Selezionare l'icona Cerca .

2. Immetti una frase o un termine di ricerca.

   La prima volta che si effettua una ricerca, viene creato un indice. Potrebbe venirti richiesto di attendere mentre il testo presente nei tuoi nodi di dialogo viene indicizzato.

Vengono visualizzati i nodi che contengono il tuo termine di ricerca e gli esempi corrispondenti. Seleziona un risultato per aprirlo per la modifica.

Copia di un nodo di dialogo

Puoi duplicare un nodo per crearne una copia esatta come un nodo peer direttamente dopo di esso nella struttura ad albero di dialogo. Al nodo copiato viene assegnato lo stesso nome del nodo originale, ma con l'aggiunta di - copyn, dove n è un numero che inizia con 1. Se si duplica lo stesso nodo più di una volta, il n nel nome aumenta di uno per ciascuna copia per consentire di distinguere le copie l'una dall'altra. Se il nodo non ha nome, viene assegnato il nome copyn.

Quando duplichi un nodo che ha nodi figlio, vengono duplicati anche i nodi figlio. I nodi figlio copiati hanno lo stesso esatto nome dei nodi figlio originali. L'unico modo per distinguere un nodo figlio copiato da uno originale è il riferimento copy nel nome nodo padre.

1. Sul nodo che si desidera copiare, fare clic sull'icona Opzioni Node , quindi selezionare Duplica.

2. Prendi in considerazione di ridenominare i nodi copiati o di modificare le loro condizioni in modo da fare una distinzione.

Spostamento di un nodo di dialogo

Ogni nodo che hai creato può essere spostato altrove nella struttura ad albero di dialogo.

Potresti voler spostare un nodo creato in precedenza in un'altra area del flusso per modificare la conversazione. Puoi spostare i nodi in modo che diventino nodi di pari livello o peer in un altro ramo.

1. Sul nodo che si desidera spostare, fare clic sull'icona Opzioni Node , quindi selezionare Sposta.

2. Seleziona un nodo di destinazione presente nella struttura ad albero vicino a dove vuoi spostare questo nodo. Scegli se posizionare questo nodo prima o dopo il nodo di destinazione o se renderlo un nodo figlio del nodo di destinazione.

Organizzazione del dialogo utilizzando le cartelle

Puoi raggruppare insieme i nodi di dialogo aggiungendoli ad una cartella. I motivi per raggruppare i nodi includono:

• Per conservare insieme i nodi che si riferiscono ad un oggetto simile per facilitarne la ricerca. Ad esempio, puoi raggruppare i nodi che fanno fronte a domande relative agli account utente in una cartella Account utente e i nodi che gestiscono le query relative ai pagamenti in una cartella Pagamenti.
• Per raggruppare un insieme di nodi che la finestra di dialogo deve elaborare solo se viene soddisfatta una determinata condizione. Utilizzare una condizione, come $isPlatinumMember, per raggruppare i nodi che offrono servizi extra che vengono elaborati solo se l'utente corrente ha diritto a ricevere i servizi extra.
• Per nascondere i nodi dal runtime mentre ci lavori. Puoi aggiungere i nodi ad una cartella con una condizione false per impedirne l'elaborazione.

Queste caratteristiche della cartella influiscono sulla modalità di elaborazione dei nodi in una cartella:

• Condizione: se non vengono specificate condizioni, il tuo assistente elabora direttamente i nodi all'interno della cartella. Se viene specificata una condizione, il tuo assistente valuta innanzitutto la condizione della cartella per stabilire se elaborare i nodi contenuti in essa.
• Personalizzazioni: le impostazioni di configurazione che applichi alla cartella vengono ereditate dai nodi presenti nella cartella. Se, ad esempio, modifichi le impostazioni di digressione della cartella, le modifiche verranno ereditate da tutti i nodi presenti nella cartella.
• Gerarchia struttura ad albero: i nodi in una cartella vengono gestiti come nodi root o figlio a seconda del fatto che la cartella sia stata aggiunta alla struttura ad albero di dialogo a livello root o figlio. I nodi a livello root che hai aggiunto ad una cartella a livello root continueranno a funzionare come nodi root; ad esempio, non diventeranno nodi figlio della cartella. Tuttavia, se sposti un nodo a livello root in una cartella che è una cartella figlio di un altro nodo, il nodo root diventa figlio di questo altro nodo.

Le cartelle non influiscono sull'ordine con cui vengono valutati i nodi. I nodi continuano ad essere elaborati dal primo all'ultimo. Quando l'assistente segue l'albero, se la cartella non ha condizioni o se la sua condizione è vera, elabora immediatamente il primo nodo della cartella e prosegue in ordine lungo l'albero. Se una cartella non ha una condizione di cartella, ogni nodo della cartella viene trattato come qualsiasi altro nodo della struttura.

Limiti di nodi del dialogo

Il numero di nodi di dialogo che puoi creare per capacità dipende dal tuo tipo di piano.

I nodi di dialogo welcome e anything_else precompilati nella struttura contano per il totale.

Limite di profondità dell'albero: la finestra di dialogo supporta 2.000 discendenti del nodo di dialogo; la finestra di dialogo funziona meglio con 20 o meno.

Ricerca di un nodo di dialogo per ID nodo

Puoi ricercare un nodo di dialogo in base al suo ID nodo. Immetti l'ID nodo completo nel campo di ricerca. Potresti voler cercare un nodo di dialogo associato a un ID nodo noto per uno dei seguenti motivi:

• Stai riesaminando i log e il log fa riferimento a una sezione del dialogo mediante il suo ID nodo.
• Vuoi associare gli ID nodo elencati nella proprietà nodes_visited dell'output del messaggio API ai nodi che puoi vedere nella tua struttura ad albero di dialogo.
• Un messaggio di errore di runtime del dialogo ti informa di un errore di sintassi e utilizza un ID nodo per identificare il nodo da correggere.

Un altro modo per rilevare un nodo basato sul suo ID nodo è:

1. Dalla pagina Dialog, seleziona un nodo nella tua struttura ad albero di dialogo.

2. Se è aperta, chiudi la vista di modifica per il nodo corrente.

3. Nel campo di localizzazione del browser web dovrebbe essere visualizzato un URL con una sintassi simile a quella dell'esempio seguente:

   https://{location}.assistant.watson.cloud.ibm.com/{location}/{instance-id}/skills/{skill-id}/build/dialog#node={node-id}

4. Modificare l' URL sostituendo il valore attuale di {node-id} con l'ID del nodo che si desidera trovare, quindi inviare il nuovo URL.

5. Se necessario, evidenzia l'URL modificato e invialo di nuovo.

La pagina si aggiorna e sposta lo stato attivo sul nodo di dialogo con l'ID nodo che hai specificato. Se l'ID nodo è per uno slot, una condizione di slot trovato o non trovato, un gestore slot o una risposta condizionale, il nodo in cui è definito lo slot o la risposta condizionale verrà attivato e verrà visualizzato il modale corrispondente.

Se ancora non riesci a trovare il nodo, puoi esportare la capacità di dialogo e utilizzare l'editor JSON per eseguire la ricerca nel file JSON della capacità.