Usare le variabili globali

1. Creare una variabile o utilizza il pannello Variabili per aprire una variabile esistente.

2. Nel riquadro Proprietà variabili, seleziona Globale (qualsiasi argomento può accedere). Il nome della variabile ottiene il prefisso Global. per distinguerlo dalle variabili a livello di argomento. Ad esempio, la variabile UserName diventa Global.UserName.

3. Salva l'argomento.

1. Selezionare la variabile desiderata.

2. Nel pannello Proprietà variabili, in Uso, seleziona Bot (qualsiasi argomento può accedere).

3. Il nome della variabile ottiene il prefisso bot. per distinguerlo dalle variabili a livello di argomento. Ad esempio, la variabile UserEmail diventa bot.UserEmail.

Quando si compone un messaggio in un nodo Messaggio o in un nodo Domanda , selezionare l'icona {x} per visualizzare le variabili a cui l'argomento può accedere. È anche possibile usare variabili globali nei nodi degli strumenti che chiamano richieste o flussi di lavoro. Le variabili globali vengono visualizzate nella scheda Personalizzata insieme a qualsiasi variabile di argomento. Le variabili sono elencate in ordine alfabetico.

Quando si compone un messaggio in un nodo Messaggio o in un nodo Domanda , selezionare l'icona {x} per visualizzare le variabili a cui l'argomento può accedere. Le variabili sono elencate in ordine alfabetico e tutte le variabili globali vengono visualizzate insieme perché iniziano tutte con bot..

Quando usi un nodo condizione, un nodo azione flusso o un nodo competenza, vedrai le variabili globali disponibili anche lì.

1. Selezionare la variabile globale desiderata nell'area di disegno di creazione o nel pannello Variabili .

2. Nel riquadro Proprietà variabili, nella sezione Riferimento, seleziona Visualizza tutti i riferimenti.

3. Passa alla scheda Altro e seleziona un argomento in cui la variabile viene utilizzata per andare direttamente a quell'argomento e nodo.

Seleziona la variabile desiderata nell'area del contenuto. Viene visualizzato il riquadro Proprietà variabili.

• Per passare direttamente al nodo in cui è stata creata la variabile globale, selezionare Vai all'origine.

• Per passare a un argomento che utilizza questa variabile, seleziona l'argomento desiderato nella sezione Usato da.

