Zapytaj z kartami adaptacyjnymi

Karty adaptacyjne umożliwiają dodawanie fragmentów zawartości do agentów Copilot Studio, które można również otwarcie wymieniać z innymi aplikacjami i usługami w chmurze. Aby zapewnić agentowi rozbudowane możliwości konwersacji, można dołączyć tekst, grafikę i przyciski. Ponieważ karty adaptacyjne nie są powiązane z platformą, można je łatwo dostosować do swoich potrzeb.

Za pomocą węzła Karty adaptacyjne agent może wyświetlić kartę adaptacyjną zawierającą co najmniej jeden przycisk przesyłania oraz opcjonalnie co najmniej jedno pole wejściowe formularza. Agent przechowuje dane wejściowe użytkownika w zmiennych do użycia w dalszej części konwersacji.

Copilot Studio zawiera wbudowanego projektanta kart adaptacyjnych, który oferuje najbardziej przydatne funkcje Projektanta kart adaptacyjnych.

Alternatywnie możesz:

• Użyj reprezentacji JSON dla karty, którą chcesz pokazać użytkownikowi.
• Użyj formuły Power Fx, aby uwzględnić informacje dynamiczne na karcie.

Możesz również kontrolować zachowanie karty, np. co zrobić, gdy użytkownik wprowadzi nieprawidłową odpowiedź lub czy węzeł może zostać przerwany.

Węzeł Karta adaptacyjna jest przeznaczony dla kart interaktywnych, na które użytkownik ma przesłać odpowiedź. Komunikat i Pytanie — te węzły mogą służyć do prezentowania użytkownikowi nieinteraktywnych kart i wyświetlania informacji użytkownikom.

Dodawanie węzła karty adaptacyjnej

1. Wybierz ikonę Dodaj węzeł poniżej węzła, po którym chcesz dodać węzeł Karta adaptacyjna, a następnie wybierz Zapytaj za pomocą karty adaptacyjnej.

2. Wybierz trzy kropki (...) węzła, a następnie wybierz Właściwości.

3. W panelu właściwości węzła Karta adaptacyjna wybierz opcję Edytuj kartę adaptacyjną. Otworzy się panel Projektant kart adaptacyjnych.

4. Dodaj żądane elementy do swojej karty i skonfiguruj ich właściwości. Alternatywnie w okienku Edytor ładunku karty zastąp domyślny ładunek literałem JSON dla karty.

   Napiwek

   Karta musi zawierać co najmniej jeden przycisk przesyłania, ponieważ musi to być karta interaktywna, która umożliwia użytkownikowi przesyłanie informacji powrotnych do agenta. Jeśli nie i ma to na celu wyłącznie wyświetlenie informacji, należy dodać kartę adaptacyjną do węzła wiadomości..

5. Po zakończeniu wstępnego projektowania wybierz pozycję Zapisz i zamknij panel projektanta. W węźle zostanie wyświetlony podgląd karty. Copilot Studio automatycznie tworzy zmienne wyjściowe na podstawie danych wejściowych określonych w kodzie.

   

   Napiwek

   Jeśli zmienne wyjściowe wygenerowane dla karty są niepoprawne, można ręcznie zaktualizować listę zmiennych i ich typy, wybierając pozycję Edytuj schemat w panelu właściwości węzła karty adaptacyjnej.

   Interakcyjna karta adaptacyjna jest już gotowa. Gdy użytkownik agenta wybierze na karcie przycisk Prześlij, zmienne wyjściowe są wypełniane informacjami podanymi przez użytkownika podczas interakcji z kartą.

Inne właściwości

Inne właściwości umożliwiają sterowanie zachowaniem węzła Karta adaptacyjna, na przykład:

• Jak agent reaguje na nieprawidłową odpowiedź
• Czy może być przerwane

Jeśli agent oczekuje na przesłanie z karty adaptacyjnej, a użytkownik zamiast tego wyśle wiadomość tekstową, ta odpowiedź zostanie uznana za nieprawidłową, chyba że wiadomość spowoduje przerwanie. W tym przypadku następujące właściwości określają zachowanie.

• Liczba ponownych monitów: liczba prób uzyskania przez agenta prawidłowego zgłoszenia z karty. Powtórz maksymalnie 2 razy to wartość domyślna. Możesz również wybrać opcję Powtórz raz lub Nie powtarzaj. Przy każdej ponowionej próbie karta jest ponownie przesyłana do użytkownika.

• Monit o ponowną próbę: użyj tej właściwości, aby zdefiniować komunikat, który ma zostać wysłany w przypadku ponownej próby, wraz z powtórzeniem karty. Aby zdefiniować wiadomość, wybierz opcję Dostosuj, a następnie wprowadź nowy monit.

