Human-in-the-Loop

¿Qué es Human-in-the-Loop?

Una puerta Human-in-the-Loop (HitL) detiene un flujo de trabajo en un paso específico y espera a que un humano revise el resultado y decida si continuar. No sucede nada irreversible hasta que tú lo digas.

HitL no es un tipo de paso separado: es una marca en cualquier paso que produzca resultados que requieran revisión. Cuando approvalRequired: true, la ejecución se detiene después de que se completa ese paso, le muestra el resultado y espera su decisión antes de pasar al siguiente paso.

Configuración

{
  id: "draft_email",
  type: "aiAction",
  // ... step config ...

  next: {
    conditions: {
      approvalRequired: true,
      approveLabel: "Send email",     // optional — customize the approve button
      approvers: [                    // optional — notify specific team members
        { userId: "user_abc" }
      ]
    }
  }
}

Después de ejecutar el paso, el estado de ejecución pasa a ser pendiente de aprobación. Permanece en pausa indefinidamente hasta que alguien lo apruebe o rechace.

Lo que ve el revisor

El revisor obtiene el resultado completo del paso (borrador del cuerpo del correo electrónico, datos enriquecidos, resultados puntuados) presentado en el panel de ejecución. Desde allí pueden:

• •Aprobar — El flujo de trabajo continúa con el siguiente paso. Para los pasos de correo electrónico, la aprobación activa la acción de envío.
• •Rechazar — Se cierra la ejecución sin proceder. El rechazo se registra con una marca de tiempo.
• •Editar y aprobar — Para los tipos de pasos admitidos (correo electrónico, texto), el revisor puede modificar el resultado antes de aprobarlo. La versión editada es la que se utiliza posteriormente.

Notificaciones

Cuando la ejecución se detiene para su aprobación, se notifica a los revisores a través de:

• •Panel — La ejecución aparece en Necesita tu atención con placa pendiente. Siempre encendido.
• •Correo electrónico — Notificación enviada al propietario del flujo de trabajo o a los aprobadores especificados. Incluye un enlace directo a la página de revisión.
• •Slack — Configurar a través de la configuración de notificación del espacio de trabajo. El mensaje incluye el resumen de resultados del paso y un enlace de aprobación/rechazo.

Comportamiento del tiempo de espera

De forma predeterminada, las puertas HitL esperan indefinidamente: no hay tiempo de espera auto-approve o auto-reject. La ejecución permanece en estado pendiente hasta que un humano actúa. Si necesita la aprobación time-bounded (por ejemplo, auto-reject después de 48 horas), combine HitL con un Agente proactivo que monitorea ejecuciones pendientes y obsoletas y notifica o escala automáticamente.

Ejemplo: revisión de extensión

Un flujo de trabajo de extensión empresarial local:

Próximos pasos

• Proactive Agents — Supervise las aprobaciones obsoletas y escale automáticamente
• Auto-Fix — Recuperación de errores autónoma cuando no es necesaria la revisión humana
• Agents como paso — Combine los pasos del agente con puertas de aprobación para la automatización supervisada