Práce s proměnnými

Můžete používat proměnné a uložit odpovědi zákazníků a znovu je použít 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 UserName a agent může zákazníka oslovovat jménem, ​​zatímco konverzace pokračuje.

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

Webová aplikace

Proměnné mohou existovat na čtyřech úrovních, neboli v rozsazích:

• téma proměnné lze použít pouze v tématech, ve kterých byly vytvořeny. Tento rozsah je výchozí pro vytvořené proměnné.
• Globální proměnné lze použít ve všech tématech. Rozsah proměnné tématu můžete změnit tak, aby se stala globální proměnnou.
• Systémové proměnné se vytváří automaticky pomocí agent. Poskytují více kontextových informací o konverzaci nebo uživateli. Jsou k dispozici ve všech tématech.
• Proměnné prostředí jsou vytvořeny v Power Platform a jsou pouze pro čtení v Copilot Studio. Uchovávají klíče a hodnoty parametrů, které pak slouží jako vstup do různých dalších objektů aplikace, včetně Copilot Studio. Oddělení parametrů od spotřebovávajících objektů umožňuje měnit hodnoty ve stejném prostředí nebo při migraci řešení do jiných prostředí. Alternativou je ponechání napevno kódovaných hodnot parametrů uvnitř komponent, které je používají.

Typy proměnné

Proměnná je spojena se základním typem. Typ určuje, jaké hodnoty může proměnná obsahovat, a operátory, které lze použít při konstrukci logického výrazu s příslušnou proměnnou.

Type	Description
Řetězcové	Posloupnost znaků používaná k reprezentaci textu
Logické	Logická hodnota, která může být pouze true nebo false
Počet	Libovolné reálné číslo
Table	Seznam hodnot, ale všechny hodnoty musí být stejného typu
Zaznamenat	Kolekce dvojic název-hodnota, kde hodnoty mohou být libovolného typu
DateTime	Datum, čas, den v týdnu nebo měsíc vztažený k určitému časovému bodu
Výběr	Seznam hodnot řetězců s přidruženými synonymy
prázdnou	Zástupný symbol pro „žádná hodnota“ nebo „neznámá hodnota“; další informace naleznete v části Prázdné hodnoty v Power Fx.

Typ proměnné je nastaven při prvním přiřazení hodnoty. Poté je její typ pevně daný a nelze jí přiřadit hodnoty jiného typu. Například proměnná s počáteční hodnotou 1 je přiřazen typu číslo. Při pokusu o přiřazení k řetězci hodnotě "apples" došlo k chybě.

Když testujete agent, proměnná se může dočasně objevit jako typ neznámý. Proměnné neznámá dosud nebyla přiřazena hodnota.

Pořadí proměnných se určuje shora dolů na plátně pro vytváření obsahu. Uzly v horní části autorského plátna jsou považovány za uzly ve spodní části.

Když vytvoříte větve s uzly Podmínka, větve jsou seřazeny zleva doprava. Uzly ve větvi nejvíce vlevo jsou brány v úvahu před uzly ve větvi nejvíce vpravo.

Entity

Copilot Studio používá entity k identifikaci konkrétního typu informací z odpovědí uživatele. Identifikované informace jsou uloženy v proměnné takového typu, který je pro tyto informace vhodný. Následující tabulka uvádí základní typ proměnné přidružený k předem sestaveným entitám.

Entity	Základní typ proměnné
Možnosti vícenásobného výběru	Výběr
Celá odpověď uživatele	Řetězcové
Věk	Počet
Logické	Logické
City	Řetězec
Barva	Řetězcové
Kontinent	Řetězcové
Země nebo oblast	Řetězcové
Datum a čas	DateTime
Email	Řetězcové
Zvláštní událost	Řetězcové
Integer	Integer
Jazyk	Řetězcové
Peníze	Počet
Počet	Počet
Řadová číslovka	Počet
Organization (Organizace)	Řetězcové
Procento	Počet
Jméno osoby	Řetězcové
Telefonní číslo	Řetězec
Bod zájmu	Řetězec
Rychlost	Číslo
Stát	Řetězec
Adresa ulice	Řetězec
Teplota	Počet
URL	Řetězcové
Hmotnost	Počet
PSČ	Řetězcové
Vlastní entita	Výběr

Vytvoření proměnné

