Restituire un elenco di risultati

È comune chiedere a un agente di cercare dati in un sistema esterno e restituire un elenco di risultati. A tale scopo, un agente può chiamare un flusso Power Automate per:

1. Autenticarsi e connettersi a una soluzione esterna.
2. Eseguire una query in base all'input dell'utente.
3. Formattare i risultati.
4. Restituire i risultati all'agente.

Questo esempio usa il connettore Dataverse in Power Automate per cercare gli account. Il connettore restituisce all'agente un elenco di risultati che include il nome dell'account, la città e il numero di account.

Prerequisiti

• Informazioni su come creare un flusso dall'area del contenuto di Copilot Studio
• Usare le variabili di input e output per passare informazioni
• Configurare la ricerca di Dataverse per l'ambiente

Impostare una tabella account di Dataverse

La tabella Account è una tabella standard disponibile per impostazione predefinita negli ambienti Power Platform. Tuttavia, non viene fornita con i dati dell'account. Prima che l'agente possa cercare gli account, devi popolare la tabella Account.

Se hai già una tabella Account con i dati, salta questo passaggio e vai a Creare un argomento. Tuttavia, ricordati di utilizzare termini di ricerca pertinenti ai tuoi dati quando testerai il tuo agente nei passaggi successivi.

1. Andare al portale di Power Apps.

2. Nel riquadro di spostamento, seleziona Tabelle.

3. Seleziona la tabella Account, quindi nella pagina delle proprietà della tabella, seleziona Modifica.

4. Aggiungi le seguenti righe alla tabella:

   Indirizzo 1: città	Nome conto	Numero conto
   Seattle	Contoso Inc	AC0125
   San Francisco	Contoso Residences	AC0255
   Olympia	Contoso Meal Delivery	AC0035

Creare un argomento

1. In Copilot Studio, vai alla pagina Argomenti per il tuo agente.

2. Crea un argomento chiamato Ricerca account.

3. Aggiungi le seguenti frasi trigger:

   • Sto cercando un cliente
   • Sto cercando un account
   • ricerca account
   • ricerca cliente

4. Aggiungi un nodo Messaggio e immetti il messaggio "Sembra che tu stia cercando un account. Posso cercarlo per te".

5. Aggiungi un nodo Domanda e immetti il messaggio "Qual è il nome del cliente che stai cercando?"

6. Per Identifica, seleziona Organizzazione.

   Funzionerebbe anche l' intera risposta dell'utente. Tuttavia, selezionando l'entità Organizzazione, si sfruttano le funzionalità di comprensione del linguaggio dell'agente per estrarre il nome dell'organizzazione dalla risposta.

7. Per Salva risposta utente con nome, rinomina la variabile in "organizzazione".

   

Creare un flusso

1. Seleziona l'icona Aggiungi nodo sotto qualsiasi nodo e seleziona Aggiungi un'azione.

2. Nella scheda Azioni di base seleziona Nuovo flusso Power Automate.

3. In Power Automate, seleziona il nome del flusso e sostituiscilo con Ricerca account.

4. Seleziona il trigger Esegui un flusso da Copilot e aggiungi un parametro di input di testo denominato Organizzazione.

   

5. Seleziona l'icona Aggiungi sotto il trigger Esegui un flusso da Copilot.

6. In Aggiungi un'azione cerca "Microsoft Dataverse" e seleziona l'azione Cerca righe.

   Questa azione utilizza la corrispondenza fuzzy per trovare account pertinenti nella tabella Account di Dataverse.

7. Nella casella Termine di ricerca, inserisci una barra (/), seleziona Inserisci contenuto dinamico, quindi seleziona il parametro di input Organizzazione.

8. Per Parametri avanzati, seleziona Mostra tutto e imposta i valori seguenti:

   • Elemento filtro tabella: account
   • Ordina per elemento - 1: search.score desc
   • Ordina per elemento - 2: name asc

   

Formattar i risultati

L'azione Cerca righe restituisce la variabile Elenco di righe che contiene dati JSON. Prima di poter usare i dati, è necessario analizzarli con l'azione Analizza JSON.

1. Seleziona l'icona Aggiungi sotto l'azione Cerca righe.

2. In Aggiungi un'azione, cerca "Operazione dati" e seleziona l'azione Analizza JSON.

3. Nella casella Contenuto, immetti una barra (/), seleziona Inserisci contenuto dinamico, quindi seleziona Elenco di righe.

4. Copia il seguente schema JSON e incollalo nella casella Schema:

   {
       "type": "array",
       "items": {
           "type": "object",
           "properties": {
               "@@search.score": {
                   "type": "number"
               },
               "name": {
                   "type": "string"
               },
               "address1_city": {
                   "type": "string"
               },
               "accountnumber": {
                   "type": "string"
               }
           },
           "required": [
               "name"
           ]
       }
   }
   

   

5. Seleziona l'icona Aggiungi sotto l'azione Analizza JSON.

6. In Aggiungi un'azione, cerca "Variabile" e seleziona l'azione Inizializza variabile.

7. Nella casella Nome, immetti "ListOfAccounts".

8. Per Tipo, seleziona Stringa.

   

9. Seleziona l'icona Aggiungi sotto l'azione Inizializza variabile.

10. In Aggiungi un'azione, cerca "Controllo" e seleziona l'azione Applica a ogni.

11. Nella casella Seleziona un output dai passaggi precedenti, immetti una barra (/), seleziona Inserisci contenuto dinamico, quindi seleziona la variabile Body in Analizza JSON.

12. Seleziona l'icona Aggiungiall'interno dell'azione Applica a ogni.

13. In Aggiungi un'azione, cerca "Variabile" e seleziona l'azione Aggiungi a variabile di stringa.

14. Per Nome, seleziona ListOfAccounts.

15. Copia il testo seguente e incollalo nella casella Valore:

    - @{items('Apply_to_each')['accountnumber']}: @{items('Apply_to_each')['name']} - @{items('Apply_to_each')['address1_city']}
    

16. Aggiungi un'interruzione di riga dopo frammento per far apparire ogni risultato su una riga separata.

    

17. Nell'azione Rispondi a Copilot aggiungi un output di testo.

18. In Nome, immetti "FoundAccounts".

19. Per il valore, immetti una barra rovesciata (/) nella casella, seleziona Inserisci contenuto dinamico, quindi seleziona la variabile ListOfAccounts.

    

20. Salva e pubblica il flusso.

Chiamare il flusso da Copilot Studio

1. In Copilot Studio, seleziona l'icona Aggiungi nodo nel nodo Domanda, seleziona Aggiungi un'azione, quindi seleziona il flusso che hai creato in precedenza, Cerca account.

2. Imposta il parametro di input del flusso sulla variabile di output dal nodo Domanda: Organizzazione (Stringa) ottiene il valore dalla variabile di organizzazione.

3. Aggiungi un nodo Messaggio e immetti il messaggio "Ok, questo è quello che ho trovato".

4. Aggiungi un secondo nodo Messaggio. Seleziona l'icona Inserisci variabile, quindi seleziona FoundAccounts.

   

5. Selezionare Salva.

6. Testa l'agente.