Udostępnij za pośrednictwem


Tworzenie i edytowanie tematów

W Copilot Studio temat określa, jak przebiega rozmowa agent.

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.

In Copilot Studio, a temat reprezentuje pewną część wątku konwersacyjnego między użytkownikiem a agent. 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. Copilot Studio Agenci używają 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

Agent używa rozumienie języka naturalnego (NLU) do przeanalizowania tego, co wpisał klient, i znalezienia najlepszego fraza wyzwalająca lub węzła.

Na przykład użytkownik może wpisać "Godziny otwarcia". agent dopasowuje to do godzin pracy sklepu temat, rozpoczyna konwersację, która, którym sklepem jest zainteresowany klient, a następnie wyświetla godziny, w których sklep jest otwarty.

Okienko Test agent pokazuje, jak konwersacja agent przebiega na każdym krok. Możesz użyć okienka Test agent , aby dostosować temat bez konieczności zamykania portalu Copilot Studio .

Aby uzyskać limity agent i temat, zobacz Limity przydziału, limity, rejestracja aplikacji, certyfikaty i wartości konfiguracji.

Tematy w Copilot Studio

Typy tematu

Agent może zawierać dwa rodzaje tematów, tematy systemowe i niestandardowe . Każdy nowy agent zaczyna się od zestawu predefiniowanych 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 mają frazy wyzwalające, które możesz dostosować do potrzeb swojego agent.

    • 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 dopóki nie poczujesz się komfortowo tworząc kompletne środowiska agent, nie zalecamy 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żesz wprowadzić zmiany w predefiniowanych tematach niestandardowych lub całkowicie usunąć je ze swojego agent.
    • 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 swój agent z listy na stronie agentów . Aby uzyskać lepszą widoczność, zamknij na razie panel Przetestuj agent .

  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 agent potrzebuje od 5 do 10 fraz wyzwalających, aby wytrenować sztuczną inteligencję w celu zrozumienia odpowiedzi 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 swoje dane agent temat:

    • Wpisz nazwę identyfikującą temat, na przykład "Godziny otwarcia sklepu". Na stronie Tematy znajduje się lista wszystkich tematów zdefiniowanych w pliku agent pod tą nazwą.
    • W razie potrzeby wprowadź wyświetlana nazwa, który będzie wyświetlany klientowi, gdy agent nie może określić, który temat pasuje do wiadomości klienta.
    • W razie potrzeby użyj pola Opis , aby opisać cel temat dla siebie i innych twórców agent w swoim 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, które zawiera znak agent z kropkami w nazwie któregokolwiek 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 Twój agent korzysta z trybu generatywnego, może automatycznie wypełniać temat dane wejściowe z kontekstu konwersacji lub po wygenerowaniu pytań, aby zebrać 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.

Przetestuj i opublikuj swój agent

Przetestuj swój agent , gdy wprowadzasz zmiany w swoich tematach, aby upewnić się, że wszystko działa zgodnie z oczekiwaniami.

Po zaprojektowaniu i przetestowaniu agent opublikuj go w Internecie, aplikacjach mobilnych lub natywnych lub kanałach Microsoft Bot Framework .