Praca ze zmiennymi

Zmiennych można używać do zapisywania odpowiedzi klientów i ponownego wykorzystania ich zawartości w dalszej części rozmowy.

Zmiennych można również używać do tworzenia wyrażeń logicznych, które dynamicznie przekierowują klienta do różnych ścieżek konwersacji. Można na przykład zapisać nazwę klienta w zmiennej o nazwie UserName, a pracownik może zwracać się do klienta przy użyciu tej nazwy w trakcie rozmowy.

Zmienne mogą być również przekazywane do i zwracane z innych tematów i przepływów usługi Power Automate.

Aplikacja sieci web

Zmienne mogą istnieć na trzech poziomach lub w trzech 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 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 pomocnika. Dostarczają one bardziej kontekstowych informacji o konwersacji lub użytkowniku. Są one dostępne we wszystkich tematach.

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 jej do ciągu wartości "apples" spowoduje błąd.

Podczas testowania pomocnika zmienna może tymczasowo występować 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. To oznacza, że węzły u góry kanwy tworzenia są używane przed węzłami u dołu. Podczas tworzenia odgałęzień z węzłów Warunek odgałęzienia są uporządkowane od lewej do prawej strony. To oznacza, że węzły w lewym odgałęzieniach są używane przed węzłami w samym odgałęzieniach 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 przedstawiono podstawowy typ zmiennej, który jest skojarzony z wstępnie zbudowanymi encjami.

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
Email	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

Tworzenie zmiennej

Każdy węzeł monitujący o wybranie zmiennej jako danych wyjściowych, taki jak węzeł Pytanie, automatycznie tworzy zmienną wyjściową odpowiedniego typu.

Wybieranie encji do użycia

Węzły Pytanie są domyślnie tworzone z wieloma opcjami wyboru. Aby użyć innej wstępnie utworzonej lub niestandardowej encji, zaznacz pole Identyfikuj i wybierz typ informacji, których powinien nasłuchiwać pomocnik.

Zmienianie nazwy zmiennej

Podczas tworzenia zmienne mają automatycznie przypisywaną nazwę. Najlepszym rozwiązaniem jest nadanie zmiennych znaczących nazw, aby ich przeznaczenie było jasne dla wszystkich innych, którzy muszą zarządzać pomocnikiem.

1. Wybierz zmienną, by otworzyć ją w okienku właściwości zmiennych.

2. W obszarze Nazwa zmiennej wprowadź nową nazwę zmiennej.

Ustaw zmienną

Zazwyczaj do zapisania danych wejściowych użytkownika w zmiennej będzie używany węzeł Pytanie. W niektórych przypadkach chcesz jednak samodzielnie ustawić wartość. W takim przypadku należy użyć węzła Ustaw wartość zmiennej.

1. Wybierz Dodaj węzeł (+), aby dodać węzeł, a następnie wybierz Zarządzanie zmianami>Ustaw wartość zmiennej.

2. Zaznacz pole w obszarze Ustaw zmienną, a następnie wybierz pozycję Utwórz nową zmienną.

   

   Została utworzona nowa zmienna. Jej typ jest nieznany, dopóki nie zostanie przypisana do niej wartość.

   

3. W przypadku Do wartości przypisz wartość, korzystając z jednej z następujących opcji:

   • Wpisz wartość literału.
   • Wybierz istniejącą zmienną tego samego typu. Ta akcja ustawi Twoją zmienną na taką samą wartość jak wybrana zmienna.
   • Użyj formuły Power Fx. Formuły Power Fx są przydatne w przypadku bardziej złożonych typów, w których nie można używać wartości literałów, takich jak Tabela i Typy rekordów.

Użyj wartości dosłownych

Zamiast wybierać wartość zmiennej, możesz wprowadzić wartość literału w dowolnej zmiennej.

Węzeł próbuje zinterpretować wartości literału jako ciąg, liczbę lub wartości logiczne. Na przykład wartość 123 jest interpretowana jako liczba. Jeśli chcesz, aby wartość była w zamian interpretowana jako wartość ciągu, możesz umieścić tę wartość w podwójnych cudzysłowach, na przykład tak: "123".

