Aggiunta di input, variabili e condizioni

Completato

Per l'agente Event Contacts è necessario espandere il numero di paesi/aree geografiche che hanno contatti. Anziché elencare tutti i paesi e le aree geografiche nel nodo messaggio, si desidera chiedere all'utente per quale di essi ha bisogno delle informazioni di contatto. Per eseguire questa attività, si usano input, variabili e condizioni.

  • Input: risposta dell'utente nel nodo Fai una domanda.

  • Variabili: memorizzano gli input da usare nei nodi conversazione successivi.

  • Condizioni: definiscono la logica di ramificazione in base alle variabili.

Per l'agente specifico è necessario eliminare il nodo del messaggio corrente perché verrà sostituito. Selezionare i puntini di sospensione (...) delle opzioni del nodo del messaggio, quindi selezionare Elimina.

Aggiunta di input e variabili con il nodo di domanda

Per aggiungere input e variabili con il nodo di domanda, effettuare i seguenti passaggi:

  1. Passare il mouse sulla metà superiore della linea che collega Frasi trigger al nodo Messaggio. Selezionare l'icona più + Aggiungi nodo visualizzata e quindi selezionare Fai una domanda dal popup di selezione che appare quando si seleziona l'icona più.

  2. Compilare il nodo di domanda con le informazioni seguenti:

    Poni una domanda: immettere la frase:

    I can help with event contacts. Please tell me which country/region the event is scheduled for.

    Identifica: selezionare Opzioni a scelta multipla. Il campo Identifica indica il tipo di risposta che l'agente attende. Altre risposte che è possibile selezionare includono un numero o una stringa. È anche possibile configurare l'agente in modo che rilevi entità come nomi di stati, numeri di telefono o indirizzi. Per altre informazioni sulle diverse opzioni disponibili, consultare i collegamenti nell'unità Riepilogo alla fine di questo modulo.

    Opzioni per l'utente: immettere USA, Canada, Francia e Spagna selezionando + Nuova opzione tra ogni parola. (vedere il numero 1 nell'immagine seguente).

    Osservare come la finestra delle domande si sposta a destra dell'area del contenuto man mano che aumentano le opzioni e le condizioni figlio popolano il canvas sotto il riquadro delle domande. Per centrare di nuovo il canvas, è possibile fare clic con il pulsante sinistro del mouse sulla schermata del canvas e trascinarla, scorrere oppure usare i controlli di visualizzazione della schermata nella parte inferiore sinistra del canvas. Questi controlli includono i pulsanti per aumentare/diminuire l'ingrandimento, ricentrare la vista o persino visualizzare una mini mappa su cui fare clic per spostarsi nel canvas dell'agente (vedere il numero 2 nell'immagine seguente).

Screenshot del nodo di domanda con i dettagli popolati e i controlli di visualizzazione della schermata sul canvas.

  1. Tornare al nodo di domanda e impostare il valore Salva risposta come, attualmente mostrato come variabile Var (testo). Selezionare l'icona di modifica accanto a Var (testo) per visualizzare il pannello Proprietà variabile sul lato destro della schermata. Sostituire il valore Nome di "Var" con "VarCountry" e chiudere il pannello. Notare come il nuovo nome della variabile "VarCountry" popoli i nodi Condizione sotto il nodo Domanda.

    Copilot Studio fornisce due variabili predefinite: agent.UserDisplayName, che specifica il nome dell'utente, e agent.UserID, che specifica il nome di accesso dell'utente. Con la variabile agent.UserDisplayName l'agente può chiamare l'utente per nome in modo da personalizzare l'esperienza. È anche possibile usare agent.UserID per creare un nodo di condizione ed eseguire azioni in base all'utente con cui l'agente interagisce.

  2. Per consentire all'agente Event Contacts di salutare l'utente per nome, aggiungere un nuovo nodo di messaggio all'inizio dell'agente. Spostare il canvas in modo da poter visualizzare il nodo Frasi trigger e aggiungere un nodo al di sotto. Per il nuovo nodo selezionare Mostra un messaggio. Quindi, nel campo di input del messaggio selezionare il menu a discesa {X} inserisci variabile e agent.UserDisplayName.

Screenshot del nuovo nodo di messaggio con l'opzione inserisci variabile selezionata e la variabile agent.UserDisplayName evidenziata.

  1. È possibile personalizzare ulteriormente il messaggio aggiungendo "Ciao " (con uno spazio prima del nome) all'inizio. Salvare l'argomento selezionando il pulsante Salva nella barra multifunzione di Copilot Studio.

Nodo di condizione

Per ogni opzione a scelta multipla nel nodo di domanda, Microsoft Copilot Studio crea un nuovo nodo di condizione. È necessario configurare ogni nodo di condizione per fornire la risposta successiva appropriata nella conversazione.

Per l'agente Event Contacts è necessario rispondere con il contatto dell'evento per il paese/area geografica. Se ad esempio l'utente seleziona USA, l'agente deve rispondere con le informazioni di contatto relative a Lynne Robbins. Per la prima voce, in questo caso USA, Copilot Studio non crea automaticamente un nuovo nodo Condizione, ma ogni condizione successiva creerà un nuovo nodo Condizione.

Paese/area geografica Nome E-mail
USA Lynne Robbins LynneR@contoso.com
Canada Lidia Holloway LidiaH@contso.com
Francia Miriam Graham MiriamG@contoso.com
Spagna Christie Cline ChristieC@contoso.com

Per ogni nodo condizione, aggiungere un nuovo nodo messaggio dopo la condizione che specifica il contatto e l'indirizzo e-mail corretti, ad esempio "Il coordinatore dell'evento per la Francia è Miriam Graham all'indirizzo MiriamG@contoso.com".

È possibile aggiungere un altro nodo di condizione per USA, ma per ora usare Tutte le altre condizioni per il messaggio riguardante il contatto negli USA.

Per tutti e quattro i nodi di messaggio, si desidera usare lo stesso argomento di sistema Fine della conversazione. Per l'agente in uso questo argomento è già definito nel nodo Tutte le altre condizioni. Per collegare altri nodi a questo, effettuare i seguenti passaggi:

  1. Dopo uno dei nodi di messaggio, selezionare Aggiungi nodo (simbolo più +). Notare come un piccolo cerchio appare nella parte superiore della casella. Se ci si passa con il puntatore del mouse, il cerchio si riempie di colore rosa.

  2. Fare clic e tenere premuto, quindi trascinare il cerchio rosa sulla parte superiore del nodo Fine sotto il messaggio di condizione predefinito. Quando si trova nel posto giusto, sopra il nodo appare un alone rosa. Rilasciare il connettore dal nodo di messaggio in quel punto. Notare che entrambi i nodi di messaggio ora si connettono al nodo Fine.

  3. Procedere nello stesso modo con gli altri due nodi Messaggio per connetterli al nodo Fine.

Screenshot del processo per spostare il nuovo nodo nel nodo di fine.

  1. Per eseguire il test dell'agente, selezionare Salva. Selezionare l'opzione Test dell'agente se il riquadro di test dell'agente non è visibile.

Si è così appreso come incorporare le variabili predefinite e come definire una variabile usando una condizione di input. Con questi strumenti è possibile continuare a espandere l'agente.