Używaj Adaptive Cards w Copilot Studio

Note

W tym artykule opisano funkcje używane w agentach lub przepływach agentów obsługiwanych przez standardowe środowisko uruchomieniowe.

Adaptive Cards opisują zawartość interfejsu użytkownika w JSON. Aplikacja hosta, taka jak Microsoft Teams, renderuje kartę w swoim własnym interfejsie. Używaj kart w agentach do zbierania danych od użytkownika lub wyświetlania informacji.

Aplikacja hosta decyduje, które wersje i funkcje kart są obsługiwane. Wybierz wersję schematu, która działa na każdym kanale, w którym publikujesz swojego agenta.

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.

Wybierz węzeł odpowiadający twojemu zadaniu:

Wskazówka

Twórz karty we wbudowanym projektancie opisanym w artykule Ask questions with Adaptive Cards lub wykorzystaj kartę z innego tematu i dostosuj ją do swojego zadania.

Dowiedz się więcej o schemacie i przykładach na stronie Adaptive Cards.

Najlepsze rozwiązania dotyczące kart interaktywnych

Gdy używasz interaktywnych Adaptive Cards (kart z przyciskami Submit), uwzględnij dane identyfikujące kartę lub akcję w każdej akcji Submit. Zweryfikuj te dane podczas przetwarzania odpowiedzi, zwłaszcza gdy wcześniejsze karty pozostają widoczne. Stały identyfikator akcji rozróżnia akcje; sam w sobie nie zapobiega zduplikowanym zgłoszeniom ani nie identyfikuje każdej wyrenderowanej instancji karty.

Dowiedz się więcej w temacie Zachowanie przycisku „Wyślij” dla agentów z następującymi po sobie kartami.