W przypadku niektórych scenariuszy lub gdy używasz bardziej złożonych typów, użyj odpowiedniej formuły programu Power Fx, aby ustawić określony typ.

Okienko Zmiennych

W okienku Zmienne można wyświetlić wszystkie zmienne dostępne w temacie, niezależnie od tego, w których węzłach są definiowane lub używane. Dla każdej zmiennej można wybrać, czy może otrzymywać jej wartości z innych tematów, zwracać jej wartość do innych tematów, czy mieć obie te możliwości. Zmienną, której właściwości chcesz edytować, można również wybrać w okienku Właściwości zmiennej.

Aby otworzyć okienko Zmienne, na pasku menu tematu wybierz pozycję Zmienne.

Okienko Właściwości zmiennej

W okienku właściwości zmiennej można zmienić nazwę zmiennej, sprawdzić, gdzie jest używana, lub przekonwertować ją na zmienną globalną. Nie można jednak przekonwertować jej ze zmiennej globalnej z powrotem na zmienną tematu. Można także wybrać, czy może ona odbierać wartości z, czy też przekazywać swoje wartości do innych tematów.

Aby otworzyć okienko właściwości zmiennych, wybierz zmienną w okienku zmiennych. Okienko właściwości zmiennej można również otworzyć, wybierając zmienną w dowolnym węźle.

Zmienne systemowe

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

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. Aby na przykład uwzględnić zmienną systemową User.DisplayName w formule, należy odwołać się do tej zmiennej jako System.User.DisplayName.

Nazwa/nazwisko	Type	Tylko do odczytu	Definicja
Activity.Attachments	tabela	tylko do odczytu	Pliki załączników dostarczone przez użytkownika
Activity.Channel	opcja wyboru	tylko do odczytu	Identyfikator kanału bieżącej konwersacji
Activity.ChannelData	dowolny	tylko do odczytu	Obiekt zawierający zawartość specyficzną dla kanału
Activity.ChannelId	string	tylko do odczytu	Identyfikator kanału bieżącej konwersacji jako ciąg
Activity.From.Id	string	tylko do odczytu	Unikalny identyfikator nadawcy specyficzny dla kanału
Activity.From.Name	string	tylko do odczytu	Przyjazna dla użytkownika ustalona dla kanału nazwa nadawcy
Activity.InputDTMFKeys	string	tylko do odczytu	Nieprzetworzone wartości klucza DTMF, które odebrano z telefonii.
Activity.Name	string	tylko do odczytu	Nazwa zdarzenia
Activity.Recipient.Id	string	tylko do odczytu	Właściwość Typ działania przychodzącego.
Activity.Recipient.Name	string	tylko do odczytu	Reprezentuje nazwę wyświetlaną pomocnik kanału. W kontekście kanału telefonii wartość tej zmiennej będzie numerem telefonu, do którego pomocnik jest dołączony.
Activity.SpeechRecognition.Confidence	numer	tylko do odczytu	Wyniki współczynnik ufności ASR zakończyły się od 0 do 1.
Activity.SpeechRecognition.MinimallyFormattedText	string	tylko do odczytu	Nieco sformatowany tekst w wyniku ASR. Przykład: pięćset dolarów. Wyrazy są pisane z pisownią, ale uwzględniana jest podstawowa litera ze znakiem przestankym.
Activity.Text	string	tylko do odczytu	Najnowsza wiadomość wysłana przez użytkownika
Activity.Type	opcja wyboru	tylko do odczytu	Typ działania
Activity.TypeId	string	tylko do odczytu	Typ działania w postaci ciągu
Activity.UserInputType	opcja wyboru	tylko do odczytu	Typ danych wejściowych w najnowszych danych wejściowych użytkownika końcowego. Wartość może mieć wartość test, mowa lub DTMF.
Activity.Value	dowolny	tylko do odczytu	Wartość nieograniczona
Bot.EnvironmentId	string	tylko do odczytu	Nazwa identyfikatora środowiska pomocnika.
Bot.Id	string	tylko do odczytu	Identyfikator pomocnika.
Bot.Name	string	tylko do odczytu	Nazwa Twojego pomocnika
Bot.SchemaName	string	tylko do odczytu	Nazwa schematu pomocnika.
Bot.TenantId	string	tylko do odczytu	Identyfikator dzierżawy pomocnika.
Channel.DisplayName	string	tylko do odczytu	Wyświetlana nazwa kanału
Channel.Specifier	string	tylko do odczytu	Nieprzetworzone wartości ciągu ChannelSpecifier, który został przekazany przez klienta.
ClientPluginActions	opcja wyboru	zapisywalne	Zbiór dynamicznych akcji dodatków plug-in klienta, które należy uwzględnić w przypadku akcji generujących.
Conversation.Id	string	tylko do odczytu	Unikalny identyfikator bieżącej konwersacji
Conversation.InTestMode	wartość logiczna	tylko do odczytu	Wartość logiczna reprezentująca, jeśli rozmowa dzieje się na kanwie testowej.
Conversation.LocalTimeZone	string	zapisywalne	Nazwa strefy czasowej, która ma być używana przez użytkownika w formacie bazy danych strefy czasowej IANA.
Conversation.LocalTimeZoneOffset	datetime	tylko do odczytu	Przesunięcie czasu przesunięcia czasowego dla bieżącej lokalnej strefy czasowej.
Conversation.OnlyAllowDTMF	wartość logiczna	tylko do odczytu	Wartość logiczna reprezentująca, czy w czasie wykonywania IVR ma być ustawiany tryb tylko do pracy z programem DTMF.
Conversation.SipUuiHeaderValue	string	tylko do odczytu	Ciąg nagłówka UUI używany do przekazania kontekstu do narzędzia IVR w sprawie rozpoczęcia rozmowy.
FallbackCount	numer	tylko do odczytu	Ta zmienna zlicza czas, w temat nie można jej dopasować do danych wejściowych użytkownika.
InactivityTimer.Continue	wartość logiczna	zapisywalne	Wartość logiczna reprezentująca, czy czasomierz ma być kontynuowany.
InactivityTimer.Count	numer	tylko do odczytu	Liczba czasu, przez który po skonfigurowaniu czasomierza (OnInactivity) został opuszczony z powodu braku aktywności użytkownika.
LastActivity.Id	string	tylko do odczytu	Identyfikator wcześniej wysłanego działania
LastMessage.Id	string	tylko do odczytu	Identyfikator poprzedniej wiadomości wysłanej przez użytkownika
LastMessage.Text	string	tylko do odczytu	Poprzednia wiadomość wysłana przez użytkownika
Recognizer.ExtractedEntities	opcja wyboru	zapisywalne	Reprezentuje wyodrębnione encje z komunikatu uruchamiającego.
Recognizer.IntentOptions	opcja wyboru	zapisywalne	Reprezentuje opcje opcji zamiaru w przypadku zwrócenia przez użytkownika jednoznacznych wyników.
Recognizer.SelectedIntent	opcja wyboru	zapisywalne	Reprezentuje zamiar wybrany w aparacie rozpoznawania.
Recognizer.TriggerMessage.Id	string	tylko do odczytu	Identyfikator wiadomości użytkownika, która spowodowała wyzwolenie bieżącego tematu
Recognizer.TriggerMessage.Text	string	tylko do odczytu	Wiadomość użytkownika, która spowodowała wyzwolenie bieżącego tematu
Recognizer.MultipleTopicsMatchedReason	string	tylko do odczytu	Wykorzystano do ustalenia, dlaczego dopasowano wiele tematów.
User.Language	opcja wyboru	zapisywalne	Ta zmienna służy do ustawienia regionalnych języków użytkownika na rozmowę.
SignInReason	opcja wyboru	tylko do odczytu	Używany do określenia, jaka opcja logowania jest potrzebna podczas wyzwalania temat.

Zmienne do uwierzytelniania zintegrowanego (domyślne)

Poniższe zmienne są dostępne po skonfigurowaniu serwera pomocnik do uwierzytelniania w firmie Microsoft. To umożliwia uwierzytelnianie za pomocą identyfikatora Tożsamość i umożliwia korzystanie tylko z zespołów i kanałów Power Apps. Jest to wartość domyślna dla nowych pomocników.

Nazwa/nazwisko	Type	Tylko do odczytu	Definicja
User.DisplayName	string	tylko do odczytu	Wyświetlana nazwa użytkownika rozmawiającego obecnie z pomocnikiem.
Użytkownik.Email	string	tylko do odczytu	Adres e-mail użytkownika rozmawiającego obecnie z pomocnikiem.
Użytkownik.FirstName	string	tylko do odczytu	Imię użytkownika rozmawiającego obecnie z pomocnikiem.
User.Id	string	tylko do odczytu	Identyfikator unikatowy użytkownika rozmawiającego obecnie z pomocnikiem.
User.IsLoggedIn	wartość logiczna	tylko do odczytu	Wartość logiczna reprezentująca, czy użytkownik rozmawia obecnie z pomocnik jest uwierzytelniony, czy nie.
Użytkownik.LastName	string	tylko do odczytu	Nazwisko użytkownika rozmawiającego obecnie z pomocnikiem.
Użytkownik.PrincipalName	string	tylko do odczytu	Główna nazwa użytkownika rozmawiającego obecnie z pomocnikiem.

Zmienne do uwierzytelniania ręcznego przy użyciu ogólnego OAuth 2

Poniższe zmienne są dostępne po skonfigurowaniu serwera pomocnik do używania dostawcy usługi ogólnej OAuth 2.

Nazwa/nazwisko	Type	Tylko do odczytu	Definicja
User.AccessToken	string	tylko do odczytu	Token dostępu dla użytkownika uwierzytelniania przy użyciu pomocnika.
User.DisplayName	string	tylko do odczytu	Wyświetlana nazwa użytkownika rozmawiającego obecnie z pomocnikiem.
User.Id	string	tylko do odczytu	Identyfikator unikatowy użytkownika rozmawiającego obecnie z pomocnikiem.
User.IsLoggedIn	wartość logiczna	tylko do odczytu	Wartość logiczna reprezentująca, czy użytkownik rozmawia obecnie z pomocnik jest uwierzytelniony, czy nie.

Zmienne do uwierzytelniania ręcznego przy użyciu ogólnego Tożsamość Microsoft Entra

Poniższe zmienne są dostępne po skonfigurowaniu serwera pomocnik do używania dostawców usługi Tożsamości Microsoft Entra (poprzednio pod nazwą Azure Active Directory).

Nazwa/nazwisko	Type	Tylko do odczytu	Definicja
User.AccessToken	string	tylko do odczytu	Token dostępu dla użytkownika uwierzytelniania przy użyciu pomocnika.
User.DisplayName	string	tylko do odczytu	Wyświetlana nazwa użytkownika rozmawiającego obecnie z pomocnikiem.
Użytkownik.Email	string	tylko do odczytu	Adres e-mail użytkownika rozmawiającego obecnie z pomocnikiem.
Użytkownik.FirstName	string	tylko do odczytu	Imię użytkownika rozmawiającego obecnie z pomocnikiem.
User.Id	string	tylko do odczytu	Identyfikator unikatowy użytkownika rozmawiającego obecnie z pomocnikiem.
User.IsLoggedIn	wartość logiczna	tylko do odczytu	Wartość logiczna reprezentująca, czy użytkownik rozmawia obecnie z pomocnik jest uwierzytelniony, czy nie.
Użytkownik.LastName	string	tylko do odczytu	Nazwisko użytkownika rozmawiającego obecnie z pomocnikiem.
Użytkownik.PrincipalName	string	tylko do odczytu	Główna nazwa użytkownika rozmawiającego obecnie z pomocnikiem.

Przekazywanie zmiennych między tematami

Podczas przekierowywania jednego tematu do innego można przekazać wartości zmiennych między tematem oryginalnym i docelowym. Przekazywanie zmiennych między tematami jest szczególnie przydatne, gdy we wcześniejszym temacie znajdują się już informacje, których potrzebuje późniejszy temat. Użytkownicy będą wdzięczni za to, że nie będą odpowiadać ponownie na te same pytania.

Odbieraj wartości z innych tematów

Gdy temat definiuje zmienną (na przykład w węźle Pytanie), pomocnik prosi użytkownika o wypełnienie wartości zmiennej. Jeśli wartość została już pozyskana przez pomocnika we wcześniejszym temacie, nie ma powodu, aby ponownie zadawać to pytanie. Dla tych przypadków można ustawić zmienną na Odbieraj wartości z innych tematów. Kiedy inne tematy przekierowują do tego tematu, może on przekazać wartość zmiennej (lub wartość literału) do tej zmiennej i pominąć pytanie. Prowadzi to do bezproblemowego doświadczenia użytkownika końcowego rozmawiającego z pomocnikiem.

W tym przykładzie użyjemy dwóch tematów: Powitanie i Rozmowa z klientem. Oba tematy zawierają pytanie o nazwę klienta. Jeśli jednak najpierw zostanie uruchomiony temat Powitanie, to pytanie zostanie pominięte w temacie Rozmowa z klientem. Zamiast tego zostanie użyta wartość przekazania z tematu Powitanie.

Oto przepływ tematu Rozmowa z klientem:

Jak pokazano w okienku Testowanie pomocnika, jeśli temat jest najpierw wyzwalany, użytkownik jest pytany „Jak mam się do Ciebie zwracać?”. Wartość jest przechowywana w zmiennej ciągu o nazwie userName. Zmienna userName ma też ustawioną wartość z innych tematów. Temat kończy się wiadomością „Mam nadzieję, że Twój dzień jest udany, {userName}!”

Oto przepływ tematu Powitanie:

Jak pokazano w okienku Testowanie pomocnika, jeśli temat jest najpierw wyzwalany, użytkownik jest pytany „Jak masz na imię?”. Wartość jest przechowywana w zmiennej ciągu o nazwie UserName. Temat wysyła wiadomość „Miło mi Cię poznać {UserName}!”. Następnie przekierowuje on użytkownika do tematu Rozmowa z klientem, która wysyła wiadomość „Mam nadzieję, że Twój dzień jest udany, {userName}!”. Należy jednak zauważyć, że temat Rozmowa z klientem pominął ponowne pytanie o imię użytkownika. Zamiast tego została użyta wartość UserName przekazana z tematu Powitanie.

Na koniec oto ponownie druga konwersacja, tym razem z perspektywy tematu Rozmowa z klientem:

Przejdźmy teraz przez kolejne kroki, aby skonfigurować temat do odbierania wartości z innych tematów. Użyjemy bieżącego przykładu, ale te same kroki będą działać w dowolnym momencie, gdy temat będzie musiał uzyskać wartość z wcześniejszego tematu.

Konfigurowanie tematu docelowego

Temat docelowy to temat, do którego następuje przekierowanie i który będzie odbierać wartości z innych tematów. W naszym przykładzie to Rozmowa z klientem.

1. Utwórz temat docelowy lub przejdź do niego.

2. Dodaj węzeł Pytanie i wprowadź wiadomość What should I call you?.

3. W obszarze Zidentyfikuj wybierz wstępnie zbudowaną encję Imię i nazwisko osoby.

4. Wybierz zmienną, aby otworzyć okienko Właściwości zmiennej. Nazwij ją userName, a następnie wybierz opcję Odbieraj wartości z innych tematów.

   

5. Dodaj węzeł Wiadomość.

6. W polu wiadomości wpisz I hope you're having a wonderful day,.

7. Wybierz ikonę Wstaw zmienną ({x}), a następnie wybierz opcję userName.

8. Wybierz miejsce za zmienną i wpisz !.

9. Zapisz temat.

Konfigurowanie tematu źródłowego

Temat źródłowy to temat dokonujący przekierowania, czyli ten, który dostarcza wartość przekazywaną do tematu źródłowego. W naszym przykładzie jest to temat Powitanie.

1. Przejdź do tematu źródłowego.

2. Wybierz węzeł Przekieruj i wybierz temat docelowy.

3. Wybierz pozycję + Dodaj wartość wejściową, a następnie wybierz zmienną z tematu docelowego, do którego chcesz przekazać wartość.

   

4. Wybierz ikonę >, a następnie wybierz zmienną, której wartość chcesz przekazać.

   

   Węzeł Przekieruj powinien teraz wyglądać następująco:

   

5. Zapisz temat.

Zwróć wartości do oryginalnych tematów

Kiedy temat jest przekierowywany i uzyskuje zmienną, zadając pytanie lub w inny sposób, zmienna może być zwrócona do oryginalnego tematu. Zmienna staje się również częścią oryginalnego tematu i może być używana jak każda inna zmienna. Informacje uzyskiwane przez pomocnika są więc dostępne w różnych tematach, co zmniejsza konieczność wyszukiwania zmiennych globalnych.

Kontynuujmy pracę z przykładem z poprzedniej sekcji. Zadajmy nowe pytanie w temacie Rozmowa z klientem, a następnie zwrócimy odpowiedź do tematu Powitanie.

Konfigurowanie tematu źródłowego na potrzeby zwróconej zmiennej

Gdy zmienna jest zwracana do tematu, temat źródłowy to temat, do którego następuje przekierowanie, czyli ten, który zapewnia wartość, która zostanie przekazana z powrotem do tematu oryginalnego. W tym przykładzie to Rozmowa z klientem.

1. Przejdź do tematu źródłowego.

2. Dodaj węzeł Pytanie i wprowadź wiadomość What city do you live in?.

3. W obszarze Zidentyfikuj wybierz wstępnie zbudowaną encję Miasto.

4. Wybierz zmienną, aby otworzyć okienko Właściwości zmiennej. Nazwij ją userCity, a następnie wybierz opcję Zwróć wartości do oryginalnych tematów.

   

5. Zapisz temat.

Konfigurowanie tematu docelowego na potrzeby zwróconej zmiennej

Gdy zmienna jest zwracana do tematu, temat docelowy to temat dokonujący przekierowania, czyli ten, który będzie odbierać wartości z innych tematów. W naszym przykładzie jest to temat Powitanie.

1. Przejdź do tematu docelowego.

2. Zmienna wybrana w temacie źródłowym powinna być wyświetlana w węźle Przekieruj jako zmienna wyjściowa.

   

3. Zapisz temat.

Klasyczny

Typ encji i zmiennej

Copilot Studio używa encji do identyfikowania określonego typu informacji z odpowiedzi użytkownika. Typ zmiennej jest skojarzony z informacjami zidentyfikowanymi podczas ich zapisania. Typ zmiennej jest analogiczny do encji.

Każdy typ encji lub zmiennej jest mapowany na typ podstawowy, jak wymieniono w poniższej tabeli. Typ podstawowy określa operatory, których można używać podczas tworzenia wyrażenia logicznego z odpowiednią zmienną. Określa również, czy zmienna może być przekazana do przepływu lub umiejętności Bot Framework jako parametru wejściowego.

Na przykład typ wartości logicznych mapuje się na operator „jest równe”, a możliwe wartości to Prawda lub Fałsz. Typ podstawowy numeru daje operatory liczbowe, takie jak "jest równe", "jest większe niż" lub "jest większe niż lub równe się" i tak dalej.

Jednostka	Typ podstawowy zmiennej
Wiele opcji wyboru	String
Cała odpowiedź użytkownika	String
Wiek	telefonu
Boolean	Boolean
City	String
Color	String
Kontynent	String
Kraj lub region	String
Data i godzina	String
Duration	String
Email	String
Wydarzenie	String
Język	String
Money	String
telefonu	String
Liczba porządkowa	String
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	String

Tworzenie zmiennej

Na kanwie tworzenia bota dodaj węzeł pytań. Zmienna jest tworzona automatycznie w węźle.

1. Przejdź do strony Tematy swojego bota i otwórz temat, do którego chcesz dodać zmienną.

2. Wybierz Dodaj węzeł (+), a następnie wybierz pozycję Zadaj pytanie.

   

   Zmienna zawierająca odpowiedź użytkownika jest tworzona automatycznie.

   

Wybieranie encji do użycia

Domyślnie węzeł pytań jest tworzony z wieloma opcjami wyboru. Aby użyć innego obiektu wstępnie utworzonego lub niestandardowego, wybierz element do identyfikacji z węzła.