• Zezwalaj na przełączanie do innego tematu: jeśli ta opcja jest zaznaczona (domyślnie), wiadomość przychodząca od użytkownika, gdy agent oczekuje na przesłanie karty, powoduje przerwanie i przejście do innego tematu. Jeśli nastąpi zmiana tematu, karta zostanie ponownie wysłana do użytkownika po zakończeniu przerywającego tematu.

Zachowanie przycisku „Wyślij” dla agentów z następującymi po sobie kartami

Zgodnie z projektem karty adaptacyjne umożliwiają wielokrotne wybieranie przycisków przesyłania. Jeśli agent ma kolejne karty adaptacyjne, a użytkownik wybierze przycisk na wcześniejszej karcie, użytkownik może napotkać nieoczekiwane zachowanie.

Aby uniemożliwić, że przesłanie akcji na jednej karcie zakłóci działanie innej karty:

• Izoluj akcje przesyłania: upewnij się, że każda karta adaptacyjna ma własny jednoznaczny identyfikator i procedury obsługi akcji.

• Użyj akcji przesyłania z unikatowymi danymi: podczas definiowania akcji przesyłania dla kart dołącz unikatowe identyfikatory lub ładunki danych, które mogą pomóc w rozróżnieniu kart, gdy użytkownik wybierze przycisk przesyłania.

• Dodaj niezawodną logikę obsługi zdarzeń do agenta: zdefiniuj warunki na podstawie charakterystycznych identyfikatorów lub elementów ładunku skojarzonych z przyciskami wysyłania.

• Debugowanie i rejestrowanie: dodaj szczegółowe rejestrowanie do kodu obsługi zdarzeń przez agenta, aby przechwycić sekwencję akcji i zidentyfikować, gdzie występują niezamierzone przesłania.

Używanie formuł Power Fx do tworzenia karty dynamicznej

Możesz użyć formuły Power Fx, aby uwzględnić dynamiczne informacje na karcie, odwołując się do zmiennych z tematu lub agenta.

1. Wybierz trzy kropki (...) węzła, a następnie wybierz Właściwości.

2. W panelu Właściwości węzła karty adaptacyjnej przejdź do Formuła. Wybranie opcji Formuła automatycznie konwertuje reprezentację JSON karty na formułę Power Fx.

   

   Na przykład zacznij od następującego literału JSON dla karty:

   {
     "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
     "type": "AdaptiveCard",
     "version": "1.5",
     "body": [{
         "type": "ColumnSet",
         "columns": [{
             "type": "Column",
             "width": 2,
             "items": [{
                 "type": "TextBlock",
                 "text": "Tell us about yourself",
                 "weight": "Bolder",
                 "size": "Medium",
                 "wrap": true,
                 "style": "heading"
               }, {
                 "type": "TextBlock",
                 "text": "We just need a few more details to get you booked for the trip of a lifetime!",
                 "isSubtle": true,
                 "wrap": true
               }, {
                 "type": "Input.Text",
                 "id": "myName",
                 "label": "Your name (Last, First)",
                 "isRequired": true,
                 "regex": "^[A-Z][a-z]+, [A-Z][a-z]+$",
                 "errorMessage": "Please enter your name in the specified format"
               }
             ]
           }
         ]
       }
     ],
     "actions": [{
         "type": "Action.Submit",
         "title": "Submit"
       }
     ]
   }
   

   Oto wynikowa formuła Power Fx, wykorzystująca dwie zmienne Topic.Title i Topic.Subtitle zamiast tekstu zakodowanego na stałe w literałach JSON. (W tym przykładzie założono, że zmienne są zdefiniowane w temacie).

   {
     '$schema': "http://adaptivecards.io/schemas/adaptive-card.json",
     type: "AdaptiveCard",
     version: "1.5",
     body: [
       {
         type: "ColumnSet",
         columns: [
           {
             type: "Column",
             width: "2",
             items: [
               {
                 type: "TextBlock",
                 text: Topic.Title,
                 weight: "Bolder",
                 size: "Medium",
                 wrap: true,
                 style: "heading"
               },
               {
                 type: "TextBlock",
                 text: Topic.Subtitle,
                 isSubtle: true,
                 wrap: true
               },
               {
                 type: "Input.Text",
                 id: "myName",
                 label: "Your name (Last, First)",
                 isRequired: true,
                 regex: "^[A-Z][a-z]+, [A-Z][a-z]+$",
                 errorMessage: "Please enter your name in the specified format"
               }
             ]
           }
         ]
       }
     ],
     actions: [
       {
         type: "Action.Submit",
         title: "Submit"
       }
     ]
   }