Utilizzo di variabili

5 minuti

Microsoft Copilot Studio permette di memorizzare informazioni importanti immesse dal cliente per essere usate in un successivo momento mediante le variabili. Ad esempio, è possibile salvare il nome di un cliente in una variabile denominata UserName. Questa variabile può essere inserita nei nodi di conversazione per creare un'esperienza più personale per il cliente, ad esempio inserendola nel nodo del messaggio, per permettere all'agente di rivolgersi al cliente per nome nel corso della conversazione.

Le variabili possono essere usate per indirizzare dinamicamente i clienti verso percorsi di conversazione diversi. Possono anche essere inserite nei flussi di Power Automate o nelle competenze di Bot Framework come parametri di input. Ad esempio, la città in cui vive il cliente potrebbe essere memorizzata in una variabile. Quando viene eseguito un flusso di Power Automate, la variabile potrebbe essere trasmessa come parametro di input per garantire che il servizio meteo riceva le previsioni corrette.

Molti tipi di variabili sono associati con entità predefinite e personalizzate definite nell'agente. A titolo di riferimento, è disponibile un elenco completo di tipi di entità e variabili.

Creazione di variabili

Le variabili vengono create automaticamente quando si aggiunge un nodo di domanda a un argomento. Per impostazione predefinita, quando viene inserito, il nodo di domanda viene creato usando opzioni a Scelta multipla. Tuttavia, è possibile usare qualsiasi entità predefinita o personalizzata selezionandola in Identifica.

Ridenominazione di una variabile

Quando una variabile viene creata automaticamente, viene assegnato un nome predefinito o simile a Var alla variabile. Non si tratta di un nome descrittivo. È possibile rinominare una variabile selezionandola e immettendo un nuovo nome. In questo modo è più facile identificarla in seguito, quando necessario.

Passaggio di variabili tra argomenti

Un'azione comune in un agente di Microsoft Copilot Studio è il reindirizzamento da un argomento a un altro, ad esempio all'argomento Store Hours dopo i saluti iniziali. Quando si esegue il reindirizzamento a un altro argomento, è possibile passare i valori alle variabili nell'argomento di destinazione. È anche possibile restituire i valori alle variabili nell'argomento originale. Il passaggio di variabili tra argomenti è particolarmente utile quando si dispone già di informazioni necessarie per l'argomento. Gli utenti apprezzeranno di non dover rispondere di nuovo alle domande. Ad esempio, se il nome dell'utente è già stato acquisito nell'argomento Saluti e si sa che tale nome viene usato nell'argomento Store Hours al quale si sta eseguendo il reindirizzamento. È possibile passare facilmente il nome utente all'argomento Store Hours quando si esegue il reindirizzamento all'argomento.

Ricezione di valori da altri argomenti

Quando si definisce una variabile in un argomento (ad esempio, inserendo un nodo domanda), la risposta dell'utente alle domande viene popolata con la variabile associata a quella domanda. Poiché il valore è già noto, non c'è motivo di porre di nuovo la domanda. In questi casi, è possibile definire la variabile come Ricevi valori da altri argomenti.

Di conseguenza, quando un altro argomento reindirizza a questo, può passare una variabile in questa variabile e ignorare la domanda. L'esperienza per l'utente che parla con l'agente è fluida.

Quando si configura il nodo di reindirizzamento, è necessario definire quale variabile si desidera popolare nell'argomento di destinazione. Dopo aver specificato quale variabile si desidera impostare nell'argomento di destinazione, specificare quale valore viene usato nell'argomento corrente. Ad esempio, nell'immagine qui sotto, stiamo reindirizzando a un argomento chiamato Restaurant list. La variabile Area nell'argomento Elenco ristoranti viene impostata su una variabile di testo denominata Var dall'argomento di reindirizzamento.

Per altre informazioni e istruzioni dettagliate sulla ricezione di valori da altri argomenti, vedere Ricezione di valori da altri argomenti.

Restituzione di valori agli argomenti originali

Quando un argomento pone una domanda oppure ottiene una variabile da un'azione in qualche altro modo, la variabile può essere restituita all'argomento originale da cui è partito il reindirizzamento.

In questo caso anche la variabile diventa parte dell'argomento originale e può essere usata come qualsiasi altra variabile. In questo modo, è possibile costruire l'argomento in modo che le informazioni ottenute dall'agente siano disponibili tra gli argomenti, riducendo la necessità di variabili globali. Le variabili globali verranno trattate nella prossima unità.

Per altre informazioni e istruzioni dettagliate, vedere Restituzione di valori agli argomenti originali.