Přehled proměnných

Proměnné existují na čtyřech úrovních nebo oborech:

• Proměnné témat, které můžete použít pouze v tématech, ve kterých je vytvoříte. Tento rozsah je výchozí pro vytvořené proměnné.
• Globální proměnné, které můžete 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é, které Copilot Studio automaticky vytvoří pro agenta. Poskytují více kontextových informací o konverzaci nebo uživateli. Jsou k dispozici ve všech tématech.
• Proměnné prostředí, které vytvoříte v Power Platform. V Copilot Studio jsou pouze ke čtení. Ukládají klíče a hodnoty parametrů, které pak slouží jako vstup pro různé další aplikační objekty, 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é

Každá proměnná má základní typ. Typ určuje, jaké hodnoty může proměnná obsahovat a jaké operátory můžete použít při sestavování logického výrazu pomocí něj.

Typ	Popis
Řetězec	Posloupnost znaků používaná k reprezentaci textu
logický	Logická hodnota, která může být pouze true nebo false
Číslo	Libovolné reálné číslo
Tabulka	Seznam hodnot, ale všechny hodnoty musí být stejného typu
Záznam	Kolekce dvojic název-hodnota, kde hodnoty mohou být libovolného typu
Datum a čas	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
Blank	Zástupný symbol pro „žádná hodnota“ nebo „neznámá hodnota“, další informace najdete v tématu Prázdné v dokumentaci Power Fx

Typ proměnné nastavíte při prvním přiřazení hodnoty. Poté je typ pevný a nemůžete přiřadit hodnoty žádného jiného typu. Pokud například přiřadíte počáteční hodnotu 1 proměnné, nastavíte její typ na Číslo. Pokud se pokusíte přiřadit String hodnotu jako "apples", zobrazí se chyba.

Při testování agenta se může dočasně zobrazit proměnná s typem neznámý. Neznámá proměnná ještě nemá hodnotu.

Pořadí proměnných se určuje shora dolů na autorovací ploše. Uzly v horní části pracovní plochy pro vytváření jsou zvažovány před uzly v dolní části.

Když vytvoříte větve pomocí uzlů Podmínka, jsou větve uspořádány zleva doprava. Uzly ve větvi zcela vlevo jsou uvažovány před uzly ve větvi zcela vpravo.

Entity

Webová aplikace

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

Entita	Typ základní proměnné
Možnosti vícenásobného výběru	Výběr
Celá odpověď uživatele	Řetězec
Věk	Číslo
logický	logický
Město	Řetězec
Barva	Řetězec
Kontinent	Řetězec
Země nebo oblast	Řetězec
Datum a čas	Datum a čas
Email	Řetězec
Událost	Řetězec
Integer	Integer
Jazyk	Řetězec
Peníze	Číslo
Číslo	Číslo
Řadová číslovka	Číslo
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
URL	Řetězec
Hmotnost	Číslo
PSČ	Řetězec
Vlastní entita	Výběr

Klasický

Copilot Studio používá entity k identifikaci konkrétních typů informací z odpovědí uživatele. Identifikované informace jsou uloženy v proměnné takového typu, který je pro tyto informace vhodný.

V následující tabulce je uveden základní typ proměnné přidružený ke každé předem připravené entitě. 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 Boolean se mapuje na operátor „rovná se“ s možnými hodnotami True a False. Číselný základní typ poskytuje číselné operátory jako „je rovno“, „je větší než“ nebo „je větší než nebo rovno“ a tak dále.

Entita	Typ základní proměnné
Několik možností	Řetězec
Celá odpověď uživatele	Řetězec
Věk	Číslo
logický	logický
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
Email	Ř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
URL	Řetězec
Hmotnost	Číslo
PSČ	Řetězec
Vlastní entita	Řetězec

Proměnné prostředí

Proměnné prostředí jsou konceptem Power Platform. 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 nebo globální a systémové proměnné. Jedním z významných rozdílů je, že proměnné prostředí jsou v Copilot Studio jen pro čtení. Autoři agentů nemohou upravovat proměnné prostředí v Copilot Studio. Správci ale mohou změnit hodnotu proměnných prostředí v Power Apps. V Copilot Studio můžete pomocí panelu Proměnné zobrazit informace o proměnné prostředí. Panel vlastností proměnných má také odkaz na Power Apps, prostředí pro vytváření proměnných prostředí.

