Esercizio - Creazione e gestione di argomenti

  • 45 minuti

In questa unità si crea il flusso di conversazione per l'agente.

Creazione di un argomento usando Microsoft 365 Copilot

È possibile creare e modificare gli argomenti usando il linguaggio naturale.

  1. Accedere a Microsoft Copilot Studio.

    Importante

    Verificare di trovarsi nell'ambiente corretto.

  2. Selezionare l'agente nel riquadro Agenti sul lato sinistro dello schermo.

  3. Selezionare la scheda Argomenti.

  4. Selezionare Aggiungi un argomento, quindi scegliere Crea da descrizione con Copilot.

    Screenshot dell'opzione Crea da descrizione con agente.

  5. Viene visualizzata una nuova finestra che chiede di Assegnare un nome all'argomento e di immettere una descrizione nel campo di testo Crea un argomento per.

  6. Nel campo Assegnare un nome all'argomento immettere il testo seguente:

    Customer Details

  7. Nel campo Crea un argomento per immettere il testo seguente:

    Ask the customer for their name and email address

  8. Selezionare Crea.

  9. Viene visualizzato un nuovo argomento con le frasi trigger generate e i nodi domanda.

    Nota

    È importante ricordare che il contenuto che si genera potrebbe apparire in modo diverso rispetto a quanto mostrato in questo lab.

  10. Selezionare Salva.

Aggiornamento dei nodi con il linguaggio naturale

  1. Se il riquadroModifica con Copilot non è visualizzato nella parte destra della schermata, selezionare l'icona Microsoft 365 Copilot nella parte superiore dell'area del contenuto.

  2. Selezionare il secondo nodo domanda What is your email address?

  3. Nel pannello Modifica con Copilot, nel campo Cosa vuoi fare? immettere il testo seguente:

    Update the message in this question node to say thank you to the Name variable from the previous node and then proceed to ask the email address question

  4. Selezionare Aggiorna.

    Nota

    Il messaggio dovrebbe essere aggiornato per includere la variabile Name dal nodo messaggio precedente.

  5. Selezionare Salva.

Aggiunta di nodi con il linguaggio naturale

Oltre che per aggiornare nodi esistenti, è possibile usare Microsoft 365 Copilot per aggiungerne di nuovi.

  1. Assicurarsi che nessun nodo sia selezionato facendo clic nello spazio vuoto attorno ai nodi.

  2. Nel pannello Modifica con Copilot, nel campo Cosa vuoi fare? immettere il testo seguente:

    Summarize the information collected in an adaptive card

  3. Selezionare Aggiorna.

  4. Alla fine dell'argomento viene aggiunto un nodo Messaggio con una scheda adattiva.

    Screenshot del nodo Messaggio con la scheda adattiva.

  5. Selezionare la scheda adattiva. Le proprietà della scheda adattiva dovrebbero essere visualizzate nella parte destra della schermata.

    Screenshot delle proprietà della scheda adattiva.

    La formula della scheda adattiva dovrebbe essere simile a quella illustrata nell'immagine precedente. In caso contrario, è possibile copiare e incollare la formula seguente:

     {
 type: "AdaptiveCard", 
     body: 
     [
         {
             type: "TextBlock",
             size: "Medium",
             weight: "Bolder",
             text: "Summary"    
         },
         {
             type: "FactSet",
             facts: 
             [
                 {
                     title: "Full Name",
                     value: Text(Topic.Name)
                 },
                 {
                     title: "Email Address",
                     value: Text(Topic.EmailAddress)
                 }
             ]
         },
         {
             type: "TextBlock",
             text: "Thank you for providing the information."
         }
     ]
 }

  6. L'apertura delle proprietà della scheda adattiva determina la chiusura del pannello Modifica con copilota. È quindi necessario selezionare l'icona per riaprirlo.

  7. Assicurarsi che nessun nodo sia selezionato facendo clic nello spazio vuoto attorno ai nodi.

  8. Nel campo Cosa vuoi fare? immettere il testo seguente:

    Add a new multiple choice question to prompt the user if the details are correct with two options Yes or No

  9. Selezionare Aggiorna.

  10. Alla fine dell'argomento è ora presente un nuovo nodo domanda con opzioni selezionabili.

  11. Selezionare Salva.

