Praca ze zmiennymi

Korzystaj ze zmiennych w celu przechowywania odpowiedzi klientów i ponownego korzystania z ich zawartości w dalszej części konwersacji.

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 customerName, a agent może zwracać się do klienta po imieniu, gdy konwersacja jest kontynuowana.

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

Tworzenie zmiennej

Aplikacja sieci web

Każdy węzeł, który zwraca dane wyjściowe, taki jak węzeł Pytanie, automatycznie tworzy zmienną wyjściową odpowiedniego typu.

Wskazówka

Zmień nazwy węzłów, aby ułatwić ich identyfikację. Zaznacz pole nazwy węzła, aby bezpośrednio zaktualizować nazwę lub wybierz ikonę Więcej (…) w węźle i w menu wybierz polecenie Zmień nazwę. Możesz także zmienić nazwy węzłów w edytorze kodu.

Nie można zmienić nazw węzłów Wyzwalacz i Przejdź do kroku.

Długość nazwy węzła nie może przekraczać 500 znaków.

Klasyczny

1. Przejdź do strony Tematy swojego klasycznego czatbota i otwórz żądany temat.

2. Wybierz ikonę Dodaj węzeł poniżej węzła, po którym chcesz dodać węzeł zapytania. Wybierz Zadaj pytanie. Copilot Studio automatycznie tworzy zmienną do przechowywania odpowiedzi użytkownika.

   

Wybieranie encji do użycia

Aplikacja sieci web

Pytanie – te węzły są domyślnie tworzone z opcjami wielokrotnego wyboru. Aby użyć innej wbudowanej lub niestandardowej encji, wybierz pole Identyfikuj, a następnie wybierz typ informacji, który chcesz zidentyfikować.

Klasyczny

Pytanie – te węzły są domyślnie tworzone z opcjami wielokrotnego wyboru. Aby użyć innej wbudowanej lub niestandardowej encji, wybierz pole Identyfikuj, a następnie wybierz typ informacji, który chcesz zidentyfikować.

Zmienianie nazwy zmiennej

Aplikacja sieci web

Aby ułatwić utrzymanie agentów, zastąp domyślną nazwę każdej zmiennej nazwą opisową.

1. Wybierz zmienną. Zostanie wyświetlony panel Właściwości zmiennej.

2. W polu Nazwa zmiennej wprowadź żądaną nazwę dla zmiennej.

Klasyczny

Automatycznie utworzone zmienne mają nazwę domyślną. Aby zmienić nazwę zmiennej, wybierz jej nazwę, wprowadź żądaną nazwę w panelu Właściwości zmiennej i zapisz zmianę.

Ustaw zmienną

Zazwyczaj używa się węzła Pytanie, aby zapisać dane wejściowe użytkownika w zmiennej. Możesz jednak chcieć samodzielnie ustawić wartość zmiennej. W takim przypadku należy użyć węzła Ustaw wartość zmiennej.

1. Wybierz ikonę Dodaj węzeł poniżej węzła, po którym chcesz dodać węzeł Ustaw wartość zmiennej.

2. Wybierz Zarządzanie zmiennymi>Ustaw wartość zmiennej. W kanwie pojawi się węzeł ustaw wartość zmiennej.

3. Wybierz pole pod Ustaw zmienną. Zostanie wyświetlony panel Wybierz zmienną.

   • Jeśli zmienna, którą chcesz ustawić, już istnieje, wybierz ją.

   • W przeciwnym razie wybierz Utwórz nowy. Ta akcja tworzy nową zmienną. Jej typ jest nieznany, dopóki nie zostanie przypisana do niej wartość.

     

4. 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.

   • 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ż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 usługi Bot Framework, można go dodać do tego parametru. Dane wyjściowe z węzłów Akcja wygenerują nowe zmienne.

Więcej informacji pod adresem:

• Wywoływanie przepływu agenta z agenta
• Używanie przepływów agenta z agentem

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

W węzłach, w których można ustawić wartość parametrów wejściowych, zawsze można wprowadzić wartość literału zamiast wybierać inną zmienną jako wartość.

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 jednak chcesz, aby węzeł interpretował tę wartość jako ciąg, możesz umieścić tę wartość w podwójnych cudzysłowach, na przykład tak: "123".

W przypadku niektórych scenariuszy (na przykład scenariuszy używających typów złożonych) może być konieczne użycie formuły Power Fx do ustawienia określonego typu.

