
Rastros de auditoría a prueba de manipulaciones para agentes de IA: Runtime Records encadenados por hash, sin dependencias, verificables por cualquiera.
Rastros de auditoría a prueba de manipulación para agentes de IA — Runtime Records encadenados por hash, renderizados como un Runtime Report que tus clientes pueden verificar por sí mismos.
Cada acción que captura tu instrumentación (llamadas a herramientas, llamadas a modelos, acceso a datos, aprobaciones) se convierte en un Runtime Record en un registro de solo adición encadenado por hash; el Runtime Report es esa cadena renderizada como una página HTML que recalcula la cadena de hash en el navegador del lector y renderiza lo que muestra a partir de los registros que verificó (para una comprobación que no dependa del propio código de la página, ejecuta halo verify sobre el JSONL). Cualquier parte que posea un checkpoint de la cadena puede verificar que los registros hasta ese checkpoint no han sido alterados desde que se tomó, sin confiar en quien los produjo — ese checkpoint es la pieza fundamental: la cadena por sí sola es a prueba de manipulación frente a todos excepto la parte que opera el registrador (LIMITS.md §1). Cuando el equipo de seguridad de un cliente pregunta "¿qué hizo tu agente con nuestros datos?", les entregas un enlace en lugar de un párrafo. Las revisiones de seguridad ya plantean preguntas sobre IA junto a la lista de verificación SOC 2 — y cada vez más esas preguntas provienen de ISO 42001, de los artículos sobre mantenimiento de registros del Reglamento de IA de la UE y de los propios cuestionarios de los clientes. Hoy en día una garantía por escrito todavía basta. La apuesta detrás de este proyecto es que no lo hará por mucho tiempo.
"Veinte años en informática forense te enseñan que una evidencia solo es evidencia si la otra parte puede comprobarla... en un campo lleno de productos de IA que piden confianza, [Halo] es el raro diseñado para hacer innecesaria la confianza."
Johannes Stillig, Fundador y CEO de Tidebreak AI y Group CISO en una oficina de inversión privada
Destacado en Help Net Security · Top 4% de los lanzamientos de Show HN esa semana · Listado en Agentic Trust Controls frente a cinco controles
El formato del registro es abierto y libre de implementar. Este paquete es la implementación de referencia: registrador, verificador, cliente testigo y servidor de informes.
¿Usas halo-record o estás pensando en ello? Cuéntame quién eres y para qué → ¿Quién usa halo-record?
Te están pidiendo que pongas un registrador dentro de tu agente. No deberías aceptarlo por fe:
pip install halo-record instala exactamente un paquete.halo serve --verify-email (envía un código de un solo uso y el nombre del sujeto del informe, por SMTP a través del servidor que configures en $HALO_SMTP_HOST, a la dirección que introduce un visor del informe). Todas están desactivadas a menos que las invoques; ningún otro contenido de los registros sale de tu infraestructura.summaries=False) no conserva ningún resumen. La redacción es de mejor esfuerzo (regex sobre formatos comunes de secretos y PII más un comodín de entropía): trátala como defensa en profundidad, no como una garantía. Los campos de resultado que proporciones más allá de summary se escanean y enmascaran con los mismos patrones, pero no se recortan a 200 caracteres (LIMITS §13).Qué demuestra cada capa — la distinción fundamental en este proyecto (LIMITS.md §1): una cadena que tú mismo posees demuestra que los registros no fueron editados, en relación con una cabeza que alguien ya posee; solo los checkpoints mantenidos fuera del operador demuestran que ninguno fue eliminado; y ningún hash demuestra que cada acción fue capturada.
| Afirmación | Cadena propia | + Checkpoints externos | + Captura confiable |
|---|---|---|---|
| Detectar ediciones en un artefacto establecido | ✔ | ✔ | ✔ |
| Detectar la reescritura del historial confirmado | — | ✔ | ✔ |
| Detectar checkpoints faltantes/tardíos | — | ✔ (cadencia acordada) | ✔ |
| Demostrar que cada acción fue registrada | — | — | depende del límite de captura |
Ve uno antes de instalar: un informe de ejecución de ejemplo — datos ficticios, cadena real, y su script recalcula en tu navegador la cadena de hashes de los registros incrustados cuando lo abres.
No se requiere ningún agente. Con uv, no hay nada que instalar:
uvx --from halo-record halo demo --serve
o la forma clásica:
pip install halo-record
halo demo --serve
Cualquiera de las dos opciones crea un proveedor ficticio de agentes de soporte con dos clientes, es testigo de las cadenas (con un archivo testigo local que representa a alguien fuera del operador — véase LIMITS.md §1), sirve sus Runtime Reports restringidos y abre la consola del operador en tu navegador. Luego prueba la prueba de manipulación: elimina una línea de uno de los archivos .jsonl y recarga. El informe lo detecta.
Una línea en el límite:
from halo_record import trace
agent = trace(run_my_agent, profile="my-agent", log="audit.jsonl") # wraps your entrypoint; records the run boundary to ./audit.jsonl — add record_call() or a framework adapter at each tool boundary to capture individual calls
También se incluye un shim de conveniencia from halo import ..., pero el nombre halo en PyPI pertenece a un paquete de spinner de terminal no relacionado, y si ese paquete está instalado, gana la importación. halo_record no es ambiguo, por lo que los ejemplos lo usan.
Sin log=, los registros van a ~/.halo/my-agent.jsonl (una cadena por agente). El wrapper sella el límite de la ejecución; la evidencia vive en los registros por llamada. Captúralos con un adaptador de framework (matriz a continuación) — o explícitamente, lo que también muestra cómo se enlaza la delegación: