Práce s proměnnými

Proměnné můžete použít k ukládání odpovědí zákazníků a opakovanému použití jejich obsahu později v konverzaci.

Můžete také použít proměnné k vytvoření logických výrazů, které dynamicky směrují zákazníka různými cestami konverzace. Například uložte jméno zákazníka do proměnné s názvem „customerName“ a agent může během konverzace oslovit zákazníka jménem.

Proměnné lze také předávat a vracet z jiných témat a toků Power Automate.

Vytvoření proměnné

Webová aplikace

Každý uzel, který vrací výstup, například uzel Otázky , automaticky vytvoří výstupní proměnnou příslušného typu.

Zpropitné

Přejmenujte uzly, abyste je snáze identifikovali. Chcete-li název aktualizovat přímo, vyberte pole názvu uzlu nebo vyberte ikonu Další (…) pro uzel a z nabídky vyberte Přejmenovat. Můžete také přejmenovat uzly v editoru kódu.

Není možné přejmenovat uzly Trigger a Přejít na krok.

Názvy uzlů mohou mít délku až 500 znaků.

Klasický

1. Přejděte na stránku Témata klasického chatovacího robota a otevřete požadované téma.

2. Vyberte ikonu Přidat uzel pod uzlem, po kterém chcete přidat uzel otázky, a pak vyberte Položit otázku. Proměnná se automaticky vytvoří pro uložení odpovědi uživatele.

   

Výběr použité entity

Webová aplikace

Ve výchozím nastavení jsou vytvořeny uzly Otázka s možností výběru z více možností. Pokud chcete použít jinou předem připravenou nebo vlastní entitu, vyberte pole Identifikace a pak vyberte požadovaný typ informací.

Klasický

Ve výchozím nastavení jsou vytvořeny uzly Otázka s možností výběru z více možností. Pokud chcete použít jinou předem připravenou nebo vlastní entitu, vyberte pole Identifikace a pak vyberte požadovaný typ informací.

Přejmenování proměnné

Webová aplikace

Proměnným je po vytvoření automaticky přiřazen název. Osvědčeným postupem je dát proměnným smysluplné názvy, aby bylo jejich účel jasné všem, kdo musí udržovat vašeho agenta.

1. Vyberte proměnnou. Zobrazí se panel Vlastnosti proměnných.

2. V části Název proměnné zadejte požadovaný název proměnné.

Klasický

Automaticky vytvořené proměnné mají výchozí název. Pokud chcete proměnnou přejmenovat, vyberte její název, zadejte požadovaný název na panelu Vlastnosti proměnné a uložte změnu.

Nastavení proměnné

Obyčejně můžete použít uzel Otázka k uložení uživatelského vstupu do proměnné. Mohou ale nastat situace, kdy chcete nastavit hodnotu proměnné sami. V těchto případech použijte uzel Nastavit hodnotu proměnné.

1. Vyberte ikonu Přidat uzel pod uzlem, po kterém chcete přidat uzel Nastavit hodnotu proměnné .

2. Vyberte Správa proměnných>Nastavte hodnotu proměnné. Na pracovní ploše se zobrazí uzel nastavit hodnotu proměnné.

3. Vyberte pole v sekci Nastavit proměnnou a poté vyberte Vytvořit novou proměnnou. Vytvoří se nová proměnná. Její typ je neznámý, dokud mu nepřiřadíte hodnotu.

   

4. Pro Hodnota do přiřaďte hodnotu pomocí jedné z následujících možností:

   • Zadejte hodnotu literálu.
   • Vyberte existující proměnnou stejného typu.
   • Použijte vzorec Power Fx. Vzorce Power Fx jsou užitečné u složitějších typů, kde nelze použít doslovné hodnoty, například u typů Tabulka a Záznam.

Použití proměnných v uzlech akcí

Pokud v uzlu akce použijete proměnnou, pokud její základní typ odpovídá typu parametru určenému pro tok nebo dovednosti bot Frameworku, můžete ho do daného parametru nasměrovat. Výstup z uzlů akcí generuje nové proměnné.

