El human in the loop aplicado a los agentes de IA significa que el agente se detiene en puntos definidos y espera a una persona. Hay dos tipos de parada: los pasos que solo puede dar una persona (un inicio de sesión, un código 2FA, un pago) y los pasos que una persona debe valorar (fusionar, publicar, enviar). Un buen traspaso de control nombra el paso, mantiene al agente esperando en lugar de adivinar y reanuda la ejecución solo ante una acción humana real.
Los agentes de IA con human in the loop son fáciles de describir y difíciles de construir bien. La mayoría de los equipos empiezan con una regla («una persona revisa antes de fusionar») y descubren los huecos después: el agente que se queda atascado ante un aviso de 2FA a las 2 de la madrugada, o el que hace clic en una página de pago porque nada le indicó que debía detenerse.
Browse, la herramienta de navegador de OpenCode para agentes de programación, incluye un diseño de traspaso de control sencillo que resuelve bien el primer tipo de parada. Esta guía repasa qué hace, hasta dónde llega y cómo trasladar ese mismo patrón a un tablero de tareas compartido en Sharkly, donde vive el segundo tipo de parada.
Qué significa human in the loop para los agentes de IA
El human in the loop (HITL) para agentes de IA es un diseño en el que un agente se detiene en puntos de control con nombre, cede el control o una decisión a una persona y solo continúa cuando esa persona actúa. El punto de control forma parte del flujo de trabajo, no es una excepción. El agente sabe que existe, la persona sabe que es responsable de él y el sistema registra quién actuó.
La comunidad de seguridad lo trata como un control, no como una cortesía. La entrada de OWASP sobre agencia excesiva recomienda el control human in the loop «para exigir que una persona apruebe las acciones de alto impacto antes de llevarlas a cabo».
Dos tipos de puntos de control humanos
No todas las pausas son una revisión. Mezclar los dos tipos hace que las configuraciones HITL se sientan lentas y aun así se les escapen cosas.
| Paso solo para una persona | Paso de juicio | |
|---|---|---|
| Ejemplos | Inicio de sesión, aviso de 2FA, captcha, pago, pantalla de consentimiento | Fusionar un PR, publicar una entrada, enviar un correo, cerrar un ticket |
| Por qué una persona | El agente no tiene la credencial, o nunca debería tenerla | El agente puede actuar, pero el resultado requiere el criterio de una persona |
| Cuándo ocurre | A mitad de la ejecución, a menudo de forma impredecible | Al final de una ejecución, o antes de una acción irreversible |
| Cuánto tarda | Segundos | De minutos a un día |
| Qué reanuda el trabajo | La persona completa el paso y luego indica que continúe | La persona aprueba, rechaza o pide cambios |

El primer tipo necesita rapidez y una señal precisa. El segundo necesita contexto y un registro.
Qué hace bien el traspaso de control de Browse
Browse es «un servidor MCP y una extensión de Chromium» que permite a los agentes de programación usar tu navegador real, con tus pestañas y tus sesiones iniciadas. Su repositorio de código fuente tiene licencia MIT. Cuando un agente se encuentra con un inicio de sesión, un aviso de 2FA o un pago, te devuelve la pestaña y continúa en cuanto pulsas Continuar.
Hay seis decisiones de diseño en ese traspaso de control que merece la pena copiar:
- El paso está delimitado a una pestaña y un sitio. La tarjeta de traspaso de control de la página muestra el origen del sitio, de modo que sabes exactamente dónde estás actuando.
- El agente pregunta en lugar de adivinar. Tras una navegación, Browse informa de muros de captcha y páginas de «acceso denegado» y le indica al agente que te ceda las interactivas. Según el README: «Nunca los resuelve».
- Solo una acción humana real reanuda la ejecución. «Solo un clic real en la tarjeta o en el botón de la barra de herramientas finaliza un traspaso de control, así que una página no puede falsificarlo». Una página maliciosa no puede pulsar Continuar en tu nombre.
- El estado se ve de un vistazo. La insignia de la barra de herramientas muestra RUN mientras un agente trabaja y WAIT cuando te necesita.
- La persona puede recuperar el control en cualquier momento. Si pulsas el botón de la barra de herramientas mientras un agente está en ejecución, recuperas la pestaña.
- Los límites se etiquetan con honestidad. El README califica
allowedOriginsyreadOnlyde «barandillas, no una frontera de datos», y dice con claridad qué no filtran.
El punto 3 es el más importante. Un traspaso de control que una página puede completar no es un punto de control humano; es un objetivo de inyección de prompts. Si construyes tu propio paso HITL, la señal de reanudación tiene que venir de un canal al que ni el agente ni el contenido que lee puedan llegar. La entrada sobre inyección de prompts y barandillas para agentes explica por qué esa frontera resiste mejor que cualquier corrección del lado del modelo.
Dónde se queda corto un traspaso de control dentro del navegador
El traspaso de control de Browse resuelve el paso solo para una persona en un escritorio concreto. No decide si el trabajo terminado debe publicarse, ni avisa a un compañero de equipo de que tu agente está bloqueado mientras tú no estás. Eso es una frontera, no un defecto: el paso de juicio necesita un registro compartido fuera del navegador.
Lleva el traspaso de control a un tablero de tareas
Un tablero de tareas da al patrón de traspaso de control un lugar donde vivir cuando la persona no está delante de la pantalla. En Sharkly, una Tarea es el registro compartido para Personas y Agentes, y cada conversación de tarea tiene un estado: Working, Queued, Needs your reply, Needs your review, Exception, Completed o Aborted. Según la documentación sobre chatear con un agente, un traspaso de control muestra «Needs your…» solo a la persona a la que espera, y el resto ve el neutro «Needs reply» o «Needs review».
Los dos estados de Sharkly se corresponden con los dos tipos de punto de control:
- Needs your reply es el traspaso a mitad de ejecución. El agente está bloqueado esperando una entrada que solo tiene una persona: una decisión, una credencial, un archivo que falta.
- Needs your review es el paso de juicio. El trabajo está terminado y espera la aceptación.
Ambos aparecen en el módulo Task Chats de la barra lateral, y el propietario de la conversación sigue recibiendo un aviso de escritorio y una notificación de Slack. Esa es la versión a escala de equipo de la insignia WAIT de Browse.
El estado del flujo de trabajo de la tarea es una capa aparte. Según la documentación sobre la ejecución de tareas de agentes, el flujo de trabajo del tipo de tarea limita qué estados puede seleccionar un Agente, y los estados de ejecución como en cola o en ejecución no implican un estado de la tarea.

