Создание ресурса Служба приложений с помощью Azure CLI

ОБЛАСТЬ ПРИМЕНЕНИЯ: ПАКЕТ SDK версии 4

В этой статье описывается создание ресурса Служба приложений с помощью Azure CLI и шаблона Azure Resource Manager (шаблона ARM) в рамках процесса подготовки и публикации бота. Служба приложений иногда называется веб-приложением.

Внимание

Боты Python нельзя развернуть в группе ресурсов, содержащей службы Windows или боты. Несколько ботов Python можно развернуть в одной группе ресурсов; однако необходимо создать другие службы (например, службы ИИ Azure) в другой группе ресурсов.

Внимание

Пакет SDK Bot Framework и эмулятор Bot Framework были архивированы на GitHub. Проект больше не обновляется или не поддерживается. Запросы на поддержку пакета SDK Bot Framework больше не будут обслуживаться с 31 декабря 2025 г.

Чтобы создавать агенты с помощью выбранной службы ИИ, оркестрации и знаний, рекомендуется использовать пакет SDK для агентов Microsoft 365. Пакет SDK для агентов поддерживает язык C#, JavaScript или Python. Дополнительные сведения о пакете SDK для агентов см. в aka.ms/agents. Если у вас есть существующий бот, созданный с помощью пакета SDK Bot Framework, вы можете обновить бота до пакета SDK для агентов. Ознакомьтесь с основными изменениями и обновлениями в руководстве по миграции с Bot Framework SDK на Agents SDK.

Если вы создаете агент для совместной работы в Microsoft Teams, рассмотрите возможность использования пакета SDK Teams. Он предоставляет интерфейсы API, поддержку адаптивных карт и встроенную оркестрацию ИИ для агентов, работающих в среде Teams. Дополнительные сведения см. в пакете SDK Teams (библиотека ИИ Teams).

Если вы ищете платформу агента на основе SaaS, рассмотрите microsoft Copilot Studio.

Требования

Чтобы использовать Azure CLI для подготовки и публикации ботов, вам потребуется:

  • Учетная запись Azure с активной подпиской. Создайте бесплатную учетную запись.

  • Установка Azure CLI.

    Для языка программирования используйте следующую версию Azure CLI. Некоторые шаги не будут работать с более поздними версиями интерфейса командной строки.

    Язык Версия интерфейса командной строки
    C# и JavaScript 2.39.0 или более поздней версии
    Питон 2.55.0 или выше
    Ява 2.29.2

  • Этот процесс использует шаблон Azure Resource Manager (шаблон ARM) для создания ресурса службы приложений для вашего бота.

    Если у вас нет текущих шаблонов, создайте копию из проекта бота папки deploymentTemplates: C#, JavaScript, Python или Java.

Совет

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

Изменение файла параметров

Измените файл параметров для шаблона ARM, чтобы он содержал значения, которые необходимо использовать.

Внимание

Необходимо использовать то же appType значение для ресурсов службы приложений и Azure Bot.

Если проект еще не содержит последние файлы шаблонов и параметров ARM, их можно скопировать из репозитория пакета SDK Bot Framework для вашего языка: C#, JavaScript, Python или Java.

В этой таблице описываются параметры развертывания в файле параметров, для использования с опцией команды parameters. По умолчанию имя файла параметров — parameters-for-template-BotApp-with-rg.json.

Параметр Тип Описание:
appServiceName Строка Обязательный. Глобально уникальное имя службы приложений.
existingAppServicePlanName Строка Необязательно. Имя существующего плана службы приложений, с помощью которого создается служба приложений для бота.
existingAppServicePlanLocation Строка Необязательно. Расположение существующего плана службы приложений.
newAppServicePlanName Строка Необязательно. Имя нового плана службы приложений.
newAppServicePlanLocation Строка Необязательно. Расположение нового плана службы приложений.
newAppServicePlanSku Объект Необязательно. SKU-номер для нового плана службы приложений. По умолчанию используется план обслуживания S1 (standard).
appType Строка Обязательный. Управление идентификаторами ресурсов бота. Допустимые значения: MultiTenant, SingleTenant и UserAssignedMSI. Значение по умолчанию — «MultiTenant».
appId Строка Обязательный. Идентификатор клиента или идентификатор приложения из созданного ранее ресурса идентификации. Это используется в качестве идентификатора приложения Майкрософт службы приложений.
appSecret Строка Необязательно. Для однопользовательских и многопользовательских типов приложений пароль ресурса идентификации.
UMSIName Строка Необязательно. Для приложений с управляемой идентичностью, назначаемых пользователем, название ресурса идентичности.
UMSIResourceGroupName Строка Необязательно. Для типов приложений с управляемым удостоверением, назначаемым пользователем, группа ресурсов для ресурса удостоверения.
tenantId Строка Необязательно. Для управляемых удостоверений, назначаемых пользователем, и типов приложений с одним клиентом, идентификатор клиента Microsoft Entra ID для ресурса удостоверения.

Не все параметры применяются ко всем типам приложений.

  • Укажите значения для UMSIName, UMSIResourceGroupNameи tenantId.
  • Оставьте appSecret пустым.

Некоторые параметры относятся к использованию существующего или нового плана службы приложений.

  • Укажите значения для existingAppServicePlanName и existingAppServicePlanLocation.
  • Оставьте newAppServicePlanName, newAppServicePlanLocationи newAppServicePlanSku пусто.

Создание службы приложений

Создайте службу приложений для бота.

az deployment group create --resource-group <resource-group> --template-file <template-file-path> --parameters "@<parameters-file-path>"
Вариант Описание:
группировка ресурсов Имя группы ресурсов Azure, в которой создается служба приложений.
файл-шаблон Путь к шаблону ARM для службы приложений. Путь может быть как относительным, так и абсолютным.
Параметры Путь к файлу параметров для использования с шаблоном ARM. Путь может быть как относительным, так и абсолютным.

Для проектов, созданных с помощью последних генераторов, файлы шаблонов и параметров ARM находятся в папке DeploymentTemplates\DeployUseExistResourceGroup в проекте. Имена файлов по умолчанию template-BotApp-with-rg.json и parameters-for-template-BotApp-with-rg.json.

Совет

  • Базовый URL-адрес службы приложений основан на имени службы приложений: https:<app-service-name>.azurewebsites.net
  • Конечная точка обмена сообщениями для бота будет базовым URL-адресом плюс /api/messages, например https:<app-service-name>.azurewebsites.net/api/messages.

Дополнительная информация:

Дополнительные сведения о шаблонах ARM см. в статье "Что такое шаблоны ARM" и "Как использовать шаблоны развертывания Azure Resource Manager (ARM) с Azure CLI.

Следующие шаги

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

  • Last updated on