Další kontext najdete v ukázkových scénářích volání toku agenta z tématu a předání informací pomocí vstupních a výstupních proměnných.

Použití hodnot literálů pro vstupy proměnných

V uzlech, kde můžete nastavit hodnotu vstupních parametrů, můžete vždy zadat hodnotu literálu místo výběru jiné proměnné jako hodnoty.

Uzel se pokouší interpretovat doslovné hodnoty jako řetězec, číslo nebo logickou hodnotu. Například 123 se interpretuje jako číslo. Pokud chcete tuto hodnotu interpretovat jako řetězec, můžete ji uzavřít do dvojitých uvozovek, například: „123“.

U některých scénářů (například používajících komplexní typy) může být k nastavení konkrétního typu nutné použít vzorec Power Fx.

Použití proměnných prostředí pro tajné klíče Azure Key Vault

Proměnná prostředí může odkazovat na tajný klíč v trezoru klíčů Key Vault. Tajné proměnné prostředí jsou zvláštním případem proměnných prostředí s jedinečnými aspekty.

Chcete-li vytvořit proměnnou prostředí tajného klíče v portálu Power Apps, musíte nakonfigurovat Key Vault.

Aby byl nástroj Copilot Studio autorizován ke čtení Key Vault, musíte provést následující akce:

1. Přiřaďte roli uživatele tajných kódů služby Key Vault k aplikaci Služba Microsoft Copilot Studio.

2. Pokud chcete autorizovat všechny agenty z prostředí pro přístup k tajnému kódu, vytvořte u tajného kódu značku AllowedEnvironments a přidejte ID povoleného prostředí oddělená čárkami.

3. Chcete-li povolit používání tohoto trezoru klíčů Key Vault pouze konkrétním agentům v prostředí, vytvořte značku AllowedAgents a vložte identifikátor agenta ve formátu {envId}/{schemaName}. V případě více hodnot je oddělte čárkami.

   Pokud dosáhnete maximálního počtu znaků, ale přesto potřebujete přidat další agenty, přidejte další značku s popisným, ale jedinečným názvem (například: AllowedAgents2).

Hodnota tajného klíče je uložena do mezipaměti v běhovém prostředí dialogu po dobu pěti minut. Neúspěšná čtení jsou uložena do mezipaměti po dobu 30 sekund.

Upozorňující

Přidáním tajného klíče do agenta můžete odhalit hodnotu tohoto tajného klíče. Každý, kdo může upravit agenta v prostředí, může přidat uzel Zpráva a vrátit hodnotu tajných proměnných prostředí ve zprávě.

Panel proměnných

Webová aplikace

Panel Proměnné je místo, kde můžete zobrazit všechny proměnné, které jsou k dispozici pro dané téma bez ohledu na to, ve kterých uzlech jsou definovány nebo použity. U každé proměnné můžete vybrat, zda může získat svou hodnotu z jiných témat, vrátit hodnotu do jiných témat nebo obojí. Můžete také vybrat proměnnou a upravit její vlastnosti v panelu Vlastnosti proměnné.

Panel Proměnné otevřete tak, že na řádku nabídek tématu vyberete Proměnné.

Klasický

Panel Proměnné je místo, kde můžete zobrazit všechny proměnné, které jsou k dispozici pro dané téma bez ohledu na to, ve kterých uzlech jsou definovány nebo použity. U každé proměnné můžete vybrat, zda může získat svou hodnotu z jiných témat, vrátit hodnotu do jiných témat nebo obojí. Můžete také vybrat proměnnou a upravit její vlastnosti v panelu Vlastnosti proměnné.

1. Na liště nabídek tématu vyberte Proměnné.

   

2. Pro každou z proměnných v tématu vyberte, zda chcete, aby se hodnoty mezi tématy předávaly, přijímaly, nebo obojí.

   

Panel vlastností proměnných

Na panelu Vlastnosti proměnné můžete proměnnou přejmenovat, zjistit, kde ji agent používá, nebo ji převést na globální proměnnou. Globální proměnnou však nelze převést zpět na proměnnou daného tématu. Můžete také vybrat, zda proměnná tématu může přijímat hodnoty z jiných témat nebo jim předávat svou hodnotu.

