Arbeta med variabler

Du kan använda variabler för att lagra kundernas svar och återanvända deras innehåll senare i konversationen.

Du kan också använda variabler för att skapa logiska uttryck som dynamiskt dirigerar kunden längs olika konversationsbanor. Spara till exempel ett kundnamn i en variabel kallad ”customerName” och agenten kan tilltala kunden vid namn under samtalets gång.

Variabler kan också skickas till och returneras från andra ämnen och Power Automate-flöden.

Skapa en variabel

Webbapp

Alla noder som returnerar utdata, till exempel en frågenod , skapar automatiskt en utdatavariabel av lämplig typ.

Tips

Byt namn på noder så att de blir enklare att identifiera. Välj nodens namnfält om du vill uppdatera namnet direkt eller välj ikonen Mer (…) för noden och välj Byt namn på menyn. Du kan också byta namn på noder i kodredigeraren.

Det går inte att byta namn på noder av typen Utlösare och Gå till steg.

Nodnamn kan vara upp till 500 tecken långa.

Klassisk

1. Gå till sidan Ämnen för din klassiska chattrobot och öppna önskat ämne.

2. Välj ikonen Lägg till nod under noden varefter du vill lägga till en frågenod och välj sedan Ställ en fråga. En variabel skapas automatiskt för att lagra användarens svar.

   

Välj en entitet att använda

Webbapp

Frågenoder skapas med flera alternativ som standard. Om du vill använda en annan fördefinierad eller anpassad entitet väljer du rutan Identifiera och väljer sedan önskad typ av information.

Klassisk

Frågenoder skapas med flera alternativ som standard. Om du vill använda en annan fördefinierad eller anpassad entitet väljer du rutan Identifiera och väljer sedan önskad typ av information.

Döpa om en variabel

Webbapp

Variabler tilldelas automatiskt ett namn när du skapar dem. Bästa praxis är att ge variablerna meningsfulla namn för att göra deras syfte tydligt för alla som måste underhålla din agent.

1. Välj variabeln. Panelen Egenskaper för variabel visas.

2. Under Variabelnamn anger du önskat namn för variabeln.

Klassisk

Variabler som skapas automatiskt kommer med ett standardnamn. Om du vill byta namn på en variabel väljer du dess namn, anger önskat namn i panelen Variabelegenskaper och sparar ändringen.

Ange en variabel

Vanligtvis använder du en frågenod för att spara användarindata i en variabel. Det kan dock finnas situationer där du vill ange värdet för en variabel själv. I dessa fall använder du noden Ange variabelvärde.

1. Välj ikonen Lägg till nod under noden varefter du vill lägga till noden Ange variabelvärde .

2. Välj Variabelhantering>Ange ett variabelvärde. Noden Ange variabelvärde visas på arbetsytan.

3. Välj rutan under Ange variabel och välj Skapa en ny variabel. En ny variabel har skapats. Dess typ är okänd tills du tilldelar det ett värde.

   

4. För Till-värde tilldelar du ett värde med hjälp av något av följande alternativ:

   • Skriv ett literalt värde.
   • Välj en befintlig variabel av samma typ.
   • Använda en Power Fx-formel. Power Fx-formler är mer användbara för mer komplexa typer där literala värden inte kan användas, till exempel tabell- och posttyper.

Använda variabler i åtgärdsnoder

När du använder en variabel i en åtgärdsnod , om dess bastyp matchar en parametertyp som angetts för ett flöde eller för en Bot Framework-färdighet, kan du skicka den till den parametern. Utdata från åtgärdsnoder genererar nya variabler.

Mer kontext finns i exempelscenarier i Anropa ett agentflöde från ett ämne och Använd indata- och utdatavariabler för att skicka information.

Använd literala värden för variabla indata

I noder där du kan ange ett värde för indataparametrar kan du alltid ange ett literalt värde i stället för att välja en annan variabel som värde.

Noden försöker tolka bokstavliga värden som sträng, tal eller boolesk. Till exempel tolkas 123 som ett tal. Om vill att det ska tolkas som ett strängvärde kan du innesluta värdet i dubbla citattecken, som: ”123”.

I vissa scenarier (till exempel scenarier med komplexa typer) kan du behöva använda en Power Fx-formel för att ange en viss typ.

Använd Azure Key Vault-hemligheter i miljövariabler

En miljövariabel kan referera till en säkerhetsnyckel i Key Vault. Hemliga miljövariabler är ett speciellt fall av miljövariabler med unika saker att tänka på.

För att kunna skapa en hemlig miljövariabel i Power Apps-portalen måste du konfigurera dess Key Vault.

