Introducción: Document Intelligence Studio

Azure Document Intelligence en Foundry Tools Studio es una herramienta en línea que puede usar para explorar, comprender e integrar visualmente características del servicio Document Intelligence en sus aplicaciones. Puede empezar explorando los modelos entrenados previamente con ejemplos o sus propios documentos. También puede crear proyectos para crear modelos de plantilla personalizados y hacer referencia a los modelos de las aplicaciones.

Requisitos previos

  • Una suscripción Azure. Cree uno gratis.
  • Un recurso de inteligencia de documentos Azure. Una vez que tenga su suscripción de Azure, cree un recurso de servicio único o de varios servicios de Azure en Azure Portal para obtener la clave y el punto de conexión.
  • Para probar el servicio, use el plan de tarifa gratuito (F0). Puede actualizar más adelante a un nivel de pago para producción.

Sugerencia

Cree un recurso de Microsoft Foundry si planea acceder a varias herramientas de Foundry en un único punto de conexión o clave. Para acceder únicamente a Document Intelligence, cree un recurso dedicado a Document Intelligence. Necesita un recurso de un solo servicio si piensa usar autenticación de Microsoft Entra.

Document Intelligence ahora admite la autenticación de tokens de Microsoft Entra ID además de la autenticación local (basada en claves) al acceder a recursos y cuentas de almacenamiento de Document Intelligence. Siga las instrucciones para configurar los roles de acceso correctos, especialmente si sus recursos están sujetos a la DisableLocalAuth política.

Se han agregado requisitos previos para usar modelos personalizados en Document Intelligence Studio. Para obtener instrucciones paso a paso, consulte Proyectos personalizados de Document Intelligence Studio.

Directivas de autorización

Su organización puede optar por deshabilitar la autenticación local y aplicar la autenticación de Microsoft Entra (anteriormente Azure Active Directory) para los recursos de Document Intelligence y Azure Blob Storage.

  • La autenticación de Microsoft Entra requiere que se deshabilite la autorización basada en claves. Una vez deshabilitado el acceso a claves, Microsoft Entra ID es el único método de autorización disponible.
  • Microsoft Entra permite conceder privilegios mínimos y un control pormenorizado para los recursos de Azure.

Para obtener más información, consulte las instrucciones siguientes:

Si la autenticación local (basada en claves) está deshabilitada para el recurso del servicio Document Intelligence, asegúrese de obtener el rol de usuario de Cognitive Services y el token de Microsoft Entra ID para autenticar las solicitudes en Document Intelligence Studio. El rol Colaborador permite enumerar solo las claves, pero no le concede permiso para usar el recurso cuando el acceso a claves está deshabilitado.

Designar asignaciones de roles

El acceso básico de Document Intelligence Studio requiere el rol de usuario de Cognitive Services . Para obtener más información, consulte Asignaciones de roles de Inteligencia de documentos.

  • Asegúrese de que tiene el rol Usuario de Cognitive Services y no el rol Colaborador de Cognitive Services al configurar la autenticación de Microsoft Entra ID.

    • Usuario de Cognitive Services: es necesario disponer de este rol para que el recurso Document Intelligence o Microsoft Foundry pueda acceder a la página de análisis.
    • Contribuyente: necesita este rol para crear un grupo de recursos, un servicio de Document Intelligence o un recurso de Microsoft Foundry.

  • En Azure contexto, el rol Colaborador solo puede realizar acciones para controlar y administrar el propio recurso, incluida la enumeración de las claves de acceso.

  • Las cuentas de usuario con un rol de colaborador solo pueden acceder al servicio Document Intelligence mediante el uso de claves de acceso. Al configurar el acceso con Microsoft Entra ID, se deshabilita el acceso a claves y se requiere el rol de usuario de Cognitive Services para que una cuenta use los recursos.

Autenticación en Document Intelligence Studio

Vaya a Document Intelligence Studio. Si es la primera vez que inicia sesión, se le pedirá que configure el recurso de servicio. De acuerdo con la directiva de su organización, tiene las siguientes opciones:

  • autenticación Microsoft Entra: acceso por recurso (recomendado)

    1. Seleccione la suscripción existente.

    2. Seleccione un grupo de recursos existente dentro de la suscripción o cree uno nuevo.

    3. Seleccione el recurso existente de Document Intelligence o Microsoft Foundry.

      Captura de pantalla que muestra la configuración de un recurso de servicio en Document Intelligence Studio.

  • Autenticación local: acceso por punto de conexión de API y clave

    1. Recupere el punto de conexión y la clave del portal de Azure.

    2. Vaya a la página de información general del recurso y, en el panel izquierdo, seleccione Claves y punto de conexión.

    3. Escriba los valores en los campos adecuados.

      Captura de pantalla que muestra la página Claves y punto de conexión en el portal de Azure.

  • Después de validar el escenario en Document Intelligence Studio, use las bibliotecas cliente de C#, Java, JavaScript o Python o la API REST para incorporar los modelos de Document Intelligence en sus propias aplicaciones.