Configurazione dell'ambito delle variabili

  1. Selezionare Variabili per aprire il riquadro Variabili.

    Screenshot del riquadro Variabili.

  2. Selezionare le caselle di controllo a destra per le variabili dell'argomento.

  3. Selezionare Salva.

Creazione manuale di argomenti

Gli argomenti possono essere creati manualmente aggiungendo frasi trigger e nodi.

Creazione di un argomento da zero

  1. Selezionare la scheda Argomenti.

  2. Selezionare Aggiungi un argomento, quindi Da vuoto.

  3. Selezionare Dettagli per aprire la finestra di dialogo Dettagli argomento.

    Screenshot della finestra di dialogo Dettagli argomento.

  4. Nel campo Nome immettere il testo seguente:

    Book a Real Estate Showing

  5. Nel campo Nome visualizzato immettere il testo seguente:

    Book

  6. Nel campo Descrizione immettere il testo seguente:

    Select the property and requested date and create a booking request

  7. Selezionare Salva.

  8. Selezionare Dettagli per chiudere la finestra di dialogo Dettagli argomento.

Aggiunta di frasi trigger

  1. Selezionare Modifica in Frasi in Trigger.

    Screenshot del riquadro delle frasi trigger dell'argomento.

  2. Immettere I want to book a real estate showing in Aggiungi frasi, quindi selezionare l'icona +.

  3. Immettere Schedule a real estate showing in Aggiungi frasi, quindi selezionare l'icona +.

  4. Immettere Arrange the viewing for a real estate property in Aggiungi frasi, quindi selezionare l'icona +.

  5. Immettere Set up an appointment to view a house in Aggiungi frasi, quindi selezionare l'icona +.

  6. Immettere Plan a property viewing in Aggiungi frasi, quindi selezionare l'icona +.

  7. Selezionare Salva.

Aggiunta di un nodo messaggio

  1. Selezionare l'icona + nel nodo trigger, quindi selezionare Invia un messaggio.

    Screenshot dell'aggiunta di un nodo.

  2. Nel campo Immetti un messaggio immettere il testo seguente:

    Hi, I can help you with booking a real estate property showing.

  3. Selezionare Salva.

Aggiunta di un nodo di gestione argomento

  1. Selezionare l'icona + nel nodo per inviare un messaggio, quindi selezionare Aggiungi una condizione.

  2. Selezionare la variabile DetailsCorrect.

  3. Selezionare Gestione argomenti > Vai a un altro argomento e selezionare l'argomento Dettagli cliente.

  4. Selezionare Salva.

Aggiunta di un nodo di condizione

  1. Selezionare l'icona + nel nodo di reindirizzamento e selezionare Aggiungi una condizione.

  2. Selezionare DetailsCorrect come variabile.

  3. Selezionare è uguale a.

  4. Selezionare Sì.

  5. Selezionare Salva.

Aggiunta di nodi domanda

  1. Selezionare l'icona + sotto il nodo di condizione a sinistra, quindi selezionare Fai una domanda.

  2. Nel campo Immetti un messaggio immettere il testo seguente:

    Which property do you want to see?

  3. Per Identificazione selezionare Intera risposta dell'utente.

  4. Selezionare la variabile in Salva risposta utente come e immettere PropertyName come Nome variabile

  5. Selezionare Salva.

  6. Selezionare l'icona + sotto il nodo domanda, quindi selezionare Fai una domanda.

  7. Nel campo Immetti un messaggio immettere il testo seguente:

    What date and time do you want to see the property?

  8. Selezionare Data e ora per Identificazione.

  9. Selezionare la variabile in Salva risposta utente come e immettere DateTime come Nome variabile

  10. Selezionare Salva.

Test dell'agente

  1. Selezionare il pulsante Test in alto a destra della schermata per aprire il pannello di test.

  2. Selezionare i tre puntini in alto nel pannello di prova in alto a destra della schermata.

  3. Selezionare Tieni traccia tra argomenti.

  4. Selezionare l'icona Inizia una nuova conversazione nella parte superiore del pannello di test.

  5. Quando viene visualizzato il messaggio Inizio della conversazione, l'agente avvia una conversazione. In risposta, immettere una frase trigger per l'argomento creato:

    I want to book a real estate showing

  6. L'agente risponde con la domanda "Qual è il tuo nome?".

  7. Immettere le informazioni seguenti:

    Name: <Your name>
