Регистрация бота с помощью API облачных коммуникаций

  • Статья

Вы можете использовать API облачных коммуникаций в Microsoft Graph для создания ботов для удовлетворения потребностей клиентов и упрощения совместной работы. В этой статье описывается, как зарегистрировать бот, а затем управлять его состоянием.

Предварительные требования

Прежде чем приступить к работе, ознакомьтесь со следующими разделами:

  • Microsoft Entra ID (Microsoft Entra ID) и того, как служба помогает сотрудникам выполнять вход и получать доступ к ресурсам.
  • Azure Служба Bot и его возможности.

Регистрация бота

Термины "приложение службы" и "бот" можно использовать взаимозаменяемо. Вы можете создать бот с помощью портал Azure напрямую или зарегистрировать бота, который не размещен в Azure. Дополнительные сведения см. в разделе Регистрация вызывающего бота.

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

Если вы хотите добавить бота в Microsoft Teams после регистрации бота, убедитесь, что вы понимаете, как использовать портал разработчика для команд и определите необходимые метаданные.

Управление состоянием бота

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

Затем вы можете решить, должен ли бот быть с отслеживанием состояния или без отслеживания состояния.

Боты без отслеживания состояния

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

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

Боты с отслеживанием состояния

Виртуальная машина может одновременно обрабатывать только один экземпляр бота. Так как все состояния находятся на одном компьютере, нет дополнительных проверок памяти или кэша REDIS.

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

Примечание.

Размещенные в службе медиа-боты могут быть с отслеживанием состояния или без отслеживания состояния. Для использования пакета SDK bot Media, размещенные в приложении, боты мультимедиа должны быть с отслеживанием состояния.

Использование пакетов SDK

В C# доступны следующие пакеты SDK. В будущем мы предоставим поддержку для других языков.

Примеры

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

Дополнительные примеры см. в репозитории примеров коммуникаций.

Конфиденциальность и соответствие требованиям

В запросах к нашим API конфиденциальные данные не должны отправляться по созданным на стороне клиента идентификаторам (например, идентификаторам сценариев, идентификаторам запросов или другим идентификаторам корреляции) в заголовках или тексте запроса. Эти идентификаторы регистрируются на стороне сервера для диагностика.

Связанные материалы