Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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
Przejdź do strony Tematy swojego agenta. Aby uzyskać lepszą widoczność, zamknij panel testowy.
Wybierz Dodaj temat, a następnie wybierz Od podstaw. Na pozornie pustym obszarze tworzenia tematów pojawi się węzeł Wyzwalacz.
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.
W właściwościach On Recognized Intentskonfiguruj wyzwalacz dla swojego tematu.
Wybierz opcję Szczegóły na pasku narzędzi, aby otworzyć panel szczegółów tematu.
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.
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:
Wybierz ikonę Dodaj węzeł
pod węzłem, po którym chcesz dodać nowy węzeł.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.
Na stronie Tematy wybierz pozycję Dodaj temat>Z pustego.
W prawym górnym rogu płótna autorskiego wybierz Więcej, a następnie otwórz edytor kodu.
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.Wybierz kolejno pozycje Zapisz i Zamknij edytor kodu. Zwróć uwagę na logikę warunkową, która jest zgodna z niektórymi węzłami pytania .
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.