Přehled proměnných

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

• Proměnné tématu lze používat 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žívat 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ářejí 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. Pokus o přiřazení k String hodnotě "apples" má za následek chybu.

Při testování agent se proměnná může dočasně zobrazit 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 plátna pro vytváření obsahu jsou zvažovány před uzly v dolní části.

Když vytvoříte větve s uzly Podmínka, větve jsou seřazeny 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í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ý. V následující tabulce je uveden základní typ proměnné přidružený k předem připravený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

Klasické

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
URL	Řetězcové
Hmotnost	Počet
PSČ	Řetězcové
Vlastní entita	Řetězcové

Proměnné prostředí

Proměnné prostředí jsou koncept 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 pouze pro čtení v Copilot Studio. Autoři agentů nemůžou upravovat proměnné prostředí v Copilot Studio. Správci však mohou změnit hodnotu proměnných prostředí v Power Apps. V Copilot Studio můžete na panelu Proměnné vidět informace o proměnné prostředí. Panel Proměnné obsahuje také odkaz na nativní prostředí pro vytváření obsahu.

Publikovaná verze agenta, která používá proměnné prostředí, má hodnoty, které byly pro tyto proměnné nastaveny 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 mapujte na datové typy Power Apps následovně:

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

Poznámka:

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

Systémové proměnné

Každá agent je dodávána 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.

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ý 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	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í agenta
Bot.Id	string	ID agenta
Bot.Name	string	Název agenta
Bot.SchemaName	string	Název schématu agenta
Bot.TenantId	string	ID tenanta agenta
ClientPluginActions	volba	Kolekce akcí modulu plug-in dynamického klienta, které je třeba vzít v úvahu 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. Chybová zpráva k aktuální chybě.
Error.Message	string	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	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 trigger je 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 trigger je 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 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	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č bylo nalezeno více témat. Poznámka: Tato proměnná je podporována pouze v případě, že trigger je On Select Intent.
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 trigger je On Sign In.
User.Language	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í.

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

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

Následující proměnné jsou k dispozici pro agenty nakonfigurované k použití zprostředkovatele služeb Generic OAuth 2.

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

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

Následující proměnné jsou k dispozici pro agenty nakonfigurované k použití zprostředkovatele služeb Microsoft Entra ID (původně Azure Active Directory).

Name	Type	definice
User.AccessToken	string	Přístupový token pro uživatele, který se ověřuje pomocí agent.
User.DisplayName	string	Zobrazované jméno uživatele, který právě mluví s agentem.
User.Email	string	E-mailová adresa uživatele, který právě mluví s agentem.
User.FirstName	string	Jméno uživatele, který právě mluví s agentem.
User.Id	string	Jedinečné ID uživatele, který právě mluví s agentem.
User.IsLoggedIn	Logické	Logický příznak, který představuje, zda je uživatel, který aktuálně komunikuje s agent, ověřen nebo ne.
User.LastName	string	Příjmení uživatele, který právě komunikuje s agentem.
User.PrincipalName	string	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.

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 Azure Site Recovery, 0 až 1.
Activity.SpeechRecognition.MinimallyFormattedText	string	Mírně formátovaný text výsledku hypotézy Azure Site Recovery. Například „pět set dolarů“. Slova jsou vypsána a zahrnují základní velká písmena a interpunkci.
Activity.UserInputType	volba	Typ vstupu z nejnovějšího vstupu 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.