Tworzenie i edytowanie tematów

Note

Ten artykuł opisuje cechy stosowane w przepływach agentów lub przepływach agentów zasilanych standardową wiązką.

W programie Copilot Studio temat definiuje sposób postępu konwersacji agenta.

Aby tworzyć tematy, możesz opisać to, co chcesz i poprosić AI o utworzenie tematu lub tworzyć tematy od podstaw.

Dowiedz się więcej w Przydziały i limity.

Wybieranie odpowiedniego tematu, aby odpowiedzieć użytkownikowi

Aby określić, jak odpowiadać użytkownikom, agenci zasilani przez standard harness używają albo orkiestracji generatywnej, albo klasycznej orkiestracji.

Dzięki generatywnej orkiestracji agent odpowiada na zapytania użytkownika lub reaguje na zdarzenia wyzwalające poprzez wybór najbardziej odpowiedniej kombinacji tematów, narzędzi i wiedzy. Każdy temat zawiera opis, który informuje agenta o swoim celu. Dowiedz się więcej o tworzeniu opisów.

W agentach skonfigurowanych do korzystania z klasycznej orkiestracji każdy temat ma zestaw fraz wyzwalających — fraz, słów kluczowych i pytań, których klient prawdopodobnie użyje w przypadku zapytań związanych z określonym problemem. Ci agenci używają rozpoznawania języka naturalnego, wiadomości klienta i fraz wyzwalających temat, aby znaleźć najlepszy temat. Dane wejściowe klienta nie muszą dokładnie odpowiadać frazie wyzwalającej temat, aby temat został zainicjowany. Na przykład temat dotyczący godzin otwarcia sklepu może mieć frazę wyzwalającą „sprawdź godziny otwarcia”. Jeśli klient wpisze „zobacz godziny otwarcia sklepu”, fraza ta uruchomi temat dotyczący godzin otwarcia sklepu. Dowiedz się więcej w Projektuj skuteczne zwroty wyzwalające.

Tematy w programie Copilot Studio

W programie Copilot Studio temat reprezentuje część konwersacji między użytkownikiem a agentem. Definiujesz tematy na obszarze roboczym tworzenia. Temat zawiera jeden lub więcej węzłów, które razem określają ścieżki konwersacyjne, którymi może podążać temat. Każdy węzeł wykonuje akcję, np. wysyłanie wiadomości lub zadawanie pytań.

Agent ma dwa typy tematów: systemowe i niestandardowe tematy. Każdy nowy agent zaczyna od zestawu predefiniowanych tematów systemowych i niestandardowych.

  • Tematy systemowe wspierają podstawowe zachowania, takie jak prośba o rozmowę z osobą lub zakończenie rozmowy.

    • Nie możesz tworzyć tematów systemowych.
    • Nie można usuwać tematów systemowych, ale możesz je wyłączać.
    • Możesz wprowadzać zmiany w tematach systemowych. Zaczekaj jednak, dopóki nie będziesz czuć się komfortowo, tworząc pełne doświadczenia z agentem, zanim rozpoczniesz edytowanie tematów systemowych.

    Dowiedz się więcej w temacie Korzystanie z tematów systemowych.

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

    • Możesz wprowadzać zmiany we wstępnie zdefiniowanych tematach niestandardowych lub całkowicie usuwać je z agenta.
    • Wszystkie tworzone tematy będą tematami niestandardowymi.

Typy węzłów

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

Typ węzła Description
węzeł Message Wysłanie wiadomości do klienta.
węzeł „Pytanie” Zadaj klientowi pytanie.
Węzeł Adaptive Card Pokaż kartę interaktywną z co najmniej jednym przyciskiem odpowiedzi lub polami wejściowymi.
węzeł Condition Rozgałęź swoją rozmowę w oparciu o warunek.
Węzły zarządzania zmiennymi Ustaw wartość, analizuj wartość lub wyczyść zmienne (w tym możliwość wyczyszczenia historii konwersacji używanej przez agenta).
Zarządzanie tematami Przekieruj konwersację, przenieś użytkownika lub zakończ temat lub konwersację.
Węzły typu Narzędzie Wywołaj przepływ, taki jak Power Automate lub Excel Online, albo użyj łącznika lub innego typu narzędzia.
Zaawansowany Wysyłaj generatywne odpowiedzi, żądania HTTP, zdarzenia i nie tylko.