Libovolný uzel, který vás vyzve k výběru proměnné jako výstupu, jako je například uzel Otázka, automaticky vytváří výstupní proměnnou příslušného typu.

Tip

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

Výběr použité entity

Uzly otázky jsou ve výchozím nastavení vytvořeny s možností výběru z více možností. Chcete-li použít jinou předem sestavenou nebo vlastní entitu, vyberte pole Identify a vyberte typ informací, kterým má agent naslouchat.

Přejmenování proměnné

Proměnným je po vytvoření automaticky přiřazen název. Nejlepším postupem je dát svým proměnným smysluplné názvy, aby byl jejich účel jasný každému, kdo musí udržovat vaše agent.

1. Vývěrem proměnné ji otevřete v podokně podokně proměnných.

2. V sekci Název proměnné zadejte nový název proměnné.

Nastavení proměnné

K uložení uživatelského vstupu do proměnné obvykle používáte uzel Otázka . Mohou však nastat situace, kdy budete chtít hodnotu nastavit sami. V těchto případech použijte uzel Nastavit hodnotu proměnné.

1. Vyberte Přidat uzel (+), přidejte uzel a poté vyberte Řízení proměnných>Nastavit hodnotu proměnné.

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

   

3. 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. Tím nastavíte proměnnou na stejnou hodnotu jako vybraná proměnná.
   • Použití vzorce 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.

Poznámka:

Pokud při nastavování proměnné typu řetězce narazíte na nesoulad mezi Nastavit proměnnou a Na hodnotu, zobrazí se chybová zpráva a zobrazí se tlačítko Opravit nesoulad typu . Vyberte tlačítko, chcete-li Copilot Studio automaticky vygenerovat Power Fx vzorec , který řeší nesoulad.

Použití hodnot literálu

Místo výběru hodnoty proměnné můžete zadat hodnotu literálu do libovolné proměnné.

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

V některých scénářích nebo při použití složitějších typů použijte k nastavení konkrétního typu vzorec Power Fx.

Podokno proměnných

V podokně Proměnné můžete zobrazit všechny proměnné, které jsou k dispozici v tématu, 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, jejíž vlastnosti chcete upravit, v podokně Vlastnosti proměnné.

Chcete-li otevřít podokno Proměnné, vyberte na panelu nabídek tématu položku Proměnné.

Podokno vlastností proměnné

V podokně Vlastnosti proměnné můžete přejmenovat proměnnou, zjistit, kde se používá, nebo ji převést na globální proměnnou. Nemůžete ji však převést z globální proměnné zpět na proměnnou tématu. Můžete také vybrat, zda může přijímat hodnoty z jiných témat nebo je předávat jiným tématům.

Chcete-li otevřít podokno Vlastností proměnné, vyberte proměnnou v podokně Proměnné. Podokno Vlastnosti proměnné můžete otevřít také výběrem proměnné v libovolném uzlu.

Proměnné prostředí

Proměnné prostředí jsou Power Platform koncept. Proměnné prostředí umožňují základní scénář správy životního cyklu aplikace (ALM) pro přesun aplikace mezi prostředími Power Platform. V tomto scénáři zůstává aplikace úplně stejná s výjimkou několika klíčových externích odkazů, které se liší mezi zdrojovým a cílovým prostředím.

Proměnné prostředí používáte stejným způsobem jako proměnné tématu a globální a systémové proměnné. Jedním z pozoruhodných rozdílů je, že proměnné prostředí můžete používat v režimu pouze pro čtení. Agent autoři nemohou upravit proměnnou prostředí v Copilot Studio. Správci však mohou změnit hodnotu proměnných prostředí na portálu PowerApps.

Typy proměnných prostředí v Copilot Studio mapujte na datové typy PowerApps následovně:

Typ v Copilot Studio	Typ v PowerApps
Desetinné číslo	Počet
Zadejte JSON	Zjistěte typ z hodnoty. Pokud není Json => nespecifikováno (chyba ověření)
Text	string
Ano/Ne	Logické
Zdroj dat	string
Tajný	Řetězcové

Poznámka:

Chyby proměnných prostředí jsou viditelné v chatu Test a při publikování. Tyto chyby však nejsou zobrazeny v seznamu Téma, protože to nejsou proměnné tématu.

