Documentation is being updated. Some sections may not reflect the latest features.

Nodo Human in the Loop

Pausar su workflow y esperar la aprobación humana antes de continuar.

Descripción general

El nodo Human in the Loop pausa su workflow y espera a que una persona revise y apruebe o rechace antes de que el flujo continúe. Esto es útil cada vez que necesita juicio humano antes de proceder — revisar contenido generado por IA, aprobar reembolsos, validar datos antes de enviarlos, etc.

Cómo funciona

  1. El workflow llega al nodo Human in the Loop y pausa la ejecución.
  2. Se presenta al revisor el prompt/instrucciones que configuró, junto con los datos que eligió mostrar.
  3. El revisor hace clic en Approve o Reject.
  4. El flujo continúa por el puerto de salida correspondiente.

Si nadie responde dentro del timeout configurado, el nodo aprueba o rechaza automáticamente según su configuración de On Timeout.

Configuración

Prompt / Instrucciones

Indique al revisor qué necesita hacer. Este es el mensaje que verá cuando el flujo esté esperando su respuesta.

Ejemplos:

  • "Revise este borrador de correo electrónico antes de enviarlo al cliente."
  • "Apruebe o rechace esta solicitud de reembolso por {{amount}}."
  • "Verifique la precisión del resumen generado por IA."

Datos a mostrar

Especifique qué variables del workflow mostrar al revisor para que tenga el contexto necesario para tomar una decisión. Use la sintaxis de plantillas para referenciar variables de pasos anteriores.

Ejemplos:

  • {{email_body}}
  • {{refund_amount}}, {{customer_name}}
  • {{ai_summary}}

Este campo es opcional. Si se deja vacío, el revisor solo verá el prompt.

Timeout

Cuánto tiempo espera el nodo una respuesta humana antes de ejecutar la acción automática. Ingrese un número y seleccione la unidad.

  • Valor: Cualquier número positivo (predeterminado: 24)
  • Unidad: Minutos, Horas o Días (predeterminado: Horas)

Al expirar el timeout

Qué sucede cuando el timeout expira sin respuesta:

Opción Comportamiento
Auto-approve El flujo continúa por el puerto APPROVED
Auto-reject El flujo continúa por el puerto REJECTED

El predeterminado es Auto-reject.

Salidas

Puerto Se activa cuando
APPROVED El revisor hace clic en Approve, o el timeout activa auto-approve
REJECTED El revisor hace clic en Reject, o el timeout activa auto-reject

Ejemplos

Revisión de contenido

Un modelo de IA genera un correo electrónico para el cliente. Antes de enviarlo, un humano lo revisa y aprueba.

[Model] → [Human in the Loop] → APPROVED → [Send Email]
                               → REJECTED → [Revise Draft]

Aprobación de reembolso

Un cliente solicita un reembolso. El flujo recopila los detalles del pedido, luego un gerente aprueba o deniega.

[Query Data] → [Human in the Loop] → APPROVED → [Process Refund]
                                   → REJECTED → [Send Denial Email]

Puerta de validación de datos

Antes de escribir datos transformados en una base de datos de producción, un miembro del equipo verifica que la salida sea correcta.

[Data Mapper] → [Human in the Loop] → APPROVED → [Write Data]
                                    → REJECTED → [Log & Alert]

Consejos

  • Mantenga el Prompt claro y orientado a la acción. El revisor debe saber exactamente qué buscar.
  • Use Data to Display para mostrar las variables más relevantes — no obligue al revisor a buscar contexto.
  • Establezca un Timeout razonable según su caso de uso. Una aprobación de reembolso puede necesitar 48 horas; una revisión de contenido antes de un envío programado quizás solo 1 hora.
  • El valor predeterminado de On Timeout es reject, que es la opción más segura para la mayoría de los workflows. Cambie a auto-approve solo cuando la acción predeterminada deba ser continuar.
AI AssistantPowered by Ubex
Beta
Ask me anything about Ubex workflows, nodes, or the API.
~/

Hola 👋

¿Cómo podemos ayudarte hoy?