Returnera en lista med resultat

Viktigt

Power Virtual Agents-funktioner ingår nu i Microsoft Copilot Studio efter betydande investeringar i generativ AI och förbättrade integrationer mellan Microsoft Copilot.

Vissa artiklar och skärmbilder kan referera till Power Virtual Agents när vi uppdaterar dokumentation och utbildning.

Det är vanligt att be en copilot att söka efter data i ett externt system och returnera en lista med resultat. Detta gör du genom att Microsoft Copilot Studio kan anropa ett Power Automate-flöde i syfte att:

• autentisera och ansluta till en extern lösning
• köra en fråga utifrån användarens indata
• formatera resultaten
• returnera resultaten till copilot

I det här exemplet använder du Dataverse-anslutningsprogrammet i Power Automate för att söka efter konton. Därefter returnerar du en lista med resultat som innehåller kontonamn, ort och kontonummer till Microsoft Copilot Studio.

Förutsättningar

• Förstår hur du skapar ett flöde från Microsoft Copilot Studio-designytan
• Lägg till variabler för indata och utdata
• Konfigurera Dataverse-sökning för din miljö

Konfigurera en Dataverse-kontotabell

Kontotabellen är en standardtabell som inkluderas automatiskt i Power Platform-miljöer. Kontodata medföljer emellertid inte. Innan din copilot kan söka efter konton måste du fylla i tabellen Konto.

Om du redan har en kontotabell med data hoppar du över det här steget och går vidare till Skapa en ämne. Men du måste använda olika söktermer när du testar din copilot i senare steg.

1. Gå till Power Apps-portalen.

2. I sidofönstret, under Dataverse, väljer du Tabeller.

3. Välj tabellen Konto och sedan Redigera på sidan för tabellegenskaper.

4. Lägg till följande rader i tabellen:

   Adress 1: Ort	Kontonamn	Kontonummer
   Seattle	Contoso Inc	AC0125
   San Francisco	Contoso-bostäder	AC0255
   Olympia	Contoso-måltidsleveranser	AC0035

Skapa ett ämne

1. Gå till sidan Ämnen för din copilot.

2. Skapa ett ämne kallat Kontosökning.

3. Lägga till följande utlösande fraser:

   • Jag letar efter en kund
   • Jag letar efter ett konto
   • sök konto
   • sök kund

4. Lägg till en nod av typen Meddelande och ange meddelandet Låter som om du letar efter ett konto. Jag kan hitta det åt dig.

5. Lägg till en nod av typen Fråga och ange meddelandet Vad heter den kund du letar efter?

6. För Identitet väljer du Organisation.

   Användarens hela svar fungerar också. Om du väljer entiteten Organisation använder du språkförståelsefunktionen i copilot för att extrahera organisationsnamnet från svaret.

   

7. För Spara svar som byter du namn på variabeln till organisation.

Skapa ett flöde

1. I designytan väljer du Lägg till nod (+). Välj Anropa en åtgärd och välj sedan Skapa ett flöde.

2. I Power Automate-portalen döper du flödet till Sökningskonto.

3. Lägg till en inmatning av typen Text kallad Organisation.

   

4. Välj Infoga nytt steg (+) och välj sedan Lägg till en åtgärd.

5. Välj Microsoft Dataverse-anslutningsprogrammet och sedan åtgärden Sök rader.

   För den här åtgärden används fuzzy-matchning för att hitta relevanta konton i Dataverse-kontotabellen.

   

6. För Sökterm väljer du variabeln Organisation.

7. Välj Visa avancerade alternativ och ange följande alternativ:

   • Objekt för tabellfilter: account
   • Sortera efter objekt – 1: @search.score desc
   • Sortera efter objekt – 2: name asc

   

Formatresultat

Åtgärden Sök rader returnerar variabeln Lista med rader, som innehåller JSON-data. Innan du kan använda dina data måste du analysera dem med åtgärden Parse JSON.

1. Välj Infoga nytt steg (+) och välj sedan Lägg till en åtgärd.

2. Välj anslutningsprogrammet Dataåtgärd och välj sedan åtgärden Parsa JSON.

3. I rutan Innehåll, under Sök rader, väljer du variabeln Radlista.

4. Kopiera följande JSON-schema och klistra in det i rutan Schema:

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

   

5. Välj Infoga nytt steg (+) och välj sedan Lägg till en åtgärd. Välj anslutningsprogrammet Variabel, och välj sedan åtgärden Initiera variabel.

6. För Namn, ange ListOfAccounts. För Typväljer du Sträng.

   

7. Välj Infoga nytt steg (+) och välj sedan Lägg till en åtgärd. Välj anslutningsprogrammet Kontroll, och välj sedan åtgärden Tillämpa på alla.

8. Välj rutan Välj en form av utdata från föregående steg för att öppna menyn Dynamiskt innehåll. Sök efter brödtext innan du under Parsa JSON väljer variabeln Brödtext.

9. Välj Infoga nytt steg (+) och välj sedan Lägg till en åtgärd. Välj anslutningsprogrammet Variabel, och välj sedan åtgärden Lägg till i strängvariabel.

10. För Namn, välj ListOfAccounts. Kopiera följande text och klistra in den i rutan Värde:

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

11. Lägg till en radbrytning efter kodavsnittet för att få varje resultat att visas på sin egen rad.

    

12. I åtgärden Returnera värde(n) till Microsoft Copilot Studio lägger du till en utmatning för Text. För Namn, ange FoundAccounts. För Värde, välj ListOfAccounts.

    

13. Välj Spara.

Anropa flödet från Microsoft Copilot Studio

1. I Microsoft Copilot Studio-designytan väljer du Lägg till nod (+) och sedan Anropa en åtgärd.

2. Välj det flöde du skapade tidigare, Sök konto.

3. För Organisationen hämtar värde från väljer du variabeln organisation.

4. Lägg till en nod av typen Meddelande och ange meddelandet Okej, det här är vad jag hittade.

5. Lägg till en ytterligare nod av typen Meddelande. Välj Infoga variabel och välj sedan FoundAccounts.

   

6. Välj Spara.

7. Testa din copilot i rutan Testa copilot.