Zmienianie nazwy zmiennej

Automatycznie utworzone zmienne mają nazwę domyślną. Aby zmienić nazwę zmiennej, wybierz nazwę zmiennej, wprowadź nową nazwę i wybierz opcję Wykonane.

Używanie zmiennych w węzłach akcji

Jeśli zmienna jest używania w węźle akcji, jeśli jej typ podstawowy odpowiada typowi parametru określonego dla przepływu lub umiejętności Bot Framework, można go dodać do tego parametru. Dane wyjściowe z węzłów akcji wygenerują nowe zmienne.

Korzystanie z wartości literalnych w węzłach akcji

Zamiast wybierania zmiennej z menu można wpisać wartość literową w polu wejściowym zmiennej w węźle akcji.

Węzeł Analizuj wartość

Węzeł Analizuj wartość umożliwia konwersję wartości jednego typu na wartość innego typu. Podczas dodawania węzła do tematu wybierz Dodaj węzeł (+), a następnie opcję Zarządzanie zmienną i Analizuj wartość.

Kluczowe scenariusze wykorzystujące węzeł Wartość analizy skoncentrują się na konwertowaniu nieprzetworzonych zmiennych JSON lub nienapisanych (których wartość lub struktura nie są poznane do czasu uruchomienia, na przykład ChannelData) na konkretne typy.

Proces rozpoczyna się w momencie wywołania przepływu, który z kolei wywołuje interfejs API. Następnie interfejs API zwraca wynik. Zazwyczaj konieczna będzie analiza tej odpowiedzi i zwrócenie przynajmniej jednej podstawowej zmienne do Copilot Studio. Przy użyciu węzła Analizuj wartości można wysłać w postaci ciągu tekstowego cały wynik interfejsu API:

{
    "Name": "Gary",
    "Position": "PM",
    "Company": "Microsoft",
    "FormerPositions": [{
            "Position": "Engineer"
        }
    ]
}

Zmienna ciągów, która teraz może zostać przekonwertowana na zmienną rekordu z pełną obsługą IntelliSense w Power Fx za pomocą tego nowego węzła. Przykład użycia danych przykładowych pomoże zilustrować ten proces.

Przykład użycia węzła Analizuj wartość

1. Dodaj węzeł Analizuj wartość i wybierz zmienną, którą chcesz przeanalizować.

   

2. Wybierz typ danych. W tym przypadku należy wybrać pozycję „Z danych przykładowych”.

   

3. Teraz możesz podać JSON, naciskając opcję „Pobierz schemat z przykładowego JSON.” Kliknięcie tego przycisku powoduje otwarcie edytora, w którym można wkleić przykład.

   

4. Na koniec określ, w której zmiennej ma zostać umieszczona przeanalizowana wartość. Zwykle należy utworzyć w tym celu nową zmienną.

   

   Należy zauważyć, że zmienna wyjściowa jest teraz poprawnego typu — Rekord.

   

Teraz możesz użyć nowej zmiennej. W edytorze Power Fx można zobaczyć, że dla różnych właściwości można uzyskać pełne IntelliSense.

Podobnie jak w przypadku analiz ciągów JSON kluczem będzie użycie węzła wartości analizy UntypedObjects w czasie wykonywania. Najpopularniejsze z nich to otrzymanie zdarzenia i konieczność analizy wartości zdarzenia. Można też chcieć przeanalizować właściwość System.Activity.ChannelData, która różni się w czasie wykonywania według kanałów.

W poniższym przykładzie, jeśli zdarzenie pochodzi z Teams, należy użyć dokumentacji dla deweloperów, aby znaleźć przykład tego, jak będzie wyglądało zdarzenie przychodzące, a następnie użyć danych przykładowych, jak pokazano w tej sekcji.

Przekazywanie zmiennych między tematami

