Проще говоря, Adaptive Card - это маленький интерфейс внутри сообщения. Вместо длинного текста бот может показать аккуратную карточку: что произошло, какие данные важны, какие варианты доступны и какие кнопки нажать. Пользователь не уходит в отдельную систему, а принимает решение прямо в рабочем чате.
Для AI-агентов Adaptive Cards особенно полезны в human-in-the-loop сценариях. Агент подготовил action candidate: создать задачу, отправить письмо, изменить статус сделки, согласовать документ или назначить встречу. Карточка показывает детали действия и кнопки: подтвердить, отклонить, изменить, запросить уточнение. Так агент не выполняет рискованное действие вслепую.
Adaptive Card отличается от обычного сообщения. Сообщение просто передает текст. Карточка структурирует информацию и может содержать поля ввода, кнопки и действия. Например, в Teams карточка может попросить выбрать приоритет, написать комментарий, подтвердить списание или назначить владельца задачи.
Adaptive Card не является полноценным frontend-приложением. У нее есть ограничения схемы и возможностей хоста. Сложные таблицы, многошаговые формы, нестандартные компоненты и тяжелую бизнес-логику лучше выносить в отдельный интерфейс. Карточка хороша для короткого решения, статуса, approval, уведомления или компактного сбора данных.
В AI-системах важно не доверять нажатию кнопки без backend-проверок. Если пользователь нажал «Approve», сервер все равно должен проверить права, action allowlist, ACL, статус объекта, срок действия карточки и audit log. Карточка - это удобный интерфейс, а не единственный уровень безопасности.
Главные ошибки: перегружать карточку текстом, делать слишком много кнопок, отправлять карточку без понятного контекста, не показывать последствия действия, не проверять права на сервере, не обрабатывать истекшие карточки и забывать, что разные хосты могут поддерживать разные версии схемы.
Примеры
- AI-агент в Teams показывает карточку: «Создать задачу в Jira?», внутри - название, описание, исполнитель, срок и кнопки «Создать», «Изменить», «Отклонить».
- После встречи агент отправляет карточку со списком action items и просит организатора подтвердить, какие пункты перенести в план задач.
- Финансовый агент показывает карточку на согласование счета: поставщик, сумма, срок оплаты, риск и кнопки «Согласовать» или «Передать бухгалтеру».
- Customer success агент присылает карточку с риском оттока клиента, последними событиями и быстрыми действиями: назначить звонок, создать задачу, добавить комментарий в CRM.
- В webhook-сценарии n8n получает нажатие кнопки из карточки, проверяет action id, права пользователя и только потом вызывает внешний API.
Где используется
- approval workflow внутри Microsoft Teams или Outlook
- подтверждение action candidates перед выполнением tool call
- уведомления AI-агента с понятным контекстом и кнопками
- сбор короткого ввода: комментарий, приоритет, владелец, дата
- создание задач, follow-up и action items после встреч
- согласование документов, счетов, сделок и публичных ответов
- интерактивные карточки для чат-ботов и внутренних ассистентов
- операционные алерты с быстрыми действиями
- связка Teams, Power Automate, Microsoft Graph, n8n или Make
- логирование решений человека в audit log
Связанные термины
Частые вопросы
Что такое Adaptive Card простыми словами?
Это интерактивная карточка внутри чата или письма. В ней можно показать важные данные, поля и кнопки, чтобы пользователь быстро принял решение без перехода в отдельную систему.
Где используются Adaptive Cards?
Чаще всего их используют в Microsoft Teams, Outlook, ботах, Copilot-сценариях и workflow. Карточки подходят для уведомлений, согласований, коротких форм и быстрых действий.
Зачем Adaptive Card нужна AI-агенту?
Она дает агенту удобный human-in-the-loop интерфейс. Агент предлагает действие, а человек видит детали и нажимает «подтвердить», «отклонить» или «изменить». Это безопаснее, чем сразу выполнять действие через API.
Чем Adaptive Card отличается от обычного сообщения?
Обычное сообщение - это текст. Adaptive Card - структурированный JSON-интерфейс с блоками, полями, кнопками и действиями. Ее можно использовать как мини-форму или карточку approval.
Можно ли считать нажатие кнопки в карточке безопасным подтверждением?
Нет, кнопку нужно проверять на сервере. Backend должен проверить пользователя, права, ACL, срок действия карточки, action allowlist и статус объекта. Иначе карточку можно использовать неправильно или повторно.
Какие ограничения есть у Adaptive Cards?
Карточки не заменяют сложный интерфейс. У них ограниченная схема, разные хосты могут поддерживать разные возможности, а тяжелую логику нужно держать на сервере. Лучше использовать карточки для коротких решений и компактного ввода.
