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.

Agentes IAAutorización de herramientasLifecycle hooksAgentCore
Wasyra Lab
Arquitectura de sistemas IA y operaciones
Publicado
min de lectura
6 min de lectura
Categoría
Sistemas IA
7pruebas para autorizar acciones de agentes
Un loop de agente atraviesa cuatro gates luminosos antes de completar una acción financiera controlada.

Capítulo 01

La pregunta no es si el agente puede actuar, sino quién autoriza

Una política útil se ejecuta fuera del razonamiento del modelo, recibe el contexto necesario y falla antes de que el efecto irreversible ocurra.

El 19 de noviembre de 2026, dos días calendario antes de este artículo en America/Lima, AWS anunció lifecycle hooks para Amazon Bedrock AgentCore Harness. El mecanismo permite ejecutar código determinista en cuatro momentos del loop: antes de la invocación, antes de una herramienta, después de una herramienta y después de la invocación. Una función Lambda puede devolver allow o deny; SNS y EventBridge reciben notificaciones sin bloquear el loop. Esta diferencia importa: observar una transferencia no equivale a impedirla, y registrar una respuesta terminada no permite retirar tokens que ya llegaron al usuario.

El avance no vuelve seguro a un agente por defecto. Sí crea una frontera operable entre una propuesta probabilística y una decisión de política. Para aprovecharla, el equipo debe definir capacidades explícitas, clasificar efectos, elegir el último gate preventivo, decidir cómo falla cada control y conservar evidencia correlacionable. Si esas decisiones quedan implícitas, los hooks se convierten en telemetría decorativa. Si quedan versionadas y probadas, permiten ampliar autonomía sin delegar la autorización al mismo modelo que solicita la acción.

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.

Mapa de efecto y evidencia por hook
FronteraDecisión útilLímite
Antes de invocarAceptar propósito, actor y presupuestoAún no ve el tool call
Antes de herramientaAutorizar parámetros y efectoDebe responder dentro del timeout
Después de herramientaValidar resultado antes de continuarEl efecto ya ocurrió
Después de invocarAuditar cierre y consumoNo 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.

Para harnesses creados antes del 12 de noviembre de 2026, AWS documenta eventos dobles temporales para read, write y edit hasta el 12 de diciembre. Deduplica por toolUseId y migra la política antes del retiro de file_operations.

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.

Agentes IAGuardrailsOperaciones
Más de este autor

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 serie

Sigue leyendo

Sigue leyendo