Riutilizzo di variabili tra gli argomenti

Completato

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 una conversazione si estende 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 agente e sono accessibili da qualsiasi argomento nell'agente.

Le variabili agente si applicano 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 agente per distinguerle dalle variabili a livello di argomento.

Creazione di una variabile agente

Per definire una variabile come variabile agente, aprirla nell'area del contenuto. Aprire il nodo Invia una domanda in cui è memorizzata la variabile che si desidera usare. Nel riquadro Proprietà variabili, nella sezione Utilizzo, selezionare Globale (qualsiasi argomento può accedere). Al nome della variabile viene assegnata la stringa di prefisso agent per differenziarla dalle variabili a livello di argomento.

Screenshot delle proprietà della variabile agente.

Ad esempio, la variabile UserName viene ora visualizzata come Global.UserName. Quando si converte una variabile in una variabile agente, assicurarsi 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 delle variabili agente

Una volta creata, una variabile agente è disponibile per tutti gli argomenti. Mentre si lavora con un nodo di domanda o messaggio, selezionare il pulsante {x}. Viene visualizzato un elenco di tutte le variabili disponibili in questo argomento. Poiché le variabili sono organizzate in ordine alfabetico, quindi tutte le variabili agente sono raggruppate nel menu delle variabili, perché iniziano tutte con la parola agent.

Screenshot delle impostazioni della variabile agente.

Quando si usa un nodo condizione, un nodo azione flusso o un nodo competenza, vengono visualizzate anche tutte le variabili agente.

Gestione delle variabili agente

Dopo aver creato una variabile agente da usare in più argomenti, è necessario capire dove viene usata. È possibile vedere facilmente dove la variabile è stata definita per la prima volta (fonte) e gli altri argomenti che la stanno usando. Questa funzionalità può essere utile se si lavora su un nuovo agente o se si dispone di più variabili e di una ramificazione complessa di argomenti.

Esistono due elementi principali disponibili nel riquadro Proprietà variabili.

  • Riferimento: rimanda al nodo in cui è stata inizialmente creata la variabile.

  • Utilizzata da: mostra tutti gli argomenti in cui viene usata la variabile, in modo da passare direttamente all'argomento e al nodo.

Screenshot dei dettagli di Origine e Utilizzata da per le variabili agente.

Impostazione del valore di una variabile agente da origini esterne

È possibile impostare una variabile agente da inizializzare con un'origine esterna. Ciò permette 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, si conosce già il nome del cliente. 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 e, nella sezione Utilizzo, selezionare la casella Le origini esterne possono impostare valori.

Screenshot dell'impostazione Le origini esterne possono impostare valori.

Per altre informazioni sull'uso di variabili agente, consultare Riutilizzo di variabili tra gli argomenti.