Eso te regala un tercer punto de control. Añade un estado como Ready for Release al que un agente pueda mover trabajo pero del que no pueda sacarlo, y por diseño la persona es responsable del último paso.
Un agente que se ejecuta en un Computer conectado puede fijar él mismo el estado de traspaso de control desde la CLI sharkly:
# Blocked on something only a person can do: ask, and wait
sharkly task edit COIN-142 --session-status waiting_human_reply
# Work finished: hand it back for acceptance, never mark it done
sharkly task edit COIN-142 --session-status waiting_human_review
Usa un estado de respuesta a mitad de ejecución cuando el agente no pueda continuar sin una persona. Usa el estado de revisión cuando el agente pueda continuar, pero el resultado necesite el criterio de una persona.
Cómo diseñar tus propios puntos de control humanos
Cinco pasos cubren a la mayoría de los equipos que ejecutan más de un agente de programación:
- Enumera todos los pasos que solo puede dar una persona. Inicios de sesión, 2FA, pagos, credenciales de producción, consentimiento legal. El agente debe cederlos, nunca retenerlos.
- Enumera todas las acciones irreversibles. Fusionar, desplegar, publicar, enviar, eliminar. Cada una tiene un punto de control de juicio antes, a cargo de una persona con nombre.
- Elige una señal de reanudación por punto de control. Un clic en un botón, un cambio de estado, una respuesta en la conversación de la tarea. Tiene que venir de una persona, no del contenido que lee el agente.
- Haz visible la espera. Una insignia WAIT para una persona, una fila «Needs your reply» para un equipo. Un agente bloqueado que nadie ve es una caída silenciosa.
- Escribe la frontera en las instrucciones del agente. «Detente y pregunta en las páginas de inicio de sesión» pertenece a las instrucciones del agente, no a la memoria de alguien.
La guía sobre puertas de aprobación para agentes de programación profundiza en el paso 2, y La revisión humana es el cuello de botella cubre qué pasa cuando las revisiones se acumulan.
Errores habituales con agentes human in the loop
- Revisarlo todo. Si cada acción necesita aprobación, la gente aprueba sin leer. Reserva los puntos de control para los pasos irreversibles o que necesiten una credencial.
- Dejar que el agente resuelva la barrera. Un agente que rellena un captcha o reintenta un aviso de 2FA ha convertido un punto de control en un circuito de obstáculos.
- Señales de reanudación dentro del contenido. Si una página web, un correo o un archivo pueden decir «aprobado», una inyección de prompts también puede.
- Sin responsable. «Alguien lo revisará» significa nadie. Cada punto de control necesita una persona con nombre.
Conclusión
El human in the loop funciona cuando el bucle tiene dos puertas claramente distintas: una para los pasos que solo puede dar una persona y otra para las decisiones que debe tomar una persona. El traspaso de control de Browse muestra la primera puerta bien resuelta: delimitada, visible y reanudable solo con un clic real. Un tablero compartido hace de segunda puerta y pone ambas a la vista del equipo.
Si tus agentes ya trabajan entre navegadores y repositorios, pon sus traspasos de control donde tu equipo pueda verlos. Empieza con Sharkly, asigna una tarea a un Agente y observa con qué frecuencia acaba en Needs your reply antes de añadir más puertas. Para el lado agente a agente del mismo problema, lee traspasos de control entre agentes de IA.
Preguntas frecuentes
¿Qué es human in the loop en los agentes de IA?
Es un flujo de trabajo en el que un agente se detiene en puntos definidos y espera a que una persona actúe o decida antes de continuar. Los puntos se diseñan de antemano, están a cargo de personas con nombre y solo se reanudan con una señal humana.
¿Cuándo debe un agente de IA devolver el control a una persona?
En cualquier paso que necesite una credencial que el agente no debería tener (inicio de sesión, 2FA, pago) y antes de cualquier acción irreversible (fusionar, desplegar, publicar, enviar). Todo lo demás normalmente puede ejecutarse sin paradas.
¿Puede un agente de IA resolver captchas o avisos de 2FA por su cuenta?
No debería. Browse, por ejemplo, informa de los muros de captcha y le dice al agente que ceda los interactivos al usuario, y su README afirma que nunca los resuelve. Trátalos como pasos solo para una persona.
¿Cuál es la diferencia entre un traspaso de control y una puerta de aprobación?
Un traspaso de control ocurre a mitad de ejecución: el agente no puede continuar hasta que una persona haga algo. Una puerta de aprobación se sitúa antes de un resultado: el agente podría continuar, pero una persona decide si debe hacerlo.
¿Cómo evito que una página web falsifique una aprobación humana?
Saca la señal de reanudación del alcance del contenido. Browse solo acepta un clic real en su tarjeta o en el botón de la barra de herramientas. En un tablero, usa un cambio de estado o una respuesta desde la cuenta de una persona.