Chcete-li otevřít panel Vlastnosti proměnné některé proměnné, vyberte požadovanou proměnnou v panelu Proměnné. Panel Vlastností proměnných můžete otevřít také z libovolného uzlu, který používá proměnné, výběrem požadované proměnné.

Předávání proměnných mezi tématy

Když přesměrujete jedno téma na jiné, můžete předat hodnoty proměnných z původního tématu do cílového tématu a také vrátit hodnoty z cílového tématu do původního tématu. Předávání proměnných mezi tématy je zvláště užitečné, když dřívější téma již shromáždilo informace, které potřebuje pozdější téma. Vaši uživatelé určitě ocení, že nebudou muset odpovídat na stejné otázky více než jednou.

Příjem hodnot z jiných témat

Když téma definuje proměnnou (například pomocí uzlu Otázky), agent požádá uživatele o otázku, aby vyplnil hodnotu proměnné. Pokud agent již hodnotu získal v dřívějším tématu, není důvod klást otázku znovu. V těchto případech nastavte proměnnou na Přijímat hodnoty z jiných témat. Když jiné téma přesměruje na toto, může předat buď hodnotu proměnné nebo hodnotu literálu do této proměnné a otázku přeskočit. Fungování pro uživatele, který mluví s agentem, je bezproblémové.

Webová aplikace

V tomto příkladu používáme dvě témata Pozdrav a Rozhovor se zákazníkem. Obě témata vyžadují jméno zákazníka. Pokud se však nejprve spustí téma Pozdrav, téma Rozhovor se zákazníkem tuto otázku přeskočí. Místo toho použije hodnotu proměnné předanou z tématu Pozdrav.

Zde je tok tématu Rozhovor se zákazníkem:

Jak je znázorněno v testovacím panelu, pokud je toto téma spuštěno jako první, zeptá se uživatele: „Jak vám mám říkat?“ Uloží hodnotu do řetězcové proměnné s názvem customerName. Proměnná customerName je rovněž nastavena tak, aby získala svou hodnotu z jiných témat. Téma končí zprávou: „Doufám, že máte krásný den, customerName!“

Zde je tok tématu Pozdrav:

Jak je znázorněno v testovacím panelu, pokud je toto téma spuštěno jako první, zeptá se uživatele: „Jak se jmenujete?“ Uloží hodnotu do řetězcové proměnné s názvem customerName. Téma odešle zprávu: „Těší mě, že vás poznávám, customerName!“ Pak je přesměrováno na téma Rozhovor se zákazníkem, které odešle zprávu: „Doufám, že máte krásný den, customerName!“ Všimněte si však, že téma Rozhovor se zákazníkem přeskočilo opětovné zadání jména uživatele. Místo toho je použita hodnota proměnné customerName předaná z tématu Pozdrav.

Nakonec je tu opět druhá konverzace, tentokrát z pohledu tématu Rozhovor se zákazníkem:

Pojďme si projít jednotlivé kroky nastavení tématu pro příjem hodnot z jiných témat. Náš ukázkový scénář používá předdefinované téma Pozdrav jako zdrojové téma a nové téma Rozhovor se zákazníkem jako cílové téma, ale stejný postup funguje pro jakékoli téma, které by mělo používat hodnotu z předchozího tématu, pokud je to možné.

Nastavení cílového tématu

Cílové téma je téma, na které se přesměrovává, téma, které přijímá hodnoty z jiných témat. V našem příkladu je to Rozhovor se zákazníkem.

1. Vytvořte nové téma a nazvěte jej „Rozhovor se zákazníkem“.

2. Přidejte spouštěcí fráze jako „mluv se mnou“, „hovoř se mnou“, „chatuj se mnou“.

3. Přidejte uzel Otázka a do zprávy zadejte „Jak vás mám oslovovat?“.

4. V části Identifikace vyberte předem vytvořenou entitu Jméno osoby.

5. Vyberte název proměnné. Otevře se panel Vlastnosti proměnné.

