La maggior parte dei modelli della categoria Messaggistica utente si basa sul componente Risposta comune, che consente di utilizzare le proprietà e i metadati dei componenti per creare un'interfaccia utente specializzata che può includere testo, pulsanti di azione, immagini e schede.

In molti casi, ad esempio i modelli della sottocategoria Visualizza messaggi multimediali, le principali differenze si trovano nella proprietà Metadati per il componente Risposta comune.

In altri casi, ad esempio nella sottocategoria Visualizza tabelle e form, il modello è costituito da un componente Risposta comune preceduto da un componente Imposta variabile.

Nella sottocategoria Funzioni specifiche del canale sono disponibili esempi di utilizzo delle estensioni per i canali Slack e Microsoft Teams.

Il componente Feedback utente consente di raccogliere dati di feedback per Insight presentando agli utenti una scala di rating dopo il completamento di un flusso transazionale. Gli utenti non possono modificare il rating perché il componente Feedback utente non consente l'input fuori ordine. Se si utilizza l'SDK 21.10 o versione successiva, questo componente genera un sistema di classificazione a stelle orizzontale.

Sebbene sia possibile modificare il funzionamento di questo componente utilizzando le proprietà del componente, è possibile modificarne l'aspetto quando si utilizza SDK (versione 21.10 o successiva). Ad esempio, è possibile sostituire le icone a stella predefinite utilizzate per i pulsanti di feedback con un'altra icona.

Questo componente può restituire le seguenti azioni:

Per i messaggi generati dagli stati di transizione è possibile utilizzare le variabili di sistema indicate di seguito.

• system.userFeedbackRating: restituisce la valutazione dell'utente.
• system.userFeedbackText: quando enableTextFeedback è impostato su true, lo skill può richiedere un feedback quando i rating sono inferiori al valore threshold. system.userFeedbackText restituisce l'input dell'utente (${system.userFeedbackText.value}).

Il testo di visualizzazione standard del componente viene memorizzato nelle voci del bundle di risorse. Queste voci bundle dispongono di testo predefinito, ma è possibile personalizzarle. Di seguito sono riportate le voci per questo componente.

Copia i valori da una variabile a un'altra.

Le definizioni di queste proprietà non devono necessariamente specularsi a vicenda. Sebbene sia possibile definire variabili sia di destinazione che di origine come elenchi di variabili, è anche possibile definire la variabile di origine con una singola variabile e la destinazione come elenco. Se si imposta una variabile di destinazione aggiuntiva, eredita il valore variabile del valore di origine corrente specificato.

Questo componente reimposta i valori delle variabili specificate su null.

Il componente Imposta variabile imposta il valore di una variabile predefinita.

Il componente Rileva lingua utilizza il servizio di traduzione per rilevare la lingua dell'utente dall'input dell'utente.

Questo componente imposta una variabile denominata profile.languageTag con la stringa delle impostazioni nazionali. È possibile impostare le variabili con la lingua corrente quando si utilizza questa variabile in un'espressione di valore (${profile.languageTag}).

Questo componente invia il testo specificato al servizio di traduzione dello skill e quindi memorizza la traduzione in inglese. Si basa sulla competenza configurata con un servizio di traduzione, che riconosce la lingua dall'input dell'utente e la traduce in inglese. Questo componente non funziona con gli skill che utilizzano la modalità lingua supportata in modo nativo.

Utilizzare questo componente quando è necessario elaborare il testo di input raw prima di tradurlo. Ad esempio, potresti voler rimuovere alcuni dati personali dall'input dell'utente prima di inviarli al servizio di traduzione.

Poiché questo componente utilizza il servizio di traduzione, che rileva già la lingua dell'utente, questo componente non deve seguire gli stati che rilevano o impostano la lingua.

Il componente Traduci output consente di tradurre il testo specificato nella lingua dell'utente. Il componente assume il valore definito per la proprietà Espressione. Utilizza il servizio di traduzione dello skill per tradurre il testo nella lingua rilevata dal componente Rileva lingua o dalla variabile profile.locale, quindi lo memorizza nella variabile specificata dalla proprietà Variabile.