Per impostazione predefinita, un valore di variabile globale viene mantenuto fino alla fine della sessione . Il nodo Clear variable values reimposta i valori delle variabili globali. L'argomento di sistema Reset Conversation usa questo nodo. Quando un reindirizzamento attiva l'argomento (o quando l'utente immette una frase, ad esempio "Ricomincia"), tutte le variabili globali vengono reimpostate.

È possibile accedere alle variabili globali da qualsiasi argomento e il relativo valore persiste in una sessione.

Il valore viene cancellato solo quando l'utente agente viene reindirizzato all'argomento di sistema Ricomincia o quando l'utente attiva direttamente questo argomento (ad esempio, digitando "Ricomincia"). In questo caso, tutte le variabili globali verranno reimpostate e non avranno alcun valore.

Inizializzazione della variabile globale

Se una variabile globale viene attivata prima che sia stata inizializzata (o "compilata"), l'agente attiva automaticamente la parte dell'argomento in cui viene definita la variabile globale, anche quando si trova in un argomento diverso, prima di tornare all'argomento originale. Questo comportamento consente all'agente di avere tutte le variabili senza interrompere la conversazione.

Ad esempio, il cliente avvia la conversazione sull'argomento "Prenotazione appuntamento" in cui viene usata la variabile globale bot.UserName. Comunque, la variabile bot.UserName viene prima definita nell'argomento "Benvenuto".

Quando la conversazione giunge al punto nell'argomento "Prenotazione appuntamento" dove si fa riferimento a bot.UserName, l'agente passa facilmente al nodo della domanda dove bot.UserName è definito.

Dopo che il cliente ha risposto alla domanda, l'agente riprende l'argomento "Prenotazione appuntamento".

Comportamento delle variabili globali durante l'implementazione di azioni tramite flussi o competenze Power Automate

A volte, potresti usare un flusso o una competenza per inizializzare o compilare una variabile.

Quando un utente interagisce con l'agente, tuttavia, la variabile potrebbe essere compilata in un punto precedente della conversazione, oppure potresti avere già impostate le variabili esternamente.

In questa situazione, il flusso o la competenza continueranno a essere eseguiti e compileranno la variabile, sovrascrivendo quanto precedentemente memorizzato nella variabile.

Per assicurarsi che l'agente avvii una conversazione con un contesto, usare una variabile globale e impostarne il valore da un'origine esterna. Si supponga che il sito richieda agli utenti di accedere. Se memorizzi il nome di un utente in una variabile globale e lo passi al tuo agente, quest'ultimo può salutare i clienti per nome prima che inizino a digitare la loro prima domanda. Un altro scenario di esempio consiste nel passare il contesto da Dynamics 365 Customer Insights - Journeys a un agente in modo che possa avviare la conversazione con la conoscenza di ciò che il cliente vuole ottenere.

Per evitare la latenza indesiderata, specificare per quanto tempo l'agente può attendere un valore. Puoi inoltre impostare un valore predefinito da utilizzare quando l'origine esterna non risponde in modo tempestivo.

1. Creare un argomento dedicato per contenere la configurazione di tutte le variabili che devono essere impostate da origini esterne. Ad esempio, potresti denominare questo argomento "Imposta variabili di contesto". Questo argomento non ha altri scopi, quindi non è necessario che siano impostate frasi trigger.

2. Aggiungi un nodo Imposta valore variabile all'argomento dedicato.

3. In Imposta variabile, apri il selezionatore della variabile e seleziona Crea una nuova variabile.

4. Seleziona il nome predefinito della nuova variabile. Viene visualizzato il riquadro Proprietà variabili.

5. Sostituire il nome predefinito con uno che corrisponde esattamente al nome della variabile passata dal sistema esterno.

6. In Utilizzo, seleziona Globale (qualsiasi argomento può accedere) e Le origini esterne possono impostare valori.

7. In Riferimento seleziona i tre puntini (⋮) nell'angolo in alto a destra e seleziona Recupera valore da questo nodo se vuoto.

8. (Facoltativo) Impostare un ritardo di timeout, espresso in millisecondi. Questo valore determina il tempo di attesa dell'agente per l'impostazione della variabile da parte di un'origine esterna prima del timeout e della continuazione con il valore predefinito impostato nel nodo Imposta valore variabile. Questa impostazione è rilevante negli scenari in cui la variabile dipende da un processo asincrono o a esecuzione prolungata, ma l'agente deve rispettare una latenza massima per garantire una buona esperienza utente.

   Per le variabili provenienti da Omnichannel per customer service, usare un valore di 10 secondi (10.000 ms) come tempo di attesa massimo.

9. Nel nodo Imposta valore variabile immettere il valore predefinito da usare se viene raggiunto il timeout. In fase di esecuzione, l'agente prevede valori con lo stesso tipo di dati. Se desideri che questo valore predefinito sia una stringa vuota, usa Text("") come formula.

   

10. Per tutti gli altri valori che si prevede provengano da un sistema esterno, aggiungi altri nodi Imposta valore variabile all'argomento dedicato e configura le variabili globali richieste nello stesso modo.

Quando si configura l'agente in questo modo, è pronto per il test. Quando l'agente viene richiamato, invece di attendere indefinitamente che tutte le variabili vengano popolate, l'agente può iniziare immediatamente a inviare tutti i messaggi che non dipendono dalle variabili passate. Quando l'agente tenta di accedere a una variabile impostata esternamente, viene sospesa fino all'arrivo del valore o al timeout. Per altre informazioni, vedere Ottimizzare gli agenti per ridurre al minimo la latenza.

È possibile impostare una variabile globale da inizializzare con un'origine esterna. Questa azione permette all'agente di avviare la conversazione con un contesto.

Ad esempio, un cliente attiva un agente dal sito Web e il sito conosce già il nome del cliente. Consenti all'agente di conoscere il nome dell'utente prima di iniziare la conversazione così che l'agente possa avere una conversazione più intelligente con il cliente senza doverne chiedere di nuovo il nome.

1. Selezionare la variabile globale desiderata.

2. Nel pannello Proprietà variabili, seleziona Le origini esterne possono impostare valori.

Se stai integrando l'agente in una semplice pagina Web, puoi aggiungere variabili e le relative definizioni all'URL dell'agente. Oppure, se desideri un po' più di controllo, puoi utilizzare un blocco di codice <script> per chiamare e utilizzare variabili a livello di codice.

Il nome della variabile nella stringa di query dell'URL deve corrispondere a quello della variabile globale, senza il prefisso Global.. Ad esempio, per una variabile Global.UserName globale usare solo UserName nella query.

Negli esempi seguenti viene usata una dichiarazione di base per le variabili. In uno scenario di produzione, è possibile passare un'altra variabile che archivia già il nome dell'utente(ad esempio, se si ha il nome utente da uno script di accesso) come parametro di query o definizione di variabile.

Aggiungi le variabili e le loro definizioni all'URL dell'agente come parametri della stringa di query (nel formato di botURL?variableName1=variableDefinition1&variableName2=variableDefinition2).

Per esempio:

• Hai una variabile globale denominata Global.UserName.
• L'URL dell'agente è https://web.powerva.microsoft.com/webchat/bots/12345.
• Per indicare il nome utente quando avvii una conversazione di un agente su un sito Web, puoi collegare la UserName= stringa di query come: https://web.powerva.microsoft.com/webchat/bots/12345?UserName=Ana.

Il nome del parametro non fa distinzione tra maiuscole e minuscole: username=Ana funziona anche in questo esempio.

È possibile aggiungere variabili e relative definizioni se si incorpora semplicemente l'agente in una semplice pagina Web. In alternativa, è possibile usare un <script> blocco di codice per chiamare e usare le variabili a livello di codice.

Negli esempi seguenti viene usata una dichiarazione di base per le variabili. In uno scenario di produzione, è possibile passare un'altra variabile che archivia già il nome dell'utente(ad esempio, se si ha il nome utente da uno script di accesso) come parametro di query o definizione di variabile.

1. Aggiungi le variabili e le loro definizioni all'URL dell'agente come parametri della stringa di query (nel formato di botURL?variableName1=variableDefinition1&variableName2=variableDefinition2), ad esempio:

   • Hai una variabile globale denominata bot.UserEmail.
   • L'URL dell'agente è https://web.powerva.microsoft.com/webchat/bots/12345.
   • Per passare il nome utente quando si avvia una conversazione con un agente su un sito web, aggiungere la stringa di query UserEmail= come segue: https://web.powerva.microsoft.com/webchat/bots/12345?UserEmail=Ana@contoso.com.

2. Il nome del parametro non fa distinzione tra maiuscole e minuscole: useremail=Ana@contoso.com funziona anche in questo esempio.

1. Nella sezione <script> della pagina in cui hai l'agente, definisci le variabili come segue, sostituendo variableName1 per il nome della variabile senza il prefisso Global. e variableDefinition1 per la definizione. Separa più variabili con le virgole (,).

      const store = WebChat.createStore({}, ({ dispatch }) => next => action => {
        if (action.type === 'DIRECT_LINE/CONNECT_FULFILLED') {
          dispatch({
             type: "WEB_CHAT/SEND_EVENT",
             payload: {
               name: "pvaSetContext",
               value: {
                  "variableName1": "variableDefinition1",
                  "variableName2": "variableDefinition2"
               }
             },
           });
         }
           return next(action);
       });
   

2. Nella sezione <script>, chiama store quando integri l'agente, come nell'esempio seguente dove store viene chiamato appena prima della chiamata di styleOptions (devi sostituire BOT_ID con il tuo ID):

   const BOT_ID = "12345-5678";
   const theURL = "https://powerva.microsoft.com/api/botmanagement/v1/directline/directlinetoken?botId=" + BOT_ID;
   
   fetch(theURL)
       .then(response => response.json())
       .then(conversationInfo => {
           window.WebChat.renderWebChat(
               {
                   directLine: window.WebChat.createDirectLine({
                       token: conversationInfo.token,
                   }),
                   store,
                   styleOptions
               },
               document.getElementById('webchat')
           );
       })
       .catch(err => console.error("An error occurred: " + err));
   

1. Nella sezione <script> della pagina in cui hai l'agente, definisci le variabili come segue, sostituendo variableName1 per il nome della variabile senza il prefisso bot. e variableDefinition1 per la definizione. Separa più variabili con le virgole ,.

      const store = WebChat.createStore({}, ({ dispatch }) => next => action => {
        if (action.type === 'DIRECT_LINE/CONNECT_FULFILLED') {
          dispatch({
             type: "WEB_CHAT/SEND_EVENT",
             payload: {
               name: "pvaSetContext",
               value: {
                  "variableName1": "variableDefinition1",
                  "variableName2": "variableDefinition2"
               }
             },
           });
         }
           return next(action);
       });
   

2. Nella sezione <script>, chiama store quando integri l'agente, come nell'esempio seguente dove store viene chiamato appena prima della chiamata di styleOptions (devi sostituire BOT_ID con il tuo ID):

   const BOT_ID = "12345-5678";
   const theURL = "https://powerva.microsoft.com/api/botmanagement/v1/directline/directlinetoken?botId=" + BOT_ID;
   
   fetch(theURL)
       .then(response => response.json())
       .then(conversationInfo => {
           window.WebChat.renderWebChat(
               {
                   directLine: window.WebChat.createDirectLine({
                       token: conversationInfo.token,
                   }),
                   store,
                   styleOptions
               },
               document.getElementById('webchat')
           );
       })
       .catch(err => console.error("An error occurred: " + err));