Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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. Są one tylko 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 | opis |
|---|---|
| Ciąg | 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 |
| Tabela | 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 |
| Puste | Symbol zastępczy dla „braku wartości” lub „nieznanej wartości”; aby uzyskać więcej informacji, zobacz Puste w dokumentacji usługi 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 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ślonych typów 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 | Ciąg |
| Wiek | telefonu |
| Logiczna | Logiczna |
| Miasto | Ciąg |
| Kolor | Ciąg |
| Kontynent | Ciąg |
| Kraj lub region | Ciąg |
| Data i godzina | DateTime |
| Ciąg | |
| Wydarzenie | Ciąg |
| Liczba całkowita | Liczba całkowita |
| Język | Ciąg |
| Pieniądze | telefonu |
| telefonu | telefonu |
| Liczba porządkowa | telefonu |
| Organizacja | Ciąg |
| Wartość procentowa | telefonu |
| Imię i nazwisko osoby | Ciąg |
| Numer telefonu | Ciąg |
| Punkt orientacyjny | Ciąg |
| Szybkość | telefonu |
| Państwo | Ciąg |
| Ulica | Ciąg |
| Temperatura | telefonu |
| URL | Ciąg |
| Waga | telefonu |
| Kod pocztowy | Ciąg |
| Obiekt niestandardowy | Opcja wyboru |
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.
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 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ą mapowanie na typy danych Power Apps w następujący sposób:
| Typ w programie Copilot Studio | Typ w usłudze Power Apps |
|---|---|
| Liczba dziesiętna | Numer |
| JSON | Wykryj typ na podstawie wartości. Jeżeli to nie jest JSON => Nieokreślony (błąd walidacji) |
| Tekst | Ciąg |
| Tak/Nie | Wartość logiczna |
| Źródło danych | Ciąg |
| Klucz tajny | Ciąg |
Notatka
Błędy zmiennych środowiskowych są widoczne w czacie Test 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.
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.
| Imię i nazwisko | Pisz | Definicja |
|---|---|---|
| Activity.Attachments | tabela | Załączniki plików dodane 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.Typ | 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 | Liczba | 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 | Liczba | 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 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 intencji, gdy aparat rozpoznawania zwraca niejednoznaczne wyniki. 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 uwierzytelniania usługi Tożsamość Microsoft Entra i jest domyślna dla nowych agentów.
Aby uzyskać więcej informacji, zobacz Zmienne uwierzytelniania.
| Imię i nazwisko | Pisz | 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 dla agentów skonfigurowanych do korzystania z dostawcy usług Ogólne uwierzytelnianie OAuth 2.
| Imię i nazwisko | Pisz | 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 ręcznego uwierzytelniania użytkowników za pomocą usługi Tożsamość Microsoft Entra
Następujące zmienne są dostępne dla agentów skonfigurowanych do korzystania z dostawców usług Tożsamość Microsoft Entra (dawniej Azure Active Directory).
| Imię i nazwisko | Pisz | 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.
| Imię i nazwisko | Pisz | Definicja |
|---|---|---|
| Activity.InputDTMFKeys | string | Nieprzetworzona wartość klucza DTMF z telefonii. |
| Activity.SpeechRecognition.Confidence | Liczba | 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. Na przykład „Pięćset dolarów”. Słowa są literowane, ale z uwzględnieniem podstawowych wielkich liter i interpunkcji. |
| Activity.UserInputType | opcja wyboru | Typ najnowszych danych wejściowych od użytkownika agenta. 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. |