Revisión Humana
Qué hace la Revisión Humana
La Revisión Humana (Human in the Loop, HITL) pone un punto de control entre la extracción y la entrega. Un Run que necesita revisión se detiene después de la extracción y la limpieza con el estado Esperando aprobación: no se envía ningún email, no se dispara ningún webhook, no se escribe ninguna fila en un Bucket y no arranca ningún Agente vinculado hasta que un revisor designado lo apruebe.
La palabra clave es antes. La revisión no es una corrección que aplicas después de que los datos malos ya llegaron a tu ERP; el paso de entrega todavía no se ha ejecutado. Cuando el revisor aprueba, el Run continúa exactamente desde donde se pausó, con sus ediciones.
- Datos de alto valor que deben verificarse antes de seguir adelante
- Un requisito de cumplimiento que exige un paso de aprobación manual documentado
- Documentos cuya extracción suele ser correcta, pero donde un error sale caro
- Valores que solo una persona puede aportar, como un centro de costo interno o un código de aprobación
- Proveedores o formatos nuevos, hasta que confíes en el Flow
Los Runs de Flows son el caso principal, pero la misma cola también reúne los Matches, las inspecciones y los rellenados que están en pausa. Consulta Otras cosas que esperan revisión más abajo.
Tres maneras de pausar un Run de un Flow
El interruptor del Flow es una manera de enviar Runs a revisión, pero no la única. Un Cleaner vinculado al Flow puede pausar Runs por su cuenta, aunque el interruptor esté apagado. Cuando varios disparadores aplican al mismo Run, sus listas de revisores se combinan.
| Disparador | Qué se pausa | Ideal para |
|---|---|---|
| Configuración del Flow (panel Revisión Humana) | Todos los Runs del Flow, sin importar lo que se extrajo. | Un tipo de documento que siempre necesita visto bueno, o un Flow recién creado en el que todavía no confías. |
| Regla de Acciones Condicionales del Cleaner con la acción Human in the Loop | Solo los Runs en los que una fila cumplió la regla, por ejemplo un total por encima de un umbral o un RUC faltante. | Mucho volumen donde casi todos los Runs están bien y solo quieres revisar las excepciones. |
| Campo de Entrada Humana del Cleaner | Todos los Runs que pasan por el Cleaner, porque una persona tiene que escribir o elegir el valor. | Datos que no están en el documento y que alguien tiene que agregar. |
Revisar cada Run anula el sentido de automatizar la extracción. Lo habitual es la vía condicional: en el Cleaner, agrega un campo de Acciones Condicionales, dale una condición como total > 10,000, agrega la acción Human in the Loop y elige sus revisores. Solo se detienen los Runs que cumplen la condición. El interruptor del Flow puede quedarse apagado.
Cuando una regla del Cleaner dispara la pausa, Tavnit registra qué filas y qué campos cumplieron la condición. La pantalla de revisión marca exactamente esas celdas, así el revisor empieza por el motivo de la pausa en lugar de leer toda la tabla. Si la regla se alimenta de un campo de Anomalías, el revisor también ve el motivo por el que se marcó cada valor.
Activar la revisión en un Flow
El interruptor está en la configuración del propio Flow. Solo un Propietario o un Administrador puede cambiarlo. Los revisores se eligen entre los miembros de tu organización.
- 1Abre el Flow y selecciona el panel Revisión Humana en su barra lateral.
- 2Activa el interruptor.
- 3En Revisores, elige uno o más miembros de tu organización.
- 4Procesa un documento y confirma que aparece como Esperando revisión en la cola de Revisión Humana de los revisores.
Con la revisión activada y sin revisores asignados, el panel advierte “Sin revisores seleccionados — las aprobaciones no llegarán a nadie.” Los Runs pausados se quedan sin nadie que pueda aprobarlos. Asigna al menos un revisor antes de enviar documentos.
Cuando el Flow tiene un Cleaner, la pausa ocurre después de la limpieza, así que la tabla en revisión es la salida limpia, con monedas convertidas, fechas reformateadas y columnas calculadas. Eso es lo que se va a entregar, así que es lo que conviene revisar.
Campos de Entrada Humana
Un campo de Entrada Humana es una columna del Cleaner que nunca se extrae: la completa un revisor en la pantalla de revisión. Úsalo para un centro de costo, una cuenta contable, un código de aprobación interno o cualquier dato que el documento no puede darte.
| Opción | Qué hace |
|---|---|
| Free text | El revisor escribe el valor. |
| Menu | El revisor elige entre los valores distintos de una columna de un Bucket (Options Bucket y Options Column), con filtros opcionales, incluidos filtros sobre los campos de la fila actual. |
| Value is mandatory | Bloquea la aprobación hasta que todas las filas tengan un valor. Apágalo para permitir valores vacíos. |
| Revisores | Quién puede completar el campo y aprobar; se combinan con los revisores del Flow. |
Todo Run que pasa por un Cleaner con un campo de Entrada Humana se pausa para revisión, esté o no activado el interruptor del Flow. En la pantalla de revisión, la columna aparece marcada como Requiere entrada humana con el conteo de filas completadas, y Aprobar queda bloqueado (“Completa todos los valores de entrada humana obligatorios para aprobar”) hasta que estén todos los valores obligatorios.
La cola de revisión
La página Revisión Humana de la barra lateral lista todo lo que te espera, del más reciente al más antiguo. Solo muestra los elementos en los que eres revisor; los revisores no ven las colas de los demás.
- Cifras resumen arriba: Esperando Revisión, Más Antigua Pendiente, Tu Rol y Flows con HITL
- Una tarjeta por elemento: el nombre del archivo y el Flow de un Run, con una etiqueta Match o Rellenado para esos tipos, y el estado Esperando revisión
- Un punto rojo en el ícono de la barra lateral siempre que algo te espera. Se actualiza en tiempo real, sin recargar la página
- Los revisores asignados también reciben un email con un enlace directo en cuanto un Run, un Match, una inspección o un rellenado los necesita
Revisar un Run
La pantalla de revisión es una vista dividida: la tabla extraída a la izquierda y el documento original a la derecha. Verificas un valor contra el original sin salir de la página, lo corriges ahí mismo y apruebas. El divisor se puede arrastrar y, en el celular, cambias entre los dos paneles.
| En la tabla de datos puedes | Cómo |
|---|---|
| Editar un valor | Doble clic en la celda y escribe. |
| Cambiar muchas celdas a la vez | Selecciona arrastrando, con Shift+clic o haciendo clic en el encabezado de una columna, y luego Aplicar a seleccionadas. |
| Quitar una fila de la salida | Desmárcala. Las filas excluidas no se entregan. |
| Agregar o quitar una columna | Usa Agregar columna o Eliminar columna. Una columna eliminada se puede restaurar antes de aprobar. |
| Ver qué disparó la pausa | Las celdas que cumplieron una regla del Cleaner aparecen marcadas. |
| Completar campos de Entrada Humana | Escribe el valor o elígelo del menú. |
| Ver lo que cambiaste | Las celdas editadas siguen resaltadas hasta que apruebas. |
- El panel del documento muestra PDFs con navegación por páginas y también imágenes; las hojas de cálculo se pueden descargar
- Ajustar al ancho, Ajustar a la altura y zoom manual; arrastra para desplazarte
- Ctrl/Cmd + y − para hacer zoom, Ctrl/Cmd + 0 para restablecer
Aprobar y rechazar
Aprobar incorpora tus ediciones al Run y lo libera. Rechazar cancela el Run y no entrega nada. Ambas decisiones son definitivas para ese Run: la pausa es un control de una sola vez, no un estado que puedas alternar.
| Decisión | Qué pasa con el Run | Qué se entrega |
|---|---|---|
| Aprobar | Tu tabla editada reemplaza la salida extraída y el Run continúa hasta Completado, con la insignia HITL Aprobado. | Todo lo que el Flow tiene configurado: email de salida, webhook, exportación al Bucket, llenado de formularios y el Agente vinculado, todo con los datos aprobados. |
| Rechazar | El Run pasa a Cancelado, con la insignia HITL Rechazado, y se registra tu razón (opcional pero recomendada). | Nada. Ni email, ni webhook, ni fila en el Bucket, ni Run del Agente. |
No hace falta que aprueben todos los revisores asignados. La primera aprobación o rechazo resuelve el Run; si otro revisor lo tenía abierto, su decisión se rechaza porque el Run ya no está esperando aprobación. Actualiza la cola para ver el estado actual.
La página del Run muestra quién decidió (Aprobado por o Rechazado por).
Otras cosas que esperan revisión
Los Matchers, los Inspectores y los Fillers tienen su propia configuración de revisión, y sus elementos pausados llegan a la misma cola, con la misma regla de que gana la primera decisión y el mismo registro de auditoría.
| Elemento | Cuándo se pausa | Qué hace el revisor |
|---|---|---|
| Match | Cuando la revisión humana está activada en el Matcher: todos los Matches. | Verifica y corrige el emparejamiento de filas entre documentos que hizo la IA, puede excluir filas, y luego aprueba o rechaza. |
| Inspección | Cuando la revisión humana está activada en el Inspector, o cuando un check que falla pide revisión con sus acciones en caso de fallo. | Exonera los checks que fallan indicando una razón y aprueba para cerrar el veredicto, o rechaza para cancelar la inspección. |
| Rellenado | Cuando la revisión humana está activada en el Filler, o siempre que tenga campos de Rellenado humano asignados. | Revisa los formularios llenados, escribe los valores de Rellenado humano y aprueba para liberar los formularios, o rechaza. |
Quién puede revisar
Solo las personas asignadas como revisores pueden aprobar o rechazar un Run de un Flow. Ser Administrador no basta: un Administrador que no está en la lista de revisores no recibe el Run en su cola y no puede aprobarlo.
- Las listas de revisores del Flow las administra un Propietario o un Administrador
- La acción Human in the Loop de un Cleaner y cada campo de Entrada Humana tienen sus propios revisores, que se combinan con los del Flow
- Cualquier miembro puede ser revisor, sea cual sea su rol
- El rol Solo HITL está pensado para revisores: esos miembros solo ven la cola de Revisión Humana y pueden revisar, pero no pueden ejecutar ni cambiar nada más
Consulta roles de usuario y permisos para ver qué puede cambiar cada rol.
El registro de auditoría inalterable
Cada acción de revisión se escribe en un registro permanente, de solo anexar, con fecha y hora y la identidad del revisor. Las entradas no se pueden editar ni borrar, así que el registro de quién cambió qué, y de cómo estaban los datos antes de tocarlos, sobrevive a la revisión.
| Evento registrado | Cuándo se escribe |
|---|---|
| Revisores notificados | El Run entra en la cola de revisión y se envía el email a los revisores. |
| Celda editada | Se cambia un valor, con el valor anterior y el nuevo. |
| Fila agregada / fila eliminada | El revisor agrega una fila o excluye una. |
| Columna agregada / columna eliminada | El revisor cambia la forma de la tabla. |
| Aprobado | La decisión, el revisor y cuántas ediciones se hicieron. |
| Rechazado | La decisión, el revisor y la razón indicada. |
Tavnit guarda la salida tal como estaba antes de que el revisor la tocara, junto a la versión aprobada. Un auditor puede comparar la extracción con el resultado entregado sin tener que reconstruirlo a partir del registro de eventos.
Solución de problemas
| Síntoma | Causa probable y solución |
|---|---|
| Los Runs se pausan aunque el interruptor del Flow está apagado | El Cleaner del Flow tiene una regla de Acciones Condicionales con la acción Human in the Loop, o un campo de Entrada Humana. |
| Un Run está Esperando aprobación pero no aparece en mi cola | No estás en su lista de revisores. Pide a un Propietario o Administrador que te agregue en el Flow (o en la regla del Cleaner que lo pausó). |
| Al aprobar, se rechaza porque no eres revisor configurado | Solo los revisores asignados pueden decidir. Si no se asignó ninguno, agrega uno en el Flow; nadie más puede liberar el Run. |
| Al aprobar, se rechaza porque el Run ya no espera aprobación | Otro revisor decidió primero. Actualiza la cola. |
| Aprobar está bloqueado por falta de entrada humana | Un campo de Entrada Humana obligatorio sigue vacío en algunas filas. Complétalas, o haz el campo opcional en el Cleaner. |
| El Agente vinculado no se ejecutó | Solo se ejecuta después de la aprobación. Un Run rechazado nunca lo inicia. |
Un Run pausado espera lo que haga falta. Si los resultados alimentan un proceso con plazos, asegúrate de que los revisores estén pendientes de su cola o de su email, o limita la pausa a las excepciones con una regla del Cleaner.