Returner 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 Dataverse-connectoren 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 opretter et flow ud fra Copilot Studio oprettelseslærred
• Brug input- og outputvariabler til at overføre oplysninger
• Konfigurere Dataverse-søgning til dit miljø

Konfigurere en Dataverse-kontotabel

Tabellen Firma 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 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. Jeg kan slå det 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".

   

Oprette et flow

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

2. Under fanen Grundlæggende handlinger skal du vælge Nyt agentflow. Fanen Designer til agentflow åbnes med en startskabelon for et agentflow, der kaldes af en agent. Flowet inkluderer to handlinger: Når en agent kalder flowet og Reager på agenten.

3. Vælg Publicer for at gemme flowet, før du foretager ændringer. Der vises en meddelelse, når flowet er oprettet med succes.

4. Vælg Gå tilbage til agent for at vende tilbage til dit emne. Der føjes en ny handlingsnode til dit emne for flowet.

5. Vælg Gem for at afslutte tilføjelsen af flowet som et værktøj til din agent.

Rediger oplysninger om flow

1. På noden Handling med flowet skal du vælge linket Vis flowoplysninger for at vende tilbage til agentflowet.

2. På fanen Oversigt i flowet skal du redigere oplysningerne for flowet og erstatte navnet med Søgekonto. Vælg Gem.

3. Gå tilbage til fanen Designer. Vælg flowudløseren Når en agent kalder flowet, og tilføj en Tekst-inputparameter med navnet Organisation.

   

4. Vælg flowudløseren Når en agent kalder flowet skal du vælge ikonet Tilføj.

5. Søg efter "Microsoft Dataverse" i Tilføj en handling, og vælg handlingen Søg i rækker.

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

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

7. 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å agenten, 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. Copilot Studio informerer dig, når agentflowet udgives.

21. Vælg Gå tilbage til agent for at vende tilbage til agentens emneeditor. Det nye handlingsflow føjes til emnet.

Kald flowet fra Copilot Studio

1. Vælg den nye handlingsnode.

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 Gem.

6. Test din agent.