Publikovaná verze agenta, která používá proměnné prostředí, má hodnoty, které jsou nastaveny pro tyto proměnné při publikování agenta. Pokaždé, když správce aktualizuje proměnné prostředí, musíte znovu publikovat všechny agenty, kteří tyto proměnné používají, aby se změny projevily za běhu. Existuje ale jedna výjimka: agenty nemusíte znovu publikovat, když se změní hodnota proměnné prostředí typu tajný kód. Na rozdíl od jiných proměnných prostředí se tajné proměnné načítají za běhu.

Typy proměnných prostředí v Copilot Studio se mapují na datové typy Power Apps následujícím způsobem:

Psát v aplikaci Copilot Studio	Zadejte v Power Apps
Desetinné číslo	Číslo
JSON	Zjistěte typ z hodnoty. Pokud to není JSON => Nezadáno (chyba ověření)
Text	Řetězec
Ano/Ne	logický
Zdroj dat	Řetězec
Tajný	Řetězec

Poznámka

Chyby proměnných prostředí jsou viditelné v testovacím chatu a při publikování. Tyto chyby se ale v seznamu Témata nezobrazují, protože se nejedná o proměnné tématu.

Systémové proměnné

Každý agent je dodáván 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 povoleným hlasem naleznete v tématu Použití hlasových proměnných.

Copilot Studio nezobrazuje všechny systémové proměnné. Chcete-li získat přístup ke skrytým systémovým proměnným, použijte vzorec Power Fx.

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

Název	Typ	definice
Aktivita.Přílohy	tabulka	Přiložené soubory, které uživatel poskytne.
Aktivita.Kanál	volba	ID kanálu aktuální konverzace.
Activity.ChannelData	jakékoliv	Objekt, který obsahuje obsah specifický pro kanál.
Activity.ChannelId	řetězec	ID kanálu aktuální konverzace jako řetězec.
Aktivita.Z.Id	řetězec	Jedinečné ID odesílatele specifické pro daný kanál.
Activity.From.Name	řetězec	Uživatelsky přívětivé jméno odesílatele specifické pro kanál.
Aktivita.Název	řetězec	Název události.
Activity.Recipient.Id	řetězec	Vlastnost typu u příchozí aktivity.
Activity.Recipient.Name	řetězec	Představuje zobrazovaný název pro agent v kanálu. V kontextu kanálu telefonie je hodnota této proměnné telefonní číslo, ke kterému je připojen agent.
Activity.Text	řetězec	Poslední zpráva odeslaná uživatelem.
Aktivita.Typ	volba	Typ aktivity.
Aktivita.TypId	řetězec	Typ aktivity, jako řetězec.
Activity.Value	jakékoliv	Variabilní hodnota.
Bot.EnvironmentId	řetězec	Identifikátor prostředí agenta.
Bot.Id	řetězec	ID agenta.
Bot.Name	řetězec	Název agenta.
Bot.SchemaName	řetězec	Název schématu agenta.
Bot.TenantId	řetězec	Identifikátor nájemce agenta.
ClientPluginActions	volba	Kolekce akcí modulu plug-in dynamického klienta, které je třeba vzít v úvahu pro generativní orchestraci.
Conversation.Id	řetězec	Jedinečné ID aktuální konverzace.
Conversation.InTestMode	logický	Logický příznak ukazující, zda se konverzace odehrává na testovacím plátně.
Conversation.LocalTimeZone	řetězec	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	řetězec	Kód aktuální chyby. Chybová zpráva k aktuální chybě.
Chyba.Zpráva	řetězec	Chybová zpráva k aktuální chybě. Poznámka: Tato proměnná je podporována pouze v případě, že trigger je 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 trigger je 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 trigger je Inactivity.
InactivityTimer.Count	Číslo	Kolikrát se časovač OnInactivity aktivoval z důvodu nečinnosti uživatele po nakonfigurovaném čase. Poznámka: Tato proměnná je podporována pouze v případě, že trigger je Inactivity.
LastMessage.Id	řetězec	ID předchozí zprávy odeslané uživatelem.
LastMessage.Text	řetězec	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 trigger je On Select Intent.
Recognizer.IntentOptions	volba	Představuje možnosti záměru, když nástroj pro rozpoznávání vrátí nejednoznačné výsledky. Poznámka: Tato proměnná je podporována pouze v případě, že trigger je 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 trigger je On Select Intent.
Recognizer.TriggeringMessage.Id	řetězec	ID zprávy uživatele, která vyvolala aktuální téma.
Rozpoznávač.SpouštěcíZpráva.Text	řetězec	Zpráva uživatele, která vyvolala aktuální téma.
Recognizer.MultipleTopicsMatchedReason	řetězec	Používá se k určení, proč bylo spárováno několik témat. Poznámka: Tato proměnná je podporována pouze v případě, že trigger je On Select Intent.
Důvod přihlášení	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 trigger je On Sign In.
Uživatel.Jazyk	volba	Tato proměnná slouží k nastavení národního prostředí jazyka uživatele pro jednotlivé konverzace.

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

