Udostępnij za pośrednictwem


Tworzenie i edytowanie tematów

W usłudze Copilot Studio temat definiuje przebieg konwersacji z pomocnikiem.

Aby utworzyć tematy dla autora, można dostosować dostępne szablony, utworzyć tematy od podstaw lub opisać własne tematy, a także utworzyć interfejs AI dla Ciebie.

W Copilot Studio, temat pomocnika to część wątku konwersacyjnego pomiędzy użytkownikiem a pomocnikiem. Tematy można definiować i pracować z nimi na kanwie tworzenia. Temat zawiera co najmniej jeden węzeł rozmowy, które razem definiują ścieżki konwersacji do uwzględnienia w temacie. Każdy węzeł wykonuje akcję, np. wysyłanie wiadomości lub zadawanie pytań.

Często temat zawiera zestaw fraz wyzwalających — wyrażeń, słów kluczowych i pytań, których prawdopodobnie użyje klient, a które są związane z konkretnym problemem. Pomocnicy Copilot Studio używają funkcji rozumienia języka naturalnego, wiadomości klienta i fraz wyzwalających dla wszystkich tematów, aby znaleźć najlepszy temat do wyzwolenia. Wiadomość nie musi dokładnie pasować do fraz wyzwalających tematu, aby wywołać temat. Na przykład wyrażenie temat godzin przechowywania może zawierać frazę uruchamianą check store hours. Jeśli klient wyśle wiadomość „zobacz godziny otwarcia sklepu”, powoduje to wyzwolenie tematu dotyczącego godzin pracy sklepu.

Wymagania wstępne

Interpretacja języka naturalnego

Pomocnik używa rozumienia języka naturalnego (NLU) do analizy tekstu wpisanego przez klienta i znalezienia najlepszego węzła lub frazy wyzwalającej.

Na przykład użytkownik może wpisać „Godziny otwarcia”. Pomocnik dopasowuje to do tematu Godziny otwarcia, rozpoczyna konserwację z pytaniem, którym sklepem klient jest zainteresowany, a następnie wyświetla godziny, w których sklep jest otwarty.

Panel Testuj pomocnika pokazuje przebieg rozmowy pomocnika na każdym kroku. Możesz użyć panelu Test pomocnika , aby dostroić temat bez konieczności opuszczania Copilot Studio portalu.

Aby znaleźć informacje o pomocniku i ograniczeniach tematów, zobacz temat Wartości normy, ograniczenia, rejestracji aplikacji, certyfikatów i wartości konfiguracji.

Tematy w Copilot Studio

Typy tematu

Pomocnik może też zawierać dwa typy tematów, systemowy i niestandardowy. Każdy nowy pomocnik zaczyna się od zestawu wstępnie zdefiniowanych tematów systemowych i niestandardowych.

  • Tematy systemowe obsługują podstawowe zachowania, takie jak niestandardowa prośba o rozmowę z daną osobą lub zakończenie rozmowy. Niektóre tematy systemowe zawierają frazy wyzwalające, które można dostosować do potrzeb pomocnika.

    • Nie możesz tworzyć tematów systemowych.
    • Nie możesz usuwać tematów systemowych, ale możesz je wyłączać.
    • Możesz wprowadzać zmiany tematów systemowych. Jednak do momentu, gdy użytkownik będzie umiał tworzyć pełne środowisko pomocnika, nie zaleca się edytowania tematów systemowych.

    Więcej informacji można znaleźć w temacie Używanie tematów systemowych.

  • Wstępnie zdefiniowane niestandardowe tematy obejmują typowe zachowania, takie jak powitanie klienta, zakończenie rozmowy lub ponowne uruchomienie rozmowy.

    • Można wprowadzać zmiany do wstępnie zdefiniowanych tematów niestandardowych lub całkowicie usuwać je z pomocnika.
    • Wszystkie tworzone tematy będą tematami niestandardowymi.

Typy węzłów

Dostępne są następujące węzłów:

Opcja Podpis
Wysyłanie wiadomości Wysłanie wiadomości do klienta.
Zadaj pytanie Zadaj klientowi pytanie.
Zapytaj za pomocą karty adaptacyjnej Utwórz fragment kodu JSON, aby wymieniać się nim z innymi aplikacjami.
Autor korzystający z warunków Rozgałęź swoją rozmowę w oparciu o warunek.
Zarządzanie zmiennymi Ustaw wartość, analizuj wartość lub wyczyść wszystkie zmienne.
Zarządzanie tematami Przekierowywanie, przesyłanie lub koniec tematu lub rozmowy.
Wywołaj przepływ Wywołaj przepływ, taki jak Power Automate lub Excel Online, albo użyć łącznika albo dodatku plug-in.
Zaawansowani Generujące odpowiedzi, żądania HTTP, zdarzenia i nie tylko.

