Часто задаваемые вопросы об Azure Bot Framework

В этой статье содержатся ответы на часто задаваемые вопросы по Azure.

применимо к: Пакет SDK v4APPLIES TO: SDK v4

Как это сделать?

Вы можете создать собственную регистрацию приложения в следующих случаях:

  • Вы создадите робот на портале Bot Framework.
  • Вы создаете регистрацию приложения для сторонней компании, которая не имеет доступа к Azure.
  • Необходимо вручную создать собственный идентификатор приложения (и пароль).

Выполните действия, описанные ниже.

  1. Войдите в учетную запись Azure. Если ее нет, вы можете зарегистрироваться и получить бесплатную учетную запись.

  2. Перейдите на панель регистрации приложений и щелкните Новая регистрация на панели действий вверху.

    новая регистрация

  3. Введите отображаемое имя для регистрации приложения в поле Имя и выберите тип среди поддерживаемых типов учетных записей.

    Важно!

    При создании приложения в разделе Поддержка типов учетных записей выберите один из следующих параметров для нескольких типов клиентов:When creating the app, in the section Supports account types, choose one of the following multi-tenant types options:

    ТипType ОписаниеDescription
    Учетные записи в любом каталоге организации (любой клиент Azure AD)Accounts in any organizational directory (Any Azure AD - Multitenant) Этот параметр обеспечивает меньшее воздействие, запрещая доступ и в случае, если OAuth не поддерживается.This option provides less exposure by restricting access and in case OAuth is not supported.
    Учетные записи в любом каталоге организации (любой Azure AD — клиент) и личные учетные записи Майкрософт (например, Xbox, Outlook.com).Accounts in any organizational directory (Any Azure AD - Multitenant) and personal Microsoft accounts (for example, Xbox, Outlook.com) Этот вариант хорошо подходит для поддержки проверки подлинности OAuth и Bot.This option is well-suited to support OAuth and bot authentication.

    Подробнее см. статью о регистрации приложения на платформе удостоверений Майкрософт.For more information, see Register an application with the Microsoft identity platform.

    сведения о регистрации

  4. Нажмите кнопку Зарегистрировать.

    Через несколько секунд вновь созданная регистрация приложения должна открыть панель. Скопируйте идентификатор приложения (Client) в области обзора и сохраните его. Он понадобится для заполнения поля идентификатора соответствующего приложения во время создания программы-робота, как описано далее в этой статье.

    Идентификатор приложения

Создание программы-робота с помощью портал Azure

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

  1. Выберите сертификаты & секреты в левом столбце навигации панели регистрации приложения.

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

    создание секрета

  3. Выберите Добавить.

  4. Скопируйте значение секрета из таблицы в разделе секреты клиента и сохраните его.

    Копировать секрет

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

    Примечание

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

    создание идентификатора приложения

Пример применения описанных выше действий можно найти в статье Добавление проверки подлинности в Bot.

Какие файлы необходимо заархивировать для развертывания?

Необходимо вручную создать ZIP-архив со всеми файлами в проекте, как описано в разделе шаг: Создание каталога с кодом вручную. Убедитесь, что выбраны все файлы и папки в папке проекта Bot. Затем, находясь в папке проекта, заархивируйте все выбранные файлы и папки, как показано на рисунке ниже.

выбрать все и почтовые индексы

Какую версию Azure CLI следует использовать для развертывания Bot?

Используйте последнюю версию интерфейса Azure Command-Line (CLI), иначе вы получите Нерекомендуемые команды. Подробнее см. статью Установка Azure CLI.

Что делать при получении Azure CLI ошибок устаревания?

Выполните обновление до последней версии Azure CLI. Для Azure CLI версии 2.2.0 или более поздней необходимо использовать az deployment sub create az deployment group create команды и вместо az deployment create , az group deployment create соответственно.

Журнал изменений Azure CLI команд, используемых для развертывания Bot в Azure

Версия Azure ClI Command1 Команда 2
Azure CLI 2.2.0 и более поздних версий az deployment group create az deployment sub create
Azure CLI 2.1.0 и более ранние версии az group deployment create az deployment create

Дополнительные сведения см. в разделе Azure CLI журнал изменений.

Что представляют собой Нерекомендуемые команды интерфейса командной строки `az deployment` ?

Ниже приведены az deployment устаревшие команды.

Не рекомендуется Кем заменено
az deployment <create/list show/delete/validate/export/cancel> az deployment **sub** <create/list/show/delete/validate/export/cancel>
az deployment operation <list/show> az deployment operation **sub** <list/show>
az group deployment <create/list/show/delete/validate/export/cancel> az deployment **group** <create/list/show/delete/validate/export/cancel>
az group deployment operation <list/show> az deployment operation **group** < list/show>

Разделы справки определить, являются ли команды Azure CLI устаревшими?

Чтобы определить, является ли команда Azure CLI нерекомендуемой, выполните команду с -h параметром (Help), как показано на рисунке ниже.

Справка CLI

Журнал изменений Azure CLI

Дополнительные сведения см. в статье Azure CLI журнал изменений.

Управление ресурсами Azure (ARM)

Ниже приведен объединенный список команд, соответствующих текущему дизайну Azure CLI: az {группа команд} {? подкоманда-группа} {Operation} {Parameters}.

  • az resource: Улучшение примеров модуля ресурсов
  • az policy assignment list: Поддержка списков назначений политик в области группы управления
  • Добавлены команды az deployment group и az deployment operation group для развертывания шаблонов в группах ресурсов. Это дубликат az group deployment и az group deployment operation .
  • Добавлены команды az deployment sub и az deployment operation sub для развертывания шаблонов в области подписки. Это дубликат az deployment и az deployment operation .
  • Добавлены команды az deployment mg и az deployment operation mg для развертывания шаблонов в группах управления.
  • Добавлены команды ad deployment tenant и az deployment operation tenant для развертывания шаблонов в области арендатора.
  • az policy assignment create: добавлено описание параметра --location.
  • az group deployment create: Добавьте параметр --aux-tenants для поддержки перекрестных клиентов.