Del via

Arbeid med variabler

Bruk variabler til å lagre kundenes svar, slik at du kan bruke innholdet på nytt senere i samtalen.

Du kan også bruke variabler til å lage logiske uttrykk som dynamisk ruter kunden gjennom forskjellige diskusjonsbaner. Lagre for eksempel navnet på en kunde i en variabel kalt customerName, og agenten kan adressere kunden etter navn etter hvert som samtalen fortsetter.

Du kan sende variabler til og returnere dem fra andre emner og Power Automate-flyter.

Opprett en variabel

Enhver node som returnerer et utdata, for eksempel en spørsmålsnode, oppretter automatisk en utdatavariabel av riktig type.

Skjermbilde av en spørsmålsnode, med standardnavnet og typen for variabelen uthevet.

Tips

Gi nytt navn til noder for å gjøre dem lettere å identifisere. Velg nodens navnefelt for å oppdatere navnet direkte, eller velg de tre prikkene (...) i noden og velg Omdøp fra menyen. Du kan også endre navn på noder i redigeringsprogrammet for kode.

Det er ikke mulig å gi nytt navn utløsernoder og Gå til trinn-noder .

Navn på noder kan være opptil 500 tegn.

Velg en enhet du vil bruke

Spørsmålsnoder bruker flervalgsalternativer som standard. Hvis du vil bruke en annen forhåndsbygd eller egendefinert enhet, velger du Identifiser-boksen , og deretter velger du hvilken type informasjon du vil bruke.

Skjermbilde av en spørsmålsnode med panelet

Gi nytt navn til en variabel

Hvis du vil gjøre det enklere å vedlikeholde agentene dine, erstatter du standardnavnet for hver variabel med et meningsfylt navn.

  1. Velg variabelen. Panelet Variabelegenskaper vises.

  2. Skriv inn navnet du vil bruke for variabelen, under Variabelnavn.

Angi en variabel

Vanligvis bruker du en spørsmålsnode til å lagre brukerinndata i en variabel. Det kan imidlertid hende du vil angi verdien for en variabel selv. I slike tilfeller bruker du noden Angi variabelverdi.

  1. Velg ikonet Legg til node under noden der du vil legge til en Angi variabel verdinode .

  2. Velg Variabelbehandling>Angi en variabelverdi. En angi variabel verdinode vises på lerretet.

  3. Velg boksen under Angi variabel. Panelet for å velge en variabel vises.

    • Hvis variabelen du vil angi allerede finnes, velger du den.

    • Ellers velger du Opprett ny. Denne handlingen oppretter en ny variabel. Typen er ukjent før du tildeler en verdi til den.

      Skjermbilde av noden Angi variabelverdi med en ny variabel av ukjent type.

  4. Tilordne en verdi for Til verdi ved hjelp av ett av følgende alternativer:

    • Skriv inn en litteralverdi.

    • Velg en eksisterende variabel av samme type.

    • Bruk en Power Fx-formel. Power Fx-formler er nyttige for mer kompliserte typer der litterale verdier ikke kan brukes, for eksempel tabell- og oppføringstyper.

Bruke variabler i handlingsnoder

Når du bruker en variabel i en handlingsnode , kan du mate den til denne parametertypen hvis basistypen samsvarer med en parametertype som er angitt for en flyt, eller for en Bot Framework-ferdighet. Utdataene fra handlingsnoder genererer nye variabler.

Hvis du vil ha mer kontekst, kan du se eksempelscenarioene i Ringe en agentflyt fra et emne og bruke inndata- og utdatavariabler til å sende informasjon.

Bruk litterale verdier for variabelinndata

I en node der du angir en verdi for inndataparametere, kan du angi en litteralverdi i stedet for å velge en annen variabel som verdi.

Skjermbilde som viser bruken av en litteral verdi for en variabel inndataparameter med navnet productName.

Noden prøver å tolke litterale verdier som en streng, et tall eller en boolsk. 123 tolkes for eksempel som et tall. Hvis du vil at den skal tolkes som en strengverdi i stedet, kan du bryte verdien i doble anførselstegn, slik som dette: «123».

For enkelte scenarioer, for eksempel scenarioer som bruker komplekse typer, må du kanskje bruke en Power Fx-formel til å angi en bestemt type.

Bruk miljøvariabler for Azure Key Vault Secrets