Porada

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.

Tworzenie tematu

  1. Otwórz pomocnika z listy na stronie Pomocnicy. Aby poprawić widoczność, należy na razie zamknąć panel Testuj pomocnika.

  2. Na górnym pasku menu wybierz Tematy.

  3. Wybierz opcję Dodaj temat i wybierz opcję Z pustego.

    Węzeł Wyzwalacz jest wyświetlany na pustym temat tworzenia.

  4. Wybierz ikonę menu Więcej () węzła Wyzwalacz, a następnie wybierz opcję Właściwości. Zostanie wyświetlony panel właściwości Po rozpoznaniu intencji.

  5. W panelu Po rozpoznaniu intencji — właściwości wybierz obszar Frazy. Zostanie wyświetlony dodatkowy panel Frazy.

  6. W obszarze Dodaj frazy wprowadź frazę wyzwalającą temat.

    Twój pomocnik potrzebuje od 5 do 10 fraz wyzwalających, aby przeszkolić sztuczną inteligencję w zakresie rozumienia reakcji klientów. Aby dodać więcej fraz wyzwalających, można wykonać następujące czynności"

    • Wybierz ikonę Dodaj obok pola tekstowego i wprowadź żądaną frazę.
    • Wklej zestaw fraz wyzwalających, każda z nich w osobnym wierszu, i naciśnij klawisz Enter.
    • Wpisz zestaw fraz wyzwalających, naciskając klawisz Shift+Enter po każdej z nich, aby umieścić ją w oddzielnym wierszu, a następnie wybierz klawisz Enter.

    Do frazy wyzwalającej można dodać znaki interpunkcyjne, ale najlepiej jest używać krótkich fraz, a nie długich zdań.

  7. Wybierz opcję Szczegóły na pasku narzędzi, aby otworzyć panel szczegółów tematu.

  8. Dodaj szczegóły pomocnika temat:

    • Wprowadź nazwę identyfikującą temat np. „Godziny sklepu”. Na stronie Tematy są wymienione wszystkie tematy zdefiniowane w pliku pomocnika przy użyciu tej nazwy.
    • W razie potrzeby wprowadź nazwę wyświetlaną, którą pomocnik pokaże klientowi, gdy nie będzie można określić, który temat odpowiada wiadomości klienta.
    • W razie potrzeby użyj pola Opis do opisania celu użycia tematu dla Ciebie innych twórców pomocników w zespole. Klienci nigdy nie widzą opisów tematów.
  9. Wybierz Zapisz w pasku górnego menu w celu zapisania tematu.

Ważne

Należy unikać okresów (.) w temat nazwy. Nie można wyeksportować rozwiązania zawierającego pomocnika z okresami w nazwie każdego z jego tematów.

Projektowanie ścieżki konwersacji tematu

Podczas tworzenia tematu węzeł Wyzwalacz jest automatycznie dodawany na kanwie tworzenia. Następnie można dodawać różne typy węzłów, aby uzyskać żądaną ścieżkę konwersacji do tematu.

Aby dodać węzeł po innym węźle lub między dwoma węzłami na kanwie tworzenia tematu:

  1. Wybierz ikonę Dodaj węzeł poniżej węzła, pod którym chcesz dodać nowy węzeł.

  2. Z wyświetlonej listy wybierz typ węzła.

    Zrzut ekranu przedstawiający opcje dostępne do wyboru w celu wstawienia węzła po węźle Wyzwalacz.

Usuń węzeł

Wybierz ikonę Więcej (...) węzła, który chcesz usunąć, a następnie wybierz Usuń.

Kontrolki edytowania węzłów na kanwie

Za pomocą kontrolek na pasku narzędzi można wycinać, kopiować, wklejać i wybrany węzeł lub wybrane sąsiadujące węzły.

Zrzut ekranu formantów paska narzędzi na temat edytowania węzłów na kanwie tworzenia.

Na pasku narzędzi znajduje się również element umożliwiający cofnięcie edycji. Otwórz menu Cofnij, aby przywrócić wszystkie akcje z powrotem do stanu z ostatniego zapisu lub aby ponownie wykonać poprzednią akcję.