V Copilot Studio nemůžete vytvářet ani upravovat proměnné prostředí. Musíte použít portál PowerApps pro změnu nebo nastavení proměnných prostředí. Z Copilot Studio můžete použít podokno Proměnné, kde zobrazíte informace o proměnné prostředí. Podokno Proměnné obsahuje také odkaz na nativní prostředí pro vytváření obsahu.

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. Toto je speciální případ proměnných prostředí s jedinečným přístupem.

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

Kromě výše uvedené konfigurace musíte k provést následující akce, abyste autorizovali Copilot Studio ke čtení tohoto trezoru klíčů Key Vault:

1. Přiřaďte roli Key Vault Secrets User aplikaci Microsoft Virtual Agents Service.

2. Chcete-li všem agentům z prostředí povolit přístup k tajnému klíči, vytvořte na tajném klíči značku AllowedEnvironments a přidejte povolená ID prostředí oddělená čárkou.

3. Chcete-li autorizovat použití tohoto trezoru klíčů pouze konkrétním agentům z prostředí, vytvořte tag AllowedAgents a vložte identifikátor agent 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 agent můžete hodnotu tohoto tajemství odhalit všem uživatelům, kteří mohou agent v prostředí upravovat, protože tito uživatelé mohou upravit agent tak, aby vrátili hodnotu v SendMessage uzel.

Systémové proměnné

Každý agent přichází s vestavěnými systémovými proměnnými, které poskytují další informace o konverzaci.

Poznámka:

Další informace o proměnných agent s podporou hlasu naleznete v části Používání hlasových proměnných.

V seznamu nejsou zobrazeny všechny systémové proměnné. K těmto skrytým systémovým proměnným musíte přistupovat pomocí vzorce Power Fx.

Chcete-li použít systémové proměnné ve vzorci Power Fx, musíte před název proměnné přidat System.. Chcete-li například do vzorce zahrnout systémovou proměnnou User.DisplayName, odkazujte na ni jako System.User.DisplayName.

Name	Type	definice
Activity.Attachments	tabulka	Souborové přílohy poskytnuté uživatelem
Activity.Channel	volba	ID kanálu aktuální konverzace
Activity.ChannelData	jakékoliv	Objekt, který obsahuje obsah specifický pro kanál
Activity.ChannelId	string	ID kanálu aktuální konverzace jako řetězec
Activity.From.Id	string	Jedinečné ID odesílatele specifické pro daný kanál
Activity.From.Name	string	Uživatelsky přívětivé jméno odesílatele specifické pro kanál
Activity.Name	string	Název události
Activity.Recipient.Id	string	Vlastnost Type příchozí aktivity.
Activity.Recipient.Name	string	Představuje zobrazované jméno pro agent v rámci kanálu. V kontextu telefonního kanálu bude hodnotou této proměnné telefonní číslo, ke kterému je připojen agent.
Activity.Text	string	Poslední zpráva odeslaná uživatelem
Activity.Type	volba	Typ aktivity
Activity.TypeId	string	Typ aktivity jako řetězec
Activity.Value	jakékoliv	Otevřená hodnota
Bot.EnvironmentId	string	ID prostředí agent
Bot.Id	string	ID agent
Bot.Name	string	Jméno vašeho agent
Bot.SchemaName	string	Název schématu agent
Bot.TenantId	string	ID tenanta agent
ClientPluginActions	volba	Kolekce akcí dynamického klientského pluginu, které je třeba zvážit pro generativní orchestraci
Conversation.Id	string	Jedinečné ID aktuální konverzace
Conversation.InTestMode	logický	Logický příznak, který indikuje, zda konverzace probíhá na testovacím plátně
Conversation.LocalTimeZone	string	Název časového pásma, které má uživatel použít ve formátu databáze časového pásma IANA
Conversation.LocalTimeZoneOffset	datetime	Časový posun od UTC pro aktuální místní časové pásmo
Error.Code	string	Kód aktuální chyby. Poznámka: Tato proměnná je podporována pouze v případě, že je spouštěč On Error.
Error.Message	string	Chybová zpráva k aktuální chybě. Poznámka: Tato proměnná je podporována pouze v případě, že je spouštěč On Error.
FallbackCount	Číslo	Tato proměnná počítá časy, kdy téma nemohlo být přiřazeno k uživatelskému vstupu. Poznámka: Tato proměnná je podporována pouze v případě, že je spouštěč On Unknown Intent.
InactivityTimer.Continue	logický	Logický příznak, který představuje, zda má časovač pokračovat. Poznámka: Tato proměnná je podporována pouze v případě, že je spouštěč Inactivity.
InactivityTimer.Count	Číslo	Počet aktivací časovače OnInactivity z důvodu nečinnosti uživatele po nakonfigurovaném čase. Poznámka: Tato proměnná je podporována pouze v případě, že je spouštěč Inactivity.
LastMessage.Id	string	ID předchozí zprávy odeslané uživatelem
LastMessage.Text	string	Předchozí zpráva odeslaná uživatelem
Recognizer.ExtractedEntities	volba	Představuje extrahované entity ze spouštěcí zprávy. Poznámka: Tato proměnná je podporována pouze v případě, že je spouštěč On Select Intent.
Recognizer.IntentOptions	volba	Představuje možnosti záměru, když rozpoznávač vrátí nejednoznačné výsledky. Poznámka: Tato proměnná je podporována pouze v případě, že je spouštěč On Select Intent.
Recognizer.SelectedIntent	volba	Představuje záměr vybraný z rozpoznávače. Poznámka: Tato proměnná je podporována pouze v případě, že je spouštěč On Select Intent.
Recognizer.TriggeringMessage.Id	string	ID zprávy uživatele, která vyvolala aktuální téma
Recognizer.TriggeringMessage.Text	string	Zpráva uživatele, která vyvolala aktuální téma
Recognizer.MultipleTopicsMatchedReason	string	Používá se k určení, proč došlo ke shodě více témat. Poznámka: Tato proměnná je podporována pouze v případě, že je spouštěč On Select Intent.
User.Language	volba	Tato proměnná slouží k nastavení národního prostředí jazyka uživatele pro jednotlivé konverzace.
SignInReason	volba	Slouží k určení, jaká možnost přihlášení je potřeba při aktivaci tématu. Poznámka: Tato proměnná je podporována pouze v případě, že je spouštěč On Sign In.

