Omówienie wariantów

Zmienne istnieją na czterech poziomach, lub w czterech zakresach:

  • Zmienne tematów, których można używać tylko w tematach, w których je tworzysz. Ten zakres jest domyślny w przypadku tworzonych przez Ciebie zmiennych.
  • Zmienne globalne, których można używać we wszystkich tematach. Zakres zmiennej tematu można zmienić, aby była zmienną globalną.
  • Zmienne systemowe tworzone automatycznie przez Copilot Studio dla agenta. Dostarczają one bardziej kontekstowych informacji o konwersacji lub użytkowniku. Są one dostępne we wszystkich tematach.
  • Zmienne środowiskowe tworzone w usłudze Power Platform. Mają one ustawiony tylko tryb do odczytu w Copilot Studio. Przechowują klucze i wartości parametrów, które mogą następnie służyć 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

Każda zmienna ma typ podstawowy. Ów typ określa, jakie wartości może przechowywać zmienna, oraz operatory, których można używać podczas tworzenia wyrażenia logicznego z tą zmienną.

Typ Description
Ciąg Sekwencja znaków używanych do reprezentowania tekstu
logiczny Wartość logiczna, która może być tylko wartością true lub false
Identyfikator Dowolna liczba rzeczywista
Tabela Lista wartości, ale wszystkie wartości muszą być tego samego typu
Rekord Zbiór par nazwa-wartość, gdzie wartości mogą być dowolnego typu
Data i czas Data, godzina, dzień tygodnia lub miesiąc w odniesieniu do punktu w czasie
Wybór Lista wartości ciągów ze skojarzonymi synonimami
Puste Symbol zastępczy dla „braku wartości” lub „nieznanej wartości”; aby uzyskać więcej informacji, zobacz Puste w dokumentacji Power Fx

Typ zmiennej ustawia się przy pierwszym przypisywaniu do niej wartości. Następnie typ jest stały i nie można przypisać wartości żadnego innego typu. Jeśli na przykład do zmiennej przypiszesz wartość początkową 1, to ustawisz jej typ na Liczba. Jeśli następnie spróbujesz przypisać wartość typu Ciąg, na przykład "apples", zostanie wyświetlony błąd.

Podczas testowania agenta może się tymczasowo pojawić zmienna o typie nieznany. Nieznana zmienna nie ma jeszcze wartości.

Kolejność zmiennych jest ustalana od góry do dołu na kanwie tworzenia. Węzły w górnej części płótna edycyjnego 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. 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 obiektów do identyfikacji określonych typów informacji na podstawie 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 Wybór
Cała odpowiedź użytkownika Ciąg
Wiek Identyfikator
logiczny logiczny
Miejscowość Ciąg
Kolor Ciąg
Kontynent Ciąg
Kraj lub region Ciąg
Data i godzina Data i czas
Email Ciąg
Event Ciąg
Liczba całkowita Liczba całkowita
Język Ciąg
Pieniądze Identyfikator
Identyfikator Identyfikator
Porządkowy Identyfikator
Organizacja Ciąg
Procentowo Identyfikator
Imię i nazwisko osoby Ciąg
Numer telefonu Ciąg
Miejsce warte uwagi Ciąg
Szybkość Identyfikator
Stan Ciąg
Adres ulicy Ciąg
Temperatura Identyfikator
adres URL Ciąg
Waga Identyfikator
Kod pocztowy Ciąg
Obiekt niestandardowy Wybór

Zmienne środowiskowe

Zmienne środowiskowe to koncepcja platformy 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.

Używaj zmiennych środowiska w taki sam sposób jak zmienne temat, globalne i systemowe. Jedną z zauważalnych różnic jest to, że zmienne środowiskowe są tylko do odczytu w Copilot Studio. Autorzy agentów nie mogą modyfikować zmiennych środowiskowych w programie Copilot Studio. Administratorzy mogą jednak zmienić wartość zmiennych środowiskowych w Power Apps. W Copilot Studio można użyć panelu Zmienne, aby wyświetlić informacje o zmiennej środowiskowej. Panel Właściwości zmiennych zawiera również link do usługi Power Apps— środowiska tworzenia zmiennych środowiskowych.

Opublikowana wersja agenta, która używa zmiennych środowiskowych, ma wartości, które są ustawiane 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 Copilot Studio są mapowane na typy danych Power Apps w następujący sposób:

Typ w programie Copilot Studio Wpisz w Power Apps
Liczba dziesiętna Identyfikator
JSON Wykryj typ na podstawie wartości. Jeżeli to nie jest JSON => Nieokreślony (błąd walidacji)
Tekst Ciąg
Tak/nie logiczny
Źródło danych Ciąg
Secret Ciąg

Uwaga / Notatka

Błędy zmiennych środowiskowych są widoczne w czacie testowym i podczas publikowania. Jednak te błędy nie są wyświetlane na liście tematów , ponieważ nie są zmiennymi tematu.

Zmienne systemowe

Każdy agent ma wbudowane zmienne systemowe, które dostarczają dodatkowych informacji o konwersacji.

Zrzut ekranu przedstawiający zmienne systemowe w temacie agent.

Uwaga / Notatka

Aby uzyskać więcej informacji na temat zmiennych agent z obsługą głosu, zobacz Używanie zmiennych głosowych.

Program Copilot Studio nie wyświetla wszystkich zmiennych systemowych. Aby uzyskać dostęp do ukrytych zmiennych systemowych, użyj formuły Power Fx.

Aby użyć zmiennych systemowych w formule Power Fx, dodaj System. przed nazwą zmiennej. Na przykład aby uwzględnić zmienną systemową User.DisplayName w formule, odnieś się do niej jako System.User.DisplayName.

Name Typ Definition
Aktywność.Załączniki tabela Załączniki plików dodane przez użytkownika.
Aktywność.Kanał wybór Identyfikator kanału bieżącej konwersacji.
Activity.ChannelData any Obiekt zawierający zawartość specyficzną dla kanału.
Activity.ChannelId ciąg Identyfikator kanału bieżącej konwersacji jako ciąg.
Activity.From.Id ciąg Unikalny identyfikator nadawcy specyficzny dla kanału.
Activity.From.Name ciąg Przyjazna dla użytkownika ustalona dla kanału nazwa nadawcy.
Aktywność.Nazwa ciąg Nazwa zdarzenia.
Activity.Recipient.Id ciąg Właściwość typu dla przychodzącej aktywności.
Aktywność.Odbiorca.Imię ciąg 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 ciąg Najnowsza wiadomość wysłana przez użytkownika.
Activity.Typ wybór Typ działania.
Activity.TypeId ciąg Typ działania w postaci ciągu.
Activity.Wartość any Wartość nieograniczona.
Bot.EnvironmentId ciąg Identyfikator środowiska agenta.
Bot.Id ciąg Identyfikator agenta.
Bot.Name ciąg Nazwa Twojego agenta.
Bot.SchemaName ciąg Nazwa schematu agenta.
Bot.TenantId ciąg Identyfikator dzierżawcy agenta.
ClientPluginActions wybór Zbiór dynamicznych akcji dodatków plug-in klienta, które należy uwzględnić w przypadku orkiestracji generatywnej.
Conversation.Id ciąg Unikalny identyfikator bieżącej konwersacji.
Conversation.InTestMode logiczny Flaga logiczna, która wskazuje, czy rozmowa odbywa się na kanwie testowej.
Conversation.LocalTimeZone ciąg Nazwa strefy czasowej, która ma być używana przez użytkownika w formacie bazy danych strefy czasowej IANA.
Conversation.LocalTimeZoneOffset data/godzina Przesunięcie względem UTC dla bieżącej lokalnej strefy czasowej.
Kod błędu ciąg Kod błędu obecnego problemu.
Komunikat o bieżącym błędzie.
Komunikat o błędzie ciąg Komunikat o bieżącym błędzie.
Uwaga: ta zmienna jest obsługiwana tylko wtedy, gdy jest to wyzwalacz On Error.
FallbackCount number Ta zmienna zlicza ilość razy, gdy temat nie można było dopasować do danych wejściowych użytkownika.
Uwaga: ta zmienna jest obsługiwana tylko wtedy, gdy jest to wyzwalacz On Unknown Intent.
InactivityTimer.Continue logiczny Wartość logiczna reprezentująca, czy czasomierz ma kontynuować swoje działanie.
Uwaga: ta zmienna jest obsługiwana tylko wtedy, gdy jest to wyzwalacz Inactivity.
LicznikNieaktywności.Wartość number Liczba uruchomień czasomierza OnInactivity z powodu braku aktywności użytkownika po skonfigurowanym czasie.
Uwaga: ta zmienna jest obsługiwana tylko wtedy, gdy jest to wyzwalacz Inactivity. Dowiedz się więcej w wyzwalaczu braku aktywności o konfigurowaniu wyzwalaczy braku aktywności i używaniu tych zmiennych.
LastMessage.Id ciąg Identyfikator poprzedniej wiadomości wysłanej przez użytkownika.
LastMessage.Tekst ciąg Poprzednia wiadomość wysłana przez użytkownika.
Rozpoznawacz.WyodrębnioneObiekty wybór Reprezentuje wyodrębnione encje z komunikatu uruchamiającego.
Uwaga: ta zmienna jest obsługiwana tylko wtedy, gdy jest to wyzwalacz On Select Intent.
Recognizer.IntentOptions wybór Reprezentuje opcje intencji, gdy aparat rozpoznawania zwraca niejednoznaczne wyniki.
Uwaga: ta zmienna jest obsługiwana tylko wtedy, gdy jest to wyzwalacz On Select Intent.
Recognizer.SelectedIntent wybór Reprezentuje zamiar wybrany w aparacie rozpoznawania.
Uwaga: ta zmienna jest obsługiwana tylko wtedy, gdy jest to wyzwalacz On Select Intent.
Recognizer.TriggeringMessage.Id ciąg Identyfikator wiadomości użytkownika, która uruchomiła bieżący wątek.
Recognizer.TriggeringMessage.Text ciąg Wiadomość użytkownika, która spowodowała wywołanie bieżącego tematu.
Recognizer.MultipleTopicsMatchedReason ciąg Służy do określania, dlaczego dopasowano wiele tematów.
Uwaga: ta zmienna jest obsługiwana tylko wtedy, gdy jest to wyzwalacz On Select Intent.
Powód Logowania wybór Używany do określenia, jaka opcja logowania jest potrzebna podczas wyzwalania temat.
Uwaga: ta zmienna jest obsługiwana tylko wtedy, gdy jest to wyzwalacz On Sign In.
Użytkownik.Język wybór 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 uwierzytelniania za pomocą Microsoft Entra ID i jest domyślną dla nowych agentów.