För att auktorisera Copilot Studio så att det går att läsa denna Key Vault måste du utföra följande åtgärder:

1. Tilldela rollen Key Vault Secrets User till Microsoft Copilot Studio Service-programmet .

2. Om du vill ge alla agenter från miljön åtkomst till hemligheten skapar du en tagg AllowedEnvironments på hemligheten och lägger till de tillåtna miljö-ID:na avgränsade med kommatecken.

3. Om du endast vill tillåta vissa agenter från miljön att använda Key Vault skapar du en tagg AllowedAgents och sätter agentidentifieraren i formatet {envId}/{schemaName}. För flera värden, separera värdena med kommatecken.

   Om du når det maximala antalet tecken men ändå behöver lägga till fler agenter lägger du till en annan tagg med ett beskrivande men unikt namn (till exempel: AllowedAgents2).

Det hemliga värdet cachelagras i körtiden Dialog i fem minuter. Misslyckade läsningar cachelagras i 30 sekunder.

Varning!

Genom att infoga hemligheten i agenten kan du avslöja värdet av denna hemlighet. Alla som kan redigera agenten i miljön kan lägga till en meddelandenod och returnera värdet för de hemliga miljövariablerna i ett meddelande.

Panelen Variabler

Webbapp

I panelen Variabler kan du visa alla variabler som är tillgängliga för ett ämne, oavsett vilka noder de definieras eller används i. För varje variabel kan du välja om den ska kunna ta emot värdet från andra ämnen, returnera värdet till andra ämnen eller både och. Du kan också välja en variabel för att redigera dess egenskaper på panelen Variabelegenskaper.

Öppna panelen Variabler genom att välja Variabler på ämnets menyrad.

Klassisk

I panelen Variabler kan du visa alla variabler som är tillgängliga för ett ämne, oavsett vilka noder de definieras eller används i. För varje variabel kan du välja om den ska kunna ta emot värdet från andra ämnen, returnera värdet till andra ämnen eller både och. Du kan också välja en variabel för att redigera dess egenskaper på panelen Variabelegenskaper.

1. Välj Variabler ämne på menyraden i menyn.

   

2. För var och en av variablerna i ämnet, välj om du vill att värdena ska skickas, tas emot eller båda mellan ämnena.

   

Panelen Variabelegenskaper

På panelen Variabelegenskaper kan du byta namn på en variabel, se var agenten använder den eller konvertera den till en global variabel. Det går inte att konvertera tillbaka en global variabel till en ämnesvariabel. Du kan också välja om en ämnevariabel kan ta emot värden från eller skicka dess värde till andra ämnen.

För att öppna panelen Variabelegenskaper för en variabel markerar du den önskade variabeln i panelen Variabler. Du kan också öppna panelen Variabelegenskaper från valfri nod som använder variabler genom att välja önskad variabel.

Skicka variabler mellan avsnitt

När du omdirigerar ett ämne till ett annat kan du skicka värdena för variabler från det ursprungliga ämnet till målämnet och även returnera värden från destinationsämnet till det ursprungliga ämnet. Att skicka variabler mellan ämnen är särskilt användbart när ett tidigare ämne redan samlat in information som ett senare ämne behöver. Dina användare uppskattar verkligen att de inte behöver svara på samma frågor mer än en gång.

Ta emot värden från andra ämnen

När ett ämne definierar en variabel (till exempel via en frågenod) agenten ställer frågan till användaren för att fylla i variabelns värde. Om agenten redan förvärvat värdet i ett tidigare ämne finns det ingen anledning att ställa frågan igen. I dessa fall kan du ange variabeln till Ta emot värden från andra avsnitt. När ett annat ämne omdirigerar till det här, kan det skicka antingen värdet för en variabel (eller ett bokstavligt värde) i den här variabeln, och den hoppar över frågan helt. Upplevelsen för användaren att prata med agenten är sömlös.

Webbapp

I det här exemplet använder vi två ämnen: Hälsning och Samtal med kund. I båda avsnitten uppmanas kunden att ange ett namn. Om Hälsningsämne körs först hoppar ämnet Samtal med kund över frågan. I stället används värdet för variabeln som skickades från ämnet Hälsning.

Här är flödet av ämnet Samtal med kund:

Som du ser i testpanelen, om det här avsnittet utlöses först, frågar det användaren: ”Vad ska jag kalla dig?” Den lagrar värdet i en strängvariabel som kallas customerName. Variabeln customerName är också inställd för att få sitt värde från andra ämnen. Ämnet avslutas med meddelandet ”Jag hoppas att du har en underbar dag customerName!”