Proměnné pro integrované ověřování (výchozí)

Následující proměnné jsou k dispozici, když jste nakonfigurovali agent pro ověřování pomocí Microsoft. Bude použito ověřování pomocí Entra ID a budou povoleny pouze kanály Teams a PowerApps. Toto je výchozí nastavení pro nové agenty.

Další informace naleznete v části Proměnné ověřování.

Name	Type	definice
User.DisplayName	string	Zobrazované jméno uživatele, který právě mluví s agent.
User.Email	string	E-mailová adresa uživatele, který aktuálně mluví s agent.
User.FirstName	string	Křestní jméno uživatele, který právě mluví s agent.
User.Id	string	Jedinečné ID uživatele, který aktuálně mluví s agent.
User.IsLoggedIn	logický	Logický příznak, který představuje, zda je uživatel aktuálně hovořící s agent ověřen nebo ne.
User.LastName	string	Příjmení uživatele, který právě mluví s agent.
User.PrincipalName	string	Hlavní jméno uživatele, který aktuálně mluví s agent.

Proměnné pro ruční ověřování pomocí Generic OAuth 2

Následující proměnné jsou dostupné, když jste nakonfigurovali agent pro použití Generic OAuth 2 poskytovatele služeb.

Name	Type	definice
User.AccessToken	string	Přístupový token pro uživatele ověřujícího se pomocí agent.
User.DisplayName	string	Zobrazované jméno uživatele, který právě mluví s agent.
User.Id	string	Jedinečné ID uživatele, který aktuálně mluví s agent.
User.IsLoggedIn	logický	Logický příznak, který představuje, zda je uživatel aktuálně hovořící s agent ověřen nebo ne.

Proměnné pro ruční ověřování pomocí Microsoft Entra ID

Následující proměnné jsou dostupné, když jste nakonfigurovali agent tak, aby používal Microsoft Entra ID (dříve Azure Active Directory) poskytovatele služeb.

Name	Type	definice
User.AccessToken	string	Přístupový token pro uživatele ověřujícího se pomocí agent.
User.DisplayName	string	Zobrazované jméno uživatele, který právě mluví s agent.
User.Email	string	E-mailová adresa uživatele, který aktuálně mluví s agent.
User.FirstName	string	Křestní jméno uživatele, který právě mluví s agent.
User.Id	string	Jedinečné ID uživatele, který aktuálně mluví s agent.
User.IsLoggedIn	logický	Logický příznak, který představuje, zda je uživatel aktuálně hovořící s agent ověřen nebo ne.
User.LastName	string	Příjmení uživatele, který právě mluví s agent.
User.PrincipalName	string	Hlavní jméno uživatele, který aktuálně mluví s agent.

