Guía · Humano en el circuito

Diseñar un flujo de aprobación humana para agentes

Que una persona vea un plan no significa que esté en el circuito. La decisión ha de estar ligada a una candidata, devolver un estado estructurado y frenar al agente antes de una acción controlada.

Actualizado 3 de agosto de 2026Guía práctica

Define el límite de decisión

Aclara qué acción queda bloqueada, qué candidata se revisa, quién recibe review, qué evidencia y reversión verá y cuánto se puede esperar.

Publica y espera

Valida el documento tipado antes de entrar en revisión. Mientras tanto, la versión oficial sigue estable y no se sustituye con mensajes informales.

ow a2ui draft check ./plan
ow a2ui draft build ./plan
ow a2ui digest ./plan/document.mdw
ow publish ./plan/document.mdw --review --no-open --timeout 900

Cada estado tiene una acción

approved ejecuta el alcance; changes requested reenvía; rejected detiene; timeout y error reportan falta de decisión y mantienen el bloqueo.

Evita que la aprobación se desplace

Guarda la versión fija aprobada junto a la evidencia de ejecución. La misma URL canónica no transfiere permiso a otra candidata.

Preguntas

Preguntas frecuentes

¿Basta con tener un botón de aprobar?

No. El agente debe comprobar una decisión vinculada a la candidata antes de actuar.

¿Qué ocurre si nadie responde?

Timeout es no aprobado: informa y mantén el bloqueo o espera según el flujo ya autorizado.

Usa el flujo real

Publica lo que crea tu agente.

Da a cada informe, documento o plan una página lista para sus lectores, desde la que vuelvan comentarios, decisiones y revisiones formales.