Поделиться через

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

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

Предпосылки

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

Подсказка

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

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

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

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

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

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

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

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

Назначение ролей

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

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

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

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

  • Учетные записи пользователей с ролью участника могут получить доступ к службе аналитики документов только путем вызова с ключами доступа. При настройке доступа с идентификатором Microsoft Entra доступ к ключу отключен, а для использования ресурсов требуется роль пользователя 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 используйте клиентские библиотеки Java, Java, JavaScript или Python или REST API для включения моделей аналитики документов в собственные приложения.

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

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

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

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

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

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

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

Управление параметрами, отличными от Майкрософт, для доступа к Document Intelligence Studio

Microsoft Edge
  1. Перейдите в раздел "Параметры " для 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-адрес Studio Document Intelligence Studio.
Сафари
  1. Выберите "Параметры Safari>".
  2. Выберите "Конфиденциальность".
  3. Снимите флажок "Блокировать все файлы cookie".

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

Сценарий Причина Резолюция
При открытии пользовательского проекта вы получите сообщение
Form Recognizer 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, отличные от Майкрософт, поэтому вы не сможете выполнить вход. Чтобы устранить эту проблему, см. раздел "Управление параметрами, отличными от Майкрософт " для браузера.

Связанный контент

  • Last updated on