Поделиться через

Адаптивные карточки для разработчиков ботов

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

Замечание

Skype не поддерживается в текущей предварительной версии. См. страницу «Состояние партнера» для получения последней информации.

Интеграция Bot Framework

С помощью Bot Framework можно написать один бот, который может общаться с пользователями в нескольких "каналах", таких как Skype, Microsoft Teams, Facebook Messenger и т. д.

Walkthrough

Добавить адаптивную карточку в ваш бот довольно просто.

Шаг 0. Начало работы с основным сообщением

Ниже приведен стандартный пакет данных Bot Framework message, который можно доставить через любой канал и отображать текст пользователю.

{
   "type": "message",
   "text": "Plain text is ok, but sometimes I long for more..."
}

Шаг 1. Добавление адаптивной карточки attachment

Чтобы добавить разнообразие за рамки простого текста, Bot Framework содержит концепцию attachments.

Давайте вложим адаптивную карточку, отображающую пользовательский текст.

Базовая адаптивная карточка 

{
  "type": "message",
  "text": "Plain text is ok, but sometimes I long for more...",
  "attachments": [
    {
      "contentType": "application/vnd.microsoft.card.adaptive",
      "content": {
        "type": "AdaptiveCard",
        "version": "1.0",
        "body": [
          {
            "type": "TextBlock",
            "text": "Hello World!",
            "size": "large"
          },
          {
            "type": "TextBlock",
            "text": "*Sincerely yours,*"
          },
          {
            "type": "TextBlock",
            "text": "Adaptive Cards",
            "separation": "none"
          }
        ],
        "actions": [
          {
            "type": "Action.OpenUrl",
            "url": "http://adaptivecards.io",
            "title": "Learn More"
          }
        ]
      }
    }
  ]
}

Шаг 2. Создание еще более богатых карточек

Адаптивные карточки предлагают гораздо больше, чем просто настраиваемый текст.

Вы можете:

Пакеты SDK для платформы

Если бот разработан с помощью .NET или NodeJS, у нас есть библиотеки, чтобы упростить создание адаптивных карточек.

Platform Install Подробнее
.NET Install-Package AdaptiveCards -IncludePrerelease Документация Bot Framework .NET
NodeJS npm install adaptivecards Документация по NodeJS Bot Framework

Состояние канала

Bot Framework позволяет публиковать бота в нескольких каналах. Мы работаем с различными каналами, чтобы обеспечить полную поддержку адаптивных карточек. См. страницу "Состояние партнера" для получения последних сведений.

Погружение!

Мы лишь затронули основы в этом руководстве, поэтому посмотрите ссылки ниже, чтобы узнать больше о том, как адаптивные карточки могут улучшить вашего бота.

  • Last updated on