6. Nahraďte výchozí název řetězcem „customerName“ a pak vyberte Přijímat hodnoty z jiných témat.

   

7. Přidejte uzel Zpráva.

8. Do pole se zprávou zadejte "Doufám, že máte krásný den, ".

9. Vyberte ikonu Vložit proměnnou ({x}) a potom vyberte customerName.

10. Vyberte mezeru za proměnnou a zadejte "!".

11. Uložte téma.

Nastavení zdrojového tématu

Zdrojové téma je téma provádějící přesměrování, které poskytuje hodnotu a předává ji cílovému tématu. V našem příkladu je to Pozdrav.

1. Přejděte na téma Pozdrav a odstraňte výchozí uzly s výjimkou uzlu Trigger.

2. Přidejte uzel Otázka a do zprávy zadejte „Jak se jmenujete?“.

3. V části Identifikace vyberte předem vytvořenou entitu Jméno osoby.

4. Nahraďte výchozí název proměnnou „customerNameFromGreeting“.

5. Přidejte uzel Zpráva.

6. Do pole zprávy zadejte "Těší mě, že vás poznávám, ".

7. Vyberte ikonu Vložit proměnnou ({x}) a potom vyberte customerNameFromGreeting.

8. Vyberte mezeru za proměnnou a zadejte "!".

9. Přidejte uzel Přesměrování a vyberte cílové téma Rozhovor se zákazníkem.

10. Vyberte Přidat vstup a poté vyberte proměnnou z cílového tématu, kam chcete předat hodnotu.

    

11. Vyberte ikonu > a pak vyberte proměnnou, jejíž hodnotu chcete předat, v tomto příkladu customerNameFromGreeting.

    Uzel Přesměrování by měl vypadat takto:

    

12. Uložte téma.

Klasický

Chcete-li přijímat hodnoty z jiných témat, nastavte vlastnost proměnné:

1. V uzlu Otázka vyberte proměnnou, pro kterou chcete přijímat hodnoty z jiných témat.

2. V panelu Vlastnosti proměnné v části Téma (omezený rozsah) vyberte Přijímat hodnoty z jiných témat.

   

   Poznámka:

   Proměnné typu Datum a čas, Doba trvání nebo Výběr z více možností a proměnné založené na vlastní entitě nelze předávat mezi tématy.

3. Uložte téma.

4. Přejděte na téma, na které chcete přesměrovat. Postupujte podle kroků v části Přesměrování na jiné téma pro přesměrování na správné téma.

5. Vyberte Přidat vstup pro cílové téma.

   

6. V přesměrovaném tématu vyberte proměnnou, které chcete proměnnou předat.

   

7. V části Zadejte nebo vyberte hodnotu vyberte proměnnou v aktuálním tématu, kterou chcete předat přesměrovanému tématu.

   

   Proměnná je zobrazena v přesměrovaném uzlu.

   

Vracení hodnot do původních témat

V rámci agenta je téma určeno ke shromažďování konkrétní informace. Několik dalších témat ji může volat a očekávat, že vrátí informace jako proměnnou. Proměnná se stane součástí původního tématu a dá se použít jako jakákoli jiná proměnná. Informace, které agent získá, jsou tak dostupné napříč tématy, což snižuje potřebu globálních proměnných.

Webová aplikace

Pokračujme příkladem z předchozí sekce. Položíme novou otázku v tématu Rozhovor se zákazníkem a odpověď potom vrátíme do tématu Pozdrav.

Nastavení zdrojového tématu pro vrácenou proměnnou

Když vracíte proměnnou do tématu, zdrojové téma je téma, které poskytuje hodnotu, která se má předat zpět původnímu tématu. V tomto příkladu je zdrojovým tématem Rozhovor se zákazníkem.

1. Jděte na zdrojové téma.

2. Přidejte uzel Otázka a do zprávy zadejte „Ve kterém městě bydlíte?“.

3. V části Identifikace vyberte předem vytvořenou entitu Město.

