Gestionar nodos de extracción

Añade, configura y elimina nodos de extracción en UiPath Maestro Flow.

El nodo Extraer extrae campos estructurados de un documento, como una factura, un recibo, un formulario o un contrato, utilizando un modelo de extracción de Extracción y Procesamiento Inteligentes (IXP) y devuelve el resultado para que los nodos posteriores actúen sobre él.

Requisitos previos

Antes de añadir un nodo de extracción , asegúrate de que tu tenant tiene habilitados tanto los servicios de Extracción y Procesamiento Inteligentes(IXP) como los de Document Understanding . El nodo Extraer depende de ambos servicios, incluso cuando solo utilizas modelos de Extracción y Procesamiento Inteligentes (IXP).

Añadir un nodo de extracción a un flujo

Para añadir un nodo Extraer a un flujo, sigue estos pasos:

1. Abre tu flujo en Maestro Flow.
2. Selecciona Añadir nodo, Documento y Extraer.
3. Selecciona una de las siguientes opciones de la paleta del nodo:
   • Extraer documento : crea un nuevo nodo e, implícitamente, un nuevo modelo.
   • En esta solución : selecciona un nodo existente de la lista desplegable.
   • Publicado : selecciona en la lista desplegable un modelo de Extracción y Procesamiento Inteligentes (IXP) implementado, como un modelo implementado desde Documentos complejos y no estructurados de Extracción y Procesamiento Inteligentes (IXP) o desde el nodo Extraer de otro flujo. Cada modelo aparece como un nodo individual.

Resultado: el nodo se añade al lienzo Flujo, vinculado al modelo que has seleccionado. En este punto, puedes conectar el nodo Extraer al nodo anterior en tu flujo.

Configurar el nodo de extracción

Al mantener el puntero sobre un nodo Extraer en el lienzo Flujo, aparece una barra de herramientas. Puedes seleccionar una de las siguientes opciones para configurar el nodo:

• Editar : abre las propiedades del nodo, donde se configuran las entradas, la gestión de errores y la configuración avanzada del nodo. Para obtener más detalles, consulta Configurar el nodo en Propiedades.
• Abrir vista completa : abre la pestaña Definición , donde se configura el modelo de extracción y la taxonomía del nodo. Para obtener más detalles, consulta Configurar el nodo en Definición.

Configurar el nodo en Propiedades

Para configurar el nodo en Propiedades, procede de la siguiente manera:

1. En el lienzo Flujo, mantén el puntero sobre el nodo Extraer .
2. En la barra de herramientas que aparece, selecciona Editar.

Resultado: las propiedades del nodo se abren en una ventana. La sección Propiedades en el centro contiene los ajustes que configuran el nodo Extraer . El panel de Entrada a la izquierda y el panel de Salida a la derecha están disponibles para cada nodo en Flujo. Para obtener más información, consulta Paneles de entrada y salida.

Propiedades

La sección Propiedades contiene las siguientes pestañas:

• Parámetros
• Administración de errores
• Avanzado

Parámetros

Nota:

En caso de errores de validación, se muestra un número en la pestaña Parámetros .

Para configurar los campos dentro de la pestaña Parámetros , procede de la siguiente manera:

• Entrada de archivo:

  • Archivo : el archivo del que extraer datos. Vincúlalo a un archivo producido anteriormente en el flujo, como la salida de un desencadenador o de un nodo anterior. Utiliza Insertar para abrir el selector de variables, donde puedes buscar variables. El selector enumera las salidas de los nodos anteriores en $vars, y los metadatos de flujo, como FolderKey, InstanceId y ProcessKey, en $metadata.

  • Intervalo de páginas : de forma opcional, añade las páginas al proceso, por ejemplo 1-5. Déjalo vacío para procesar todo el documento. Utiliza el icono de tipo de valor T en el campo para elegir entre:

    • Valor fijo : introduce un valor directamente.
    • Expresión : introduce una expresión JavaScript con IntelliSense.

    También puedes utilizar Insertar para añadir una variable.

• Definición : un resumen del modelo de extracción del nodo:
  • El modelo de extracción y su versión, junto con las métricas de evaluación. Un nodo que no tiene ejecución de evaluación muestra Aún no evaluado.
  • Documentos anotados : el número de documentos anotados del número total de documentos.
  • Cargar : cargar documentos para anotar.
  • Anotar : abre la vista de anotación. Esta opción no está disponible hasta que añadas campos a la taxonomía.
  • Ejecutar evaluación : ejecuta una evaluación del modelo de extracción.
  • Editar : abre la pestaña Definición del panel Extraer documento . Para obtener más detalles, consulta Configurar el nodo en Definición.
  • Configuración del modelo : un resumen de solo lectura de la configuración del modelo: modelo de extracción, estrategia de extracción, soporte de idioma, análisis de diseño y atribución.
  • Taxonomía : el número de campos en la taxonomía. Si la taxonomía no tiene campos, selecciona Añadir campos para abrir la pestaña Definición con un nuevo grupo de campos.

