Omówienie wariantów
Zmienne mogą istnieć na czterech poziomach lub w zakresach:
- Temat: zmienne tematu mogą być używane tylko w tematach, w których są tworzone. Ten zakres jest domyślny w przypadku tworzonych przez Ciebie zmiennych.
- Zmienne globalne mogą być używane we wszystkich tematach. Zakres zmiennej tematu można zmienić, aby była zmienną globalną.
- Zmienne systemowe są tworzone automatycznie przy użyciu agenta. Dostarczają one bardziej kontekstowych informacji o konwersacji lub użytkowniku. Są one dostępne we wszystkich tematach.
- Zmienne środowiska są tworzone w Power Platform i są tylko do odczytu w Copilot Studio. Przechowują klucze parametrów i wartości, które następnie służą jako dane wejściowe dla różnych innych obiektów aplikacji , w tym Copilot Studio. Dzielenie parametrów od obiektów zużywających dane pozwala na zmianę wartości w tym samym środowisku lub migrowanie rozwiązań do innych środowisk. Alternatywa to pozostawienie w składnikach, które z nich korzystają, wartości parametrów zakodowanych „na twardo”.
Typy zmiennych
Zmienna jest skojarzona z typem podstawowym. Typ określa, jakie wartości może zawierać zmienna oraz operatory, których można użyć podczas konstruowania wyrażenia logicznego przy jej użyciu.
| Type | opis |
|---|---|
| String | Sekwencja znaków używanych do reprezentowania tekstu |
| Wartość logiczna | Wartość logiczna, która może być tylko wartością true lub false |
| telefonu | Dowolna liczba rzeczywista |
| Table | Lista wartości, ale wszystkie wartości muszą być tego samego typu |
| Nagraj | Zbiór par typu nazwa-wartość, w których mogą być wartości dowolnego typu |
| DateTime | Data, godzina, dzień tygodnia lub miesiąc względem punktu w czasie |
| Opcja wyboru | Lista wartości ciągów ze skojarzonymi synonimami |
| Pusta | Symbol zastępczy elementu „brak wartości” lub „nieznana wartość”. Aby uzyskać więcej informacji, zobacz temat Wartości puste w programie Power Fx |
Typ zmiennej jest ustawiany przy pierwszym przypisywaniu do niego wartości Po tym typ tej zmiennej jest stały i nie można przypisać do niej wartości innych typów. Na przykład zmiennej z wartością początkową 1 przypisano typ Liczba. Próba przypisania go do wartości String powoduje "apples" błąd.
Podczas testowania agent zmienna może tymczasowo pojawić się jako typ nieznany. Nieoznaona zmienna nie została jeszcze przypisana do wartości.
Kolejność zmiennych jest określana od góry do dołu na kanwie tworzenia. Węzły w górnej części kanwy tworzenia są rozpatrywane przed węzłami na dole.
Podczas tworzenia odgałęzień z węzłów Warunek odgałęzienia są uporządkowane od lewej do prawej strony. Węzły w gałęzi po lewej stronie są rozpatrywane przed węzłami w gałęzi po prawej stronie.
Jednostki
Copilot Studio używa encji do identyfikowania określonego typu informacji z odpowiedzi użytkownika. Zidentyfikowane informacje są zapisywane w zmiennej typu, która jest odpowiednia dla tych informacji. W poniższej tabeli wymieniono typ podstawowy zmiennej skojarzony ze wstępnie utworzonymi jednostkami.
| Jednostka | Typ podstawowy zmiennej |
|---|---|
| Wiele opcji wyboru | Opcja wyboru |
| Cała odpowiedź użytkownika | String |
| Wiek | telefonu |
| Wartość logiczna | Wartość logiczna |
| City | String |
| Color | String |
| Kontynent | String |
| Kraj lub region | String |
| Data i godzina | DateTime |
| String | |
| Wydarzenie | String |
| Integer | Integer |
| Język | String |
| Money | telefonu |
| telefonu | telefonu |
| Liczba porządkowa | telefonu |
| Organizacja | String |
| Wartość procentowa | telefonu |
| Imię i nazwisko osoby | String |
| Numer telefonu | String |
| Punkt orientacyjny | String |
| Szybkość | telefonu |
| State | String |
| Ulica | String |
| Temperatura | telefonu |
| URL | String |
| Weight | telefonu |
| Kod pocztowy | String |
| Obiekt niestandardowy | Opcja wyboru |
Zmienne środowiskowe
Zmiennych środowiskowe są konepcją Power Platform. Zmienne środowiskowe umożliwiają podstawowy scenariusz zarządzania cyklem życia aplikacji (ALM) w zakresie przenoszenia aplikacji między środowiskami Power Platform. W tym scenariuszu aplikacja pozostaje taka sama z wyjątkiem kilku kluczowych odwołań zewnętrznych różnych między środowiskiem źródłowym a środowiskiem docelowym.
Zmienne środowiska są takie same, jak Temat, Globalne i Systemowe. Jedną z zauważalnych różnic jest to, że zmienne środowiskowe są tylko do odczytu Copilot Studio. Autorzy agentów nie mogą modyfikować zmiennych środowiskowych w Copilot Studio. Administratorzy mogą jednak zmienić wartość zmiennych środowiskowych w Power Apps. W Copilot Studio panelu Zmienne można wyświetlić informacje o zmiennej środowiskowej. Panel Zmienne zawiera również odnośnik do natywnego środowiska tworzenia.
Opublikowana wersja agenta, która używa zmiennych środowiskowych, ma wartości, które zostały ustawione dla tych zmiennych podczas publikowania agenta. Za każdym razem, gdy administrator aktualizuje zmienne środowiskowe, należy ponownie opublikować wszystkich agentów, którzy używają tych zmiennych, aby zmiany zaczęły obowiązywać w czasie wykonywania. Istnieje jednak jeden wyjątek: nie trzeba ponownie publikować agentów, gdy zmieni się wartość zmiennej środowiskowej typu tajne . W przeciwieństwie do innych zmiennych środowiskowych zmienne tajne są pobierane w czasie wykonywania.
Typy zmiennych środowiskowych w mapowaniu Copilot Studio na typy danych Power Apps w następujący sposób:
| Typ w usłudze Copilot Studio | Typ w usłudze Power Apps |
|---|---|
| Liczba dziesiętna | telefonu |
| JSON | Wykryj typ na podstawie wartości. Jeżeli to nie jest JSON => Nieokreślony (błąd walidacji) |
| Tekst | String |
| Tak/Nie | Wartość logiczna |
| Źródło danych | String |
| Klucz tajny | String |
Notatka
Błędy zmiennych środowiskowych są widoczne w czacie Test podczas publikowania. Te błędy nie są jednak wyświetlane na liście Temat, ponieważ nie są to zmienne tematu.
Zmienne systemowe
Każdy agent ma wbudowane zmienne systemowe, które dostarczają dodatkowych informacji o konwersacji.
Notatka
Aby uzyskać więcej informacji na temat zmiennych agent z obsługą głosu, zobacz Używanie zmiennych głosowych.
Nie wszystkie zmienne systemowe są wyświetlane na liście. Te ukryte zmienne systemowe muszą być dostępne za pomocą formuły Power Fx.
Aby używać zmiennych systemowych w formułach Power Fx, należy dodać System. przed nazwą zmiennej. Na przykład aby uwzględnić zmienną systemową User.DisplayName w formule, odnieś się do niej jako System.User.DisplayName.
| Nazwa/nazwisko | Type | Definicja |
|---|---|---|
| Activity.Attachments | tabela | Pliki załączników dostarczone przez użytkownika |
| Activity.Channel | opcja wyboru | Identyfikator kanału bieżącej konwersacji |
| Activity.ChannelData | dowolny | Obiekt zawierający zawartość specyficzną dla kanału |
| Activity.ChannelId | string | Identyfikator kanału bieżącej konwersacji jako ciąg |
| Activity.From.Id | string | Unikalny identyfikator nadawcy specyficzny dla kanału |
| Activity.From.Name | string | Przyjazna dla użytkownika ustalona dla kanału nazwa nadawcy |
| Activity.Name | string | Nazwa zdarzenia |
| Activity.Recipient.Id | string | Właściwość Typ działania przychodzącego. |
| Activity.Recipient.Name | string | Reprezentuje nazwę wyświetlaną agenta w kanale. W kontekście kanału telefonii wartością tej zmiennej będzie numer telefonu, do którego jest dołączony agent. |
| Activity.Text | string | Najnowsza wiadomość wysłana przez użytkownika |
| Activity.Type | opcja wyboru | Typ działania |
| Activity.TypeId | string | Typ działania w postaci ciągu |
| Activity.Value | dowolny | Wartość nieograniczona |
| Bot.EnvironmentId | string | Nazwa identyfikatora środowiska agenta |
| Bot.Id | string | Identyfikator agenta |
| Bot.Name | string | Nazwa Twojego agenta |
| Bot.SchemaName | string | Nazwa schematu agenta |
| Bot.TenantId | string | Identyfikator dzierżawy agenta |
| ClientPluginActions | opcja wyboru | Zbiór dynamicznych akcji dodatków plug-in klienta, które należy uwzględnić w przypadku orkiestracji generatywnej |
| Conversation.Id | string | Unikalny identyfikator bieżącej konwersacji |
| Conversation.InTestMode | Wartość logiczna | Wartość logiczna reprezentująca, jeśli rozmowa dzieje się na kanwie testowej |
| Conversation.LocalTimeZone | string | Nazwa strefy czasowej, która ma być używana przez użytkownika w formacie bazy danych strefy czasowej IANA |
| Conversation.LocalTimeZoneOffset | datetime | Przesunięcie czasu przesunięcia czasowego dla bieżącej lokalnej strefy czasowej |
| Kod błędu | string | Kod błędu bieżącego błędu. Komunikat o bieżącym błędzie. |
| Error.Message | string | Komunikat o bieżącym błędzie. Uwaga: ta zmienna jest obsługiwana tylko wtedy, gdy jest to wyzwolenie On Error. |
| FallbackCount | numer | Ta zmienna zlicza czas, w temat nie można jej dopasować do danych wejściowych użytkownika. Uwaga: ta zmienna jest obsługiwana tylko wtedy, gdy jest to wyzwolenie On Unknown Intent. |
| InactivityTimer.Continue | Wartość logiczna | Wartość logiczna reprezentująca, czy czasomierz ma być kontynuowany. Uwaga: ta zmienna jest obsługiwana tylko wtedy, gdy jest to wyzwolenie Inactivity. |
| InactivityTimer.Count | numer | Liczba czasu, przez który po skonfigurowaniu czasomierza OnInactivity został opuszczony z powodu braku aktywności użytkownika. Uwaga: ta zmienna jest obsługiwana tylko wtedy, gdy jest to wyzwolenie Inactivity. |
| LastMessage.Id | string | Identyfikator poprzedniej wiadomości wysłanej przez użytkownika |
| LastMessage.Text | string | Poprzednia wiadomość wysłana przez użytkownika |
| Recognizer.ExtractedEntities | opcja wyboru | Reprezentuje wyodrębnione encje z komunikatu uruchamiającego. Uwaga: ta zmienna jest obsługiwana tylko wtedy, gdy jest to wyzwolenie On Select Intent. |
| Recognizer.IntentOptions | opcja wyboru | Reprezentuje opcje opcji zamiaru w przypadku zwrócenia przez użytkownika jednoznacznych wyników. Uwaga: ta zmienna jest obsługiwana tylko wtedy, gdy jest to wyzwolenie On Select Intent. |
| Recognizer.SelectedIntent | opcja wyboru | Reprezentuje zamiar wybrany w aparacie rozpoznawania. Uwaga: ta zmienna jest obsługiwana tylko wtedy, gdy jest to wyzwolenie On Select Intent. |
| Recognizer.TriggeringMessage.Id | string | Identyfikator wiadomości użytkownika, która spowodowała wyzwolenie bieżącego tematu |
| Recognizer.TriggeringMessage.Text | string | Wiadomość użytkownika, która spowodowała wyzwolenie bieżącego tematu |
| Recognizer.MultipleTopicsMatchedReason | string | Służy do określania, dlaczego dopasowano wiele tematów. Uwaga: ta zmienna jest obsługiwana tylko wtedy, gdy jest to wyzwolenie On Select Intent. |
| SignInReason | opcja wyboru | Używany do określenia, jaka opcja logowania jest potrzebna podczas wyzwalania temat. Uwaga: ta zmienna jest obsługiwana tylko wtedy, gdy jest to wyzwolenie On Sign In. |
| User.Language | opcja wyboru | Ta zmienna służy do ustawienia regionalnych języków użytkownika na rozmowę. |
Zmienne do uwierzytelniania zintegrowanego (domyślne)
Następujące zmienne są dostępne dla agentów skonfigurowanych do uwierzytelniania z Microsoft. Ta konfiguracja używa Microsoft Entra uwierzytelniania za pomocą ID i jest domyślna dla nowych agentów.
Aby uzyskać więcej informacji, zobacz Zmienne uwierzytelniania.
| Nazwa/nazwisko | Type | Definicja |
|---|---|---|
| User.DisplayName | string | Wyświetlana nazwa użytkownika rozmawiającego obecnie z agentem. |
| Użytkownik.Email | string | Adres e-mail użytkownika rozmawiającego obecnie z agentem. |
| Użytkownik.FirstName | string | Imię użytkownika rozmawiającego obecnie z agentem. |
| User.Id | string | Identyfikator unikatowy użytkownika rozmawiającego obecnie z agentem. |
| User.IsLoggedIn | Wartość logiczna | Flaga logiczna, która informuje, czy użytkownik aktualnie rozmawiający z agent jest uwierzytelniony, czy nie. |
| Użytkownik.LastName | string | Nazwisko użytkownika, który aktualnie rozmawia z agent. |
| Użytkownik.PrincipalName | string | Główna nazwa użytkownika rozmawiającego obecnie z agentem. |
Zmienne do uwierzytelniania ręcznego przy użyciu ogólnego OAuth 2
Następujące zmienne są dostępne po skonfigurowaniu agent do korzystania z dostawcy usług Generic OAuth 2.
| Nazwa/nazwisko | Type | Definicja |
|---|---|---|
| User.AccessToken | string | Token dostępu dla użytkownika uwierzytelniającego się przy użyciu agent. |
| User.DisplayName | string | Wyświetlana nazwa użytkownika rozmawiającego obecnie z agentem. |
| User.Id | string | Identyfikator unikatowy użytkownika rozmawiającego obecnie z agentem. |
| User.IsLoggedIn | Wartość logiczna | Flaga logiczna, która informuje, czy użytkownik aktualnie rozmawiający z agent jest uwierzytelniony, czy nie. |
Zmienne do uwierzytelniania ręcznego przy użyciu ogólnego Tożsamość Microsoft Entra
Następujące zmienne są dostępne po skonfigurowaniu agenta do korzystania z dostawcy usług Microsoft Entra ID (wcześniej Azure Active Directory).
| Nazwa/nazwisko | Type | Definicja |
|---|---|---|
| User.AccessToken | string | Token dostępu dla użytkownika uwierzytelniającego się przy użyciu agent. |
| User.DisplayName | string | Wyświetlana nazwa użytkownika rozmawiającego obecnie z agentem. |
| Użytkownik.Email | string | Adres e-mail użytkownika rozmawiającego obecnie z agentem. |
| Użytkownik.FirstName | string | Imię użytkownika rozmawiającego obecnie z agentem. |
| User.Id | string | Identyfikator unikatowy użytkownika rozmawiającego obecnie z agentem. |
| User.IsLoggedIn | Wartość logiczna | Flaga logiczna, która informuje, czy użytkownik aktualnie rozmawiający z agent jest uwierzytelniony, czy nie. |
| Użytkownik.LastName | string | Nazwisko użytkownika, który aktualnie rozmawia z agent. |
| Użytkownik.PrincipalName | string | Główne nazwisko użytkownika, który aktualnie rozmawia z agentem. |
Zmienne dla agentów z obsługą głosu
Następujące zmienne są dostępne tylko w agentach obsługujących usługi głosowe.
Notatka
Aby uzyskać więcej informacji na temat zmiennych agent z obsługą głosu, zobacz Używanie zmiennych głosowych.
| Nazwa/nazwisko | Type | Definicja |
|---|---|---|
| Activity.InputDTMFKeys | string | Nieprzetworzone wartości klucza DTMF, które odebrano z telefonii. |
| Activity.SpeechRecognition.Confidence | numer | Współczynnik ufności dla całego wyniku tezy Azure Site Recovery, od 0 do 1. |
| Activity.SpeechRecognition.MinimallyFormattedText | string | Lekko sformatowany tekst wyniku tezy usługi Azure Site Recovery. Przykład: "pięćset dolarów". Wyrazy są pisane z pisownią, ale uwzględniana jest podstawowa litera ze znakiem przestankym. |
| Activity.UserInputType | opcja wyboru | Typ danych wejściowych z najnowszego wprowadzenia użytkownika. Wartość może mieć wartość test, mowa lub DTMF. |
| Conversation.OnlyAllowDTMF | Wartość logiczna | Wartość logiczna reprezentująca, czy w czasie wykonywania IVR ma być ustawiany tryb tylko do pracy z programem DTMF. |
| Conversation.SipUuiHeaderValue | string | Ciąg nagłówka UUI używany do przekazania kontekstu do narzędzia IVR w sprawie rozpoczęcia rozmowy. |