En miljøvariabel kan referere til en hemmelighet i Key Vault. Hemmelige miljøvariabler er et spesielt tilfelle med miljøvariabler med unike hensyn.

Hvis du vil opprette en hemmelig miljøvariabel i Power Apps, må du konfigurere et Key Vault-hvelv.

Hvis du vil godkjenne at Copilot Studio leser dette Key Vault-hvelvet, fullfører du følgende handlinger:

  1. Tilordne brukerrollen Key Vault Secrets til Microsoft Copilot Studio Service-programmet .

  2. Hvis du vil godkjenne at alle agenter fra miljøet får tilgang til hemmeligheten, oppretter du en kode AllowedEnvironments på hemmeligheten og legger til de tillatte miljø-ID-ene atskilt med komma.

  3. Hvis du bare vil godkjenne bestemte agenter fra miljøet til å bruke dette hvelvet, oppretter du en kode AllowedAgents og plasserer agentidentifikatoren i formatet {envId}/{schemaName}. Skill verdiene med komma for flere verdier.

    Hvis du når maksimalt antall tegn, men fortsatt trenger å legge til flere agenter, legger du til et nytt merke med et beskrivende, men unikt navn (for eksempel: AllowedAgents2).

Dialogbokskjøring bufrer den hemmelige verdien i fem minutter. Den bufrer mislykkede lesinger i 30 sekunder.

Advarsel!

Ved å legge til hemmeligheten i agenten, kan du vise verdien av denne hemmeligheten. Alle som kan redigere agenten i miljøet, kan legge til en meldingsnode og returnere verdien for de hemmelige miljøvariablene i en melding.

Variabler-panelet

I Variabler-panelet kan du vise alle variablene som er tilgjengelige for et emne, uavhengig av hvilke noder de er definert eller brukt i.

Hvis du vil åpne Variabler-panelet , velger du Variabler på menylinjen for emnet.

Skjermbilde av Variabler-panelet, med Variabler-knappen uthevet.

For hver emnevariabel kan du velge om den kan motta verdien fra andre emner, returnere verdien til andre emner eller begge deler. Du kan også velge en variabel for å redigere egenskapene for den i panelet Egenskaper for variabel.

Panelet Egenskaper for variabel

I egenskapspanelet Variabel kan du gi nytt navn til en variabel, se hvor agenten bruker den, eller konvertere den til en global variabel. Du kan ikke konvertere en global variabel tilbake til en emnevariabel. Du kan også velge om en emnevariabel kan motta verdier fra eller sende verdien til andre emner.

Du kan åpne panelet Egenskaper for variabel for en variabel ved å velge den ønskede variabelen i Variabler-panelet. Du kan også åpne egenskapspanelet Variabel fra en hvilken som helst node som bruker variabler, ved å velge ønsket variabel.

Send variabler mellom emner

Når du omdirigerer ett emne til et annet, kan du sende verdiene for variabler fra det opprinnelige emnet til målemnet, og også returnere verdier fra målemnet til det opprinnelige emnet. Det er spesielt nyttig å sende variabler mellom emner når et tidligere emne allerede har hentet inn informasjon som et senere emne trenger. Brukerne setter absolutt pris på at de ikke trenger å svare på de samme spørsmålene mer enn én gang.

Motta verdier fra andre emner

Når et emne definerer en variabel (for eksempel i en spørsmålsnode), ber agenten brukeren om å fylle inn verdien for variabelen. Hvis agenten allerede har hentet verdien i et tidligere emne, er det ingen grunn til å stille spørsmålet på nytt. Du kan angi Motta verdier fra andre emner for variabelen i slike tilfeller. Når et annet emne omdirigeres til dette, kan det sende verdien for en variabel eller en litteralverdi til denne variabelen og hoppe over spørsmålet. Opplevelsen for sluttbrukeren som snakker med agenten, er sømløs.

Dette eksemplet bruker to emner, Hilsning og Snakk med kunde. Begge emnene ber om kundens navn. Hvis Hilsning-emnet kjører først, vil imidlertid Snakk med kunde-emnet hoppe over spørsmålet. I stedet brukes verdien av variabelen som sendes fra Hilsning-emnet.

Her er flyten i Snakk til kunde-emnet:

Skjermbilde av samtaleflyten for Snakk til kunde-emnet.