Email address: <Your email address>

  8. Dopo aver immesso le informazioni, la scheda adattiva contiene queste informazioni, una domanda che chiede se le informazioni sono corrette e le opzioni da selezionare, ovvero Sì o No.

  9. Selezionare Sì.

  10. Immettere 555 Oak Lane, Denver, CO 80203 nella richiesta Quale proprietà vuoi vedere?

  11. Immettere Tomorrow 10:00 AM nella richiesta In che data e ora vuoi vedere la proprietà?

Uso delle entità per migliorare l'agente

Microsoft Copilot Studio usa entità per comprendere l'intento dell'utente. Sono incluse numerose entità predefinite per le informazioni di uso comune. Si possono creare entità personalizzate per eventuali scopi specifici.

Visualizzazione di entità predefinite

  1. Selezionare Impostazioni in alto a destra nella schermata.

  2. Selezionare la scheda Entità.

Creazione dell'entità del tipo di proprietà

  1. Selezionare + Aggiungi un'entità, quindi + Nuova entità.

  2. Selezionare il riquadro Elenco chiuso.

  3. Immettere Property Type nel campo Nome.

  4. Immettere Apartment nel campo Immetti elemento, quindi selezionare Aggiungi.

  5. Immettere House nel campo Immetti elemento, quindi selezionare Aggiungi.

  6. Immettere Condominium nel campo Immetti elemento, quindi selezionare Aggiungi.

  7. Immettere Duplex nel campo Immetti elemento, quindi selezionare Aggiungi.

  8. Selezionare + Sinonimi per Apartment, immettere Flat, quindi selezionare l'icona + e Fatto.

  9. Selezionare + Sinonimi per House, immettere Single-family home, quindi selezionare l'icona + e Fatto.

  10. Selezionare + Sinonimi per Condominium, immettere Townhouse, quindi selezionare l'icona + e Fatto.

  11. Selezionare Salva.

  12. Selezionare Chiudi.

Creazione dell'entità del numero di camere da letto

  1. Selezionare + Aggiungi un'entità, quindi + Nuova entità.

  2. Selezionare il riquadro Espressione regolare (Regex).

  3. Immettere Number of Bedrooms nel campo Nome.

  4. Immettere [1-5] nel campo Criterio.

  5. Selezionare Salva.

  6. Selezionare Chiudi.

Uso delle entità

  1. Selezionare l'agente nel riquadro Agenti sul lato sinistro dello schermo per tornare alla scheda Panoramica.

  2. Selezionare la scheda Argomenti.

  3. Selezionare l'argomento Book a Real Estate Showing.

  4. Selezionare l'icona + sopra il nodo domanda della proprietà, quindi selezionare Fai una domanda.

  5. Nel campo Immetti un messaggio immettere il testo seguente:

    What type of property do you want to see?

  6. Selezionare Property Type per Identificazione.

  7. Selezionare Seleziona opzioni per l'utente, quindi selezionare l'opzione Visualizza per tutti i valori dell'elenco.

  8. Selezionare la variabile in Salva risposta utente come e immettere PropertyType come Nome variabile

  9. Selezionare l'icona + sotto il nuovo nodo domanda, quindi selezionare Fai una domanda.

  10. Nel campo Immetti un messaggio immettere il testo seguente:

    How many bedrooms do you need?

  11. Selezionare Number of Bedrooms per Identificazione.

  12. Selezionare la variabile in Salva risposta utente come e immettere NumberofBedrooms come Nome variabile

  13. Selezionare Salva.

Creazione delle azioni dell'agente

Microsoft Copilot Studio può accedere ai dati in Microsoft Dataverse tramite flussi cloud di Power Automate

