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

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

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

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

  • Azure Active Directory (Azure AD) и то, как служба помогает сотрудникам входить в систему и получать доступ к ресурсам.
  • Azure Служба Bot и его возможности.

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

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

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

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

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

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

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

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

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

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

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

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

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

Примечание.

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

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

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

Примеры

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

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

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

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

См. также