Uźywanie zmiennych środowiskowych dla wpisów tajnych Azure Key Vault

Zmienna środowiskowa może się odwoływać do wpisu tajnego w magazynie Key Vault. Tajne zmienne środowiskowe są szczególnym przypadkiem zmiennych środowiskowych z unikatowymi zagadnieniami.

Aby utworzyć wpis tajny zmiennej środowiskowej w portalu Power Apps, należy skonfigurować magazyn kluczy Key Vault.

Aby autoryzować Copilot Studio do odczytu tego magazynu Key Vault, wykonaj następujące czynności:

1. Przypisz rolę Użytkownika wpisów tajnych usługi Key Vault do aplikacji usługi Microsoft Copilot Studio.

2. Aby autoryzować wszystkich agentów ze środowiska do dostępu do wpisu tajnego, utwórz tag AllowedEnvironments dla wpisu tajnego i dodaj do niego dozwolone identyfikatory środowisk oddzielone przecinkami.

3. Aby autoryzować tylko określonych agentów ze środowiska do korzystania z tego magazynu, utwórz tag AllowedAgents i umieść identyfikator agenta w formacie {envId}/{schemaName}. W przypadku wielu wartości, rozdziel wartości przecinkami.

   Jeśli osiągniesz maksymalną liczbę znaków, ale nadal musisz dodać więcej agentów, dodaj kolejny tag o opisowej, ale unikalnej nazwie (na przykład: AllowedAgents2).

Wartość wpisu tajnego jest buforowana w czasie wykonywania dialogu przez pięć minut. Odczyty nieudane są przechowywane w pamięci podręcznej przez 30 sekund.

Ostrzeżenie

Dodanie wpisu tajnego w agencie może spowodować ujawnienie jego wartości. Każdy, kto może edytować agenta w środowisku, może dodać węzeł Komunikat i zwrócić wartość wpisów tajnych zmiennych środowiskowych w komunikacie.

Panel zmiennych

Aplikacja sieci web

Panel Zmienne to miejsce, w którym można wyświetlić wszystkie zmienne dostępne dla tematu, niezależnie od węzłów, w których są zdefiniowane lub używane.

Aby otworzyć panel Zmienne, kliknij Zmienne na pasku menu tematu.

Dla każdej zmiennej tematu 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. Możesz również wybrać zmienną, aby edytować jej właściwości w panelu Właściwości zmiennej.

Klasyczny

Panel Zmienne to miejsce, w którym można wyświetlić wszystkie zmienne dostępne dla tematu, niezależnie od węzłów, w których są zdefiniowane 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. Możesz również wybrać zmienną, aby edytować jej właściwości w panelu Właściwości zmiennej.

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.

   

Panel właściwości zmiennych

W panelu Właściwości zmiennej możesz zmienić nazwę zmiennej, sprawdzić, gdzie agent jej używa, lub przekonwertować ją na zmienną globalną. Nie można jednak przekonwertować zmiennej globalnej z powrotem na zmienną tematu. Można również wybrać, czy zmienna tematu może odbierać wartości z innych tematów lub przekazywać jej wartość do innych tematów.

Aby otworzyć panel Właściwości zmiennej, wybierz żądaną zmienną w panelu Zmienne. Panel Właściwości zmiennej można również otworzyć z dowolnego węzła, który używa zmiennych, wybierając żądaną zmienną.

Przekazywanie zmiennych między tematami

Przekierowując jeden temat do innego, można przekazać wartości zmiennych z tematu źródłowego do tematu docelowego, a także zwrócić wartości z tematu docelowego do tematu źródłowego. Przekazywanie zmiennych między tematami jest szczególnie przydatne, gdy we wcześniejszym temacie znajdują się już informacje, których potrzebuje późniejszy temat. Twoi użytkownicy z pewnością docenią, że nie muszą odpowiadać na te same pytania więcej niż raz.

Odbieraj wartości z innych tematów

Kiedy temat definiuje zmienną (na przykład przez węzeł pytania), agent zada użytkownikowi pytanie, aby wypełnić wartość zmiennej. Jeśli agent uzyskał już tę wartość we wcześniejszym temacie, 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 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 agentem.

Aplikacja sieci web

W tym przykładzie używamy dwóch tematów, Pozdrowienie 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 używa wartości zmiennej przekazanej z tematu Greeting .