Som vist i testpanelet, hvis dette emnet utløses først, spør den brukeren: «Hva skal jeg kalle deg?» Den lagrer verdien i en strengvariabel kalt customerName. Variabelen customerName er også satt til å hente verdien fra andre emner. Emnet avsluttes med meldingen "Jeg håper du har en flott dag, customerName!"

Her er flyten i Hilsning-emnet:

Skjermbilde av samtaleflyten for Hilsning-emnet.

Som vist i testpanelet, hvis dette emnet utløses først, spør den brukeren: «Hva heter du?» Den lagrer verdien i en strengvariabel kalt customerName. Emnet sender meldingen "Hyggelig å møte deg, customerName!" Deretter omdirigerer det til Snakk med kunde-emnet, som sender meldingen "Jeg håper du har en flott dag, customerName!" Vær imidlertid oppmerksom på at Snakk med kunde-emnet hoppet over å be om brukerens navn på nytt. I stedet brukte den verdien for variabelen customerName som ble sendt fra hilsningsemnet .

Til slutt, her er den andre samtalen igjen, denne gangen fra perspektivet til Snakk til kunde-emnet:

Skjermbilde av samtaleflyten for Snakk til kunde-emnet når Hilsning-emnet utløses først.

Gå gjennom trinnene for å konfigurere et emne for å motta verdier fra andre emner. Dette eksempelscenarioet bruker det forhåndsdefinerte emnet Hilsen som kildeemne, og et nytt emne Snakk med kunde som målemne, men de samme trinnene fungerer for et emne som bør bruke en verdi fra et tidligere emne når det er mulig.

Konfigurer målemnet

Målemnet mottar verdier fra andre emner. I dette eksemplet er det Snakk med kunde.

  1. Opprett et nytt emne, og gi det navnet «Snakk med kunde».

  2. Legg til utløseruttrykk som «snakk med meg», «snakk med meg» og «chat med meg».

  3. Legg til en spørsmålsnode, og skriv inn "Hva skal jeg kalle deg?" for meldingen.

  4. Velg den forhåndsbygde enheten Personnavn under Identifiser.

  5. Velg navnet på variabelen. Panelet Egenskaper for variabel åpnes.

  6. Erstatt standardnavnet med customerName, og velg deretter Motta verdier fra andre emner.

    Skjermbilde av panelet Variable egenskaper viser customerName-variabelen og egenskapene.

  7. Legg til en Melding-node.

  8. Skriv inn "Jeg håper du har en flott dag" i meldingsboksen.

  9. Velg ikonet Sett inn variabel ({x}), og velg deretter customerName.

  10. Velg mellomrommet etter variabelen, og skriv inn et utropstegn (!).

  11. Lagre emnet.

Sett opp kildeemnet

Kildeemnet er emnet som omdirigerer til et annet emne. Den gir verdien og sender den til målemnet. I dette eksemplet er det Hilsen.

  1. Gå til Hilsning-emnet, og slett standardnodene bortsett fra Utløser-noden.

  2. Legg til en spørsmålsnode, og skriv inn "Hva heter du?" for meldingen.

  3. Velg den forhåndsbygde enheten Personnavn under Identifiser.

  4. Erstatt standardnavnet med customerNameFromGreeting.

  5. Legg til en Melding-node.

  6. Skriv inn "Hyggelig å møte deg" i meldingsboksen.

  7. Velg ikonet Sett inn variabel ({x}), og velg deretter customerNameFromGreeting.

  8. Velg mellomrommet etter variabelen, og skriv inn et utropstegn (!).

  9. Legg til en Omdiriger-node , og velg målemnet Snakk med Kunde.

  10. Velg Legg til inndata og velg variabelen fra målemnet som du vil sende en verdi til.

    Skjermbilde av Hilsning-emnet med variabelen customerName lagt til som inndata i en omdirigeringsnode.

  11. Velg >-ikonet, og velg deretter variabelen som du vil sende verdien for, customerNameFromGreeting, i dette eksemplet.

    Omdirigeringsnoden skal se slik ut:

    Skjermbilde av den fullførte Omadressering-noden i hilsningsemnet.

  12. Lagre emnet.

Returner verdier til opprinnelige emner

I en agent samler et emne inn en bestemt del av informasjonen. Flere andre emner kan kalle det og forvente at informasjonen returneres som en variabel. Variabelen blir en del av det opprinnelige emnet og kan brukes som alle andre variabler. Ved å gjøre informasjonen agenten får tilgjengelig på tvers av emner, reduserer denne tilnærmingen behovet for globale variabler.