Podczas przekierowywania do innych tematów, możesz chcieć przekazać wartości do zmiennych w temacie docelowym lub otrzymać od niego zmienne z powrotem. Przekazywanie zmiennych między tematami jest szczególnie przydatne, gdy już masz informacje, których temat potrzebuje. Użytkownicy będą wdzięczni za to, że nie będą odpowiadać ponownie na to samo pytanie. Może to być również pomocne przy refaktoryzacji i rozdzielaniu tematów na komponenty wielokrotnego użytku, a ty chcesz przekazywać zmienne pomiędzy tematami.

Uwaga

Zmiennych typu Custom Entity, Date and Time, Duration i Multiple-choice nie można przekazywać między tematami.

Odbieraj wartości z innych tematów

Kiedy temat definiuje zmienną (na przykład przez węzeł pytania), bota zada użytkownikowi pytanie, aby wypełnić wartość zmiennej. Jeśli wartość została już pozyskana przez bota, nie ma powodu, aby ponownie zadawać to pytanie. Dla tych przypadków zmienna ta może być zdefiniowana jako Odbieraj wartości z innych tematów. Kiedy inne tematy przekierowują do tego tematu, może on wtedy przekazać zmienną (lub dosłowne wartości) do tej zmiennej, i pominie to pytanie całkowicie. Prowadzi to do bezproblemowego doświadczenia użytkownika końcowego rozmawiającego z botem.

Aby otrzymywać wartości z innych tematów, należy ustawić właściwość zmiennej:

1. W węźle Pytanie wybierz zmienną, która ma otrzymywać wartości z innych tematów.

2. W okienku Właściwości zmiennych w obszarze Temat (ograniczony zakres) wybierz opcję Odbierz wartości z innych tematów.

   

3. Zapisz temat.

4. Przejdź do tematy, do której chcesz przekierować. Postępuj zgodnie z krokami w przekierowywaniu do tematu, aby przekierować do właściwego tematu.

5. Wybierz + Dodaj dane wejściowe dotyczące tematu docelowego.

   

6. Wybierz zmienną z przekierowanego tematu, do którego chcesz przekazać zmienną.

   

7. W obszarze Wprowadź lub wybierz wartość, wybierz zmienną z bieżącej wartości temat, którą chcesz przekazać do przekierowywania tematu.

   

   Zmienna jest wyświetlana w przekierowywanym węźle.

   

Zwróć wartości do oryginalnych tematów

Kiedy temat zadaje pytanie lub w inny sposób uzyskuje zmienną z akcji, ta zmienna może być zwrócona do oryginalnego tematu, który ją przekierował.

W tym przypadku zmienna staje się również częścią oryginalnego tematu i może być używana jak każda inna zmienna. Pomaga to w zbudowaniu tematu tak, aby informacje uzyskiwane przez tego bota były dostępne w różnych tematach, zmniejszając konieczność tworzenia zmiennych globalnych.

Aby przywrócić zmienną do oryginalnego tematu, ustaw właściwość zmiennej:

1. W węźle Pytanie wybierz zmienną, która ma otrzymywać wartości z innych tematów.

2. W okienku Właściwości zmiennych w obszarze Temat (ograniczony zakres) wybierz opcję Zwróć wartości z pierwotnych tematów.

   

3. Zapisz temat.

4. Przejdź do tematy, do której chcesz przekierować. Postępuj zgodnie z krokami w przekierowywaniu do tematu, aby przekierować do właściwego tematu.

   Zmienna, która jest zwracana do tematu, jest wyświetlana w przekierowanym temacie. Użyj zwróconej zmiennej w swoim temacie.

   

Korzystanie z panelu zmiennych

Użyj panelu Zmienne, aby wybrać status odbioru lub zwrotu wielu zmiennych jednocześnie.

1. Na temat menu wybierz Zmienne.

   

2. Dla każdej zmiennej w temacie wybierz, czy wartości mają być przekazywane, odebrane czy obie opcje między tematami.

   

Używanie dosłownych wartości na zmiennych wejściach

Wartości literowe i zmienne można przekazać do tematu. Aby przekazać wartość dosłowną, wpisz wartość, której chcesz użyć jako wejścia, zamiast wybierać zmienną.

Powiązana zawartość

• Używanie zmiennych do przenoszenia zawartości między tematami
• Dostosowywanie wyglądu i działania pomocnika