Riutilizzo di variabili tra gli argomenti
Per impostazione predefinita, è possibile usare il valore di una variabile solo nell'argomento in cui si crea la variabile stessa. Ad esempio, se si crea una variabile UserCity in un argomento Controlla meteo, è possibile includerla solo in elementi quali i nodi dei messaggi all'interno dell'argomento Controlla meteo. Si tratta in questo caso di variabili Argomento (ambito limitato). Tuttavia, potrebbero verificarsi scenari in cui si desidera usare lo stesso valore in più argomenti. Gli agenti possono ricordare il contesto di una variabile quando le conversazioni si estendono su più argomenti. Ad esempio, in un argomento Benvenuto potrebbero essere richiesti il nome e l'indirizzo e-mail del cliente. Quando la conversazione passa a un altro argomento, ad esempio Prenotazione appuntamenti, potrebbe essere utile che l'agente ricordi il nome e l'indirizzo e-mail del cliente. In Microsoft Copilot Studio queste variabili sono indicate come Variabili globali e sono accessibili da qualsiasi argomento nell'agente.
Le variabili globali si applicano soltanto durante la sessione di chat corrente. Non possono essere trasferite da una sessione di chat del cliente a un'altra. È possibile specificare quali variabili devono essere trattate come variabili globali per distinguerle dalle variabili a livello di argomento.
Creazione di una variabile globale
Per definire una variabile come globale, selezionare la variabile direttamente da un nodo o nel menu Variabili nella barra dei menu superiore. In genere, si passa al nodo Domanda che per primo fa riferimento alla variabile con la quale si desidera lavorare.
Nel riquadro Proprietà variabili, nella sezione Utilizzo, selezionare Globale (qualsiasi argomento può accedere). Al nome della variabile viene assegnata la stringa di prefisso Global per differenziarla dalle variabili a livello di argomento.
Ad esempio, la variabile UserName viene ora visualizzata come Global.UserName. Quando si converte una variabile di argomento in una variabile globale, accertarsi che il nome della variabile sia univoco in tutti gli argomenti. In caso di conflitto, è necessario rinominare la variabile prima di salvare la modifica.
Per altre informazioni, consultare Utilizzare le variabili globali tra gli argomenti all'interno di un agente.
Impostazione di variabili globali
Una volta creata, una variabile globale è disponibile per tutti gli argomenti. Mentre si lavora con un nodo di domanda o messaggio, selezionare il pulsante {x} e spostarsi nella scheda Personalizzato. Viene visualizzato un elenco di tutte le variabili disponibili nell'argomento corrente. Le variabili sono elencate in ordine alfabetico e raggruppate in base al tipo di Utilizzo, ad es. Globale e Argomento.
Quando si usa un nodo condizione, un nodo azione flusso o un nodo competenza, vengono visualizzate anche tutte le variabili globali.
Gestione delle variabili globali
Quando si crea una variabile globale da usare in più argomenti, è essenziale capire dove viene applicata. Si può individuare facilmente il punto in cui è stata inizialmente definita la variabile controllando Riferimento e identificare altri argomenti che la usano selezionando Visualizza tutti i riferimenti. Questa funzionalità è particolarmente utile quando si sviluppa un nuovo agente o si gestiscono più variabili all'interno di rami argomento complessi.
La sezione Riferimenti fornisce due opzioni principali:
Riferimento: mostra dove è attualmente definita la variabile.
Visualizza tutti i riferimenti: elenca tutti gli argomenti e i nodi in cui viene usata la variabile, con la possibilità di spostarsi direttamente in ciascun nodo e argomento di riferimento.
Impostazione del valore di una variabile globale da origini esterne
È possibile impostare una variabile globale da inizializzare con un'origine esterna. Ciò consente all'agente di avviare la conversazione con un contesto.
Ad esempio, un cliente apre una chat dal sito Web. Se l'utente ha effettuato l'accesso al sito Web, il nome del cliente è già noto. Passando tali informazioni all'agente prima di iniziare la conversazione, questo può avere una conversazione più intelligente con il cliente senza dover chiedere nuovamente il suo nome.
È possibile specificare che una variabile può ottenere i suoi valori da un'origine esterna. Aprire il riquadro Proprietà variabile, quindi, nella sezione Utilizzo, selezionare la casella Le origini esterne possono impostare valori.
Per altre informazioni sull'uso di variabili globali, consultare Riutilizzo di variabili tra gli argomenti.