La oss fortsette med eksemplet fra forrige del. Du stiller et nytt spørsmål i emnet Snakk med kunde , og deretter returnerer du svaret på hilsningsemnet .

Konfigurer kildeemnet for en returnert variabel

Når du returnerer en variabel til et emne, er kildeemnet emnet som gir verdien som skal sendes tilbake til det opprinnelige emnet. I dette eksemplet er kildeemnet Snakk med kunde.

  1. Gå til kildeemnet.

  2. Legg til en spørsmålsnode, og skriv inn "Hvilken by bor du i?" for meldingen.

  3. Velg den forhåndsbygde enheten Poststed under Identifiser.

  4. Velg variabelen for å åpne panelet Egenskaper for variabel. Gi den et navn customerCity, og velg deretter Returner verdier til opprinnelige emner.

    Skjermbilde av emnet Snakk med kunde med variabelen customerCity og egenskapene uthevet.

  5. Legg til en Melding-node.

  6. Velg ikonet Sett inn variabel ({x}), og velg deretter customerCity.

  7. Etter variabelen i meldingsboksen skriver du inn «må være flott på denne tiden av året!».

  8. Lagre emnet.

Konfigurer målemnet for en returnert variabel

Når du returnerer en variabel til et emne, mottar målemnet verdier fra gjeldende emne. I eksemplet nedenfor er målemnet Hilsen.

  1. Gå til målemnet.

  2. Variabelen du valgte i kildeemnet, vises på omadresseringsnoden som en utdatavariabel.

    Skjermbilde av samtaleflyten for Hilsning-emnet med en returnert variabel i en omdirigeringsnode.

  3. Lagre emnet.

Analyser verdier

Analyseverdinoden konverterer en verdi fra én type til en annen. Et vanlig brukstilfelle for analyseverdinoden konverterer rå JSON. En agent kaller for eksempel en flyt som kaller et API. API-en returnerer et resultat. Du trenger en metode for å analysere dette resultatet og returnere én eller flere primitive variabler. Ved hjelp av analyseverdinoden kan du sende hele API-resultatet som en streng, for eksempel følgende:

{
    "Name": "Parker",
    "Position": "Product manager",
    "Company": "Contoso",
    "FormerPositions": [{
            "Position": "Customer service representative"
        }
    ]
}

Analyseverdinoden konverterer strengvariabelen til en variabel av typen Post. Power Fx-redigeringsprogrammet gir fullføring av IntelliSense-kode og forslag til denne typen.

I tillegg til å analysere JSON-strenger, analyserer en nøkkelbruk for analyseverdinoden uskrevne objekter ved kjøring. Det vanligste brukstilfellet er når du mottar en hendelse og må analysere hendelsesverdien. Eller du vil kanskje analysere System.Activity.ChannelData egenskapen, som varierer etter kanal.

Hvis du trenger å analysere informasjon fra en hendelse som kommer fra Teams, kan du se utviklerdokumentasjonen for Teams for å finne et eksempel på hvordan den forventede hendelsen kan se ut. Deretter kan du følge instruksjonene i denne delen ved å bruke eksempelhendelsen som eksempeldata.

Slik legger du til en analyseverdinode i et emne:

  1. Velg ikonet Legg til node under noden der du vil analysere en verdi. Pek på variabel behandling, og velg Analyser verdi.

  2. Legg til en Analyser verdi-node, og velg variabelen du vil analysere.

    Skjermbilde som viser valg av variabel som skal analyseres.

  3. Velg Fra eksempeldata for datatypen.

    Skjermbilde som viser valg av datatype for en Analyser verdi-node.

  4. Velg Hent skjema fra eksempel-JSON, skriv inn det ønskede JSON-eksemplet i redigeringsprogrammet som åpnes, og velg Bekreft.

    Skjermbilde som viser redigeringsprogrammet der du skriver inn eksempeldata for JSON.

  5. Velg variabelen som skal inneholde den analyserte verdien. Vanligvis oppretter du en ny variabel.

    Skjermbilde som viser hvordan du oppretter en variabel for å holde en analysert verdi direkte fra analyseverdinoden.

    Utdatavariabelen har nå forventet type: post.

    Skjermbilde som viser at variabelen som holder de analyserte dataene, har forventet type: post.

Relatert innhold

  • Last updated on