Proměnné pro hlasové agenty

Následující proměnné jsou dostupné pouze u agentů s podporou hlasu.

Poznámka:

Další informace o proměnných agent s podporou hlasu naleznete v části Používání hlasových proměnných.

Name	Type	definice
Activity.InputDTMFKeys	string	Nezpracovaná hodnota klíče DTMF, která byla přijata z telefonie.
Activity.SpeechRecognition.Confidence	Číslo	Skóre spolehlivosti pro celý výsledek hypotézy ASR, 0 až 1.
Activity.SpeechRecognition.MinimallyFormattedText	string	Mírně formátovaný text výsledku hypotézy ASR. Například pět set dolarů. Slova jsou vypsána a zahrnují základní velká písmena a interpunkci.
Activity.UserInputType	volba	Typ posledního vstupu koncového uživatele. Hodnota může být buď test, speech (řeč) nebo DTMF.
Conversation.OnlyAllowDTMF	logický	Logický příznak, který představuje, zda má být interaktivní hlasový systém nastaven na běh pouze v režimu tónové volby.
Conversation.SipUuiHeaderValue	string	Řetězec záhlaví UUI používaný k předání kontextu do interaktivního hlasového systému při zahájení hovoru.

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 mezi původní téma a cílové téma. 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é ocení, že nebudou muset na stejnou otázku znovu odpovídat.

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

Když téma definuje proměnnou (například v uzlu Question), agent požádá uživatele o otázku, aby vyplnil hodnotu proměnné. Pokud agent již získal hodnotu v dřívějším téma, není důvod klást otázku znovu. V těchto případech můžete nastavit proměnnou jako 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. Zážitek pro uživatele mluvícího s agent je bezproblémový.

V tomto příkladu použijeme 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žívá hodnotu proměnné, která je předána z tématu Pozdrav.

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

Jak je znázorněno v podokně Test agent, pokud je toto téma spuštěno jako první, zeptá se uživatele: "Jak vám mám říkat?" Ukládá hodnotu do řetězcové proměnné nazvané userName. Proměnná userName je také nastavena tak, aby získala svou hodnotu z jiných témat. Toto téma končí zprávou: „Doufám, že máte krásný den, {userName}!“

Zde je tok tématu Pozdrav:

Jak je znázorněno v podokně Test agent, pokud je toto téma spuštěno jako první, zeptá se uživatele: "Jak se jmenujete?" Ukládá hodnotu do řetězcové proměnné nazvané UserName. Téma odešle zprávu: „Rád vás poznávám, {UserName}!“ Poté se přesměruje na téma Rozhovor se zákazníkem, které odešle zprávu: „Doufám, že máte krásný den, {userName}!“ Všimněte si však, že téma Rozhovor se zákazníkem opět přeskočil dotaz na jméno uživatele. Místo toho používá hodnotu proměnné UserName, která je předána z tématu Pozdrav.

Nakonec je tu opět druhý rozhovor, 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. Použijeme náš aktuální příklad, ale stejné kroky budou fungovat, kdykoli téma potřebuje získat hodnotu z dřívějšího tématu.

Nastavení cílového tématu

Na cílové téma je téma přesměrováno, 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 nebo přejděte do cílového tématu.

2. Přidejte uzel Otázka a zadejte What should I call you? zprávu.

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

4. Výběrem proměnné otevřete podokno Vlastnosti proměnné. Pojmenujte jej userName a poté vyberte Přijímat hodnoty z jiných témat.

   

5. Přidejte uzel zprávy.

6. Do pole zprávy zadejte I hope you're having a wonderful day, (Doufám, že máte krásný den, ).

7. Vyberte ikonu Vložit proměnnou ({x}) a poté vyberte userName.

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

9. Uložte téma.

Nastavení zdrojového tématu

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

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

2. Přidejte uzel přesměrování a vyberte cíl téma.

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

   

4. Vyberte ikonu > a poté vyberte proměnnou, jejíž hodnotu chcete předat.

   

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

   

