Начало работы: Document Intelligence Studio

Azure Аналитика документов в Studio Foundry Tools — это онлайн-средство, которое можно использовать для визуального изучения, понимания и интеграции функций из службы аналитики документов в приложения. Вы можете начать с изучения предварительно обученных моделей, используя примеры или собственные документы. Вы также можете создавать проекты для разработки пользовательских шаблонов моделей и использовать эти модели в своих приложениях.

Необходимые условия

  • Подписка Azure. Создайте его бесплатно.
  • Ресурс аналитики документов Azure. После получения подписки Azure создайте ресурс single-service или Azure multiservice на портале Azure, чтобы получить ключ и конечную точку.
  • Чтобы попробовать службу, используйте бесплатную ценовую категорию (F0). Позже вы можете перейти на платный уровень для продакшена.

Совет

Создайте ресурс Microsoft Foundry, если планируется получить доступ к нескольким средствам Foundry в рамках одной конечной точки или ключа. Только для доступа к аналитике документов создайте ресурс аналитики документов. Если вы планируете использовать проверку подлинности Microsoft Entra, вам потребуется ресурс с единой службой.

Аналитика документов теперь поддерживает проверку подлинности маркеров Microsoft Entra ID помимо локальной проверки подлинности (на основе ключей) при доступе к ресурсам аналитики документов и учетным записям хранения. Следуйте инструкциям по настройке надлежащих ролей доступа, особенно если на ваши ресурсы распространяется политика DisableLocalAuth.

Добавлены предварительные требования для использования пользовательских моделей в Document Intelligence Studio. Пошаговые инструкции см. в разделе "Пользовательские проекты Document Intelligence Studio".

Политики авторизации

Ваша организация может отключить локальную проверку подлинности и применить проверку подлинности Microsoft Entra (ранее Azure Active Directory) для ресурсов аналитики документов и Хранилище BLOB-объектов Azure.

  • Microsoft Entra проверка подлинности требует отключения авторизации на основе ключей. После отключения доступа к ключу Microsoft Entra ID является единственным доступным методом авторизации.
  • Microsoft Entra позволяет предоставлять минимальные привилегии и детализированный контроль для Azure ресурсов.

Дополнительные сведения см. в следующих рекомендациях:

Если локальная (на основе ключа) проверка подлинности отключена для ресурса службы аналитики документов, обязательно получите роль пользователя Cognitive Services и маркер Microsoft Entra ID для проверки подлинности запросов в Document Intelligence Studio. Роль участника позволяет перечислять только ключи, но не дает разрешения на использование ресурса при отключении доступа к ключам.

Назначьте назначения ролей

Базовый доступ к Document Intelligence Studio требует роли пользователя Cognitive Services . Дополнительные сведения см. в разделе "Назначение ролей аналитики документов".

  • Убедитесь, что у вас есть роль пользователя Cognitive Services, а не роль участника Cognitive Services при настройке проверки подлинности Microsoft Entra ID:

    • Cognitive Services User. Эта роль необходима для ресурса Аналитики документов или Microsoft Foundry для доступа к странице анализа.
    • Contributor: эта роль необходима для создания группы ресурсов, службы аналитики документов или ресурса Microsoft Foundry.

  • В контексте Azure роль 'Contributor' может выполнять действия только для управления самим ресурсом, включая перечисление ключей доступа.

  • Учетные записи пользователей с ролью участника могут получить доступ к службе интеллектуального анализа документов только путем обращения с использованием ключей доступа. При настройке доступа с помощью Microsoft Entra ID доступ к ключу отключен, а для использования ресурсов требуется роль пользователя Cognitive Services.

Проверка подлинности в Document Intelligence Studio

Перейдите в Document Intelligence Studio. Если вы впервые вошли в систему, вам будет предложено настроить ресурс службы. В соответствии с политикой вашей организации у вас есть следующие параметры:

  • Аутентификация Microsoft Entra: доступ по ресурсу (рекомендуется)

    1. Выберите существующую подписку.

    2. Выберите существующую группу ресурсов в подписке или создайте новую.

    3. Выберите существующий ресурс Аналитики документов или Microsoft Foundry.

      Снимок экрана: настройка ресурса службы в Document Intelligence Studio.

  • Локальная проверка подлинности: доступ по конечной точке и ключу API

    1. Получите конечную точку и ключ на портале Azure.

    2. Перейдите на страницу обзора ресурса, а на левой панели выберите "Ключи" и "Конечная точка".

    3. Введите значения в соответствующие поля.

      Скриншот, показывающий страницу

  • После проверки сценария в Document Intelligence Studio используйте C#Java, JavaScript или Python клиентские библиотеки или клиентские библиотеки REST для включения моделей аналитики документов в собственные приложения.