4. Vyberte proměnnou, kterou chcete otevřít na panelu Vlastnosti proměnné. Pojmenujte jej „customerCity“ a pak vyberte Vracet hodnoty do původních témat.

   

5. Přidejte uzel Zpráva.

6. Vyberte ikonu Vložit proměnnou ({x}) a potom vyberte customerCity.

7. Za proměnnou v poli se zprávou zadejte " v tomto ročním období musí být krásné!".

8. Uložte téma.

Nastavení cílového tématu pro vrácenou proměnnou

Když vracíte proměnnou do tématu, cílové téma je téma, které přijímá hodnoty z aktuálního tématu. V našem příkladu je cílové téma Greeting.

1. Jděte do cílového tématu.

2. Proměnná, kterou jste vybrali ve zdrojovém tématu, by se měla zobrazit v uzlu Přesměrování jako výstupní proměnná.

   

3. Uložte téma.

Klasický

Chcete-li vrátit proměnnou do původního tématu, nastavte vlastnost proměnné:

1. V uzlu Otázka vyberte proměnnou, pro kterou chcete přijímat hodnoty z jiných témat.

2. V panelu Vlastnosti proměnné v části Téma (omezený rozsah) vyberte Vracet hodnoty do původních témat.

   

   Poznámka:

   Proměnné typu Datum a čas, Doba trvání nebo Výběr z více možností a proměnné založené na vlastní entitě nelze předávat mezi tématy.

3. Uložte téma.

4. Přejděte na téma, na které chcete přesměrovat. Postupujte podle kroků v části Přesměrování na jiné téma pro přesměrování na správné téma.

   Proměnná, která se vrací do tématu, je zobrazena v tématu přesměrování. Použijte vrácenou proměnnou v tématu.

   

Parsování hodnot

Uzel Parsování hodnoty umožňuje převést hodnotu jednoho typu na hodnotu jiného typu. Běžným případem použití uzlu parsování hodnoty je převod nezpracovaného formátu JSON. Například agent volá tok, který následně volá API. Rozhraní API pak vrátí výsledek. Teď potřebujete způsob, jak tento výsledek analyzovat a vrátit jednu nebo více primitivních proměnných. Pomocí uzlu Analyzovat hodnotu můžete odeslat celý výsledek API jako řetězec, například toto:

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

Uzel Parse value může převést řetězcovou proměnnou, kterou máte nyní, na proměnnou typu Record, pro kterou editor Power Fx poskytuje automatické dokončování kódu a návrhy IntelliSense.

Kromě analýzy řetězců JSON je hlavní použití uzlu Parse value analýza nezatypovaných objektů při běhu programu. Nejběžnějším případem použití je, když obdržíte událost a potřebujete parsovat hodnotu této události. Nebo můžete chtít analyzovat vlastnost System.Activity.ChannelData, která se liší v modulu runtime podle kanálu.

Pokud potřebujete analyzovat informace z události přicházející z Teams, projděte si dokumentaci pro vývojáře Teams a najděte si příklad toho, jak očekávaná událost může vypadat. Pak můžete postupovat podle pokynů v této části pomocí ukázkové události jako ukázkových dat.

Přidejte uzel Analyzovat hodnotu do tématu:

1. Vyberte ikonu Přidat uzel pod uzlem, po kterém chcete parsovat hodnotu, přejděte na správu proměnných a vyberte Parsovat hodnotu.

2. Přidejte uzel Parsování hodnoty a vyberte proměnnou, kterou chcete parsovat.

   

3. Vyberte datový typ. V tomto případě zvolte Z ukázkových dat.

   

4. Vyberte Získat schéma z ukázkového formátu JSON, zadejte požadovaný příklad JSON v editoru, který se otevře, a vyberte Potvrdit.

   

5. Nakonec vyberte proměnnou, která má obsahovat parsovanou hodnotu. Obvykle byste vytvořili novou proměnnou.

   

   Výstupní proměnná má nyní očekávaný typ: záznam.

   

Související obsah

• Přehled proměnných
• Práce s globálními proměnnými
• Používání entit a vyplňování slotů v agentech
• Přizpůsobte si vzhled a chování agenta