Примечание
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
ОБЛАСТЬ ПРИМЕНЕНИЯ: ПАКЕТ SDK версии 4
Если вы в настоящее время не размещаете бота в Azure, вы по-прежнему можете сделать его доступным в Azure и использовать Azure для подключения бота к каналам. Для этого введите в Azure веб-адрес, в котором размещен бот.
В этой статье показано, как зарегистрировать такого бота в Служба Bot Azure AI.
Внимание
Необходимо зарегистрировать бот только в том случае, если он не размещен в Azure. Боты, созданные с помощью Azure CLI, уже зарегистрированы в Служба Bot Azure AI.
Идентификацией бота можно управлять в Azure несколькими способами.
- Используя управляемое удостоверение, назначаемое пользователем, вы не должны управлять учетными данными вручную.
- Как однотенантное приложение.
- В качестве мультитенантного приложения.
Замечание
- Поддержка управляемых удостоверений, назначаемых пользователем , и типов приложений с одним клиентом доступна в пакете SDK Bot Framework для C#, JavaScript и Python.
- Эти типы приложений не поддерживаются на других языках SDK, Bot Framework Composer, эмуляторе Bot Framework или в туннелях разработки.
Внимание
- Создание многотенантного бота будет прекращено после 31 июля 2025 г.
- Существующие многотенантные боты будут продолжать функционировать, но создание нового мультитенантного бота больше не будет поддерживаться после этой даты.
- Чтобы обеспечить постоянную поддержку, используйте одноарендное или управляемое удостоверение, назначенное пользователем.
Поддерживаемые типы приложений
| Тип приложения | Поддерживается в |
|---|---|
| Управляемое удостоверение, назначаемое пользователем | Служба Azure AI Bot; Пакеты SDK для C#, JavaScript и Python |
| Один клиент | Служба Azure AI Bot; Пакеты SDK для C#, JavaScript и Python |
| Мультитенантный (устаревший — заканчивается 31 июля 2025 г.) | Служба Azure AI Bot; все языки пакета SDK Bot Framework; Композитор; Эмулятор; Туннели разработки |
В этой статье не описывается создание или развертывание бота для регистрации. Дополнительные сведения см. в разделе:
- Краткое руководство по созданию бота
- Руководство по развертыванию базового бота
Создание ресурса
Создайте ресурс Azure Bot, который позволит зарегистрировать бота в Служба Bot Azure AI.
Совет
Новые ресурсы регистрации каналов веб-приложения ибота не могут быть созданы. Однако все существующие ресурсы, настроенные и развернутые, будут продолжать работать. Боты, созданные из шаблона VSIX или Yeoman из пакета SDK версии 4.14.1.2 или более поздней, содержат шаблоны ARM, которые будут создавать ресурс Azure Bot.
Переход на портал Azure.
В правой области выберите "Создать ресурс".
В поле поиска введите
bot, а затем нажмите клавишу ВВОД.Выберите карточку Azure Bot .
Нажмите кнопку создания.
Введите значения в обязательных полях и проверьте и обновите параметры.
Укажите сведения в разделе "Сведения о проекте". Выберите, будет ли бот иметь глобальное или локальное расположение данных. В настоящее время функция расположения локальных данных доступна для ресурсов в регионе "westeurope" и "centralindia". Дополнительные сведения см. в разделе "Регионизация" в azure AI Служба Bot.
Укажите сведения в разделе идентификатора приложения Майкрософт. Выберите способ управления удостоверением бота в Azure и создание нового удостоверения или использование существующего.
Выберите Review + create (Просмотреть и создать).
Если проверка проходит, нажмите кнопку "Создать".
После завершения развертывания выберите "Перейти к ресурсу". Вы увидите бота и связанные ресурсы, перечисленные в выбранной группе ресурсов.
Если у вас еще нет пакета SDK Bot Framework, выберите "Скачать" из GitHub , чтобы узнать, как использовать пакеты для предпочитаемого языка.
Теперь вы готовы к созданию бота с помощью пакета SDK Bot Framework.
Совет
При создании ресурса Azure с одним клиентом или несколькими клиентами Azure Bot с новым идентификатором приложения он также создает пароль.
Идентификационная информация бота
Выполните следующие действия, чтобы добавить сведения об удостоверениях в файл конфигурации бота. Файл отличается в зависимости от языка программирования, используемого для создания бота.
Внимание
- Версия пакета SDK Bot Framework для Java поддерживает только многотенантные боты.
- Версии C#, JavaScript и Python поддерживают все три типа приложений для управления удостоверением бота.
| Язык | Имя файла | Примечания. |
|---|---|---|
| C# | appsettings.json | Поддерживает все три типа приложений для управления удостоверениями бота. |
| JavaScript | env. | Поддерживает все три типа приложений для управления удостоверениями бота. |
| Ява | файл настроек application.properties | Поддерживает только многотенантные боты. |
| Питон | config.py | Поддерживает все три типа приложений для управления удостоверениями бота. |
Сведения об удостоверениях, которые необходимо добавить, зависят от типа приложения бота. Укажите следующие значения в файле конфигурации.
Доступно для ботов C#, JavaScript и Python.
| Свойство | Значение |
|---|---|
MicrosoftAppType |
UserAssignedMSI |
MicrosoftAppId |
Идентификатор клиента управляемого удостоверения, назначаемого пользователем. |
MicrosoftAppPassword |
Неприменимо. Оставьте это пустым для бота управляемого удостоверения, назначаемого пользователем. |
MicrosoftAppTenantId |
Идентификатор клиента управляемого удостоверения, назначаемого пользователем. |
Обновление службы приложений
Если у вас есть существующий ресурс Служба приложений (веб-приложение) для бота, а бот — это приложение управляемого удостоверения, назначаемое пользователем, может потребоваться обновить службу приложений бота:
- Перейдите в колонку Служба приложений для веб-приложения бота.
- В разделе Параметры выберите пункт Удостоверение.
- В колонке "Удостоверение" выберите вкладку "Назначаемый пользователем" и "Добавить " (+).
- В колонке "Добавление назначаемого пользователем управляемого удостоверения ":
Выберите свою подписку.
Для управляемых удостоверений, назначенных пользователем, выберите управляемое удостоверение для бота. Если управляемое удостоверение было автоматически создано для вас, оно будет иметь то же имя, что и бот.
Выберите "Добавить ", чтобы использовать это удостоверение для бота.
Получение идентификатора приложения или клиента
Чтобы получить идентификатор приложения или клиента бота:
- Перейдите в колонку ресурсов Azure Bot для бота.
- Перейдите в колонку конфигурации бота. В этой колонке можно скопировать идентификатор приложения Майкрософт или идентификатор клиента приложения бота.
Создание нового пароля
Боты с одним клиентом и несколькими клиентами имеют секрет приложения или пароль, необходимый для некоторых операций. Azure AI Служба Bot скрывает секрет бота. Однако владелец ресурса Служба приложений бота может создать новый пароль:
- Перейдите в колонку ресурсов Azure Bot для бота.
- Перейдите в колонку конфигурации бота.
- Выберите "Управление", рядом с идентификатором приложения Майкрософт, чтобы перейти в колонку "Сертификаты и секреты " для службы приложений.
- Следуйте инструкциям в колонке, чтобы создать новый секрет клиента и записать значение в безопасном месте.
Регистрация приложений вручную
Регистрация вручную необходима, если:
- Вы не можете сделать регистрацию в вашей организации и требуется другая сторона, чтобы создать идентификатор приложения для создаваемого бота.
- Необходимо вручную создать собственный идентификатор приложения и пароль.
Обновление бота
Чтобы обновить файл конфигурации бота, чтобы включить его идентификатор приложения и пароль, ознакомьтесь с идентификатором приложения и паролем в настройке параметров регистрации бота.
Дополнительная информация:
Дополнительные сведения о приложениях Azure см. в этих статьях.
| Тема | Статья |
|---|---|
| Регистрация приложения | Краткое описание: регистрация приложения на платформе Microsoft Identity |
| Управляемые удостоверения | Что такое управляемые удостоверения для ресурсов Azure? |
| Однотенантные и мультитенантные приложения | Арендочность в идентификаторе Microsoft Entra |