Här är flödet av Hälsningsämnet:

Som du ser i testpanelen, om det här avsnittet utlöses först, frågar det användaren: ”Vad heter du?” Den lagrar värdet i en strängvariabel som kallas customerName. Ämnet skickar meddelandet ”Trevligt att träffas customerName!” Det omdirigerar sedan till ämnet Samtal med kund som skickar meddelandet ”Jag hoppas att du har en underbar dag customerName!” Observera emellertid att ämnet Samtal med kund hoppade över att fråga efter användarens namn igen. I stället används värdet för variabeln customerName som skickades från ämnet Hälsning.

Slutligen här är det andra samtalet igen, den här gången utifrån ett ämnet Samtal med kund:

Nu ska vi gå igenom stegen för att konfigurera en ämne som ska ta emot värden från andra avsnitt. Vårt exempelscenario använder det fördefinierade ämnet Hälsning som källämne och ett nytt ämne Samtal med kund som målämne, men samma steg fungerar för alla ämnen som bör använda ett värde från ett tidigare ämne när det är möjligt.

Konfigurera målämnet

Målämnet är det ämne som du omdirigeras till, det som tar emot värden från andra ämnen. I vårt exempel är det Samtal med kund.

1. Skapa ett nytt ämne och kalla det för ”Samtal med kund”.

2. Lägg till utlösande fraser som ”prata med mig”, ”tala med mig”, ”prata med mig”.

3. Lägg till en frågenod och skriv ”Vad ska jag kalla dig?” för meddelandet.

4. Under Identitet, välj den fördefinierade entiteten Personnamn.

5. Välj namnet på variabel. Panelen för Variabelegenskaper öppnas.

6. Ersätt standardnamnet med ”customerName” och välj sedan Ta emot värden från andra ämnen.

   

7. Lägga till en nod av typen Meddelande.

8. I meddelanderutan skriver du ”Jag hoppas att du har en underbar dag”.

9. Välj ikonen Infoga variabel icon ({x}) och välj sedan customerName.

10. Markera utrymmet efter variabeln och ange ”!”.

11. Spara ämnet.

Ange källämne

Källämnet är ämnet som dirigerar om, det ämne som tillhandahåller värdet och skickar det till målämnet. I vårt exempel är det Hälsning.

1. Gå till ämnet Hälsning och ta bort standardnoderna, förutom noden Utlösaren.

2. Lägg till en frågenod och skriv ”Vad heter du?” för meddelandet.

3. Under Identitet, välj den fördefinierade entiteten Personnamn.

4. Ersätt standardnamnet med ”customerNameFromGreeting”.

5. Lägga till en nod av typen Meddelande.

6. I meddelanderutan anger du ”Trevligt att träffas”.

7. Välj ikonen Infoga variabel icon ({x}) och välj sedan customerNameFromGreeting.

8. Markera utrymmet efter variabeln och ange ”!”.

9. Lägg till en nod för Omdirigera och välj målämnet Samtal med kund.

10. Välj Lägg till indata och välj sedan variabeln från målämnet som du vill skicka ett värde till.

    

11. Välj ikonen > och välj sedan variabeln vars värde du vill skicka customerNameFromGreeting, i det här exemplet.

    Omdirigeringsnoden bör se ut så här:

    

12. Spara ämnet.

Klassisk

Om du vill ta emot värden från andra avsnitt anger du variabelns egenskap:

1. I noden Fråga markerar du den variabel som du vill ta emot värden från andra avsnitt.

2. I panelen Variabelegenskaper under Ämne (begränsad omfattning) välj Ta emot värden från andra ämnen.

   

   Obs

   Variabler av typen Datum och tid, Varaktighet eller Flera alternativ och variabler som bygger på en anpassad entitet kan inte skickas mellan ämnen.

3. Spara ämnet.

4. Gå till en ämne som du vill omdirigera till. Följ anvisningarna i Omdirigera till en annan ämne om du vill omdirigera till rätt ämne.

5. Välj Lägg till indata för målämne.

   

6. Markera den variabel du vill använda från den ämne som du vill skicka variabeln till.

   

7. Under Ange eller välj ett värde, välj variabeln från det aktuella ämnet som du vill skicka till det omdirigerade ämnet.

   

   Variabeln visas i den omdirigerade noden.

   

Återställ värden till ursprungliga ämnen

I en agent är ett ämne avsett att samla in specifik information. Flera andra ämnen kan anropa den och förvänta sig att den returnerar informationen som en variabel. Variabeln blir en del av det ursprungliga ämnet och kan användas som vilken annan variabel som helst. Information som agent får är därmed tillgänglig över ämnesgränserna, vilket minskar behovet av globala variabler.