Probar un modelo de Inteligencia de documentos

Para más información sobre los modelos de Document Intelligence disponibles, consulte Soporte para modelos de Document Intelligence.

  • Pruebe los diferentes modelos que Document Intelligence Studio tiene que ofrecer después de configurar el recurso. Seleccione cualquier modelo de Inteligencia de documentos para usarlo con un enfoque sin código.
  • Pruebe cualquiera de los modelos precompilados o de análisis de documentos. Seleccione el modelo y use uno de los documentos de ejemplo o cargue su propio documento para analizarlo. El resultado del análisis aparece en el panel de la derecha que muestra el código de resultado de contenido.
  • Entrene los modelos personalizados en sus documentos. Para obtener información general sobre los modelos personalizados, consulte Introducción a los modelos personalizados.
  • Valide el escenario en Document Intelligence Studio. A continuación, use el C#, Java, JavaScript o Python o la API REST para incorporar modelos de Inteligencia de documentos en sus propias aplicaciones.

Visualización de los detalles del recurso

Para ver detalles de recursos como el nombre y el plan de tarifa, seleccione el icono Configuración en la esquina superior derecha de la página principal de Document Intelligence Studio y, a continuación, seleccione la pestaña Recurso . Si tiene acceso a otros recursos, también puede cambiar los recursos.

Captura de pantalla que muestra la pestaña Recurso de la página Configuración.

Con La inteligencia de documentos, puede automatizar rápidamente el procesamiento de datos en aplicaciones y flujos de trabajo, mejorar fácilmente las estrategias controladas por datos y enriquecer con habilidad las funcionalidades de búsqueda de documentos.

Administrar la configuración que no es de Microsoft para el acceso a Document Intelligence Studio

Microsoft Edge
  1. Vaya a Configuración para Microsoft Edge.
  2. Busque terceros.
  3. Vaya a Administrar y eliminar cookies y datos del sitio.
  4. Desactive la configuración de Bloquear cookies de terceros.
Chrome
  1. Vaya a Configuración de Chrome.
  2. Busque Terceros.
  3. En Comportamiento predeterminado, seleccione Permitir cookies de terceros.
Firefox
  1. Vaya a Configuración de Firefox.
  2. Busque cookies.
  3. En Protección de seguimiento mejorada, seleccione Administrar excepciones.
  4. Agregue una excepción para https://documentintelligence.ai.azure.com o para la URL de Document Intelligence Studio de su entorno.
Safari
  1. SeleccionePreferencias de>.
  2. Seleccione Privacidad.
  3. Borrar Bloquear todas las cookies.

Solución de problemas

Escenario Causa Resolución
Recibe el mensaje de error
Form Recognizer Not Found al abrir un proyecto personalizado.		 El recurso de Inteligencia de documentos, que está enlazado al proyecto personalizado, se eliminó o se movió a otro grupo de recursos. Hay dos maneras de resolver este problema:
• Vuelva a crear el recurso de Document Intelligence en la misma suscripción y grupo de recursos con el mismo nombre.
• Vuelva a crear un proyecto personalizado con el recurso de Document Intelligence migrado y especifique la misma cuenta de almacenamiento.
Recibirá el mensaje
PermissionDenied de error cuando use aplicaciones precompiladas o abra un proyecto personalizado.		 El principal no tiene acceso a la API ni a la operación cuando realiza análisis contra modelos precompilados o abre un proyecto personalizado. Es probable que la autenticación local (basada en claves) esté deshabilitada para el recurso de Document Intelligence y no tenga permiso suficiente para acceder al recurso. Para configurar los roles de acceso, consulte Azure Role Assignments.
Recibirá el mensaje
AuthorizationPermissionMismatch de error al abrir un proyecto personalizado.		 La solicitud no está autorizada para realizar la operación mediante el permiso designado. Es probable que la autenticación local (basada en claves) esté deshabilitada para la cuenta de almacenamiento y no tenga el permiso concedido para acceder a los datos del blob. Para configurar los roles de acceso, consulte Azure Role Assignments.
No puede iniciar sesión en Document Intelligence Studio y recibir el mensaje
InteractionRequiredAuthError:login_required:AADSTS50058:A silent sign-request was sent but no user is signed in de error.		 Es probable que el explorador bloquee las cookies que no son Microsoft, por lo que no puede iniciar sesión correctamente. Para resolver este problema, consulte Administrar la configuración no Microsoft para el explorador.

Contenido relacionado

  • Last updated on