Questo componente non funziona con gli skill che utilizzano la modalità lingua supportata in modo nativo.

Il componente Corrispondenza entità chiama il modulo di gestione degli intenti per estrarre le informazioni sull'entità dal testo contenuto nella proprietà Variabile di origine. Se esiste una corrispondenza per il tipo di entità della variabile, la variabile specificata dalla proprietà Variabile viene impostata con questo valore di entità.

Questo componente ha anche due transizioni predefinite: match e nomatch.

Utilizzare questo componente per ottenere il codice di autorizzazione per i servizi protetti dal flusso di concessione del codice di autorizzazione, ad esempio LinkedIn, Twitter, Google o Microsoft. I componenti personalizzati dello skill possono scambiare il codice di autorizzazione per un token di accesso, che vengono quindi utilizzati per richiamare il servizio finale.

Il componente indirizza innanzitutto l'utente alla pagina di login del provider di identità. Dopo un login riuscito, il componente restituisce il codice di autorizzazione in una variabile, utilizzato per passare il codice di autorizzazione al componente personalizzato. L'API del componente personalizzato deve scambiare il codice di autorizzazione, l'ID client e il segreto client per un token di accesso utente OAuth.

Per ogni stato che richiede l'autorizzazione prima di poterla richiamare, è necessario impostare l'impostazione Richiede autorizzazione su True. Per la procedura di impostazione, vedere Autorizzazione utente.

${(system.message.channelConversation.channelType=='twilio')?then('false','true')}

Questo componente può restituire le seguenti azioni:

Il testo di visualizzazione standard del componente viene memorizzato nelle voci del bundle di risorse. Queste voci bundle dispongono di testo predefinito, ma è possibile personalizzarle. Di seguito sono riportate le voci per questo componente.

Fare riferimento alla sezione Modifica di una voce di bundle di risorse per la procedura di modifica del messaggio predefinito per una voce di bundle di risorse.

Quando il motore della finestra di dialogo rileva questo componente, il bot delle competenze richiede all'utente due collegamenti: Login e Annulla.

Descrizione dell'immagine fb-oauth.png

Esistono diversi modi per eseguire la transizione da questo componente:

• L'utente fa clic sul pulsante Annulla e il componente passa allo stato indicato dall'azione fail.

• L'utente non fa clic su alcun pulsante, ma immette testo. Il componente passa allo stato denominato dall'azione textReceived.