Následující proměnné jsou k dispozici pro agenty konfigurované k ověřování prostřednictvím společnosti Microsoft. Tato konfigurace používá ověřování Microsoft Entra ID a je výchozí pro nové agenty.

Další informace najdete v tématu Proměnné ověřování.

Název	Typ	definice
Uživatelské.ZobrazenéJméno	řetězec	Zobrazované jméno uživatele, který právě mluví s agentem.
Uživatel.Email	řetězec	E-mailová adresa uživatele, který právě mluví s agentem.
User.FirstName	řetězec	Jméno uživatele, který právě mluví s agentem.
Uživatel.ID	řetězec	Jedinečné ID uživatele, který právě mluví s agentem.
Uživatel.JePřihlášen	logický	Logický příznak, který představuje, zda je uživatel, který aktuálně komunikuje s agentem, ověřen nebo ne.
User.LastName	řetězec	Příjmení uživatele, který právě komunikuje s agentem.
Uživatel.PrincipalName	řetězec	Uživatelské hlavní jméno uživatele, který právě komunikuje s agentem.

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

Následující proměnné jsou k dispozici pro agenty nakonfigurované tak, aby používaly obecného poskytovatele služeb OAuth 2.

Název	Typ	definice
User.AccessToken	řetězec	Přístupový token pro uživatele, který se ověřuje pomocí agenta.
Uživatelské.ZobrazenéJméno	řetězec	Zobrazované jméno uživatele, který právě mluví s agentem.
Uživatel.ID	řetězec	Jedinečné ID uživatele, který právě mluví s agentem.
Uživatel.JePřihlášen	logický	Logický příznak, který představuje, zda je uživatel, který aktuálně komunikuje s agentem, ověřen nebo ne.

Proměnné ručního ověřování uživatele pomocí Microsoft Entra ID

Následující proměnné jsou k dispozici pro agenty nakonfigurované tak, aby používaly zprostředkovatele služeb Microsoft Entra ID (dříve Azure Active Directory).

Název	Typ	definice
User.AccessToken	řetězec	Přístupový token pro uživatele, který se ověřuje pomocí agenta.
Uživatelské.ZobrazenéJméno	řetězec	Zobrazované jméno uživatele, který právě mluví s agentem.
Uživatel.Email	řetězec	E-mailová adresa uživatele, který právě mluví s agentem.
User.FirstName	řetězec	Jméno uživatele, který právě mluví s agentem.
Uživatel.ID	řetězec	Jedinečné ID uživatele, který právě mluví s agentem.
Uživatel.JePřihlášen	logický	Logický příznak, který představuje, zda je uživatel, který aktuálně komunikuje s agentem, ověřen nebo ne.
User.LastName	řetězec	Příjmení uživatele, který právě komunikuje s agentem.
Uživatel.PrincipalName	řetězec	Hlavní jméno uživatele, který právě komunikuje s agentem.

Proměnné pro hlasové agenty

Následující proměnné jsou k dispozici pouze hlasovým agentům.

Poznámka

Další informace o proměnných agent s povoleným hlasem naleznete v tématu Použití hlasových proměnných.

Název	Typ	definice
Activity.InputDTMFKeys	řetězec	Nezpracovaná hodnota klíče DTMF z telefonního subsystému.
Aktivita.RozpoznáváníŘeči.Důvěra	Číslo	Skóre spolehlivosti pro celý výsledek hypotézy Azure Site Recovery, 0 až 1.
Akce.RozpoznáváníŘeči.MinimálněFormátovanýText	řetězec	Mírně formátovaný text výsledku hypotézy Azure Site Recovery. Například: „Pět set dolarů.“ Slova jsou hláskována, ale základní velká písmena a interpunkce jsou zahrnuty.
Activity.UserInputType	volba	Typ nejnovějšího vstupu od uživatele agenta. Hodnota může být buď test, rozpoznání hlasu nebo DTMF.
Konverzace.OnlyAllowDTMF	logický	Logický příznak, který představuje, zda má být IVR nastavena na provoz pouze v režimu DTMF.
Conversation.SipUuiHeaderValue	řetězec	Řetězec záhlaví UUI používaný k předání kontextu do interaktivního hlasového systému při zahájení hovoru.