Skip to main content

Interrupt-Driven HITL & Breakpoints

PARA AGENTE IAChatGPTClaude

Patrón de diseño de sistemas de agentes con capacidad de pausa, inyección de correcciones humanas y recuperación segura del estado (Resume) antes de realizar acciones críticas.

1. Visión general del concepto y problema sistémico

La autonomía total de los agentes suena atractiva en presentaciones de marketing, pero en producción real, la autonomía 100% incontrolada es un camino directo hacia el desastre:

  • Un agente decidió optimizar la base de datos y ejecutó DROP TABLE old_logs, eliminando la tabla con los rastros de auditoría financiera.
  • Un agente envió 500 correos incorrectos a clientes reales de la empresa debido a una alucinación accidental en la plantilla del mensaje.

Interrupt-Driven HITL (Human-in-the-Loop) proporciona un equilibrio dorado entre la velocidad de la IA y la fiabilidad de la supervisión humana. En lugar de que una persona realice todo el trabajo rutinario, el agente lleva a cabo el 98% de la preparación, pero pausa la ejecución en puntos críticos predefinidos (Breakpoints).

2. Taxonomía arquitectónica y modelo mental

                       [ CICLO AUTÓNOMO DEL AGENTE ]
                                  │
                                  ▼
                     [ Preparación de acción peligrosa ]
                     (por ejemplo: DROP / UPDATE prod)
                                  │
                                  ▼
                   ┌──────────────────────────────┐
                   │    CRITICAL ACTION GATE      │
                   │ ¿Está marcada la acción como riesgosa? │
                   └──┬────────────────────────┬──┘
                      │ NO                     │ SÍ
                      ▼                        ▼
               [ Auto-llamada ]        ┌──────────────────┐
                                      │ PAUSE & SUSPEND  │
                                      │ (State to DB)    │
                                      └────────┬─────────┘
                                               │
                                               ▼
                                      [ Push Notification ]
                                      (Slack / Telegram / UI)
                                               │
                                               ▼
                                      ┌──────────────────┐
                                      │  HUMAN REVIEW    │
                                      │ • Aprobar        │
                                      │ • Editar / Mutar │
                                      │ • Rechazar / Abortar │
                                      └────────┬─────────┘
                                               │
                                               ▼
                                      ┌──────────────────┐
                                      │ RESUME EXECUTION │
                                      └──────────────────┘

3. Pipeline técnico y mecánica interna

Implementación de Interrupts en runtimes de grafos (por ejemplo, LangGraph):

  1. Declaración de Checkpoints:
    workflow.compile(
        checkpointer=MemorySaver(),
        interrupt_before=["deploy_to_production", "charge_card"]
    )
    
  2. Serialización del estado: Cuando el flujo llega al nodo deploy_to_production, la ejecución se pausa. El estado se serializa en PostgreSQL.
  3. Esperando señal: El sistema genera un enlace a un formulario de aprobación para el líder técnico. El flujo no consume memoria del proceso ni recursos GPU mientras espera.
  4. Reanudación: Al recibir una solicitud POST con la aprobación, el sistema carga el estado de la base de datos y continúa la ejecución desde el mismo lugar.

4. Escenarios prácticos de ingeniería en producción

01. Lanzamiento controlado de migraciones de bases de datos

El agente analiza el esquema, escribe la migración Drizzle/Prisma, la ejecuta en la base de datos de prueba y verifica la compatibilidad. En la etapa de despliegue en producción, se genera una tarjeta en Slack con el diff de cambios y botones "Confirmar" / "Rechazar".

02. Edición selectiva de respuestas del servicio de atención al cliente

El agente genera una respuesta personalizada a una queja de un cliente. El operador ve el texto generado, corrige una frase incorrecta y presiona el botón de envío.

5. Errores comunes, trampas y seguridad

  • Human Bottleneck (Cuello de botella humano): Si se establecen interrupciones para cada pequeño detalle (por ejemplo, cada lectura de archivo), el sistema pierde sentido, y el desarrollador comienza a hacer clic automáticamente en "Sí" debido a la fatiga de atención (Approval Fatigue).
  • Timeouts & State Staling: Si una persona aprueba una acción después de 6 horas, el contexto en el sistema puede haber cambiado (por ejemplo, el archivo ya ha sido editado por otro desarrollador). Antes de la reanudación, es necesaria una verificación de versiones (Optimistic Locking).
/ Preguntas frecuentesSchema.org FAQPage

FAQ: Interrupt-Driven HITL & Breakpoints

Una simple pregunta en el chat no garantiza atomicidad: el agente puede continuar la ejecución en segundo plano o olvidar el estado anterior. Los Interrupts son una pausa asíncrona del grafo de estado (State Graph Pause), que serializa toda la memoria y espera autorización externa (Webhook / UI Approval).
/ Enlaces internos
Todos los términos

Recursos relacionados del ecosistema

Guías prácticas, terminología clave y habilidades de agentes

Concepto del glosario

Botón de Confirmación Humana (Human-in-the-Loop / HITL)

Patrón arquitectónico de seguridad para agentes autónomos (Human-in-the-Loop) que establece puntos de control (Approval Gates) antes de realizar acciones críticas. El agente prepara la operación (pago, eliminación de base de datos, envío de correo al cliente), pero detiene su trabajo hasta recibir la aprobación explícita de una persona.

Concepto del glosario

Human-in-the-Loop (HITL)

Patrón fundamental de seguridad y arquitectura donde la ejecución autónoma de procesos se interrumpe en puntos de control definidos para la verificación y aprobación obligatoria por parte de un humano.

Guía práctica

Parte II. Cómo trabajar con Codex + optimización/seguridad/equipo

Codex no es un autocompletado de código en el chat, sino un agente de ingeniería completo: lee el repositorio, planifica cambios, edita archivos, ejecuta pruebas, revisa sus propio...

Guía práctica

Cómo hacer que los agentes de IA sean seguros: reglas de parada, aprobación humana y sandbox

Un agente en producción es un proceso que puede escribir archivos, realizar llamadas API, cambiar datos y consumir tokens de forma autónoma, sin pausas y sin tu participación en cada paso.

Noticia

Binance publica una investigación sobre el robo de $6,300 millones

La investigación vincula el robo con una versión modificada de Homebrew, una entrevista falsa y el uso de una herramienta interna de IA de Binance.

Noticia

Claude Code reduce un 99% el coste de actualizar el estado de los subagentes en segundo plano

En la versión CLI de Claude Code, Haiku 5.5 ahora actualiza el estado de los subagentes en segundo plano a partir de notas breves, lo que reduce el consumo de límites.