Přehled proměnných

Note

Tento článek popisuje funkce používané v agentech nebo tocích agentů, které využívají standardní harness.

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ím parametrů od spotřebovávajících objektů můžete změ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 Description
String Posloupnost znaků používaná k reprezentaci textu
logický Logická hodnota, která může být pouze true nebo false
Number Libovolné reálné číslo
Table 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
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
Bianko Zástupce pro "žádná hodnota" nebo "neznámá hodnota"; více se dozvíte v Blank 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 je určeno odshora dolů na autorském plátně. Agent zvažuje uzly nahoře na autorském plátně před uzly dole.

Když vytváříte větve pomocí uzlov Condition, Copilot Studio řadí větve zleva doprava. Agent zvažuje uzly v levé větvi před uzly v pravé větvi.

Entities

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 String
Věk Number
logický logický
Město String
Barva String
Continent String
Země nebo oblast String
Datum a čas DateTime
Email String
Zvláštní událost String
Integer Integer
Jazyk String
Peníze Number
Number Number
Řadová číslovka Number
Organizace String
Procento Number
Jméno osoby String
Telefonní číslo String
Bod zájmu String
Rychlost Number
Kraj String
Adresa ulice String
Teplota Number
URL String
Weight Number
PSČ String
Vlastní entita Výběr

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 zcela stejná, kromě několika klíčových externích odkazů, které se liší mezi zdrojovým a cílovým prostředím.

Používejte proměnné prostředí stejným způsobem jako tématické, 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í, obsahuje hodnoty, které nastavíte pro tyto proměnné při publikování agenta. Kdykoli správce aktualizuje proměnné prostředí, musíte znovu publikovat všechny agenty, kteří tyto proměnné používají, aby změny nabyly účinnosti 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 Number
JSON Zjistěte typ z hodnoty. Pokud to není JSON => Nezadáno (chyba ověření)
Text String
Ano/Ne logický
Zdroj dat String
Tajný String

Note

Chyby proměnných prostředí vidíte v testovacím chatu i při publikování. Tyto chyby se však v seznamu témat neobjevují, protože proměnné prostředí nejsou tématické proměnné.

Systémové proměnné

Každý agent obsahuje vestavěné systémové proměnné, které poskytují další informace o konverzaci.

Snímek obrazovky systémových proměnných v článku.

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.

Name Typ Definition
Aktivita.Přílohy tabulka Přiložené soubory, které uživatel poskytne.
Aktivita.Kanál choice ID kanálu aktuální konverzace.
Activity.ChannelData any 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 choice Typ aktivity.
Aktivita.TypId řetězec Typ aktivity, jako řetězec.
Activity.Value any 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 choice 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. Další informace ve spouštěči nečinnosti.
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 choice 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 choice 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 choice 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í choice 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 choice Tato proměnná slouží k nastavení národního prostředí jazyka uživatele pro jednotlivé konverzace.

Proměnné pro hlasové agenty

Následující proměnné jsou k dispozici pouze hlasovým agentům. Více informací v Používejte hlasové proměnné.

Name Typ Definition
Activity.InputDTMFKeys řetězec Nezpracovaná hodnota klíče DTMF z telefonního subsystému.
Aktivita.RozpoznáváníŘeči.Důvěra Číslo Celkové skóre důvěry hypotézy automatického rozpoznávání řeči je 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 automatického rozpoznávání řeči. Například: „Pět set dolarů.“ Slova jsou hláskována, ale základní velká písmena a interpunkce jsou zahrnuty.
Activity.UserInputType choice 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.

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. Více informací v sekci Autentizační proměnné.

Name Typ Definition
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.

Name Typ Definition
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).

Name Typ Definition
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.
  • Last updated on