Wskazówka

Zmień nazwy węzłów, aby ułatwić ich identyfikację. Wybierz pole nazwy węzła, aby bezpośrednio zaktualizować nazwę, lub zaznacz trzy kropki (...) węzła i wybierz Zmienij nazwę z menu. Możesz także zmienić nazwy węzłów w edytorze kodu.

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

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

Tworzenie tematu

  1. Przejdź do strony Tematy swojego agenta. Aby uzyskać lepszą widoczność, zamknij panel testowy.

  2. Wybierz Dodaj temat, a następnie wybierz Od podstaw. Na pozornie pustym obszarze tworzenia tematów pojawi się węzeł Wyzwalacz.

  3. Wybierz trzy kropki (...) węzła Wyzwalacz , a następnie wybierz pozycję Właściwości. Pojawi się panel Właściwości rozpoznanych intencji.

  4. W właściwościach On Recognized Intentskonfiguruj wyzwalacz dla swojego tematu.

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

  6. Dodaj szczegóły dotyczące tematu:

    • Wprowadź nazwę, aby zidentyfikować temat, na przykład "Godziny sklepu". Strona Tematy zawiera listę wszystkich tematów zdefiniowanych w agencie według tej nazwy.
    • W razie potrzeby wprowadź nazwę wyświetlaną, która będzie wyświetlana klientowi, gdy agent nie będzie mógł określić, który temat pasuje do wiadomości klienta.
    • Jeśli chcesz, użyj pola Opis, aby opisać cel tematu dla siebie i innych twórców agentów w swoim zespole. Klienci nigdy nie widzą opisów tematów.
  7. Wybierz Zapisz w pasku górnego menu w celu zapisania tematu.

Important

Należy unikać kropek (.) w nazwach tematów. Nie można wyeksportować rozwiązania zawierającego agenta z kropkami w nazwach dowolnego z jego tematów.

Edytowanie 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ł pod węzłem, po którym chcesz dodać nowy węzeł.

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

Usuń węzeł

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

Kontrolki edytowania węzłów na kanwie

Użyj kontrolek na pasku narzędzi, aby wycinać, kopiować, wklejać i usuwać wybrany węzeł lub wybrane sąsiadujące węzły.

Pasek narzędzi ma również kontrolkę cofania edycji. Wybierz ikonę Cofnij i wybierz:

  • Cofnij, aby cofnąć najnowszą zmianę
  • Cofnij do ostatniego zapisu , aby cofnąć wszystkie akcje do ostatniego zapisu
  • Powtórz, aby powtórzyć poprzednią akcję

Wklej węzły

Gdy użyjesz narzędzi Wytnij lub Kopiuj, aby umieścić jeden lub więcej węzłów w schowku, możesz wkleić je na płótnie na dwa sposoby:

  • Jeśli wybierzesz węzeł, a następnie wybierzesz Wklej, wstawisz węzły ze schowka po wybranym węźle.

  • Jeśli wybierzesz "+", aby zobaczyć menu Dodaj węzeł , a następnie wybierzesz Wklej, wstawisz węzeł ze schowka 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.

Jeśli Twój agent korzysta z generatywnej orkiestracji, może automatycznie wypełniać dane tematyczne z kontekstu rozmowy lub po generowaniu pytań, aby zebrać wartości od użytkowników. To zachowanie jest podobne do tego, jak generatywne wypełnianie szczelin działa dla narzędzi. Dowiedz się więcej w temacie Manage topic inputs and outputs (Zarządzanie danymi wejściowymi i wyjściowymi tematu).

Edytuj tematy za pomocą edytora kodu

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

Important

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 pozycję Dodaj temat>Z pustego.

  2. W prawym górnym rogu płótna autorskiego wybierz Więcej, a następnie otwórz edytor kodu.

    Zrzut ekranu pokazujący, jak otworzyć edytor kodu dla danego 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. Zwróć uwagę na logikę warunkową, która jest zgodna z niektórymi węzłami pytania .

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

Testowanie i publikowanie

Testuj swojego agenta , gdy wprowadzasz zmiany w tematach, aby upewnić się, że wszystko działa zgodnie z oczekiwaniami.

Gdy będziesz zadowolony, opublikuj agenta w docelowych kanałach.