Использование адаптивных карточек в Copilot Studio

Note

Функции, описанные в этой статье, питаются стандартным жгутом, который использует опции выставления счетов, описанные в разделе «Лицензирование для агентов, работающих на стандартном жгуте». Узнайте, как получить доступ к стандартным функциям в стандартных агентах и потоках агентов доступа.

Адаптивные карточки — это фрагменты пользовательского интерфейса, не зависящие от платформы, написанные в формате JSON, которыми приложения и службы могут открыто обмениваться. При передаче в конкретное приложение (часто называемое "узлом") представление JSON преобразуется в собственный пользовательский интерфейс, который автоматически адаптируется к контексту приложения. Используя адаптивные карточки, вы можете разрабатывать и интегрировать упрощенный пользовательский интерфейс для всех основных платформ и инфраструктур.

Адаптивные карточки особенно ценятся в таких продуктах, как Microsoft Teams и Outlook, потому что дизайнер интерфейса не может предсказать, находится ли пользователь, например, в темном или светлом режиме. В любом случае адаптивные карточки просто адаптируются.

Note

Copilot Studio поддерживает схему Adaptive Cards версий 1.6 и более ранних версий. Однако подходящая версия схемы зависит от целевого ведущего приложения:

• Компонент веб-чата Bot Framework (то есть стандартная схема интеграции с веб-сайтом) поддерживает версию 1.6, но не Action.Execute
• Мини-приложение чата (используемое в многоканальном взаимодействии для Customer Service) ограничено версией 1.5.
• Teams также ограничен версией 1.5

Кроме того, Copilot Studio рендерит карточки версии 1.6 только в тестовом чате, а не на холсте.

Подробнее см. в разделе Адаптивные карточки.

Используйте адаптивные карточки в агентах Copilot Studio, чтобы проверять информацию от клиента, задавать вопросы или улучшать разговорное взаимодействие.

• Используйте интерактивный узел Адаптивная карточка для запроса информации.
• Добавьте адаптивную карточку в узел Сообщение или Вопрос для отображения информации.

Tip

Для создания новых адаптивных карточек используйте следующие ресурсы:

• Веб-сайт Адаптивные карточки для документации по схемам и примеров.
• Предыдущие темы агента (клонируйте и редактируйте предыдущие карточки для обеспечения единообразия).
• ChatGPT или Copilot в Bing, чтобы создать полезную нагрузку JSON для карточки.
• Power Apps или Power Automate (для разработки карточки).

Рекомендации по использованию интерактивных карточек

Когда вы используете интерактивные адаптивные карточки (карточки с кнопками Отправить), убедитесь, что каждое действие отправить содержит уникальные данные, идентифицирующие карточку или действие. Использование уникальных данных, связанных с конкретной карточкой или действием, снижает риск неожиданного поведения, если одновременно отображается несколько карточек или если пользователь выбирает кнопку на предыдущей карточке.

Дополнительные сведения см. в разделе Поведение кнопки отправки для агентов с последовательными карточками.