Webbapp

Vi fortsätter med exemplet från föregående avsnitt. Vi ställer en ny fråga i ämnet Samtal till kund och returnerar svaret på ämnet Hälsning.

Ställ in källämnet för en returnerad variabel

När du returnerar en variabel till ett ämne är källämnet det ämne som tillhandahåller det värde som ska vidarebefordras till det ursprungliga ämnet. I det här exemplet är källämnet Samtal med kund.

1. Gå till källämnet.

2. Lägg till en frågenod och skriv ”I vilken stad bor du i?” för meddelandet.

3. Under Identitet, välj den fördefinierade entiteten Ort.

4. Välj variabeln för att öppna den i panelen Variabelegenskaper. Ge den namnet ”customerCity” och välj sedan Returnera värden till ursprungliga ämnen.

   

5. Lägga till en nod av typen Meddelande.

6. Välj ikonen Infoga variabel icon ({x}) och välj sedan customerCity.

7. Efter variabeln i meddelanderutan skriv ”det måste vara vackert så här års!”.

8. Spara ämnet.

Ställ in målämnet för en returnerad variabel

När du returnerar en variabel till ett avsnitt är målämnet det ämne som tar emot värden från det aktuella avsnittet. I vårt exempel är destinationsämnet ämnet Hälsning.

1. Gå till målämnet.

2. Variabeln du valde i källämnet ska visas på noden Omdirigera som en utdatavariabel.

   

3. Spara ämnet.

Klassisk

Om du vill returnera en variabel till ämne anger du variabelns egenskap:

1. I noden Fråga markerar du den variabel som du vill ta emot värden från andra avsnitt.

2. I panelen Variabelegenskaper under Ämne (begränsat omfång) välj Återställ värden till ursprungliga ämnen.

   

   Obs

   Variabler av typen Datum och tid, Varaktighet eller Flera alternativ och variabler som bygger på en anpassad entitet kan inte skickas mellan ämnen.

3. Spara ämnet.

4. Gå till en ämne som du vill omdirigera till. Följ anvisningarna i Omdirigera till en annan ämne om du vill omdirigera till rätt ämne.

   Variabeln som returneras till ämne visas i den omdirigerade ämne. Använd variabeln som returneras i ämne.

   

Analysera värden

Med noden Parsa värde kan du konvertera ett värde av en typ till ett värde av en annan typ. Ett vanligt användningsfall för noden Parsa-värde är att konvertera rå JSON. En agent anropar till exempel ett flöde som i sin tur anropar ett API. API returnerar ett resultat. Nu behöver du ett sätt att parsa det här resultatet och returnera en eller flera primitiva variabler. Med noden Parsa-värde kan du skicka hela API-resultatet som en sträng, till exempel följande:

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

Noden Parsa värde kan konvertera strängvariabeln som du nu har till en variabel av typen Post, för vilken Power Fx-redigeraren tillhandahåller kodkomplettering och förslag med IntelliSense.

Förutom att parsa JSON-strängar är en nyckelfunktion för noden Parsa värde att parsa otypade objekt vid körtid. Det vanligaste användningsfallet är när du tar emot en händelse och du måste tolka händelsevärdet. Eller så kanske du vill parsa egenskapen System.Activity.ChannelData, som varierar vid körning beroende på kanal.

Om du behöver parsa information från en händelse som kommer från Teams kan du läsa dokumentationen för Teams-utvecklare för att hitta ett exempel på hur den förväntade händelsen kan se ut. Du kan sedan följa anvisningarna i det här avsnittet med exempelhändelsen som exempeldata.

Så här lägger du till en tolkningsvärde-nod i ett ämne:

1. Välj ikonen Lägg till nod under noden varefter du vill parsa ett värde, peka på Variabelhantering och välj Parsa-värde.

2. Lägg till en nod för Parsa värde och markera den variabel som du vill parsa.

   

3. Välj datatyp. Välj i så fall Från exempeldata.

   

4. Välj Hämta schema från JSON-exempel, ange önskat JSON-exempel i redigeraren som öppnas och välj Bekräfta.

   

5. Välj slutligen variabeln för att lagra det parsade värdet. Vanligtvis skapar du en ny variabel.

   

   Utdatavariabeln har nu den förväntade typen: record.

   En skärmbild som visar att variabeln som innehåller parsade data har den förväntade typen: record.

Relaterat innehåll

• Översikt över variabler
• Arbeta med globala variabler
• Använda entiteter och platsfyllning i agenter
• Anpassa agentens utseende och känsla