Creazione di un flusso di Power Automate per recuperare una proprietà

  1. Selezionare l'agente nel riquadro Agenti sul lato sinistro dello schermo per tornare alla scheda Panoramica.

  2. Selezionare la scheda Azioni.

  3. Selezionare + Aggiungi un'azione.

  4. Scorrere verso il basso e selezionare Crea un nuovo flusso.

  5. Accedere a Power Automate, se richiesto.

  6. Selezionare Esegui un flusso da Copilot in alto a sinistra nello schermo, quindi immettere Get Property come nome del flusso.

  7. Selezionare il passaggio del trigger Esegui un flusso da Copilot, quindi selezionare + Aggiungi un input.

  8. Selezionare Testo.

  9. Immettere Bedrooms per Input e Number of Bedrooms per Immettere l'input.

  10. Selezionare l'icona + tra i due passaggi del flusso, quindi selezionare Aggiungi un'azione.

  11. Immettere Dataverse nel campo Cerca, quindi selezionare Vedi altro per il connettore Dataverse.

  12. Selezionare l'azione Elenca righe.

  13. Se richiesto per l'autenticazione, selezionare OAuth, quindi Accedi.

  14. Selezionare Real Estate Properties come nome della tabella.

  15. Selezionare Mostra tutto.

  16. Immettere contoso_bedrooms eq nel campo Filtra righe.

  17. Usare Contenuto dinamico per selezionare il parametro Bedrooms, quindi selezionare Aggiungi.

  18. Selezionare l'azione Rispondi a Copilot, quindi + Aggiungi un output.

  19. Selezionare Testo.

  20. Immettere PropertyId per Immetti un nome, fare clic sul campo Immettere un valore con cui rispondere, quindi selezionare Inserisci espressione.

  21. Immettere l'espressione seguente:

    first(outputs('List_rows')?['body/value'])['contoso_realestatepropertyid']

  22. Selezionare Aggiungi.

  23. Selezionare + Aggiungi un output.

  24. Selezionare Testo.

  25. Immettere PropertyName per Immetti un nome, fare clic sul campo Immettere un valore con cui rispondere, quindi selezionare Inserisci espressione.

  26. Immettere l'espressione seguente:

    first(outputs('List_rows')?['body/value'])['contoso_propertyname']

  27. Selezionare Aggiungi.

  28. Selezionare Impostazioni.

  29. Verificare che Risposta asincrona sia impostata su Disattivato.

  30. Selezionare Salva bozza.

  31. Selezionare Pubblica.

  32. Chiudere la scheda Power Automate.

Aggiunta di un'azione dell'agente per recuperare una proprietà

  1. Selezionare Aggiorna.

  2. Selezionare il flusso Get Property.

  3. Selezionare Avanti.

  4. Selezionare Avanti.

  5. Selezionare Fine.

  6. Selezionare la scheda Argomenti.

  7. Selezionare l'argomento Book a Real Estate Showing.

  8. Selezionare l'icona + sotto il nodo domanda Di quante camere da letto hai bisogno?, quindi selezionare Chiama un'azione.

  9. Selezionare il flusso Get Property.

  10. Selezionare la variabile NumberofBedrooms per il parametro di input Bedrooms.

  11. Selezionare i tre puntini nel nodo domanda Quale proprietà vuoi vedere? e selezionare Elimina.

  12. Selezionare l'icona + nel nodo azione, quindi selezionare Invia un messaggio.

  13. Nel campo Immetti un messaggio immettere il testo seguente:

    Property

  14. Selezionare l'icona Inserisci variabile, quindi selezionare la variabile PropertyName.

  15. Selezionare Salva.

  16. Selezionare Pubblica, quindi selezionare di nuovo Pubblica.

