PREVIEW

Clasificar documento: vista previa

UiPath.IntelligentOCR.StudioWeb.Activities.ClassifyDocument

Descripción

Puedes utilizar esta actividad para clasificar documentos, seleccionando un clasificador deseado y un documento que te gustaría clasificar.

Nota: la actividad Clasificar datos del documento utiliza puntos finales públicos.

Limitaciones conocidas

El tipo de proyecto generativo predefinido y los extractores correspondientes no están disponibles en Automation Suite.

Compatibilidad de proyectos

Windows | Multiplataforma

Configuración

Panel del Diseñador

• Entrada: proporciona el archivo de entrada o el objeto Datos del documento.
  Importante: el número máximo de páginas que puede tener un archivo es 500. Los archivos que superan este límite no se pueden clasificar.
  Consejo: cuando tus archivos no se almacenan como variable de IResourcetipo, hay una opción para realizar una conversión. Utiliza LocalResource.FromPath(<reference_to_the_file>) en el campo de propiedad Entrada para esto.

  Considera un escenario en el que iteras a través de una lista de archivos utilizando una actividad Para cada. Supongamos que currentItem es tu variable iterativa. Para convertir currentItem en IResource, pega LocalResource.FromPath(currentItem) en el campo Entrada.
• Proyecto de Document Understanding: requiere que selecciones tu proyecto de Document Understanding en el menú desplegable. Las opciones disponibles son:
  • Predefinido: proyecto que utiliza modelos especializados preentrenados recomendados para escenarios estándar.
  • Generativo predefinido: proyecto que utiliza modelos generativos preentrenados que aceptan instrucciones como entrada para la clasificación o extracción de datos del documento.
  • Proyecto existente del tenant y la carpeta a los que estás conectado
  • Puedes crear un nuevo proyecto seleccionando el icono +.
  Nota: si has creado más de 500 proyectos en tu tenant y utilizas la actividad Clasificar Documento, UiPath Studio o Studio Web no mostrará ningún proyecto más allá de los 500 iniciales.Por lo tanto, esos proyectos no se pueden utilizar.
• Clasificador: si utilizas el proyecto predefinido, puedes seleccionar tu clasificador de Document Understanding deseado en el menú desplegable.
  Nota: Los datos enviados al Clasificador generativo se enviarán a una instancia de Modelo LLM que no es de acceso público, no saldrá de él y, una vez procesados, no se almacenarán ni se utilizarán para el entrenamiento.
  • Para el proyecto predefinido, tienes dos opciones:
    • Clasificación ML: clasificador basado en ML.
    • Clasificador generativo: el tipo de clasificador generativo.
      Importante:

      Esta característica forma parte actualmente de un proceso de auditoría y no debe considerarse parte de la autorización de FedRAMP hasta que finalice la revisión. Consulta aquí la lista completa de características actualmente en revisión.

      • Detalles del tipo de documento: instrucciones para identificar tipos de documentos, proporcionadas como pares clave-valor, donde la clave representa el nombre del tipo de documento y el valor una descripción del mismo, lo que ayuda al clasificador a identificar dichos documentos.
        • Clave: proporciona el nombre del tipo de documento que se utilizará como resultado de la clasificación (límite de 30 caracteres).
        • Valor: requiere que proporciones instrucciones al clasificador generativo sobre cómo identificar el tipo de documento. El número máximo de caracteres permitidos es de 1000.
  • Para el proyecto generativo predefinido solo puedes utilizar el clasificador generativo.
• Versión (Vista Previa): utiliza esta propiedad al utilizar un proyecto moderno de Document Understanding existente. Selecciona la etiqueta que corresponde a la versión del proyecto de la que deseas procesar datos. Por ejemplo, si eliges la etiqueta de producción asignada a la versión 3, la actividad procesa datos de la versión 3 de tu proyecto en el entorno de producción.

  El valor predeterminado para la versión es Clasificación. Si la etiqueta de Clasificación no existe en tu proyecto seleccionado, el valor predeterminado es Producción.

  Después de seleccionar una etiqueta, la actividad muestra una lista de tipos de documentos admitidos para esa versión.

Panel de propiedades

Opciones avanzadas

