Restituire un elenco di risultati

È comune chiedere a un agente di cercare dati in un sistema esterno e restituire un elenco di risultati. Per farlo, Microsoft Copilot Studio può chiamare un flusso Power Automate per:

• Autenticarsi e connettersi a una soluzione esterna
• Eseguire una query in base agli input dell'utente
• Formattare i risultati
• Restituisci i risultati a agente

In questo esempio utilizzerai il connettore Dataverse in Power Automate per cercare gli account. Quindi restituirai un elenco di risultati che include il nome dell'account, la città e il numero di account a Microsoft Copilot Studio.

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 che è inclusa automaticamente negli ambienti Power Platform. Tuttavia, non viene fornita con i dati dell'account. Prima che agente possa cercare gli account, è necessario popolare la tabella Account.

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

1. Andare al portale di Power Apps.

2. Nel riquadro laterale, sotto Dataverse 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. 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 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.

   Anche Intera risposta dell'utente va bene. Tuttavia, selezionando l'entità Organizzazione si sfruttano le capacità di comprensione del linguaggio di agente per estrarre il nome dell'organizzazione da risposta.

   

7. Per Salva risposta come, rinomina la variabile in organizzazione.

Crea un flusso

1. Nel canvas di creazione seleziona Aggiungi nodo (+). Seleziona Chiama un'azione e quindi seleziona Crea un flusso.

2. Nel portale Power Automate denomina il flusso Cerca account.

3. Aggiungi un input Testo denominato Organizzazione.

   

4. Seleziona Inserisci un nuovo passaggio (+), quindi seleziona Aggiungi un'azione.

5. Seleziona il connettore Microsoft Dataverse e quindi l'azione Cerca righe.

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

   

6. Per Termine di ricerca, seleziona la variabile Organizzazione.

7. Seleziona Mostra opzioni avanzate e imposta i seguenti elementi come indicato:

   • 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 utilizzare i dati, dovrai analizzarli con l'azione Analizza JSON.

1. Seleziona Inserisci un nuovo passaggio (+), quindi seleziona Aggiungi un'azione.

2. Seleziona il connettore Operazione sui dati e quindi l'azione Analizza JSON.

3. Nella casella Contenuto sotto Cerca righe, seleziona la variabile 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 Inserisci un nuovo passaggio (+), quindi seleziona Aggiungi un'azione. Seleziona il connettore Variabile e quindi l'azione Inizializza variabile.

6. In Nome, immetti ListOfAccounts. Per Tipo, seleziona Stringa.

   

7. Seleziona Inserisci un nuovo passaggio (+), quindi seleziona Aggiungi un'azione. Seleziona il connettore Controllo, quindi seleziona l'azione Applica a ogni.

8. Seleziona la casella Selezionare un output dai passaggi precedenti per aprire il menu Contenuto dinamico. Cerca corpo, e poi sotto Analizza JSON, seleziona la variabile Corpo.

9. Seleziona Inserisci un nuovo passaggio (+), quindi seleziona Aggiungi un'azione. Seleziona il connettore Variabile e quindi l'azione Aggiungi a variabile di stringa.

10. Per Nome, seleziona ListOfAccounts. 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']}
    

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

    

12. Nell'azione Restituisci i valori a Microsoft Copilot Studio, aggiungi un output Testo. In Nome, immetti FoundAccounts. Per Valore, seleziona ListOfAccounts.

    

13. Seleziona Salva.

Chiamare il flusso da Microsoft Copilot Studio

1. Sul canvas di creazione Microsoft Copilot Studio seleziona Aggiungi nodo (+), quindi seleziona Chiama un'azione.

2. Seleziona il flusso che hai creato in precedenza, Cerca account.

3. Per L'organizzazione recupera il valore da, seleziona la variabile organizzazione.

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

5. Aggiungi un secondo nodo Messaggio. Seleziona Inserisci variabile, quindi seleziona FoundAccounts.

   

6. Seleziona Salva.

7. Prova il tuo agente nel riquadro Test agente .