Если вы в настоящее время не размещаете бота в Azure, вы по-прежнему можете сделать его доступным в Azure и использовать Azure для подключения бота к каналам. Для этого введите в Azure веб-адрес, в котором размещен бот.
В этой статье показано, как зарегистрировать такого бота в Служба Bot Azure AI.
Важно!
Необходимо зарегистрировать бот только в том случае, если он не размещен в Azure.
Боты, созданные с помощью Azure CLI, уже зарегистрированы в Служба Bot Azure AI.
Удостоверение бота можно управлять в Azure несколькими способами.
В качестве управляемого удостоверения, назначаемого пользователем, поэтому вам не нужно самостоятельно управлять учетными данными бота.
Как однотенантное приложение.
В качестве мультитенантного приложения.
Поддержка управляемых удостоверений, назначаемых пользователем, и типов приложений с одним клиентом была добавлена в пакет SDK Bot Framework для C#, JavaScript и Python.
Эти типы приложений не поддерживаются на других языках или в Bot Framework Composer, эмуляторе Bot Framework или в туннелях разработки.
Создайте ресурс Azure Bot, который позволит зарегистрировать бота в Служба Bot Azure AI.
Совет
Новые ресурсы регистрации каналов веб-приложения ибота не могут быть созданы. Однако все существующие ресурсы, настроенные и развернутые, будут продолжать работать.
Боты, созданные из шаблона VSIX или Yeoman из пакета SDK версии 4.14.1.2 или более поздней, содержат шаблоны ARM, которые будут создавать ресурс Azure Bot.
В поле поиска введите 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.
Поддерживает все три типа приложений для управления удостоверениями бота.
Java
application.properties
Поддерживает только многотенантные боты.
Python
config.py
Поддерживает все три типа приложений для управления удостоверениями бота.
Сведения об удостоверениях, которые необходимо добавить, зависят от типа приложения бота.
Укажите следующие значения в файле конфигурации.
Доступно для ботов на всех языках программирования: C#, JavaScript, Java и Python.
Свойство
Значение
MicrosoftAppType
MultiTenant
MicrosoftAppId
Идентификатор приложения бота.
MicrosoftAppPassword
Пароль приложения бота.
MicrosoftAppTenantId
Неприменимо. Оставьте это пустым для мультитенантного бота.
Обновление службы приложений
Если у вас есть существующий ресурс Служба приложений (веб-приложение) для бота, а бот — это приложение управляемого удостоверения, назначаемое пользователем, может потребоваться обновить службу приложений бота:
Перейдите в колонку Служба приложений для веб-приложения бота.
В разделе Параметры выберите пункт Удостоверение.
В колонке "Удостоверение" выберите вкладку "Назначаемый пользователем" и "Добавить " (+).
В колонке "Добавление назначаемого пользователем управляемого удостоверения ":
Выберите свою подписку.
Для управляемых удостоверений, назначенных пользователем, выберите управляемое удостоверение для бота. Если управляемое удостоверение было автоматически создано для вас, оно будет иметь то же имя, что и бот.
Выберите "Добавить ", чтобы использовать это удостоверение для бота.
Получение идентификатора приложения или клиента
Чтобы получить идентификатор приложения или клиента бота:
Перейдите в колонку ресурсов Azure Bot для бота.
Перейдите в колонку конфигурации бота.
В этой колонке можно скопировать идентификатор приложения Майкрософт или идентификатор клиента приложения бота.
Создание нового пароля
Боты с одним клиентом и несколькими клиентами имеют секрет приложения или пароль, необходимый для некоторых операций.
Azure AI Служба Bot скрывает секрет бота. Однако владелец ресурса Служба приложений бота может создать новый пароль:
Перейдите в колонку ресурсов Azure Bot для бота.
Перейдите в колонку конфигурации бота.
Выберите "Управление", рядом с идентификатором приложения Майкрософт, чтобы перейти в колонку "Сертификаты и секреты " для службы приложений.
Следуйте инструкциям в колонке, чтобы создать новый секрет клиента и записать значение в безопасном месте.
Регистрация приложений вручную
Регистрация вручную необходима, если:
Вы не можете сделать регистрацию в вашей организации и требуется другая сторона, чтобы создать идентификатор приложения для создаваемого бота.
Необходимо вручную создать собственный идентификатор приложения и пароль.
Обновление бота
Чтобы обновить файл конфигурации бота, чтобы включить его идентификатор приложения и пароль, ознакомьтесь с идентификатором приложения и паролем в настройке параметров регистрации бота.
Дополнительная информация:
Дополнительные сведения о приложениях Azure см. в этих статьях.
Бизнес, разработанный внутри организации, нуждается в регистрации в идентификаторе Microsoft Entra и назначен пользователям для безопасного решения Azure. Узнайте, как реализовать регистрацию приложений.
Продемонстрировать основные понятия ИИ, связанные с разработкой программного обеспечения и служб Microsoft Azure для создания решений искусственного интеллекта.
Узнайте, как управлять ботами. Узнайте, как использовать портал Azure для поиска сведений о журналах действий, параметрах сборки, параметрах отладки и других свойствах.
Канал подключает приложение связи к боту. Узнайте, как настроить бота для запуска канала с помощью портал Azure, Direct Line или пользовательского адаптера.
Узнайте, как устранять ошибки проверки подлинности бота, такие как проблемы с подключением и проблемы с идентификаторами приложений и паролями. Просмотр дополнительных ресурсов.