Oto przepływ tematu Rozmowa z klientem:

Jak pokazano w panelu testowym, jeśli ten temat zostanie wyzwolony jako pierwszy, pyta użytkownika "Jak mam Cię nazywać?". Przechowuje wartość w zmiennej typu ciąg o nazwie customerName. Zmienna customerName ma też ustawioną wartość z innych tematów. Temat kończy się komunikatem: "Mam nadzieję, że masz wspaniały dzień, customerName!".

Oto przepływ tematu Powitanie:

Jak pokazano w panelu testowym, jeśli ten temat zostanie wyzwolony jako pierwszy, pyta użytkownika „Jak masz na imię?”. Przechowuje wartość w zmiennej ciągowej o nazwie customerName. W temacie jest wysyłany komunikat "Miło mi Cię poznać, customerName!" Następnie następuje przekierowanie do tematu Rozmowa z klientem , który wysyła komunikat "Mam nadzieję, że masz wspaniały dzień, customerName!". Należy jednak pamiętać, że w tematu Rozmowa z klientem pominięto ponowną prośbę o podanie nazwy użytkownika. Zamiast tego używa wartości zmiennej customerName przekazanej z tematu Pozdrowienie.

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

Przejdź przez kolejne kroki, aby skonfigurować temat do odbierania wartości z innych tematów. W naszym przykładowym scenariuszu wstępnie zdefiniowany temat Powitanie jest używany jako temat źródłowy, a jako tematu docelowego nowy temat Rozmowa z klientem, ale te same kroki działają w przypadku każdego tematu, który powinien używać wartości z wcześniejszego tematu, jeśli jest to możliwe.

Konfigurowanie tematu docelowego

Temat docelowy otrzymuje wartości z innych tematów. W tym przykładzie jest to Rozmowa z klientem.

1. Utwórz nowy temat i nazwij go "Rozmowa z klientem".

2. Dodaj frazy wyzwalające, takie jak "porozmawiaj ze mną", "pogadaj ze mną", "czatuj ze mną".

3. Dodaj węzeł Pytanie i wprowadź "Jak mam Cię nazywać?" dla wiadomości.

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

5. Wybierz nazwę zmiennej. Panel Właściwości zmiennych otworzy się.

6. Zastąp nazwę domyślną nazwą ciągiem customerName, a następnie wybierz pozycję Odbieraj wartości z innych tematów.

   

7. Dodaj węzeł Komunikat.

8. W polu wiadomości wpisz "Mam nadzieję, że masz wspaniały dzień".

9. Wybierz ikonę Wstaw zmienną ({x}), a następnie wybierz pozycję customerName.

10. Zaznacz spację po zmiennej i wpisz wykrzyknik (!).

11. Zapisz temat.

Konfigurowanie tematu źródłowego

Temat źródłowy to ten, który przekierowuje do innego tematu. Udostępnia wartość i przekazuje ją do tematu docelowego. W tym przykładzie jest to temat Powitanie.

1. Przejdź do tematu Powitanie i usuń węzły domyślne, z wyjątkiem węzła Wyzwalacz .

2. Dodaj węzeł Pytanie i wprowadź "Jak mam Cię nazywać?" dla wiadomości.

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

4. Zmień domyślną nazwę na customerNameFromGreeting.

5. Dodaj węzeł Komunikat.

6. W polu wiadomości wpisz "Miło Cię poznać, ".

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

8. Zaznacz spację po zmiennej i wpisz wykrzyknik (!).

9. Dodaj węzeł Przekieruj i wybierz temat docelowy Porozmawiaj z klientem.

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

    

11. Wybierz ikonę > , a następnie wybierz zmienną, której wartość chcesz przekazać, w tym przykładzie customerNameFromGreeting.

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

    

12. Zapisz temat.

Klasyczny

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.

   

   Notatka

   Między tematami nie można przekazywać zmiennych na podstawie encji typu Data i godzina, Czas trwania lub Wielokrotny wybór lub zmiennych opartych na encji niestandardowej.

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

Temat w agencie zbiera określone informacje. Wiele innych tematów może go wywołać i oczekiwać, że zwróci informacje w formie zmiennej. W tym przypadku zmienna staje się również częścią oryginalnego tematu i może być używana jak każda inna zmienna. Informacje uzyskiwane przez agent są dzięki temu dostępne w różnych tematach, co zmniejsza potrzebę użycia stosowania zmiennych globalnych.