• Confianza mínima: especifica el umbral de confianza mínimo en función del que se asigna un tipo de documento durante la clasificación. Si la puntuación de confianza de un documento cae por debajo de este umbral, su tipo de documento se informa como "desconocido".
  Consejo: la mayoría de los tipos de documentos generan una predicción con un nivel de confianza. Establecer esta propiedad evita falsos positivos considerando solo las predicciones con un nivel de confianza por encima del umbral. Puedes identificar un nivel de confianza óptimo probando varios documentos dentro de tu flujo de trabajo, grabando los resultados en una hoja de cálculo Excel, por ejemplo, y luego analizar qué valor de umbral es el más preciso.

  Conexión externa en tiempo de diseño

  La conexión externa en tiempo de diseño te permite aprovechar la actividad utilizando recursos de Document Understanding de otros proyectos o tenants. Antes de configurar estas propiedades, asegúrate de haber cumplido los requisitos previos mencionados en la página Configurar la conexión externa de runtime . Una vez completados estos pasos, puedes proceder a configurar la conexión externa de runtime.

  • ID de la aplicación: introduce el ID de la aplicación externa que creaste anteriormente.
  • Secreto de la aplicación: introduce el secreto de la aplicación externa que creaste anteriormente.
  • URL del tenant: introduce la URL del tenant donde creaste la aplicación externa. Este es el tenant desde el que utilizarás los recursos en tiempo de diseño.
    La URL debe tener el siguiente formato: https://<baseURL>/<OrganizationName>/<TenantName>.

Entrada

• Tiempo de espera (segundos) : tiempo máximo de ejecución (en segundos) para la llamada al modelo generativo. Si la operación supera este tiempo de espera, se finaliza automáticamente para evitar retrasos o bloqueos. Esta propiedad solo se muestra si el Clasificador generativo está seleccionado como clasificador.

Salida

• Datos del documento: todos los datos de campo validados extraídos del archivo.

Conexión externa de runtime

La conexión externa de runtime te permite ejecutar la actividad a través de robots locales. Antes de configurar estas propiedades, asegúrate de haber cumplido los requisitos previos mencionados en la página Configurar la conexión externa de runtime . Una vez completados estos pasos, puedes proceder a configurar la conexión externa de runtime.

• Activo de credenciales de tiempo de ejecución : utiliza este campo cuando necesites acceder a los recursos de Document Understanding mientras el robot está conectado a un Orchestrator local, o desde un tenant diferente. Puedes elegir introducir un activo de credenciales, con fines de autenticación, de una de las siguientes maneras:
  • En la lista desplegable, selecciona el activo de credenciales deseado del Orchestrator al que está conectado el UiPath® Robot.
  • Introduce manualmente la ruta al activo de credenciales de Orchestrator donde almacenas las credenciales de la aplicación externa para acceder al proyecto.
    El formato de la ruta debe ser: <OrchestratorFolderName>/<AssetName>.
• URL del tenant de Runtime: utiliza este campo, junto con el campo Asset de credenciales de Runtime. Introduce la URL del tenant al que se conectará el robot para ejecutar la clasificación. La URL debe estar en el siguiente formato: https://<baseURL>/<OrganizationName>/<TenantName>.

Uso del clasificador generativo

Para empezar rápidamente con las capacidades generativas de la actividad Clasificar documento, realiza los siguientes pasos:

1. Añadir una actividad Clasificar documento
2. En la lista desplegable Proyecto, selecciona Predefinido o Generativo predefinido.
3. Para Clasificador, selecciona Clasificador generativo.

   La propiedad Detalles del tipo de documento aparece en el cuerpo de la actividad.

4. En la colección Detalles del tipo de documento, proporciona tus instrucciones como pares clave-valor del diccionario, donde:
   • La clave representa el tipo de documento (ejemplo: CV).
   • El valor representa la solicitud generativa: la descripción utilizada por el clasificador generativo para identificar los tipos de documentos.

     Por ejemplo, consulta la siguiente tabla para ver una muestra de pares clave-valor:

     Tabla 1. Pares clave-valor utilizados como solicitud para el clasificador generativo

     Clave	Valor
     CV	"Encuentre palabras clave comunes de CV como "Educación", "Habilidades" y "Experiencia"."
     Factura	"Encuentre nombres de campo comunes como "Número de factura", "Facturar a" o "Importe total"."

   Figura 1. Pares de clave-valor utilizados como solicitud para el clasificador generativo