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
W tym artykule opisano funkcje używane w agentach lub przepływach agentów obsługiwanych przez standardowe środowisko uruchomieniowe.
Użyj karty adaptacyjnej, aby zbierać informacje od użytkownika podczas konwersacji agenta. Karta może zawierać tekst, grafikę, przyciski i pola wejściowe. Dowiedz się więcej w temacie Korzystanie z kart adaptacyjnych w programie Copilot Studio.
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.
Note
program Copilot Studio obsługuje schemat Adaptive Cards w wersji 1.6 i starszych. Jednak odpowiednia wersja schematu zależy od docelowej aplikacji hosta:
- Składnik czatu internetowego Bot Framework (tj. domyślny wzorzec integracji witryny internetowej) obsługuje wersję 1.6, ale nie obsługuje akcji
Action.Execute - Widżet czatu na żywo (używany dla omnichannel dla obsługi klienta) jest ograniczony do wersji 1.5
- Aplikacja Teams jest również ograniczona do wersji 1.5
Ponadto program Copilot Studio renderuje tylko karty w wersji 1.6 na czacie testowym, a nie na kanwie.
Dowiedz się więcej w usłudze AdaptiveCard.
Program Copilot Studio oferuje wbudowany projektant 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ź. Użyj węzłów Message i Question , aby przedstawić użytkownikowi nieinteraktywną kartę wyświetlającą informacje.
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ć nazw węzłów Wyzwalacz i Przejdź do kroku.
Długość nazwy węzła nie może przekraczać 500 znaków.
Dodawanie węzła karty adaptacyjnej
Wybierz ikonę Dodaj węzeł
poniżej węzła, po którym chcesz dodać nowy węzeł, aby dodać węzeł Karta adaptacyjna. Następnie wybierz Ask with Adaptive Card.Wybierz trzy kropki (...) węzła, a następnie wybierz Właściwości.
W panelu właściwości węzła Karta adaptacyjna wybierz opcję Edytuj kartę adaptacyjną. Panel projektanta kart adaptacyjnych otworzy się.
Dodaj żądane elementy do swojej karty i skonfiguruj ich właściwości. Alternatywnie, w panelu Edytor ładunku karty, zastąp domyślny ładunek literą JSON, która odpowiada twojej karcie.
Wskazówka
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..
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.
Wskazówka
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.
Interaktywna karta adaptacyjna jest 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
Wykorzystaj inne właściwości do sterowania zachowaniem węzła Adaptive Card , takie jak:
- 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. Wartość domyślna to Powtarzaj maksymalnie 2 razy. 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.
Użyj ponownie polecenia: użyj tej właściwości, aby zdefiniować komunikat do wysłania w przypadku ponownej próby, wraz z powtórzeniem karty. Aby zdefiniować komunikat ponawiania próby, wybierz pozycję 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. W przypadku zmiany tematu karta zostanie ponownie wysłana do użytkownika po zakończeniu przerywanego tematu.
Zachowanie przycisku „Wyślij” dla agentów z następującymi po sobie kartami
W założeniu Adaptive Cards 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 odróżnić zgłoszenia z różnych kart, uwzględnij dane identyfikacyjne w każdej akcji przesłania i sprawdź je podczas przetwarzania odpowiedzi. W niestandardowym kliencie obsługuj powtarzające się lub nieaktualne przesłania oddzielnie od identyfikowania wybranej akcji.
Używanie identyfikatora przesyłania w danych Action.Submit
Jeśli agent wysyła wiele kart adaptacyjnych w konwersacji (na przykład kolejne karty, ponawianie prób lub przerwy), użytkownicy mogą wybrać opcję Prześlij na wcześniejszej karcie. Uwzględnij identyfikator w danych każdej akcji przesyłania i zweryfikowaj go podczas przetwarzania odpowiedzi.
Example:
{
"type": "Action.Submit",
"title": "Confirm",
"data": {
"actionSubmitId": "booking_confirm_card_v3_confirm"
}
}
Ten stały identyfikator odróżnia działanie w tym przykładzie. Nie identyfikuje jednoznacznie każdej wyrenderowanej instancji karty ani automatycznie zapobiega zduplikowanym zgłoszeniom.
Porada dotycząca interfejsu czatu internetowego, aby uniknąć nieaktualnych kliknięć
Niektóre aplikacje czatu utrzymują wcześniejsze karty klikalne po przesłaniu późniejszej karty przez użytkownika. Jeśli tworzysz niestandardową aplikację do czatu internetowego, rozważ ustawienie przesłanych kart jako tylko do odczytu lub aktualizację wcześniejszych kart, aby ograniczyć przypadkowe zduplikowanie lub przestarzałe zgłoszenia.
Korzystaj z interfejsów obsługi akcji i wysyłania aktywności obsługiwanych przez wybranego klienta. Oddziel obsługę wysyłania od innych działań karty i zapewnij możliwość ponownej próby, gdy dostawa się nie powiedzie. Uczynienie karty tylko do odczytu to miara użyteczności po stronie klienta, a nie zastępstwo weryfikacji zgłoszeń w Twoim agencie lub usłudze.
Użyj Power Fx, aby uczynić swoją kartę dynamiczną
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.
Wybierz trzy kropki (...) węzła, a następnie wybierz Właściwości.
W panelu Właściwości węzła karty adaptacyjnej przejdź do pozycji Formuła. Wybranie pozycji 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.microsoft.com/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": "Enter your name to continue with your booking.", "isSubtle": true, "wrap": true }, { "type": "Input.Text", "id": "myName", "label": "Your name", "isRequired": true, "errorMessage": "Please enter your name." } ] } ] } ], "actions": [{ "type": "Action.Submit", "title": "Submit", "data": { "actionSubmitId": "trip_details_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.microsoft.com/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", isRequired: true, errorMessage: "Please enter your name." } ] } ] } ], actions: [ { type: "Action.Submit", title: "Submit", data: { actionSubmitId: "trip_details_submit" } } ] }
Important
Po rozpoczęciu edytowania w panelu formuły nie można wrócić do oryginalnego kodu JSON. Aby umożliwić iteracyjne projektowanie i zmiany, zapisz kopię oryginalnego kodu JSON we własnych notatkach lub jako komentarz w węźle. Ten środek ostrożności pomaga przywrócić zmiany w razie potrzeby.