Zrzut ekranu menu cofania.

Wklejanie węzłów

Gdy użyjesz narzędzi Wytnij lub Kopiuj w celu umieszczenia jednego lub większej liczby węzłów w schowku, istnieją dwa sposoby aby wkleić je na płótnie:

  • Jeśli wybierzesz węzeł i opcję Wklej, węzły w schowku zostaną wstawione po wybranym węźle.

  • Jeśli wybierzesz „+”, aby wyświetlić menu Dodaj węzeł , a następnie wybierz Wklej, węzeł ze schowka zostanie wstawiony w tym miejscu.

Dodaj parametry wejściowe i wyjściowe dla tematu

Tematy mogą mieć parametry wejściowe i wyjściowe. Jeśli temat jest przekierowany do innego tematu, można użyć tych parametrów do przekazania informacji między tematami.

Dodatkowo, jeśli pomocnik używa trybu generowania, może automatycznie uzupełnić temat z kontekstu rozmowy lub po wygenerowaniu pytań w celu zebrania wartości od użytkowników. Takie zachowanie jest podobne do działania wypełniania rowka generatywowego dla akcji.

Aby dowiedzieć się więcej o parametrach wejściowych i wyjściowych tematów, zobacz Zarządzanie tematami danych wejściowych i wyjściowych.

Edytowanie tematów za pomocą edytora kodu

Edytor kodu pokazuje temat w YAML,, języku znaczników, który jest łatwy do odczytania i zrozumienia. Użyj edytora kodu, aby kopiować i wklejać tematy z innych botów, nawet tych stworzonych przez innych autorów.

Ważne

Projektowanie tematu w całości w edytorze kodu i wklejanie złożonych tematów nie jest w pełni obsługiwane.

W tym przykładzie kopiujesz i wklejasz YAML do edytora kodu, aby szybko dodać temat, który prosi klienta o podanie informacji o wysyłce.

  1. Na stronie Tematy wybierz opcję + Utwórz>Z pustej.

  2. W prawym górnym rogu kanwy tworzenia wybierz Więcej, a następnie wybierz Otwórz edytor kodu.

    Zrzut ekranu przedstawiający sposób otwierania edytora kodu dla tematu.

  3. Wybierz i usuń zawartość edytora kodu. Następnie skopiuj i wklej następujący kod YAML:

    kind: AdaptiveDialog
    beginDialog:
      kind: OnRecognizedIntent
      id: main
      intent:
        displayName: Lesson 3 - A topic with a condition, variables and a prebuilt entity
        triggerQueries:
          - Buy items
          - Buy online
          - Buy product
          - Purchase item
          - Order product
    
      actions:
        - kind: SendMessage
          id: Sjghab
          message: I am happy to help you place your order.
    
        - kind: Question
          id: eRH3BJ
          alwaysPrompt: false
          variable: init:Topic.State
          prompt: To what state will you be shipping?
          entity: StatePrebuiltEntity
    
        - kind: ConditionGroup
          id: sEzulE
          conditions:
            - id: pbR5LO
              condition: =Topic.State = "California" || Topic.State = "Washington" || Topic.State     = "Oregon"
    
          elseActions:
            - kind: SendMessage
              id: X7BFUC
              message: There will be an additional shipping charge of $27.50.
    
            - kind: Question
              id: 6lyBi8
              alwaysPrompt: false
              variable: init:Topic.ShippingRateAccepted
              prompt: Is that acceptable?
              entity: BooleanPrebuiltEntity
    
            - kind: ConditionGroup
              id: 9BR57P
              conditions:
                - id: BW47C4
                  condition: =Topic.ShippingRateAccepted = true
    
              elseActions:
                - kind: SendMessage
                  id: LMwySU
                  message: Thank you and please come again.
    
  4. Wybierz kolejno pozycje Zapisz i Zamknij edytor kodu. Węzeł Pytanie ma teraz wiele warunków na pytanie dotyczące wysyłki.

    Zrzut ekranu rozmowy utworzonej w programie YAML w edytorze kodu Copilot Studio.

Testowanie i publikowanie pomocnika

Przetestuj pomocnika po wprowadzeniu zmian w tematach, aby upewnić się, że wszystko działa zgodnie z oczekiwaniami.

Po zaprojektowaniu i przetestowaniu pomocnika opublikuj go w internecie, aplikacjach mobilnych lub natywnych albo Microsoft Bot Framework kanałach.