Aplikacja sieci web

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

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

Gdy zwracasz zmienną do tematu, tematem źródłowym jest temat, który udostępnia wartość do przekazania z powrotem do oryginalnego tematu. W tym przykładzie tematem źródłowym jest Rozmowa z klientem.

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

2. Dodaj węzeł Pytanie i wprowadź "W jakim mieście mieszkasz?" dla wiadomości.

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

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

   

5. Dodaj węzeł Komunikat.

6. Wybierz ikonę Wstaw zmienną ({x}), a następnie wybierz pozycję customerCity.

7. Po zmiennej w polu wiadomości wpisz " musi być piękne o tej porze roku!".

8. Zapisz temat.

Konfigurowanie tematu docelowego na potrzeby zwróconej zmiennej

Gdy zwracasz zmienną do tematu, temat docelowy jest tematem, który otrzymuje wartości z bieżącego tematu. W następującym przykładzie tematem docelowym jest Powitanie.

1. Przejdź do tematu docelowego.

2. Zmienna wybrana w temacie źródłowym pojawi się w węźle Przekierowanie jako zmienna wyjściowa.

   

3. Zapisz temat.

Klasyczny

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

1. W węźle Pytanie wybierz zmienną, która ma zwracać wartości do 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.

   

   Notatka

   Między tematami nie można przekazywać zmiennych na podstawie encji typu Data i godzina, Czas trwania lub Wielokrotny wybór lub zmiennych opartych na encji niestandardowej.

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órą zwracasz do tematu, pojawia się w przekierowanym temacie. Użyj zwróconej zmiennej w swoim temacie.

   

Analizuj wartości

Węzeł Analizuj wartość konwertuje wartość z jednego typu na inny. Jednym z typowych zastosowań węzła Analizuj wartość jest konwersja surowego JSON. Na przykład agent wywołuje przepływ, który wywołuje API. Następnie interfejs API zwraca wynik. Potrzebujesz sposobu, aby przeanalizować ten wynik i zwrócić jedną lub kilka zmiennych pierwotnych. Za pomocą węzła Analizuj wartość można przesłać cały wynik interfejsu API w formie ciągu znaków, na przykład:

{
    "Name": "Parker",
    "Position": "Product manager",
    "Company": "Contoso",
    "FormerPositions": [{
            "Position": "Customer service representative"
        }
    ]
}

Węzeł Analizuj wartość konwertuje zmienną typu ciąg znaków na zmienną typu Record. Edytor Power Fx udostępnia uzupełnianie kodu i sugestie dotyczące tego typu funkcji IntelliSense.

Oprócz analizowania ciągów JSON, kluczowe użycie węzła Analizuj wartość polega na analizowaniu obiektów bez typu w czasie wykonania. Najczęstszym przypadkiem użycia jest odebranie zdarzenia i konieczność przeanalizowania wartości zdarzenia. Możesz też chcieć przeanalizować właściwość System.Activity.ChannelData, która zmienia się podczas działania w zależności od kanału.

Jeśli potrzebujesz przeanalizować informacje ze zdarzenia pochodzącego z Teams, zapoznaj się z dokumentacją deweloperską Teams, aby znaleźć przykład oczekiwanego zdarzenia. Następnie możesz postępować zgodnie z instrukcjami w tej sekcji, korzystając z przykładowego zdarzenia jako danych testowych.

Aby dodać węzeł Analizuj wartość do tematu:

1. Wybierz ikonę Dodaj węzeł poniżej węzła, po którym chcesz przeanalizować wartość. Wskaż na Zarządzanie zmiennymi, a następnie Analizuj wartość.

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

   

3. Wybierz Z przykładowych danych jako typ danych.

   

4. Wybierz Pobierz schemat z przykładowego JSON, wprowadź odpowiedni przykład JSON w edytorze, który się otworzy, a następnie wybierz Potwierdź.

   

5. Wybierz zmienną do przechowywania przeanalizowanej wartości. Zazwyczaj tworzy się nową zmienną.

   

   Zmienna wyjściowa ma teraz oczekiwany typ: record.

   

Powiązana zawartość

• Omówienie wariantów
• Praca z globalnymi zmiennymi
• Korzystanie z encji i wypełnianie miejsc na wartość w agentach usługi
• Dostosowywanie wyglądu i działania agenta