Creazione di un flusso di Power Automate per effettuare una prenotazione

  1. Selezionare l'agente nel riquadro Agenti sul lato sinistro dello schermo per tornare alla scheda Panoramica.

  2. Selezionare la scheda Azioni.

  3. Selezionare + Aggiungi un'azione.

  4. Scorrere verso il basso e selezionare Crea un nuovo flusso.

  5. Selezionare Esegui un flusso da Copilot in alto a sinistra nello schermo, quindi immettere Create Booking Request come nome del flusso.

  6. Selezionare il passaggio del trigger Esegui un flusso da Copilot, quindi selezionare + Aggiungi un input.

  7. Selezionare Testo.

  8. Immettere PropertyId per Input e Property per Immettere l'input.

  9. Selezionare Aggiungi un input.

  10. Selezionare Testo.

  11. Immettere ViewerName per Input e Viewer Name per Immettere l'input.

  12. Selezionare Aggiungi un input.

  13. Selezionare Testo.

  14. Immettere ViewerEmail per Input e Viewer Email per Immettere l'input.

  15. Selezionare l'icona + tra i due passaggi del flusso, quindi selezionare Aggiungi un'azione.

  16. Immettere Dataverse nel campo Cerca, quindi selezionare Vedi altro per il connettore Dataverse.

  17. Selezionare l'azione Aggiungi una nuova riga.

  18. Selezionare Booking Requests per il nome della tabella.

  19. Selezionare Mostra tutto.

  20. Immettere Agent booking nel campo Booking Name.

  21. Immettere contoso_bookingrequests() nel campo Proprietà (proprietà immobiliari), spostare il cursore all'interno delle parentesi e usare Contenuto dinamico per selezionare il parametro PropertyId.

  22. Usare Contenuto dinamico per selezionare il parametro ViewerName per il campo Viewer Name.

  23. Usare Contenuto dinamico per selezionare il parametro ViewerEmail per il campo Viewer Email.

  24. Selezionare l'azione Rispondi a Copilot.

  25. Selezionare Impostazioni.

  26. Verificare che Risposta asincrona sia impostata su Disattivato.

  27. Selezionare Salva bozza.

  28. Selezionare Pubblica.

  29. Chiudere la scheda Power Automate.

Aggiunta di un'azione dell'agente per creare una richiesta di prenotazione

  1. Selezionare Aggiorna.

  2. Selezionare il flusso Create Booking Request.

  3. Selezionare Avanti.

  4. Selezionare Avanti.

  5. Selezionare Fine.

  6. Selezionare la scheda Argomenti.

  7. Selezionare l'argomento Book a Real Estate Showing.

  8. Selezionare l'icona + sotto il nodo In che data e ora vuoi vedere la proprietà? e selezionare Chiama un'azione.

  9. Selezionare il flusso Create Booking Request.

  10. Selezionare la variabile PropertyId per il parametro di input PropertyId.

  11. Selezionare la variabile Name per il parametro di input ViewerName.

  12. Selezionare la variabile EmailAddress per il parametro di input ViewerEmail.

  13. Selezionare l'icona + sotto il nodo azione. Selezionare Gestione argomenti, quindi selezionare Vai a un altro argomento e selezionare End of conversation.

  14. Selezionare Salva.

  15. Selezionare Pubblica, quindi selezionare di nuovo Pubblica.

Test dell'agente e invio di una richiesta di prenotazione

  1. Selezionare il pulsante Test in alto a destra della schermata per aprire il pannello di test.

  2. Selezionare i tre puntini in alto nel pannello di prova in alto a destra della schermata.

  3. Selezionare Tieni traccia tra argomenti.

  4. Selezionare l'icona Inizia una nuova conversazione nella parte superiore del pannello di test.

  5. Quando viene visualizzato il messaggio Inizio della conversazione, l'agente avvia una conversazione. In risposta, immettere una frase trigger per l'argomento creato:

    I want to book a real estate showing

  6. Immettere le informazioni seguenti:

    Name: <Your name>
Email address: <Your email address>

  7. Dopo aver immesso le informazioni, la scheda adattiva contiene queste informazioni, una domanda che chiede se le informazioni sono corrette e le opzioni da selezionare, ovvero Sì o No.

  8. Selezionare Sì.

  9. Selezionare House per il tipo di richiesta di proprietà.

  10. Immettere 2 per specificare il numero di camere da letto.

  11. Immettere Tomorrow 2:00 PM nella richiesta In che data e ora vuoi vedere la proprietà?

  12. Selezionare Sì alla richiesta Ho risposto alla tua domanda?

  13. Selezionare una valutazione qualsiasi.

  14. Selezionare No alla richiesta Posso aiutarti con qualcos'altro?

Verifica della richiesta di prenotazione

  1. Accedere a Power Apps Maker Portal.

  2. Nel riquadro di spostamento a sinistra selezionare Tabelle, quindi Personalizzata.

  3. Selezionare la tabella Booking Request.

  4. In Colonne e dati di Booking Request è ora visibile la richiesta di prenotazione dell'agente creata.