Регистрация бота с помощью 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. В будущем мы предоставим поддержку для других языков.
- Если вы используете боты без отслеживания состояния , установите пакет SDK Graph Communications Core.
- Если вы используете боты с отслеживанием состояния, установите пакет SDK для вызовов в Graph Communications.
Примеры
Узнайте, как реализовать различные сценарии с помощью ботов с отслеживанием состояния, например отвечать на входящий вызов с помощью носителя, размещенного в приложении или службе.
Дополнительные примеры см. в репозитории примеров коммуникаций.
Конфиденциальность и соответствие требованиям
В запросах к нашим API конфиденциальные данные не должны отправляться по созданным на стороне клиента идентификаторам (например, идентификаторам сценариев, идентификаторам запросов или другим идентификаторам корреляции) в заголовках или тексте запроса. Эти идентификаторы регистрируются на стороне сервера для диагностика.