Создание ботов для Teams

Статья
09/30/2024

Бот также называется чат-ботом или ботом для общения. Это приложение, которое выполняет простые и повторяющиеся задачи пользователей, например в службах обслуживания или поддержки клиентов. В быту используются боты, которые сообщают сведения о погоде, бронируют рестораны или предоставляют сведения для путешествий. Взаимодействие с ботами может быть в виде быстрых вопросов и ответов или сложных бесед.

Рекомендуется начать с создания первого приложения бота с помощью JavaScript или создания бота уведомлений с помощью JavaScript с помощью средства разработки нового поколения для Teams. Дополнительные сведения см. в статье Общие сведения о наборе средств Teams.

Важно!

Боты доступны в облаках сообщества для государственных организаций (GCC), GCC-High и Министерстве обороны (DOD). Приложения ботов в Microsoft Teams для GCC-High и DOD доступны через службу azure bot и регистрацию канала бота необходимо выполнить на портале Azure для государственных организаций.
URL-адреса изображений в адаптивных карточках не поддерживаются в средах GCC-High и DOD. URL-адрес изображения можно заменить на DataUri в кодировке Base64.
Когда пользователь изменяет тему Teams в боте, она не применяется к содержимому, к которым предоставлен общий доступ с помощью адаптивной карточки.

Диалоговые боты позволяют пользователям взаимодействовать с веб-службой с помощью текста, интерактивных карточек и диалоговых окон (называемых модулями задач в TeamsJS версии 1.x).

Боты для общения чрезвычайно гибкие. Боты могут обрабатывать несколько основных команд или сложных задач, которые включают искусственный интеллект и обработку естественного языка. Боты могут быть частью большего приложения или быть автономными.

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

На снимке экрана показан пример бота с часто задаваемыми вопросами.

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

Боты — это приложения с интерфейсом бесед. Вы можете взаимодействовать с ботом с помощью текста, интерактивных карточек и речи. Бот ведет себя по-разному в канале или групповом чате, а также в личной беседе. Беседы обрабатываются через соединители Bot Framework. См. статью об основах бесед с ботами.

Для доступа к соответствующему содержимому и улучшения работы бота требуется контекстная информация, например сведения о профиле пользователя. См. статью о получении контекста в Teams.

Вы можете отправлять и получать файлы с помощью бота через API Graph или API бота Teams. См. статью об отправке и получении файлов с помощью ботов.

Для оптимизации ботов, используемых для приложения Teams, применяется ограничение скорости трафика. Чтобы защитить Teams и его пользователей, API бота предоставляют ограничение скорости для входящих запросов. См. статью Оптимизация бота с ограничением скорости в Teams.

С помощью API Microsoft Graph для звонков и онлайн-собраний приложения Teams теперь могут взаимодействовать с пользователями с помощью голосовых вызовов и видеосвязи. См. статью о ботах для звонков и собраний.

Вы можете использовать API бота Teams для получения сведений для участников чата или команды. См. статью об изменениях API ботов Teams для получения сведений участников команды или чата.

Имя бота и значок

Имя бота. Имя бота, отображаемое в среде Teams, можно изменить, обновив его в следующих экземплярах:

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

Значок бота. Вы можете добавить или обновить значок бота для приложения Teams следующим образом. Обновленный значок бота становится видимым только после того, как пользователь выйдет из системы и снова войдет в Teams. Это связано с тем, что значки кэшируются:

Приложение Microsoft Teams Store. Для приложений Магазина Teams значки ботов извлекаются из манифеста приложения. Вы можете обновить значок профиля бота, обновив его с помощью манифеста приложения и повторно опубликовав приложение.


{
  "$schema": "https://developer.microsoft.com/json-schemas/teams/v1.16/MicrosoftTeams.schema.json",
  "manifestVersion": "1.17",
  "version": "1.0.0",
  "id": "%MICROSOFT-APP-ID%",
  "icons": {
     "outline": "A relative path to a transparent .png icon — 32px X 32px", // This icon is used for bot profile.
     "color": "A relative path to a full color .png icon — 192px X 192px"
  },
  "bots": [
  {
    "botId": "%MICROSOFT-APP-ID-REGISTERED-WITH-BOT-FRAMEWORK%",
    "scopes": [
      "team",
      "personal",
      "groupChat"
    ]
  }
  ]
...
}

Отправка пользовательского приложения в Teams или пользовательских приложений, созданных для вашей организации (бизнес-приложений):
- портал Azure. Значок бота можно изменить, перейдя к портал Azure.
- Портал Bot Framework. Для ботов, созданных с помощью портала Bot Framework, можно обновить значок бота на странице ПАРАМЕТРЫ .

Указание требований к среде выполнения узла (предварительная версия для разработчиков)

Чтобы гарантировать, что приложение всегда предоставляет клиентам высококачественные возможности, вы можете настроить поведение приложения в применимых узлах Microsoft 365 или исключить его из контекстов, которые вы не готовы поддерживать. Используйте манифест приложения для указания любых связей зависимостей между возможностями приложения и конкретных требований среды выполнения статических вкладок, расширений сообщений и ботов.

Дополнительные сведения см. в статье Указание требований к среде выполнения узла Microsoft 365 в манифесте приложения.

Добавление проверки подлинности единого входа в боты беседы

Вы можете добавить проверку подлинности единого входа в бот беседы, выполнив следующие действия.

Интерфейс настройки бота

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

Примеры кода

Название примера	Описание	.NET	Node.js	Манифест
Напоминание о ежедневной задаче бота	В этом примере показано, как запланировать повторяющуюся задачу и получить напоминание в запланированное время с помощью бота.	Просмотр	Просмотр	Просмотр
бот Hello мира	Это простое приложение hello world с возможностями расширения для ботов и сообщений.	Н/Д	Просмотр
Уведомление адаптивной карточки	Это пример, в котором показано, как отправлять уведомления с помощью различных адаптивных карточек с помощью ботов.	Н/Д	Просмотр
Уведомление о входящих веб-перехватчиках	Это пример, в котором показано, как отправлять уведомления с помощью входящих веб-перехватчиков в каналах Microsoft Teams.	Н/Д	Просмотр

Следующий этап

Боты и пакеты SDK

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