Componenti
Gli stati di un flusso di finestre di dialogo si basano su componenti che eseguono azioni quali l'accettazione dell'input utente, la verifica dell'input o la risposta con testo.
Esistono due tipi di componenti che è possibile utilizzare in un flusso di finestre di dialogo: componenti integrati e componenti personalizzati. Quando Dialog Engine entra in uno stato nel flusso della finestra di dialogo, valuta il componente. Quando incontra uno dei componenti incorporati, esegue uno dei task generici, ad esempio la visualizzazione di un messaggio o la richiesta all'utente di immettere testo. Quando Dialog Engine rileva un componente personalizzato, chiama il servizio del componente, che ospita uno o più componenti personalizzati.
Componenti incorporati
Digital Assistant fornisce un set di componenti che supportano una serie di azioni generiche, che è possibile utilizzare in qualsiasi competenza: sicurezza, analisi dell'input utente, instradamento del flusso della finestra di dialogo in base all'input dell'utente e output delle risposte dello skill in vari modi. A meno che non sia necessario integrarsi con i backend o eseguire una logica estremamente complessa, questi componenti forniranno le azioni necessarie agli stati.
Il modo in cui si accede ai componenti dipende dal fatto che si stia progettando il flusso di dialogo con Visual Flow Designer o in modalità YAML:
- Se si utilizza Visual Flow Designer, è possibile aggiungere il primo stato di un componente incorporato a un flusso passando il puntatore del mouse sulla casella Avvia, facendo clic sul menu
, selezionando Aggiungi stato iniziale e quindi selezionando un modello di componente dalla finestra di dialogo Aggiungi stato. È possibile aggiungere stati successivi selezionando Aggiungi stato dal menu di uno stato oppure facendo clic sull'icona Aggiungi stato a questa transizione tra due stati. Vedere Progettazione flussi.
- Se si sta progettando lo skill in modalità YAML, aggiungere uno stato per un componente incorporato al flusso della finestra di dialogo selezionando + Componenti e quindi selezionando un modello di componente dal menu.
Quando si convalida il flusso della finestra di dialogo, Digital Assistant verifica le proprietà del componente. Ad esempio, verrà segnalato se si è dimenticato di includere una proprietà obbligatoria.
Per i dettagli sui modelli di componente disponibili in Visual Flow Designer, vedere Modelli di componente.
Per informazioni dettagliate sui componenti disponibili in modalità YAML, vedere Componenti incorporati: proprietà, transizioni e uso.
Componenti personalizzati
La maggior parte delle competenze deve integrarsi con i dati provenienti da sistemi remoti o eseguire alcune elaborazioni backend. Ad esempio, potrebbe essere necessario ottenere un elenco di prodotti o salvare le informazioni sull'ordine. Un altro esempio è che potrebbe essere necessario eseguire una logica complessa che non è possibile eseguire utilizzando FreeMarker o un gestore di eventi entità. I componenti personalizzati consentono di eseguire l'integrazione con i backend ed eseguire task non coperti dai componenti integrati.
Per informazioni su come creare un componente personalizzato, vedere Implementare componenti personalizzati. Per informazioni su come aggiungere componenti personalizzati da utilizzare nello skill, vedere Aggiungere package di componenti a una skill. Per ulteriori informazioni su un componente personalizzato aggiunto allo skill, andare alla pagina Componenti dello skill , espandere il servizio componenti e selezionare il componente. Vengono visualizzati il nome, le proprietà e le azioni supportate del componente. Utilizzare queste informazioni per creare lo stato del componente nel flusso della finestra di dialogo.
Suggerimento
Poiché è possibile che i componenti di servizi diversi abbiano lo stesso nome, è possibile anteporre il nome del componente al nome del servizio seguito dai due punti (:
) per assicurarsi di fare riferimento in modo univoco a ogni componente personalizzato utilizzato.
Di seguito è riportato un esempio di stato di un componente personalizzato in un flusso di finestre di dialogo sviluppato in modalità YAML. Il componente hello.world
proviene dal servizio custom
.
start:
component: "custom:helloWorld"
properties:
human: "${human.value}"
transitions:
next: "askAge"
Quando si utilizza il servizio componenti incorporato per ospitare i componenti personalizzati, è possibile accedere ai log delle viste e ai report di arresto anomalo per i componenti dalla pagina Componenti . Selezionare il servizio, quindi fare clic su Diagnostica.
Altre proprietà disponibili per componenti personalizzati in modalità YAML
Quando si sviluppano flussi di dialogo in modalità YAML, è possibile includere queste proprietà nello stato del componente personalizzato oltre alle proprietà definite del componente.
Nome | descrizione; | Richiesto? |
---|---|---|
autoNumberPostbackActions |
Quando è impostata su true , questa opzione antepone i numeri ai pulsanti e alle opzioni di elenco. Anche se questa opzione non è stata impostata su true , è possibile applicare la numerazione automatica agli elementi della scheda quando la configurazione di Abilita numerazione automatica su azioni postback dell'assistente digitale è impostata su true . L'impostazione predefinita è false .
|
N |
insightsEndConversation |
Impostare su true per interrompere la registrazione della conversazione per la generazione di report degli approfondimenti. L'impostazione predefinita è false .
|
N |
insightsInclude |
Specifica se includere lo stato nel report degli approfondimenti. L'impostazione predefinita è true .
|
N |
translate |
Utilizzare questa proprietà per sostituire il valore booleano impostato per la variabile di contesto autotranslate . Se la variabile autotranslate non è stata impostata oppure se è stata impostata su false , è possibile impostare questa proprietà su true per abilitare la traduzione automatica solo per questo componente. Se si imposta la variabile autotranslation su true , è possibile impostare questa proprietà su false per escludere questo componente dalla traduzione automatica. Vedere Servizi di traduzione nelle competenze. Il valore predefinito è il valore della variabile di contesto autotranslate .
|
N |
Queste proprietà non sono disponibili per gli stati nei flussi di dialogo sviluppati con Visual Flow Designer.