Развертывание средства разметки образцов

Это содержимое относится к следующему:🟩версия 2.1.

Совет

  • Для большего удобства работы и более высокого качества модели попробуйте Студию Document Intelligence v3.0.
  • Студия версии 3.0 поддерживает любую модель, обученную с помощью маркированных данных версии 2.1.
  • Подробные сведения о переходе с версии 2.1 на версию 3.0 см. в руководстве по миграции API.
  • Чтобы приступить к работе с версией 3.0, ознакомьтесь с нашими краткими руководствами по пакетам SDK для REST API или C#, Java, JavaScript или Python.

Примечание.

Средство маркировки данных, размещенное в облаке, доступно по адресу https://fott-2-1.azurewebsites.net/. Выполните действия, описанные в этом документе, только если вы хотите развернуть средство разметки образцов для собственного использования.

Средство создания примеров меток для анализа документов — это приложение, которое предоставляет простой пользовательский интерфейс, который можно использовать для ручной маркировки форм (документов) для защищенного обучения. В этой статье приведены ссылки и инструкции, которые учат вас:

Запустите средство Sample Labeling локально

Самый быстрый способ начать маркировку данных — запустить средство Sample Labeling локально. В следующем кратком руководстве используется REST API аналитики документов и средство создания меток для обучения пользовательской модели с данными, помеченными вручную.

Развертывание с помощью Экземпляров контейнеров Azure (ACI)

Прежде чем мы начнём, важно отметить, что существует два способа развертывания инструмента разметки образцов в Azure Container Instance (ACI). Оба варианта используются для запуска инструмента маркировки образцов с помощью ACI.

Портал Azure

Чтобы создать новый ресурс с помощью портала Azure, выполните следующие действия.

  1. Войдите на портал Azure.

  2. Выберите Создать ресурс.

  3. Затем выберите Веб-приложение.

    Выбор веб-приложения

  4. Сначала убедитесь, что выбрана вкладка Базовый. Теперь необходимо указать определенную информацию.

    Выбор вкладки

    • Подписка. Выберите существующую подписку Azure.
    • Группа ресурсов. Можно повторно использовать существующую группу ресурсов или создать новую для этого проекта. Рекомендуется создать новую группу ресурсов.
    • Имя. Присвойте веб-приложению имя.
    • Опубликовать — выберите контейнер Docker
    • Операционная система. Выберите Linux.
    • Регион — выберите подходящий вам регион.
    • План Linux. Выберите ценовую категорию или план для службы приложений.

    Настройка веб-приложения

  5. Затем перейдите на вкладку Docker.

    Выбор Docker

  6. Теперь настроим контейнер Docker. Если не указано иное, все поля являются обязательными.

  • Параметры. Выберите Один контейнер.
  • Источник образа. Выберите Частный реестр.
  • URL-адрес сервера. Укажите для этого параметра значение https://mcr.microsoft.com.
  • Имя пользователя (необязательно). Создайте имя пользователя.
  • Пароль (необязательно) — создайте безопасный пароль, который можно запомнить.
  • Изображение и тег — установите значение mcr.microsoft.com/azure-cognitive-services/custom-form/labeltool:latest-2.1
  • Непрерывное развертывание — установите значение Вкл., если хотите получать автоматические обновления, когда команда разработчиков вносит изменения в инструмент Sample Labeling.
  • Команда запуска. Укажите для этого параметра значение ./run.sh eula=accept.

Настройка Docker

  • Затем выберите Просмотр и создание, а затем Создать для развертывания веб-приложения. После завершения вы сможете получить доступ к веб-приложению по URL-адресу, указанному в разделе Обзоре этого ресурса.

Непрерывное развертывание

После создания веб-приложения можно включить параметр непрерывного развертывания:

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

Снимок экрана: расширение параметров контейнера для непрерывного развертывания.

Примечание.

При создании веб-приложения можно также настроить авторизацию и проверку подлинности. Но для начала работы это не обязательно.

Внимание

Возможно, вам потребуется включить TLS для веб-приложения, чтобы просмотреть его по адресу https . Следуйте инструкциям в разделе Включение TLS-конечной точки, чтобы настроить sidecar-контейнер, который обеспечивает поддержку TLS/SSL для вашего веб-приложения.

Azure CLI

В качестве альтернативы порталу Azure можно создать ресурс с помощью Azure CLI. Прежде чем продолжить, необходимо установить Azure CLI. Этот шаг можно пропустить, если вы уже работаете с Azure CLI.

Есть несколько вещей, которые нужно знать об этой команде:

  • DNS_NAME_LABEL=aci-demo-$RANDOM создает случайный DNS-идентификатор.
  • В этом примере предполагается, что у вас есть группа ресурсов, которую можно использовать для создания ресурса. Замените <resource_group_name> на допустимую группу ресурсов, связанную с вашей подпиской.
  • Необходимо указать место создания ресурса. Замените <region name> на нужный регион для веб-приложения.
  • Эта команда автоматически принимает лицензионное соглашение конечного пользователя (EULA).

В интерфейсе командной строки Azure (Azure CLI) выполните следующую команду, чтобы создать ресурс веб-приложения для инструмента Sample Labeling:

DNS_NAME_LABEL=aci-demo-$RANDOM

az container create \
  --resource-group <resource_group_name> \
  --name <name> \
  --image mcr.microsoft.com/azure-cognitive-services/custom-form/labeltool:latest-2.1 \
  --ports 3000 \
  --dns-name-label $DNS_NAME_LABEL \
  --location <region name> \
  --cpu 2 \
  --memory 8 \
  --command-line "./run.sh eula=accept"

Подключение к идентификатору Microsoft Entra для авторизации

Рекомендуется подключить веб-приложение к идентификатору Microsoft Entra. Это гарантирует, что входить в систему и использовать веб-приложение смогут только пользователи с действительными учетными данными. Следуйте инструкциям в разделе Настройка приложения App Service, чтобы подключиться к Microsoft Entra ID.

Открытый код на GitHub

Средство маркировки форм также доступно в виде проекта с открытым исходным кодом на сайте GitHub. Средство — это веб-приложение, созданное с помощью команды React + Redux и написанное в TypeScript. Дополнительные сведения или участие см. в разделе "Инструмент маркировки форм".

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

Сведения о том, как использовать средство для ручной маркировки обучающих данных и выполнения контролируемого обучения, см в. кратком руководстве Обучение с метками.