Returnere en liste over resultater

Det er almindeligt at bede en agent om at søge efter data i et eksternt system og returnere en liste over resultater. For at gøre dette kan en agent kalde et Power Automate flow for at:

1. Godkende og oprette forbindelse til en ekstern løsning.
2. Kør en forespørgsel baseret på brugerinputtet.
3. Formatere resultaterne.
4. Returnere resultaterne til agenten.

I dette eksempel bruges connectoren Dataverse i Power Automate til at søge efter konti. Connectoren returnerer en liste over resultater, der indeholder kontonavn, by og kontonummer, til din agent.

Forudsætninger

• Forstå, hvordan du kan oprette et flow fra Copilot Studio-oprettelseslærredet
• Bruge input- og outputvariabler til at overføre oplysninger
• Konfigurere Dataverse-søgning for dit miljø

Konfigurere en Dataverse-kontotabel

Kontotabellen er en standardtabel, der som standard er tilgængelig i Power Platform miljøer. Den kommer imidlertid ikke med kontodata. Før din agent kan søge efter konti, skal du udfylde Kontotabellen.

Hvis du allerede har en kontotabel med data, kan du springe dette trin over og gå videre til Oprettelse af et emne. Husk dog at bruge søgeord, der er relevante for dine data, når du tester din agent i de senere trin.

1. Gå til Power Apps-portalen.

2. Vælg Tabeller i navigationsruden.

3. Vælg tabellen Konto, og vælg derefter Rediger på siden med tabelegenskaberne.

4. Føj følgende rækker til tabellen:

   Adresse 1: By	Kontonavn	Kontonummer
   Seattle	Contoso Inc	AC0125
   San Francisco	Contoso Residences	AC0255
   Olympia	Contoso Meal Delivery	AC0035

Opret et emne

1. I Copilot Studio gå til siden Emner for din agent.

2. Opret et emne med navnet Kontosøgning.

3. Tilføj følgende udløserfraser:

   • Jeg søger efter en kunde
   • Jeg søger efter en konto
   • søg efter konto
   • søg efter kunde

4. Tilføj en meddelelsesnode, og indtast meddelelsen "Det lyder som om du leder efter en konto. Det kan jeg slå op for dig."

5. Tilføj en Spørgsmål-node, og angiv meddelelsen "Hvad er navnet på den kunde, du leder efter?"

6. Vælg Organisation for Identificer.

   Hele brugerens svar fungerer også. Men hvis du vælger objektet Organisation, udnytter du agentens muligheder for sprogforståelse til at udtrække organisationsnavnet fra svaret.

7. For Gem brugersvar som skal du omdøbe variablen til "organisation".

   

Opret et flow

1. Vælg ikonet Tilføj node under en node, og vælg Tilføj en handling.

2. Under fanen Grundlæggende handlinger skal du vælge Nyt Power Automate flow.

3. I Power Automate skal du markere navnet på flowet, og erstatte det med Søg konto.

4. Vælg flowudløseren Kør et flow fra Copilot og tilføje Tekst-inputparameteren med navnet Organisation.

   

5. Vælg flowudløseren Kør et flow fra Copilot under Kær et flow fra Copilot.

6. I Tilføj en handling skal du søge efter "Microsoft Dataverse" og vælge handlingen Søg i rækker.

   I denne handling bruges matching af forskellige oplysninger til at finde relevante konti i din Dataverse-kontotabel .

7. I feltet Søgeord, skriv en skråstreg (/), vælg Indsæt dynamisk indhold, og vælg derefter inputparameteren for din organisation.

8. For Avancerede parametre, vælg Vis alle og angiv følgende værdier:

   • Tabelfilterelement: account
   • Sortér efter element – 1: search.score desc
   • Sortér efter element – 2: name asc

   

Formatere resultater

Handlingen Søg i rækker returnerer variablen Liste over rækker, som indeholder JSON-data. Før du kan bruge dataene, skal du analysere dem med handlingen Opdel JSON.

1. Vælg ikonet Tilføj under handlingen Søg i rækker.

2. I Tilføj en handling skal du søge efter "Datahandling" og vælge handlingen Opdel JSON.

3. I feltet Indhold skal du angive en skråstreg (/), vælge Indsæt dynamisk indhold, og vælge Liste over rækker.

4. Kopiér følgende JSON-skema, og indsæt det i feltet Skema:

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

   

5. Vælg ikonet Tilføj under handlingen Opdel JSON.

6. I Tilføj en handling skal du søge efter "Variabel" og vælge handlingen Initialiser variabel.

7. I feltet Navn skal du angive "ListOfAccounts".

8. Vælg Streng for Type.

   

9. Vælg ikonet Tilføj under handlingen Initialiser variabel.

10. I Tilføj en handling skal du søge efter "Kontrol" og vælge handlingen Anvend i hver.

11. I feltet Vælg et output fra forrige trin skal du angive en skråstreg (/), vælge Indsæt dynamisk indhold og derefter vælge variablen Brødtekst under Opdel JSON.

12. Vælg ikonet Tilføji handlingen Anvend i hver handling.

13. I Tilføj en handling skal du søge efter "Variabel" og vælge handlingen Føj til strengvariabel.

14. Vælg ListOfAccounts for Navn.

15. Kopiér følgende tekst, og indsæt den i feltet Værdi:

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

16. Tilføj et linjeskift efter kodestykke for at få hvert resultat vist på sin egen linje.

    

17. I handlingen Reager på Copilot, tilføj et tekstoutput.

18. Angiv "FoundAccounts" for Navn.

19. For værdien skal du angive en skråstreg (/) i feltet, vælge Indsæt dynamisk indhold og derefter vælge variablen ListOfAccounts.

    

20. Gem og publicer dit flow.

Kald flowet fra Copilot Studio

1. I Copilot Studio skal du vælge ikonet Tilføj node under noden Spørgsmål, vælge Tilføj en handling og derefter vælge det flow, du oprettede tidligere, Søg konto.

2. Angiv outputvariablen fra noden Spørgsmål som flowinputparameter: Organisation (streng) henter sin værdi fra organisationsvariablen.

3. Tilføj en Meddelelse-node , og skriv meddelelsen "Ok. Det er det, jeg har fundet."

4. Tilføj en ekstra Meddelelse-node Vælg ikonet Indsæt variabel, og vælg FoundAccounts.

   

5. Vælg Save.

6. Test din agent.