Omówienie wariantów

Note

Funkcje opisane w tym artykule są obsługiwane przez standardowy mechanizm, który wykorzystuje opcje rozliczeniowe opisane w Licencjonowanie agentów obsługiwanych przez standardowy mechanizm. Dowiedz się, jak uzyskać dostęp do standardowych funkcji w Uzyskiwanie dostępu do standardowych agentów i przepływów agentó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. Oddzielając parametry od obiektów konsumujących, możesz zmienić wartości w tym samym środowisku lub podczas migracji 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
Sznurek Sekwencja znaków używanych do reprezentowania tekstu
logiczny Wartość logiczna, która może być tylko wartością true lub false
Number 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
Pusty Symbol zastępczy dla „braku wartości” lub „nieznanej wartości”; więcej informacji znajdziesz w Blank 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 płótna autorskiego. Agent rozważa węzły na górze płótna autorskiego, a następnie węzły na dole.

Gdy tworzysz gałęzie za pomocą węzłów warunkowych, Copilot Studio porządkuje je od lewej do prawej. Agent rozważa węzły w najbardziej lewej gałęzi przed węzłami w najbardziej prawej gałęzi.

Entities

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.

Entity Typ podstawowy zmiennej
Wiele opcji wyboru Wybór
Cała odpowiedź użytkownika Sznurek
Wiek Number
logiczny logiczny
Miejscowość Sznurek
Kolor Sznurek
Continent Sznurek
Kraj lub region Sznurek
Data i godzina Data i czas
Email Sznurek
Event Sznurek
Liczba całkowita Liczba całkowita
Język Sznurek
Pieniądze Number
Number Number
Liczba porządkowa Number
Organizacja Sznurek
Wartość procentowa Number
Imię i nazwisko osoby Sznurek
Numer telefonu Sznurek
Miejsce warte uwagi Sznurek
Szybkość Number
Państwa Sznurek
Adres ulicy Sznurek
Temperatura Number
adres URL Sznurek
Weight Number
Kod pocztowy Sznurek
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 dokładnie taka sama, z wyjątkiem kilku kluczowych zewnętrznych odniesień, które różnią się między środowiskiem źródłowym a docelowym.

Używaj zmiennych środowiskowych tak samo jak zmiennych tematycznych, globalnych i systemowych. 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 korzystająca ze zmiennych środowiskowych zawiera wartości ustawione dla tych zmiennych podczas publikacji agenta. Za każdym razem, gdy administrator aktualizuje zmienne środowiskowe, musisz ponownie opublikować wszystkich agentów, którzy z nich korzystają, aby zmiany weszły w życie w czasie działania. 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 Number
JSON Wykryj typ na podstawie wartości. Jeżeli to nie jest JSON => Nieokreślony (błąd walidacji)
Tekst Sznurek
Yes/No logiczny
Źródło danych Sznurek
Secret Sznurek

Note

Błędy zmiennych środowiskowych widzisz na czacie testowym i podczas publikowania. Jednak te błędy nie pojawiają się na liście tematów , ponieważ zmienne środowiskowe nie są zmiennymi tematycznymi.

Zmienne systemowe

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

Zrzut ekranu zmiennych systemowych w danym temacie.

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ł choice 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 choice 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 choice 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.
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 choice 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 choice 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 choice 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 choice 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 choice Ta zmienna służy do ustawienia regionalnych języków użytkownika na rozmowę.

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ą. Dowiedz się więcej w Używaj zmiennych głosowych.

Name Typ Definition
Aktywność.InputDTMFKeys ciąg Nieprzetworzona wartość klucza DTMF z telefonii.
Działanie.RozpoznawanieMowy.Pewność number Cały wynik pewności dla hipotezy automatycznego rozpoznawania mowy, 0 do 1.
Activity.SpeechRecognition.MinimallyFormattedText ciąg Lekko sformatowany tekst wyniku hipotezy automatycznego rozpoznawania mowy. Na przykład „Pięćset dolarów”. Słowa są literowane, ale z uwzględnieniem podstawowych wielkich liter i interpunkcji.
Activity.UserInputType choice 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.

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. Dowiedz się więcej w sekcji 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.
  • Last updated on