Returner en liste over resultater

Artikkel
08/09/2024

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

Gå til Power Apps-portalen.
Velg Tabeller under Dataverse i sideruten.
Velg tabellen Forretningsforbindelse, og velg deretter Rediger på siden for tabellegenskaper.

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

Gå til Emner-siden for kopiloten.
Opprett et emne kalt Forretningsforbindelsessøk.
Legg til følgende utløseruttrykk:
- jeg ser etter en kunde
- jeg ser etter en forretningsforbindelse
- søk etter forretningsforbindelse
- søk etter kunde
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.
Legg til en Spørsmål-node, og skriv inn meldingen Hva er navnet på kunden du ser etter?
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.
For Lagre svar som gir du variabelen det nye navnet organisasjon.

Opprett en flyt

Velg Legg til node (+) på redigeringslerretet. Velg Kall opp en handling, og velg deretter Opprett en flyt.
Gi flyten navnet Søk etter forretningsforbindelse i Power Automate-portalen.
Legg til Tekst-inndata kalt Organisasjon.
Velg Sett inn et nytt trinn (+), og velg deretter Legg til en handling.
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.
For Søkeord velger du variabelen Organisasjon.
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.

Velg Sett inn et nytt trinn (+), og velg deretter Legg til en handling.
Velg Dataoperasjon-koblingen, og velg deretter handlingen Analyser JSON.
Velg variabelen Liste over rader under Søk i rader i Innhold-boksen.

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"
        ]
    }
}

Skjermbilde av JSON-skjema angitt i Analyser JSON-noden.

Velg Sett inn et nytt trinn (+), og velg deretter Legg til en handling. Velg Variabel-koblingen, og velg deretter handlingen Initialiser variabel.
For Navn angir du ListeOverForretningsforbindelser. For Type velger du Streng.
Velg Sett inn et nytt trinn (+), og velg deretter Legg til en handling. Velg Kontroll-koblingen, og velg deretter handlingen Bruk på alle.
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.
Velg Sett inn et nytt trinn (+), og velg deretter Legg til en handling. Velg Variabel-koblingen, og velg deretter handlingen Tilføy til strengvariabel.

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']}

Legg til et linjeskift etter snutten for å få hvert resultat til å vises på en egen linje.
Legg til Tekst-utdata i handlingen Returner verdi(er) til Microsoft Copilot Studio. For Navn angir du FunneForretningsforbindelser. For Verdi velger du ListeOverForretningsforbindelser.
Velg Lagre.

Kall opp flyten fra Microsoft Copilot Studio

Velg Legg til node (+) på redigeringslerretet i Microsoft Copilot Studio, og velg deretter Kall opp en handling.
Velg flyten du opprettet tidligere, Søk etter forretningsforbindelse.
For Organisasjon får verdi fra velger du variabelen organisasjon.
Legg til en Melding-node, og skriv inn meldingen OK, her er det jeg fant.
Legg til en andre Melding-node. Velg Sett inn variabel, og velg deretter FunneForretningsforbindelser.
Velg Lagre.
Test kopiloten i ruten Test kopilot.

Del via