5. Uložte téma.

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

Když je téma přesměrováno a obdrží proměnnou položením otázky nebo nějakým jiným způsobem, proměnná může být vrácena do původního tématu. Proměnná se stane součástí původního tématu a lze ji použít jako kteroukoli jinou proměnnou. Informace, které agent získá, jsou tak dostupné napříč tématy, což snižuje potřebu globálních proměnných.

Pokračujme příkladem z předchozí sekce. V tématu Rozhovor se zákazníkem položíme novou otázku a poté odpověď 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, na které je přesměrována, téma, které poskytuje hodnotu, která bude předána zpět původnímu tématu. V tomto příkladu je to Rozhovor se zákazníkem.

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

2. Přidejte uzel Otázka a zadejte What city do you live in? jako zprávu.

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

4. Výběrem proměnné otevřete podokno Vlastnosti proměnné. Pojmenujte jej userCity a poté vyberte Vracet hodnoty do původních témat.

   

5. 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 provádějící přesměrování, téma, které obdrží hodnoty z jiných témat. V našem příkladu je to Pozdrav.

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

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

   

3. Uložte téma.

Klasické

Typ entity a proměnné

Copilot Studio používá entity k identifikaci konkrétního typu informací z odpovědí uživatele. Typ proměnné je při ukládání přidružen k identifikovaným informacím. Typ proměnné je analogický s entitou.

Každý typ entity nebo proměnné se mapuje na základní typ, jak je uvedeno v následující tabulce. Základní typ určuje operátory, které můžete použít při vytváření logického výrazu s odpovídající proměnnou. Určuje také, zda můžete přidávat proměnnou do toku nebo dovednosti Bot Framework jako vstupní parametr.

Například základní typ logická hodnota se mapuje na operátor „je rovno“ s možnými hodnotami True a False. Základní typ číslo poskytuje číselné operátory jako „je rovno“, „je větší než“ nebo „je větší než nebo rovno“ a tak dále.

Entita	Základní typ proměnné
Několik možností	Řetězec
Celá odpověď uživatele	Řetězec
Věk	Číslo
Logická hodnota	Logická hodnota
Město	Řetězec
Barva	Řetězec
Kontinent	Řetězec
Země nebo oblast	Řetězec
Datum a čas	Řetězec
Doba trvání	Řetězec
E-mail	Řetězec
Událost	Řetězec
Jazyk	Řetězec
Peníze	Řetězec
Číslo	Řetězec
Řadová číslovka	Řetězec
Organizace	Řetězec
Procento	Číslo
Jméno osoby	Řetězec
Telefonní číslo	Řetězec
Bod zájmu	Řetězec
Rychlost	Číslo
Stát	Řetězec
Adresa ulice	Řetězec
Teplota	Číslo
Adresa URL	Řetězec
Hmotnost	Číslo
PSČ	Řetězec
Vlastní entita	Řetězec

Vytvoření proměnné

Na plátně pro vytváření robotů přidejte uzel otázky. V uzlu se automaticky vytvoří proměnná.

1. Přejděte na stránku robot Témata a otevřete téma, do kterého chcete přidat proměnnou.

2. Vyberte Přidat uzel (+) a pak vyberte Přidat otázku.

   

   Automaticky se vytvoří proměnná, která obsahuje odpověď uživatele.

   

Výběr použité entity

Ve výchozím nastavení je vytvořen uzel otázky s možností výběru z více možností. Chcete-li použít jinou předem sestavenou nebo vlastní entitu, vyberte, co chcete z uzlu identifikovat.

Přejmenování proměnné

Automaticky vytvořené proměnné mají výchozí název. Chcete-li proměnnou přejmenovat, vyberte název proměnné, zadejte nový název a vyberte Hotovo.

Použití proměnných v akčních uzlech

Když použijete proměnnou v uzlu akce, pokud její základní typ odpovídá typu parametru, který je zadán pro tok nebo dovednost Bot Framework, můžete ji naplnit tímto parametrem. Výstup z uzlů akce generuje nové proměnné.

Použití hodnoty literálů v akčních uzlech

Místo výběru proměnné z nabídky můžete zadat hodnotu literálu do vstupního pole proměnné v uzlu akce.

Uzel Parsovat hodnotu

