Hooks para agentes: 7 pruebas antes de ejecutar herramientas
AWS añadió hooks deterministas antes y después de invocaciones y herramientas. El valor no está en acumular callbacks, sino en ubicar cada política en el último punto donde todavía puede impedir una acción y demostrarlo con pruebas adversariales.
- Publicado
- min de lectura
- 6 min de lectura
- Categoría
- Sistemas IA
En esta página
6 capítulos- 01La pregunta no es si el agente puede actuar, sino quién autoriza
- 02Qué puede detener cada una de las cuatro fronteras
- 03Separa capacidad, autorización y evidencia
- 04Ejemplo hipotético: reembolsos con aprobación escalonada
- 05Las siete pruebas antes de ampliar autonomía
- 06Cómo desplegar sin convertir el hook en un punto ciego

Capítulo 02
Qué puede detener cada una de las cuatro fronteras
before_invocation valida la solicitud antes de que el agente empiece, pero su contexto contiene los mensajes de la llamada actual antes de restaurar el estado de sesión. Es apropiado para identidad, tenant, propósito, presupuesto o consentimiento de la operación solicitada. before_tool_call recibe nombre, tipo, identificador e input propuesto de la herramienta; es el gate natural para monto, destino, alcance, clasificación de datos e idempotencia antes de ejecutar. Cuando niega, la herramienta se omite y el loop puede continuar para explicar o escalar.
after_tool_call observa un resultado ya producido. Puede impedir inferencia posterior y evitar que el agente encadene otra acción, pero no deshace el efecto de la herramienta. after_invocation recibe el motivo de parada y uso de tokens cuando la invocación terminó; sirve para contabilidad, alertas y revisión, no para autorización. La regla de diseño es simple: coloca una condición en la frontera más temprana que tenga suficiente evidencia y nunca uses un hook posterior como sustituto de un control preventivo.
| Frontera | Decisión útil | Límite |
|---|---|---|
| Antes de invocar | Aceptar propósito, actor y presupuesto | Aún no ve el tool call |
| Antes de herramienta | Autorizar parámetros y efecto | Debe responder dentro del timeout |
| Después de herramienta | Validar resultado antes de continuar | El efecto ya ocurrió |
| Después de invocar | Auditar cierre y consumo | No puede retirar la salida |
Capítulo 03
Separa capacidad, autorización y evidencia
Un hook no reemplaza mínimo privilegio. AgentCore permite fijar allowedTools; si se omite o usa un comodín, el conjunto administrado puede ganar capacidades cuando evoluciona el harness. Un producto con frontera fija debe enumerar herramientas concretas y separar lectura, escritura y edición. Después, la identidad de ejecución limita recursos; finalmente, el hook decide si una llamada permitida también está autorizada para este actor, objeto, instante y propósito. Son tres capas distintas: poder técnico, permiso de infraestructura y política de negocio.
La evidencia también necesita su propio contrato. Los hookEvent del stream confirman qué hook se ejecutó y, para Lambda, qué decisión se aplicó. En cambio, un evento de SNS o EventBridge solo confirma que el despacho fue programado, no que el consumidor lo recibió. Conserva hookEventId, sessionId, toolUseId, versión de política, decisión, razón y referencia al efecto en un sistema de registro duradero. Evita copiar payloads sensibles completos cuando basten hashes, identificadores y campos mínimos para reconstruir la decisión.
Capítulo 04
Ejemplo hipotético: reembolsos con aprobación escalonada
Imagina un agente de soporte que consulta pedidos y propone reembolsos. El caso es hipotético y no representa un cliente ni resultados de Wasyra. before_invocation comprueba que el operador pertenece al tenant y que el usuario pidió resolver ese pedido. La identidad del runtime solo puede leer órdenes del tenant y llamar a una función de reembolso acotada. before_tool_call valida moneda, monto, pedido, razón, ventana de devolución, beneficiario e idempotency key. Hasta un umbral bajo permite; por encima devuelve deny y crea una solicitud humana en un sistema separado.
La herramienta devuelve un providerTransactionId. after_tool_call verifica que el resultado corresponde al pedido y registra estado incierto cuando hay timeout, en vez de reintentar a ciegas. El agente puede explicar que el caso fue escalado, pero no puede convertir una negación en una herramienta alternativa con el mismo efecto. Para eso, todas las rutas equivalentes comparten una taxonomía de efectos y una misma política. Los tool hooks también se aplican a subagentes, lo que reduce un bypass por delegación; aun así, debes probar aliases, funciones inline y gateways que materialicen el mismo efecto.
Capítulo 05
Las siete pruebas antes de ampliar autonomía
Prueba 1, efecto bloqueado: una negación antes de herramienta debe producir cero llamadas al proveedor. Prueba 2, equivalencias: aliases, subagentes y funciones inline no pueden eludir la misma política. Prueba 3, fallo cerrado: timeout, excepción y respuesta inválida de Lambda deben adoptar el failureMode esperado; para acciones irreversibles, el valor defendible suele ser deny. Prueba 4, contexto truncado: los payloads de hook se limitan a 64 KiB y marcan campos truncados; si la política necesita datos ausentes, debe negar o consultar un registro confiable, nunca asumir.
Prueba 5, concurrencia: cuando varios hooks Lambda comparten evento, se ejecutan en paralelo y cualquier deny aplica; verifica que la razón visible y las dependencias entre políticas sean deterministas. Prueba 6, reintento e idempotencia: una conexión cortada no puede duplicar el efecto y un resultado incierto debe reconciliarse antes de reejecutar. Prueba 7, evidencia completa: correlaciona solicitud, decisión, tool call, resultado y efecto final; además alerta cuando el canal asíncrono no entrega. Ejecuta casos allow y deny, límites exactos, datos malformados, tenants cruzados, replay y degradación de dependencias.
Capítulo 06
Cómo desplegar sin convertir el hook en un punto ciego
Empieza en sombra: calcula la decisión y registra divergencias sin bloquear, pero solo con operaciones reversibles o simuladas. Después activa deny para una clase estrecha de alto riesgo, mide latencia p50/p95/p99, timeouts, razones de negación, apelaciones humanas, falsos positivos y efectos sin evidencia completa. Versiona configuración y función como una sola unidad. La actualización de hooks reemplaza la lista suministrada, así que prueba el documento completo y detecta eliminaciones accidentales antes de promoverlo.
Los límites siguen siendo importantes. Un hook síncrono añade latencia y disponibilidad a la ruta crítica. after_tool_call no revierte el mundo externo. Un resultado inline enviado por el cliente demuestra que el harness lo procesó, no que la acción ocurrió realmente; autentica al caller y valida contra el sistema de registro. Tampoco confundas deny con una estrategia completa: necesitas consentimiento, segregación de funciones, límites de tasa, reconciliación y rollback donde exista. La decisión de avanzar llega cuando las siete pruebas pasan en un entorno representativo y cada negación tiene una ruta de recuperación comprensible.
Si estás diseñando un agente con herramientas reales, convierte primero cada acción en un contrato de efecto: quién puede pedirla, qué campos son obligatorios, qué gate la autoriza, cómo falla, cómo se reconcilia y qué evidencia demuestra el resultado. Wasyra puede ayudarte a diseñar y validar ese slice operativo sin mezclarlo con el producto Agents, que vive por separado en agents.wasyra.com.
Escrito por
Wasyra Lab
Arquitectura de sistemas IA y operaciones
Wasyra Lab publica marcos prácticos para diseñar agentes de IA, automatizaciones y flujos operativos que sí sobreviven producción.
Serie
Sistemas IA que sí llegan a producción
Una serie sobre agentes, copilots y guardrails para llevar IA al trabajo real sin romper confianza ni operación.
Posts de esta serieMás de este autor
Más de este autor
Sistemas IA
Post-training científico: 7 gates de evidencia
Nemotron for Science abre el post-training científico. Estos siete gates evitan optimizar un proxy, contaminar la prueba o desplegar falsas mejoras.
ArtículoSistemas IA
Agentic RL: cómo leer MLPerf Training 6.1
MLPerf ya mide post-training de agentes. Aprende a leer tiempo hasta calidad, límites del workload y señales útiles para decidir infraestructura.
ArtículoSigue leyendo
Sigue leyendo
Sistemas IA
Post-training científico: 7 gates de evidencia
Nemotron for Science abre el post-training científico. Estos siete gates evitan optimizar un proxy, contaminar la prueba o desplegar falsas mejoras.
ArtículoSistemas IA
Agentic RL: cómo leer MLPerf Training 6.1
MLPerf ya mide post-training de agentes. Aprende a leer tiempo hasta calidad, límites del workload y señales útiles para decidir infraestructura.
ArtículoSistemas IA
Agent skills portables: contratos de producción
Una skill portable no traslada permisos ni garantías. Siete contratos separan instrucciones, herramientas, aprobación, pruebas y rollback.
Artículo