Returner en liste over resultater

Det er vanlig å be en agent om å se etter data i et eksternt system og returnere en liste over resultater. En agent kan gjøre dette ved å kalle opp en Power Automate-flyt for å gjøre følgende:

1. Godkjenn og koble til en ekstern løsning.
2. Kjør en spørring basert på brukerinndataene.
3. Formater resultatene.
4. Returner resultatene til agenten.

Dette eksemplet bruke Dataverse-koblingen i Power Automate til å søke etter forretningsforbindelser. Koblingen returnerer en liste over resultater som inkluderer kontonavn, by og kontonummer til agenten.

Forutsetning

• Forstå hvordan du oppretter en flyt fra Copilot Studio-redigeringslerretet
• Bruke variabler for inndata og utdata til å sende informasjon
• Konfigurer Dataverse-søk for miljøet

Konfigurer en tabell for forretningsforbindelser i Dataverse

Tabellen Forretningsforbindelse er en standardtabell som er tilgjengelig som standard i Power Platform-miljøer. Den kommer imidlertid ikke med forretningsforbindelsesdataene. Før agenten kan søke etter kontoer, må du fylle ut Konto-tabellen.

Hvis du allerede har en tabell for forretningsforbindelser med data, hopper du over dette trinnet og går videre til Opprett et emne. Husk imidlertid å bruke søkeord som er relevante for dataene dine når du tester agenten din i senere trinn.

1. Gå til Power Apps-portalen.

2. I navigasjonsruten velger du Tabeller.

3. Velg tabellen Forretningsforbindelse, og velg deretter Rediger på siden for tabellegenskaper.

4. Legg til følgende rader i tabellen:

   Adresse 1: Poststed	Navn på forretningsforbindelse	Nummer for forretningsforbindelse
   Seattle	Contoso Inc.	AC0125
   San Francisco	Contoso Residences	AC0255
   Olympia	Contoso Meal Delivery	AC0035

Opprette et emne

1. Gå til Emner-siden for agenten i Copilot Studio.

2. Opprett et emne kalt Søk etter forretningsforbindelse.

3. Legg til følgende utløseruttrykk:

   • jeg ser etter en kunde
   • jeg ser etter en forretningsforbindelse
   • søk etter forretningsforbindelse
   • søk etter kunde

4. Legg til en Melding-node, og skriv inn meldingen «Det høres ut som du ser etter en konto. Jeg kan se det opp for deg.»

5. Legg til en Spørsmål-node, og skriv inn meldingen «Hva er navnet på kunden du ser etter?»

6. Velg Organisasjon for Identifiser.

   Brukerens fulle svar fungerer også. Hvis du velger enheten Organisasjon, drar du imidlertid nytte av agentens funksjoner for språkforståelse, slik at du kan trekke ut organisasjonsnavnet fra svaret.

7. Gi variabelen det nye navnet «organisasjon» for Lagre brukersvar som.

   

Opprett en flyt

1. Velg ikonet Legg til node under en hvilken som helst node, og velg Legg til en handling.

2. Velg Ny Power Automate-flyt i fanen Grunnleggende handlinger.

3. Velg navnet på flyten i Power Automate, og erstatt den med Søk etter forretningsforbindelse.

4. Velg flytutløseren Kjør en flyt fra Copilot, og legg til en inndataparameter for Tekst kalt Organisasjon.

   

5. Velg ikonet Legg til nedenfor flytutløseren Kjør en flyt fra Copilot.

6. Søk etter «Microsoft Dataverse» i Legg til en handling, og velg handlingen Søk etter rader.

   Denne handlingen bruker tilnærmet samsvar til å finne relevante forretningsforbindelser i tabellen Forretningsforbindelse i Dataverse.

7. Skriv inn en skråstrek (/) i Søkeord-boksen, velg Sett inn dynamisk innhold, og velg deretter inndataparameteren Organisasjon.

8. Velg Vis alle for Avanserte parametere, og angi følgende verdier:

   • Element for tabellfilter: account
   • Sorter etter element – 1: search.score desc
   • Sorter etter element – 2: name asc

   

Formater resultatene

Handlingen Søk i rader returnerer variabelen Liste over rader, som inneholder JSON-data. Før du kan bruke dataene, må du analysere dem med handlingen Analyser JSON.

1. Velg ikonet Legg til nedenfor handlingen Søk i rader.

2. Søk etter «Dataoperasjon» i Legg til en handling, og velg handlingen Analyser JSON.

3. Skriv inn en skråstrek (/ ) i Innhold-boksen, velg Sett inn dynamisk innhold, og velg deretter Liste over rader.

4. Kopier følgende JSON-skjema, og lim den inn i Skjema-boksen:

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

   

5. Velg ikonet Legg til nedenfor handlingen Analyser JSON.

6. Søk etter «Variabel» i Legg til en handling, og velg handlingen Initialiser variabel.

7. I Navn-boksen skriver du inn «ListeOverForretningsforbindelser».

8. For Type velger du Streng.

   

9. Velg ikonet Legg til nedenfor handlingen Initialiser variabel.

10. Søk etter «Kontroll» i Legg til en handling, og velg handlingen Bruk på alle.

11. Skriv inn en skråstrek (/) i boksen Velg utdata fra tidligere trinn, velg Sett inn dynamisk innhold, og velg deretter variabelen Brødtekst under Analyser JSON.

12. Velg ikonet Legg tili handlingen Bruk på alle.

13. Søk etter «Variabel» i Legg til en handling, og velg handlingen Tilføy i strengvariabel.

14. For Navn velger du ListeOverForretningsforbindelser.

15. Kopier følgende tekst og lim den inn i Verdi-boksen:

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

16. Legg til et linjeskift etter snutten for å få hvert resultat til å vises på en egen linje.

    

17. Legg til Tekst-utdata i handlingen Svar til Copilot.

18. For Navn angir du «FunneForretningsforbindelser».

19. Skriv inn en skråstrek (/) for verdien i boksen, velg Sett inn dynamisk innhold, og velg deretter variabelen ListeOverForretningsforbindelser.

    

20. Lagre og publiser flyten.

Kall opp flyten fra Copilot Studio

1. Velg ikonet Legg til node under Spørsmål-noden i Copilot Studio, velg Legg til en handling, og velg deretter flyten du opprettet tidligere, Søk etter forretningsforbindelse.

2. Angi utdatavariabelen for inndataparameteren for flyt fra Spørsmål-noden: Organisasjon (streng) får verdien fra variabelen organisasjon.

3. Legg til en Melding-node, og skriv inn meldingen «OK, her er det jeg fant.»

4. Legg til en andre Melding-node. Velg ikonet Sett inn variabel, og velg deretter FunneForretningsforbindelser.

   

5. Velg Lagre.

6. Test agenten.