Uzel Parsovat umožňuje převést hodnotu jednoho typu na hodnotu jiného typu. Při přidávání uzlu do tématu vyberte Přidat uzel (+), poté Správa proměnných a Parsovat hodnotu.

Klíčové scénáře využívající uzel Parsovat hodnotu se zaměřují na převod nezpracovaných proměnných JSON nebo netypovaných proměnných (jejichž hodnota nebo struktura není známa až za běhu, například ChannelData) na konkrétní typy.

Proces začíná voláním toku, který zase volá rozhraní API. Rozhraní API pak vrátí výsledek. Obvykle budete muset tuto odpověď analyzovat a vrátit jednu nebo více primitivních proměnných do Copilot Studio. Pomocí uzlu Parsovat hodnotu můžete odeslat celý výsledek rozhraní API jako řetězec:

{
    "Name": "Gary",
    "Position": "PM",
    "Company": "Microsoft",
    "FormerPositions": [{
            "Position": "Engineer"
        }
    ]
}

Řetězcovou proměnnou, kterou nyní máte, lze převést na proměnnou Záznam s plnou podporou intellisense v Power Fx pomocí tohoto nového uzlu. Tento proces pomůže ilustrovat příklad využívající vzorová data.

Příklad použití uzlu Parsovat hodnotu

1. Přidejte uzel Parsovat hodnotu a vyberte proměnnou, kterou chcete parsovat.

   

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

   

3. Nyní můžete zadat JSON kliknutím na „Získat schéma z ukázkového JSON“. Kliknutím na toto otevřete editor, do kterého můžete vložit příklad.

   

4. Nakonec určete, do které proměnné chcete umístit parsovanou hodnotu. Obvykle byste pro to vytvořili novou proměnnou.

   

   Všimněte si, že výstupní proměnná je nyní správného typu – záznam.

   

Nyní můžete použít svou novou proměnnou. Zde v editoru Power Fx můžete vidět, že získáte plnou IntelliSense pro různé vlastnosti.

Kromě parsování řetězců JSON bude klíčové využití uzlu Parsovat hodnotu pro analýzu UntypedObjects za běhu. Nejběžnější z nich bude, když přijmete událost a potřebujete analyzovat hodnotu události. Nebo můžete chtít parsovat vlastnost System.Activity.ChannelData, která se mění za běhu podle kanálu.

V následujícím příkladu, pokud událost pocházela z Teams, budete muset pomocí dokumentace pro vývojáře Teams najít příklad toho, jak bude příchozí událost vypadat, a poté použít ukázková data, jak je uvedeno v této části.

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

Při přesměrování na jiná témata můžete předat hodnoty do proměnných v tématu cíle nebo z něj získat proměnné zpět. Předávání proměnných mezi tématy je zvláště užitečné, když již máte informace, které téma potřebuje. Vaši uživatelé ocení, že nebudou muset na otázku znovu odpovídat. Je také užitečné, když refaktorujete a rozdělujete svá témata do opakovaně použitelných komponent a chcete předávat proměnné napříč tématy.

Poznámka:

Proměnné typu Custom Entity, Date and Time, Duration a Multiple-choice nelze předávat mezi tématy.

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

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

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 podokně Vlastnosti proměnných v části Téma (omezený rozsah) vyberte Přijímat hodnoty z jiných témat.

   

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

Když téma položí otázku nebo nějakým jiným způsobem získá proměnnou z akce, může být proměnná vrácena do původního tématu, které na ni přesměrovalo.

V tomto případě se proměnná také stane součástí původního tématu a lze ji použít jako kteroukoli jinou proměnnou. To vám pomůže vytvořit téma tak, aby informace, které robot získá, byly dostupné napříč tématy, což snižuje potřebu globálních proměnných.

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 podokně Vlastnosti proměnných v části Téma (omezený rozsah) vyberte Vracet hodnoty do původních témat.

   

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.

   

Použití podokna Proměnné

Použijte podokno Proměnné pro výběr stavu příjmu nebo vrácení více proměnných najednou.

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

   

Použití hodnot literálů na vstupech proměnných

Do tématu můžete předat hodnoty literálu i proměnné. Chcete-li předat hodnotu literálu, zadejte hodnotu, kterou chcete použít jako vstup, místo výběru proměnné.

Související obsah

• Použití proměnných k přenášení obsahu napříč tématy
• Přizpůsobte si vzhled a dojem agent