Попробуйте модель аналитики документов

Дополнительные сведения о доступных моделях аналитики документов см. в статье "Поддержка модели аналитики документов".

  • Попробуйте различные модели, которые предлагает Document Intelligence Studio после настройки вашего ресурса. Выберите любую модель аналитики документов, чтобы использовать ее с подходом без кода.
  • Попробуйте воспользоваться анализом документов или предварительно созданной моделью. Выберите модель и используйте один из примеров документов или отправьте собственный документ для анализа. Результат анализа отображается в панели справа, где отображается код результата анализа.
  • Обучайте пользовательские модели на ваших документах. Общие сведения о пользовательских моделях см. в обзоре пользовательских моделей.
  • Проверьте сценарий в Document Intelligence Studio. Затем используйте C#Java, JavaScript или Python клиентские библиотеки или клиентские библиотеки REST для включения моделей аналитики документов в собственные приложения.

Просмотр сведений о ресурсе

Чтобы просмотреть сведения о ресурсах, например имя и ценовую категорию, щелкните значок "Параметры " в правом верхнем углу домашней страницы Document Intelligence Studio и перейдите на вкладку "Ресурс ". Если у вас есть доступ к другим ресурсам, можно также переключить ресурсы.

Снимок экрана: вкладка

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

Управление параметрами, не относящимися к Microsoft, для доступа к Document Intelligence Studio

Microsoft Edge
  1. Перейдите к Settings для Microsoft Edge.
  2. Найдите стороннего производителя.
  3. Перейдите к разделу "Управление и удаление файлов cookie" и данных сайта.
  4. Отключите параметр "Блокировать сторонние файлы cookie".
Хром
  1. Перейдите в раздел "Параметры " для Chrome.
  2. Найдите стороннее приложение.
  3. В разделе "Поведение по умолчанию" выберите "Разрешить сторонние файлы cookie".
Firefox
  1. Перейдите в раздел "Параметры " для Firefox.
  2. Найдите файлы cookie.
  3. В разделе "Расширенная защита отслеживания" выберите "Управление исключениями".
  4. Добавьте исключение для https://documentintelligence.ai.azure.com или URL-адреса Document Intelligence Studio вашей среды.
Сафари
  1. Выберите "Параметры Safari>".
  2. Выберите "Конфиденциальность".
  3. Снимите флажок "Блокировать все файлы cookie".

Устранение неполадок

Сценарий Причина Разрешение
При открытии пользовательского проекта появится сообщение об ошибке
Распознаватель документов Not Found.		 Ресурс аналитики документов, привязанный к пользовательскому проекту, был удален или перемещен в другую группу ресурсов. Существует два способа устранить эту проблему:
• повторно создайте ресурс аналитики документов в одной подписке и группе ресурсов с тем же именем.
• Повторно создайте пользовательский проект с перенесенным ресурсом аналитики документов и укажите ту же учетную запись хранения.
При использовании предварительно созданных приложений вы получаете сообщение
PermissionDenied об ошибке или открываете пользовательский проект.		 Принципал не имеет доступа к API или функциям при анализе предварительно созданных моделей или открытии пользовательского проекта. Скорее всего, для ресурса аналитики документов отключена локальная проверка подлинности (на основе ключа), и у вас недостаточно разрешений на доступ к ресурсу. Чтобы настроить роли доступа, см. в разделе назначения ролей Azure.
При открытии пользовательского проекта вы получите сообщение
AuthorizationPermissionMismatch об ошибке.		 Запрос не авторизован для выполнения операции с помощью указанного разрешения. Скорее всего, локальная (основанная на ключе) аутентификация отключена для вашего аккаунта хранения, и у вас нет разрешенного доступа к данным BLOB. Чтобы настроить роли доступа, см. в разделе назначения ролей Azure.
Вы не можете войти в Document Intelligence Studio и получить сообщение
InteractionRequiredAuthError:login_required:AADSTS50058:A silent sign-request was sent but no user is signed in об ошибке.		 Скорее всего, браузер блокирует файлы cookie, отличные от Microsoft, поэтому вы не сможете выполнить вход. Чтобы устранить эту проблему, см. раздел Управление параметрами, не относящимися к Microsoft для браузера.

Связанное содержимое

  • Last updated on