Administración de errores

La pestaña Gestión de errores contiene la opción Habilitar gestión de errores . Cuando lo habilitas, el nodo obtiene un identificador de salida de error que detecta y gestiona los fallos, y la salida del nodo incluye un objeto error con code, message, detail, category y status claves.

Avanzado

La pestaña Avanzado contiene los siguientes ajustes:

• ID : el ID del nodo, por ejemplo extractDocument2. Para cambiarlo, selecciona el icono de edición.
• Color del icono : el color del icono del nodo en el lienzo.
• Actualizar variable : asigna valores a las variables cuando se ejecuta el nodo. Selecciona Añadir actualización de variable y luego configura los siguientes ajustes:
  • Variable : la variable que se actualizará. Selecciona una variable existente o selecciona Crear nueva variable.
  • Expresión : el valor a asignar. Utiliza Insertar para añadir una variable. Para hacer referencia a una variable en una expresión, utiliza $vars.{name}.

Paneles de entrada y salida

Los paneles Entrada y Salida están disponibles para cada nodo en Flujo. Muestran datos del flujo y no se configura el nodo Extraer en ellos.

Entrada

El panel de entrada enumera los nodos anteriores en el flujo. Puedes ver la entrada en los siguientes formatos:

• Esquema : las claves de salida de cada nodo anterior y sus tipos. Para un nuevo nodo, las claves no tienen valores.
• JSON : la entrada en formato JSON. Para un nuevo nodo, esta vista está vacía.

Salida

El panel Salida muestra la salida de la ejecución anterior del nodo, con las teclas version, type, result, taxonomy y metadata . Si el nodo aún no se ha ejecutado, las claves no tienen valores. Puedes ver la salida en el formato Esquema, JSON o Resultado de extracción .

La lista desplegable selecciona qué respuesta devuelve el nodo:

• En directo : la respuesta real del nodo.
• Simulacro estático : un valor que defines, devuelto cada vez.
• Generado : una respuesta que un LLM genera de forma dinámica.

Configurar el nodo en Definición

Para configurar el nodo en la pestaña Definición , procede de la siguiente manera:

1. En el lienzo Flujo, mantén el puntero sobre el nodo Extraer .
2. En la barra de herramientas que aparece, selecciona Abrir vista completa.

Resultado: el panel Extraer documento abre la pestaña Definición .

La pestaña Definición contiene las siguientes secciones:

• Resumen de evaluación : el modelo de extracción, su versión y métricas de evaluación. Un nodo que no tiene ejecución de evaluación muestra Aún no evaluado. Para obtener más detalles, consulta Puntuación de salud del nodo. La sección también contiene las siguientes opciones:

  • Documentos anotados : el número de documentos anotados del número total de documentos.
  • Cargar : carga documentos para anotar.
  • Anotar documento : abre la vista de anotación. Esta opción no está disponible hasta que añadas campos a la taxonomía.

• Configuración del modelo : el modelo de extracción y su configuración avanzada. Para obtener más información, consulta Configuración del modelo.

• Taxonomía : los campos que el nodo extrae de cada documento:

  • Instrucciones generales de extracción : añade contexto que sea relevante en toda la taxonomía.
  • Pestaña Taxonomía : añade y gestiona grupos de campos y campos. Para un nuevo nodo, selecciona Grupo de campos para añadir el primer grupo de campos.
  • Pestaña Tipos de campo : añade y gestiona los tipos de campo preconfigurados y personalizados.
  • Vista previa de documentos : abre una vista previa del documento junto a la taxonomía.
  • Importar/Exportar : importa o exporta la taxonomía. Para obtener más detalles, consulta Importar y exportar taxonomías.

  Para obtener más detalles, consulta Gestionar la taxonomía.

Al cambiar la taxonomía, asegúrate de seleccionar Guardar.

Eliminar un nodo de extracción

Para eliminar un nodo Extraer de un flujo, sigue estos pasos:

1. En el lienzo Flujo, mantén el puntero sobre el nodo Extraer .
2. En la barra de herramientas que aparece, selecciona el icono de los puntos suspensivos.
3. Selecciona Eliminar. Como alternativa, selecciona el nodo Extraer en el lienzo Flujo y pulsa Retroceso.

Resultado: el nodo Extraer se elimina del lienzo Flujo.

Documentación relacionada de Maestro Flow

• Extraer : la referencia del nodo, incluido cómo leer el resultado de la extracción, los campos que faltan, las puntuaciones de confianza y los campos de la tabla.
• Procesamiento de documentos : los nodos de procesamiento de documentos disponibles en el lienzo Flujo.