Aby uzyskać więcej informacji, zobacz Zmienne uwierzytelniania.

Name Typ Definition
User.DisplayName ciąg Wyświetlana nazwa użytkownika rozmawiającego obecnie z agentem.
Użytkownik.Email ciąg Adres e-mail użytkownika rozmawiającego obecnie z agentem.
Użytkownik.FirstName ciąg Imię użytkownika rozmawiającego obecnie z agentem.
Id użytkownika ciąg Identyfikator unikatowy użytkownika rozmawiającego obecnie z agentem.
User.IsLoggedIn logiczny Flaga logiczna, która informuje, czy użytkownik aktualnie rozmawiający z agent jest uwierzytelniony, czy nie.
Użytkownik.LastName ciąg Nazwisko użytkownika, który aktualnie rozmawia z agent.
Użytkownik.PrincipalName ciąg Główna nazwa użytkownika rozmawiającego obecnie z agentem.

Zmienne do ręcznego uwierzytelniania przy użyciu genericznego OAuth 2

Następujące zmienne są dostępne dla agentów skonfigurowanych do korzystania z dostawcy usług Generic OAuth 2.

Name Typ Definition
User.AccessToken ciąg Token dostępu użytkownika uwierzytelniającego się za pomocą agenta.
User.DisplayName ciąg Wyświetlana nazwa użytkownika rozmawiającego obecnie z agentem.
Id użytkownika ciąg Identyfikator unikatowy użytkownika rozmawiającego obecnie z agentem.
User.IsLoggedIn logiczny Flaga logiczna, która informuje, czy użytkownik aktualnie rozmawiający z agent jest uwierzytelniony, czy nie.

Zmienne do ręcznego uwierzytelniania z Microsoft Entra ID

Następujące zmienne są dostępne dla agentów skonfigurowanych do użytkowania dostawców usług Microsoft Entra ID (dawniej Azure Active Directory).

Name Typ Definition
User.AccessToken ciąg Token dostępu użytkownika uwierzytelniającego się za pomocą agenta.
User.DisplayName ciąg Wyświetlana nazwa użytkownika rozmawiającego obecnie z agentem.
Użytkownik.Email ciąg Adres e-mail użytkownika rozmawiającego obecnie z agentem.
Użytkownik.FirstName ciąg Imię użytkownika rozmawiającego obecnie z agentem.
Id użytkownika ciąg Identyfikator unikatowy użytkownika rozmawiającego obecnie z agentem.
User.IsLoggedIn logiczny Flaga logiczna, która informuje, czy użytkownik aktualnie rozmawiający z agent jest uwierzytelniony, czy nie.
Użytkownik.LastName ciąg Nazwisko użytkownika, który aktualnie rozmawia z agent.
Użytkownik.PrincipalName ciąg 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 dla agentów z obsługą głosową.

Uwaga / Notatka

Aby uzyskać więcej informacji na temat zmiennych agent z obsługą głosu, zobacz Używanie zmiennych głosowych.

Name Typ Definition
Aktywność.InputDTMFKeys ciąg Nieprzetworzona wartość klucza DTMF z telefonii.
Działanie.RozpoznawanieMowy.Pewność number Współczynnik ufności dla całego wyniku tezy Azure Site Recovery, od 0 do 1.
Activity.SpeechRecognition.MinimallyFormattedText ciąg Lekko sformatowany tekst wyniku hipotezy dla Azure Site Recovery. Na przykład „Pięćset dolarów”. Słowa są literowane, ale z uwzględnieniem podstawowych wielkich liter i interpunkcji.
Activity.UserInputType wybór Typ najnowszych danych wejściowych od użytkownika agenta. Wartość może być testem, głosem lub DTMF.
Rozmowa.TylkoZezwólNaDTMF logiczny Flaga logiczna, która wskazuje, czy podczas działania IVR powinna być ustawiona na tryb wyłącznie DTMF.
Conversation.SipUuiHeaderValue ciąg Ciąg nagłówka UUI używany do przekazania kontekstu do narzędzia IVR przy rozpoczęciu połączenia.
  • Last updated on