Returner en liste over resultater

Viktig!

Power Virtual Agents-funksjoner er nå en del av Microsoft Copilot Studio etter betydelige investeringer i generativ kunstig intelligens og forbedrede integreringer på tvers av Microsoft Copilot.

Enkelte artikler og skjermbilder kan henvise til Power Virtual Agents når vi oppdaterer dokumentasjons- og opplæringsinnhold.

Det er vanlig å be en kopilot om å se etter data i et eksternt system og returnere en resultatliste. Microsoft Copilot Studio kan gjøre dette ved å kalle opp en Power Automate for å gjøre følgende:

• godkjenne og koble til en ekstern løsning
• kjøre en spørring basert på brukerens inndata
• formatere resultatene
• returnere resultatene til kopiloten

I dette eksemplet skal du bruke Dataverse-koblingen i Power Automate til å søke etter forretningsforbindelser. Du skal deretter returnere en liste over resultater som omfatter navnet på forretningsforbindelsen, poststedet og nummeret for forretningsforbindelsen til Microsoft Copilot Studio.

Forutsetning

• Forstå hvordan du oppretter en flyt fra Microsoft Copilot Studio-redigeringslerretet
• Legg til inndata- og utdatavariabler
• Konfigurer Dataverse-søk for miljøet

Konfigurer en tabell for forretningsforbindelser i Dataverse

Tabellen Forretningsforbindelse er en standardtabell som tas med automatisk i Power Platform-miljøer. Den kommer imidlertid ikke med forretningsforbindelsesdataene. Før kopiloten 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. Du må imidlertid bruke forskjellige søkeord når du tester kopiloten i senere trinn.

1. Gå til Power Apps-portalen.

2. Velg Tabeller under Dataverse i sideruten.

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

2. Opprett et emne kalt Forretningsforbindelsessøk.

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 Høres ut som du ser etter en forretningsforbindelse. Jeg kan slå den 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å. Valg av Organisasjon-enheten drar imidlertid nytte av kopilotens språkforståelsesfunksjoner for å trekke ut organisasjonsnavnet fra svaret.

   

7. For Lagre svar som gir du variabelen det nye navnet organisasjon.

Opprett en flyt

1. Velg Legg til node (+) på redigeringslerretet. Velg Kall opp en handling, og velg deretter Opprett en flyt.

2. Gi flyten navnet Søk etter forretningsforbindelse i Power Automate-portalen.

3. Legg til Tekst-inndata kalt Organisasjon.

   

4. Velg Sett inn et nytt trinn (+), og velg deretter Legg til en handling.

5. Velg Microsoft Dataverse-koblingen, og velg deretter handlingen Søk i rader.

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

   

6. For Søkeord velger du variabelen Organisasjon.

7. Velg Vis avanserte alternativer, og angi følgende elementer som gitt:

   • 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 Sett inn et nytt trinn (+), og velg deretter Legg til en handling.

2. Velg Dataoperasjon-koblingen, og velg deretter handlingen Analyser JSON.

3. Velg variabelen Liste over rader under Søk i rader i Innhold-boksen.

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 Sett inn et nytt trinn (+), og velg deretter Legg til en handling. Velg Variabel-koblingen, og velg deretter handlingen Initialiser variabel.

6. For Navn angir du ListeOverForretningsforbindelser. For Type velger du Streng.

   

7. Velg Sett inn et nytt trinn (+), og velg deretter Legg til en handling. Velg Kontroll-koblingen, og velg deretter handlingen Bruk på alle.

8. Velg boksen Velg utdata fra tidligere trinn for å åpne menyen Dynamisk innhold. Søk etter brødtekst, og velg deretter Brødtekst-variabelen under Analyser JSON.

9. Velg Sett inn et nytt trinn (+), og velg deretter Legg til en handling. Velg Variabel-koblingen, og velg deretter handlingen Tilføy til strengvariabel.

10. For Navn velger du ListeOverForretningsforbindelser. 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']}
    

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

    

12. Legg til Tekst-utdata i handlingen Returner verdi(er) til Microsoft Copilot Studio. For Navn angir du FunneForretningsforbindelser. For Verdi velger du ListeOverForretningsforbindelser.

    

13. Velg Lagre.

Kall opp flyten fra Microsoft Copilot Studio

1. Velg Legg til node (+) på redigeringslerretet i Microsoft Copilot Studio, og velg deretter Kall opp en handling.

2. Velg flyten du opprettet tidligere, Søk etter forretningsforbindelse.

3. For Organisasjon får verdi fra velger du variabelen organisasjon.

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

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

   

6. Velg Lagre.

7. Test kopiloten i ruten Test kopilot.