Especificar y delegar en el bucle HITL
¿Cuál es la diferencia entre pulsar «Aceptar a todo» lo que propone un agente y dirigir realmente el desarrollo en un bucle HITL (Human-in-the-Loop)? Si pides un deseo ambiguo («hazme el módulo de facturación») y dejas que el agente modifique decenas de archivos de golpe sin un modelo acordado, aunque te pida confirmación al final ya habrás perdido el gobierno del sistema: no sabrás qué supuestos tomó sobre los datos, los permisos o los casos límite.
Objetivos y conocimientos previos
Partiendo de Investigar y contrastar y del análisis de casos límite del Curso V, aprenderás a distinguir con precisión entre Modelo, Chat, Agente y Harness, a recorrer las seis etapas del bucle HITL, a redactar una especificación lógica de delegación en lugar de un prompt improvisado, y a separar la fase de planificación de la codificación.
Del Chat a la construcción: Modelo, Chat, Agente y Harness
A lo largo de los cursos hemos insistido en que programar no es codificar: programar es concebir la lógica, las estructuras de datos y las reglas del sistema; codificar es expresar esa lógica en un lenguaje formal.
En la práctica post-2024, cuando pasas de estudiar una idea a construir un proyecto real con IA, intervienen cuatro piezas distintas que debes diferenciar como sistemas:
| Pieza | Qué es | Función principal | Límite que debes tener presente |
|---|---|---|---|
| 1. Modelo (LLM) | El motor de lenguaje e inferencia estadística. | Comprender instrucciones, razonar sobre el contexto recibido y generar texto o código. | Por sí solo no tiene manos ni memoria persistente del proyecto; solo responde a la entrada que recibe en cada llamada. |
| 2. Chat | Una interfaz conversacional por turnos conectada a un Modelo. | Aprender, explorar problemas, razonar socráticamente y despejar dudas conceptuales fuera del proyecto. | No lee directamente tu repositorio ni ejecuta pruebas reales en tu entorno; si copias y pegas código suelto desde un chat, pierdes el contexto del sistema. |
| 3. Agente | Un sistema que envuelve al Modelo en un bucle autónomo de decisión y acción orientado a un objetivo. | Planificar pasos, consultar archivos, escribir o modificar código, observar resultados de pruebas y corregir errores iterativamente. | Sin una especificación lógica clara, puede tomar decisiones de negocio arbitrarias o modificar más piezas de las necesarias para lograr que «algo funcione». |
| 4. Harness (Entorno o arnés de trabajo) | La infraestructura de software donde vive y opera el Agente sobre tu proyecto real. | Conectar al Agente con las herramientas del entorno (archivos, compilador, pruebas, terminal, control de versiones) e imponer las riendas, permisos, límites de seguridad y puntos de revisión humana. | El harness te da los mandos y frenos técnicos, pero no piensa las reglas de tu negocio por ti: la dirección lógica sigue siendo tuya. |
Observa la relación entre los cuatro: utilizas el Chat para pensar, investigar y afinar tu comprensión; y cuando ya has programado la lógica (tus reglas, datos e invariantes), utilizas un Agente dentro de un Harness para delegar la codificación y la ejecución de comprobaciones bajo tu gobierno.
Anatomía completa del bucle HITL
En el paradigma post-2024, HITL (Human-in-the-Loop) no significa vigilar cada pulsación de tecla del agente ni repetir a mano sus operaciones mecánicas. Significa situar la intervención humana exactamente donde se toman decisiones de alcance, reglas de dominio, garantías técnicas y evaluación de evidencia:
- 1. Observar y definir la necesidad y el estado actual del proyecto
- 2. Modelar y acordar reglas, invariantes, casos límite y criterios de aceptación
- 3. Planificar y delegar con alcance acotado y puntos de revisión explícitos
- 4. Ejecutar y observar (el agente implementa, prueba y reúne evidencias)
- 5. Contrastar evidencia frente a criterios (Validación técnica y lógica del Curso V)No cumple
- Diagnosticar el origen (modelo, supuesto o código) y volver al paso correspondiente
Sí cumple- 6. Comprobar el nuevo estado del sistema, registrar la decisión y pasar al siguiente objetivo
De un deseo ambiguo a una especificación lógica
Compara estas dos formas de encargar una funcionalidad a un agente dentro de un harness:
| Aspecto | Deseo ambiguo (Prompt improvisado) | Especificación lógica para el bucle HITL |
|---|---|---|
| Objetivo | «Añade pagos y reembolsos a las facturas». | «Implementar la transición de factura PENDIENTE a PAGADA y el registro de reembolsos mediante movimiento compensatorio». |
| Entidades y estado (Curso II) | No dice nada (el agente inventa o sobrescribe campos). | «Conservar Facturas inmutable una vez emitida; registrar cada cobro o reembolso en MovimientosPago vinculado por id_factura». |
| Invariantes y precondiciones (Curso I y V) | Implícitos. | «Solo una factura PENDIENTE admite cobro; el reembolso nunca puede superar el importe cobrado; ambos cambios ocurren en una misma transacción». |
| Fronteras y contratos (Curso III y IV) | Implícitos. | «Verificar autorización en el servidor; exigir id_intento_pago para idempotencia ante reintentos de red». |
| Fuera de alcance | Nada (el agente puede alterar pantallas o módulos que no pediste). | «No modificar estilos visuales ni la exportación de documentos en esta tarea». |
| Evidencia exigida (Curso V) | «Asegúrate de que funcione». | «Aportar pruebas reales de: cobro válido, intento de doble cobro con la misma clave de idempotencia, intento sobre factura anulada y rechazo de reembolso superior al saldo». |
Separar la fase de planificación de la fase de ejecución
Uno de los hábitos más eficaces al trabajar con agentes consiste en separar la conversación de diseño de la ejecución de cambios:
- Fase de exploración y propuesta (Sin editar archivos): Pides al agente que inspeccione los archivos actuales del proyecto, revise tu especificación, señale cualquier contradicción o caso límite que falte definir y te proponga un plan breve de qué piezas tocará y cómo lo verificará.
- Acuerdo del modelo: Respondes a sus dudas, corriges cualquier supuesto erróneo (por ejemplo, si pensaba hacerlo en memoria en vez de en una transacción de base de datos) y apruebas el plan.
- Fase de ejecución acotada: Con el modelo ya despejado, autorizas al agente a implementar y ejecutar las comprobaciones acordadas.
Acordar el plan antes de tocar archivos evita el 80 % de las reescrituras y malentendidos.
Qué delegar y dónde reservar revisión humana obligatoria
No todas las acciones dentro de un proyecto tienen el mismo perfil de riesgo:
- Alto grado de delegación: explorar en qué parte del proyecto está definida una entidad, redactar casos de prueba adicionales siguiendo la matriz que tú diseñaste, transformar formatos o aplicar una regla ya acordada y acotada.
- Revisión humana obligatoria antes de consolidar: cambiar esquemas de tablas y datos persistentes, modificar reglas de autenticación y autorización, incorporar nuevas dependencias externas, alterar contratos públicos entre componentes o ejecutar operaciones sobre datos reales.
Practica
Quieres incorporar al sistema de reservas una Lista de Espera: cuando una actividad de 10 plazas esté llena (0 plazas libres), un socio activo puede apuntarse a la lista de espera; cuando alguien con reserva activa la cancele, la primera persona en espera pasa a ocupar la plaza.
Un compañero te propone enviar directamente este mensaje al agente: «Crea una lista de espera automática cuando no queden plazas y que cuando alguien cancele le pase su plaza al siguiente de la lista».
- Antes de permitir que el agente escriba código, identifica tres reglas o casos límite que ese mensaje deja en el aire (piensa en unicidad por socio, qué ocurre si la actividad ya empezó, o si la cancelación y la promoción del siguiente en espera deben ocurrir dentro de una misma transacción atómica).
- Redacta la especificación lógica completa (Objetivo, Entidades y estados, Invariantes, Fronteras/Seguridad, Fuera de alcance y Evidencia exigida) que le entregarías al agente.
- Escribe la instrucción inicial que le darías para que primero planifique y te pregunte dudas sin modificar todavía ningún archivo del proyecto.
Criterio de comprensión: debes explicitar que un socio no pueda estar duplicado en la misma lista de espera ni en la reserva activa, que el paso de «liberar plaza + promover al primero en espera» sea transaccional para que nadie externo robe la plaza en medio, y exigir una fase previa de revisión del plan antes de editar código.
Profundiza con IA
Aquí tienes mi especificación lógica para la Lista de Espera: [tu respuesta]. Actúa como el agente en la Fase 1 (Exploración y planificación sin escribir código): examina mi especificación con lupa, señala dos casos límite o supuestos técnicos adicionales que deberíamos dejar cerrados antes de implementar, y propónme el plan de verificación.
Siguiente lectura
Incluso con una especificación clara y un buen plan, si intentamos construir un módulo grande de un solo salto perderemos la capacidad de auditar y deshacer errores con limpieza. ¿Cómo dividimos el trabajo en pasos seguros? Continúa con Unidades de trabajo atómicas, reversibilidad y trazabilidad.