• L'utente fa clic sul collegamento di login e il canale visualizza la pagina di login del provider di identità o la relativa finestra di dialogo di autenticazione come vista Web, come mostrato nell'esempio riportato di seguito. Dopo l'autorizzazione riuscita, il componente passa allo stato denominato dall'azione pass (o allo stato successivo se non è presente un'azione pass), che in genere richiama un componente personalizzato che scambia il codice di autorizzazione per un token di accesso.

Descrizione dell'immagine webview-login.png

Se la finestra di test non visualizza la vista Web, tagliare e incollare il testo del collegamento nel browser.

Utilizzare questo componente per ottenere un token di accesso utente OAuth2 (codice autorizzazione tipo di concessione) per le risorse protette da OCI IAM, Oracle Access Manager (OAM), dalla piattaforma di identità Microsoft o dall'autorizzazione Google OAuth 2.0. Questo componente completa tutti i passi per il flusso OAuth2 a 3 fasi e restituisce il token di accesso OAuth2.

Per ogni stato che richiede l'autorizzazione prima di poterla richiamare, è necessario impostare l'impostazione Richiede autorizzazione su True. Per la procedura di impostazione, vedere Autorizzazione utente.

Se è necessario ottenere un token di accesso di tipo Credenziali client per accedere alle risorse client, vedere OAuth 2.0 Client.

Per poter utilizzare questo componente in uno skill, è necessario eseguire i task riportati di seguito.

1. Se non è già stata registrata, registrare il client con il provider di identità come descritto nella sezione Registrazione provider di identità.
2. Aggiungere un servizio di autenticazione per il provider di identità, come descritto in Servizi di autenticazione.

Alcuni provider di identità emettono token di aggiornamento. Quando si utilizza questo componente, Digital Assistant memorizza il token di aggiornamento per il periodo di conservazione specificato per il servizio di autenticazione. Il backend di Digital Assistant può utilizzare il token di aggiornamento, se disponibile, per ottenere un nuovo token di accesso senza che l'utente debba eseguire di nuovo l'accesso.

${(system.message.channelConversation.channelType=='twilio')?then('false','true')}

Questo componente può restituire le seguenti azioni:

Il testo di visualizzazione standard del componente viene memorizzato nelle voci del bundle di risorse. Queste voci bundle dispongono di testo predefinito, ma è possibile personalizzarle. Di seguito sono riportate le voci per questo componente.

Fare riferimento alla sezione Modifica di una voce di bundle di risorse per la procedura di modifica del messaggio predefinito per una voce di bundle di risorse.

Quando il motore della finestra di dialogo incontra il componente, il bot skill richiede all'utente due collegamenti: Ottieni un token di accesso e Annulla (è possibile utilizzare linkLabel e cancelLabel per modificare il testo del collegamento).

Se l'utente fa clic sul collegamento per ottenere un token di accesso, visualizza la pagina di login o la finestra di dialogo di autenticazione del provider di identità, come specificato dal servizio di autenticazione. Dopo aver eseguito correttamente il login, ottiene il token di accesso, imposta i valori per le variabili identificate da accessTokenVariableName e authenticatedUserVariableName, quindi passa allo stato denominato dall'azione pass o allo stato successivo se non esiste un'azione pass. Se l'utente annulla l'operazione di postback viene impostata su fail. Se l'utente immette testo, restituisce l'azione textReceived.

Come accennato in precedenza, è possibile impostare requiresAuthorization per uno stato per assicurarsi che l'utente sia autorizzato prima di richiamare il componente dello stato. Se l'utente non ha ancora ricevuto l'autorizzazione, la finestra di dialogo richiama l'evento Autorizza utente.

Utilizzare questo componente per ottenere un token di accesso OAuth2 del tipo di privilegio Credenziali client. Cioè, lo usi per ottenere un token di accesso basato sulle credenziali del client, e non sul nome e sulla password dell'utente. È possibile utilizzare questo componente per ottenere un token che abilita l'accesso alle risorse client protette da Oracle Identity Cloud Service o Oracle Access Manager (OAM).

Se è necessario accedere alle risorse per conto di un utente, vedere OAuth Collegamento account 2.0 e OAuth Collegamento account.

Per poter utilizzare questo componente in uno skill, è necessario eseguire i task riportati di seguito.

1. Se non è già stata registrata, registrare il client con il provider di identità come descritto nella sezione Registrazione provider di identità.
2. Aggiungere un servizio di autenticazione client-credenziali per il provider di identità, come descritto in Authentication Services.

Questo componente non ha azioni. Per gestire i problemi di sistema che potrebbero verificarsi, aggiungere una transizione successiva che passa a uno stato in grado di gestire tali errori.

Utilizzare questo componente per revocare tutti i token di aggiornamento e accesso utente dell'utente collegato dal provider di identità rappresentato dal servizio di autenticazione. Rimuove inoltre i token di aggiornamento dal database. Per utilizzare questo componente, è necessario fornire l'URL del token di aggiornamento di revoca del provider di identità nell'interfaccia utente del servizio di autenticazione.

Lo skill deve includere uno stato che utilizza il componente OAuth 2.0 Collegamento account per lo stesso servizio di autenticazione e deve essere richiamato prima dello stato che utilizza questo componente.

Questo componente può restituire l'azione seguente:

Utilizzare questo componente per cambiare gli stati in base a un valore variabile.

Questo componente determina un percorso di esecuzione mediante la risoluzione di una variabile o di un'espressione e quindi l'attivazione di un'azione di transizione corrispondente mappata a uno stato nel flusso.

È possibile definire e mappare le azioni di transizione nella scheda Transizioni della finestra di ispezione delle proprietà.

Questo componente consente di richiamare un flusso figlio dal flusso corrente, eventualmente passando i parametri di input. Quando il flusso figlio viene completato, restituisce un'azione e parametri di output facoltativi al relativo flusso padre.

Le azioni di transizione che possono essere impostate dipendono dalle azioni impostate nel componente Fine flusso del flusso figlio.

Questo componente consente di chiamare un flusso di skill diverso, eventualmente passando i parametri di input. Quando il flusso chiamato viene completato, restituisce un'azione e parametri di output facoltativi al flusso chiamante.

Prima di utilizzare questo componente, è necessario che nello skill che si sta chiamando sia disponibile un flusso pubblico. Vedere Richiama un'altra competenza da un flusso.

ParamName: ParamValue

Questo componente viene utilizzato per terminare in modo esplicito un flusso.

Quando viene raggiunto questo stato, tutte le variabili del flusso vengono cancellate e il controllo viene restituito al flusso padre (o, se non esiste un flusso padre, il flusso principale).

Non è necessario specificare uno stato Fine flusso per un flusso se non è necessario restituire parametri o azioni dal flusso a un flusso padre o al flusso principale.

Questo modello è costituito dai componenti Avvio agente e Conversazione agente. Questi componenti vengono utilizzati insieme per trasferire la conversazione di uno skill a un agente di Oracle B2C Service.

• Il componente Agent Initiation avvia l'handshake con il canale di integrazione agente specificato dalla proprietà Agent Integration Channel del componente.
• Il componente Conversazione agente gestisce l'interscambio tra lo skill e l'agente attivo.

Questo modello si riferisce alle conversazioni che hanno origine nello skill. Non utilizzare questo modello per le conversazioni che hanno origine nella chat di Oracle B2C Service, come descritto in L'assistente digitale come struttura agente in azione.

Il componente Trasferimento agente viene utilizzato negli assistenti digitali DA-as-agent per trasferire la conversazione al servizio chat. La conversazione verrà instradata a un agente reale in base alle regole di chat configurate nel servizio chat.

Questo componente si riferisce alle conversazioni che hanno origine in una chat di servizio, come descritto in Digital Assistant come framework agente in azione. Per le conversazioni che hanno origine nello skill, utilizzare invece il modello Comunicazione agente.

È possibile utilizzare il componente Condizione trasferimento agente negli assistenti digitali DA-as-agent per determinare se gli agenti sono disponibili e, in caso affermativo, il tempo di attesa previsto.

Le proprietà del componente vengono utilizzate per specificare le condizioni di trasferimento e restituisce un'azione che indica se le condizioni sono state soddisfatte. Inoltre, imposta i valori della variabile mappa denominata.

Di seguito è riportata la struttura del valore di Variabile stato disponibilità agente e le informazioni memorizzate in tale variabile.

queueId (integer, optional): The engagement queue ID,
expectedTotalWaitSeconds (integer, optional): Expected wait time in the queue in seconds
        ( -1 if there's inadequate information, zero or greater otherwise ).,
expectedWaitSeconds (integer, optional): The number representing the "ss" segment of the expected wait time of format mm:ss 
        ( -1 if there's inadequate information, zero or greater otherwise ).,
expectedWaitMinutes (integer, optional): The number representing the "mm" segment of the expected wait time of format mm:ss 
        ( -1 if there's inadequate information, zero or greater otherwise ).,
availableAgentSessions (integer, optional): Total number of sessions available across all agents.,
totalAvailableAgents (integer, optional): Total number of agents whose status is available.,
totalUnavailableAgents (integer, optional): Total number of agents whose status is unavailable.,
totalAgentsRequestingNewEngagement (integer, optional): Total number of agents who are available and have capacity.
outsideOperatingHours (boolean, optional): True if outside operating hours. False if inside operating hours.,
engagementsInQueue (integer, optional): The number of engagements currently in the queue.
sessionId (string, optional): The session ID.,
clientId (integer, optional): The client ID.

This might take {minutes, plural,
     =-1 {}
     =0 {}
     =1 {1 minute and }
     other {# minutes and }
}{seconds, plural,
     =-1 {a while}
     =0 {{minutes, plural,
          =0 {a short wait time}
          other {0 seconds}
        }}
     =1 {1 second}
     other {# seconds}
} to connect. Are you willing to wait?

Utilizzare questo componente per inviare una richiesta HTTP a un endpoint REST configurato nelle impostazioni dei servizi API.

Di seguito sono riportate le proprietà dei componenti.

Il componente restituisce le azioni riportate di seguito.

Per ulteriori informazioni, vedere Accedi ai backend utilizzando il componente di servizio REST.

Utilizzare questo componente per cercare informazioni su un determinato termine di ricerca in Oracle B2C Service Knowledge Foundation o Oracle Fusion Service Knowledge Management e visualizzare i risultati.

Per Oracle B2C Service, i risultati della ricerca dipendono dal fatto che le risposte siano pubbliche e dalle impostazioni del livello di accesso, del prodotto o della categoria.

Si noti che è necessario creare un servizio di ricerca knowledge prima di poter utilizzare questo componente. Vedere Aggiungere un servizio di ricerca knowledge.

Di seguito sono riportate le proprietà del componente Ricerca knowledge:

Utilizzare il modello Creazione incidente per creare un report incidenti in una sede del servizio clienti. Si noti che è necessario creare un'integrazione del servizio clienti dalla pagina Impostazioni > Servizi aggiuntivi > Integrazione del servizio clienti prima di poter utilizzare questo componente nell'istanza.

Utilizzare questo componente per accedere a un'intervista Oracle Intelligent Advisor da uno skill.

Per poter utilizzare questo componente, è necessario creare un'integrazione del servizio di Intelligent Advisor. Vedere Aggiungere un servizio Intelligent Advisor. Inoltre, l'intervista deve essere stata distribuita in Intelligent Advisor Hub e attivata nel canale del servizio di chat. L'intervista deve essere per utenti anonimi. Impossibile accedere alle interviste per gli utenti del portale o degli agenti.

È possibile utilizzare le proprietà del componente per specificare le impostazioni dell'intervista riportate di seguito.

• Se visualizzare i titoli e la spiegazione
• Le etichette per i pulsanti Sì, No e Non certo
• Le stringhe immesse dall'utente per reimpostare, tornare alla domanda precedente (annullare) e uscire dall'intervista
• Il testo da visualizzare alla fine dell'intervista
• Come esprimere la domanda se visualizzare la spiegazione
• La stringa immessa dall'utente per indicare che il caricamento dei file è stato completato
• Valori degli attributi e parametri del connettore da passare all'intervista
• Impostazioni nazionali progetto da utilizzare

Il componente Vista Web apre una vista Web all'interno dello skill o per gli skill eseguiti in un canale Web in una scheda del browser.

Questo componente consente di inviare una notifica a un utente quando si è verificato un evento basato su cloud di tipo registrato in Oracle Digital Assistant. Per informazioni sulla registrazione dei tipi di evento e sulla configurazione di un assistente digitale per l'utilizzo dell'evento, vedere Eventi esterni.

Questo componente viene utilizzato per pubblicare esternamente un evento basato su cloud di tipo registrato in Oracle Digital Assistant. Per informazioni sulla registrazione dei tipi di evento e sulla configurazione di un assistente digitale per la pubblicazione e il consumo di eventi, vedere Eventi esterni.

Di seguito è riportato un payload di esempio che può essere utilizzato come valore per la proprietà Data.

{
    "size": "Large",
    "type": "Veggie"
}

        "system.postbackActions": {
          "small": {
            "postback": {
              "variables": {
                "size": "Small"
              },
              "system.botId": "44F2405C-F317-4A3F-8250-617F54F01EA6",
              "action": "Small",
              "system.state": "size"

A questo punto, il sistema confronta la proprietà system.state nel payload dell'azione di postback in entrata con lo stato corrente. Quando i due elementi non corrispondono più, lo skill esegue una transizione che può, a seconda della modalità di configurazione del flusso della finestra di dialogo, soddisfare la richiesta dell'utente o negarla.

È possibile modificare il funzionamento predefinito della gestione dei messaggi fuori ordine mappando l'evento di transizione del sistema Messaggio fuori ordine a un componente Flusso di richiamo che richiama un flusso fornito per la gestione dei messaggi fuori ordine.