Skip to content
VeriSwarm
Acerca de
DocumentaciónPreciosHabilidad del agente
Iniciar sesiónRegistrarse
  1. Inicio
  2. /Learn
  3. /Immutable audit trail ai agents
VeriSwarm
  • English
  • ✓ Español
  • Deutsch
  • Français
  • Italiano
  • Português
  • 日本語
  • 한국어
  • 简体中文

Producto

  • Precios
  • Documentación
  • API
  • Habilidad del agente
  • Especificación OATS

Confianza

  • Centro de confianza
  • Seguridad
  • Cumplimiento
  • Estado
  • Registro de cambios

Empresa

  • Acerca de
  • Blog
  • Código abierto
  • Inversionistas
  • Prensa

Legal

  • Términos
  • Privacidad
  • SLA
  • DPA
  • Accesibilidad
Guía técnica

¿Qué es un registro de auditoría inmutable para agentes de IA?

Un registro de base de datos mutable no es evidencia: cualquiera con acceso de escritura puede cambiarlo, y la tabla queda igual de fiable después de la edición que antes. Un registro de auditoría inmutable es distinto: un libro de auditoría encadenado por hash e independientemente verificable, donde cada evento se enlaza con el anterior, de modo que la manipulación es detectable en lugar de simplemente desalentada. Esto es lo que eso significa técnicamente, y cómo se aplica específicamente a los agentes de IA.

Qué es un registro de auditoría inmutable

Un registro de auditoría inmutable para agentes de IA es un libro de eventos de solo adición, encadenado por hash, en el que el hash criptográfico de cada entrada incorpora el hash de la entrada anterior, de modo que cualquier modificación, eliminación o inserción en cualquier punto de la secuencia rompe la cadena y resulta independiente y matemáticamente detectable. No es una base de datos meramente protegida por política frente a ediciones: es una estructura en la que la manipulación deja pruebas inevitables de sí misma.

Por qué un registro normal no es evidencia

Todo sistema en producción ya tiene registros. Registros de aplicación, trazas de solicitudes, una tabla de Postgres con una columna occurred_at y una clave foránea al agente que lo desencadenó. El problema no es que no existan, sino que no prueban nada sobre su propia integridad.

  • Un ingeniero con acceso a la base de datos puede editar una fila, y la tabla queda idéntica después.
  • Una credencial de servicio comprometida puede eliminar el registro del incidente que causó.
  • Un script bien intencionado de «limpieza de datos» puede corregir silenciosamente una entrada inconveniente.

Nada de esto requiere intención maliciosa — basta con el acceso operativo ordinario a la base de datos. Un registro mutable es una afirmación: esto es lo que ocurrió, confía en nosotros. Para un agente autónomo que realiza acciones reales — enviar correos, mover dinero, tocar datos de clientes — una afirmación no basta cuando alguien eventualmente pregunta «¿qué hizo realmente este agente, y cómo sabemos que el registro es preciso?».

Cómo funciona la cadena de hashes

El mecanismo es más simple de lo que suena. Cada evento del libro tiene un content_hash — un hash criptográfico del contenido de ese evento — calculado tanto a partir de los datos propios del evento como del previous_event_hash que apunta a la entrada inmediatamente anterior. Eso significa que el hash de cada evento depende de todo el historial de la cadena hasta ese punto, no solo del propio evento.

Añadir, nunca editar

Los nuevos eventos se añaden al final de la cadena. No existe una operación de actualización o eliminación en el diseño — el libro solo crece.

Cada enlace depende del anterior

El hash del evento N incorpora el hash del evento N−1. Cambiar cualquier cosa del evento N−1, incluso después del hecho, produce un hash distinto del que el evento N registró como su predecesor.

La verificación recalcula la cadena

Una pasada de verificación recorre cada entrada, recalcula el hash esperado a partir del contenido y del predecesor registrado, y confirma que coincide con lo almacenado. Una sola discrepancia en cualquier punto rompe toda la cadena a partir de ese momento.

Esta es la misma idea estructural detrás de las blockchains y los historiales de commits de Git — referencias encadenadas y direccionadas por contenido — aplicada a un registro de auditoría en lugar de a una moneda o un repositorio de código.

Cómo lo implementa VeriSwarm Vault

VeriSwarm Vault es un libro de solo adición, encadenado por hash, disponible en el plan Max. Cada evento procesado a través de la suite — decisiones de confianza, hallazgos de escaneo de Guard, verificaciones de Passport, cambios del ciclo de vida del agente — se escribe en él automáticamente, sin necesidad de una llamada de registro independiente. Cada entrada del libro registra:

  • event_id, actor_type / actor_id, subject_type / subject_id
  • event_type, source, occurred_at, ingested_at
  • content_hash — el hash criptográfico de este evento
  • previous_event_hash — el hash de la entrada inmediatamente anterior

La integridad se puede comprobar bajo demanda en GET /v1/suite/vault/verify, que recorre la cadena y devuelve si está intacta junto con un recuento de entradas comprobadas. Una verificación fallida se trata como un incidente de seguridad, no como un problema de calidad de datos, precisamente porque una cadena rota significa que el libro ya no prueba lo que afirma probar. Los datos del libro también se pueden exportar (JSON o CSV, filtrables por tipo de evento, actor o agente) con una suma de comprobación para verificación fuera de línea. El detalle completo a nivel de campo se encuentra en la documentación de Vault.

Dónde importa más esto: EU AI Act, artículo 12

La aplicación concreta más clara ahora mismo es la EU AI Act. El artículo 12 exige que los sistemas de IA de alto riesgo registren automáticamente eventos a lo largo de su vida útil, en una forma que pueda identificar situaciones de riesgo y sobrevivir a la ventana de retención de seis meses del artículo 26. Un libro encadenado por hash es lo que convierte «tenemos registros» en evidencia en la que un regulador o auditor puede realmente confiar. Ese requisito, y exactamente cómo Vault se ajusta a él, se cubre en Registro del artículo 12 del EU AI Act para agentes de IA. Un registro de auditoría inmutable es el mecanismo general; el artículo 12 es una razón específica y actualmente exigible para tener uno.

Preguntas frecuentes

¿Qué hace que un registro de auditoría sea "inmutable"?

La inmutabilidad no significa que la capa de almacenamiento impida físicamente las escrituras — la mayoría de las bases de datos técnicamente pueden ser editadas por alguien con suficiente acceso. Significa que la manipulación es detectable. En un libro encadenado por hash, el hash de contenido de cada evento incorpora el hash del evento anterior, de modo que cada entrada está criptográficamente enlazada a su predecesora. Cambiar, eliminar o insertar un registro en cualquier punto de la cadena hace que todos los hashes calculados a partir de ese punto dejen de coincidir — la manipulación aparece de inmediato bajo verificación, en lugar de permanecer invisible.

¿En qué se diferencia esto de un registro de aplicación normal?

Un registro normal — registros de aplicación, una tabla de auditoría de Postgres, entradas de CloudWatch — registra que ocurrió un evento. No demuestra que el registro no haya sido alterado desde entonces. Cualquiera con acceso de escritura a esa tabla (un ingeniero, una credencial comprometida, un script de limpieza automatizado) puede editar o eliminar una fila, y la tabla se ve exactamente igual de fiable que antes. Un libro encadenado por hash cierra esa brecha: la integridad no se afirma, es matemáticamente comprobable mediante la verificación de la cadena.

¿Qué comprueba realmente la verificación de la cadena?

La verificación recorre el libro desde el primer evento hacia adelante, recalculando el hash esperado de cada entrada a partir de su contenido y del hash registrado de su predecesora, y confirmando que coincide con lo almacenado. VeriSwarm Vault expone esto como GET /v1/suite/vault/verify, que devuelve ok: true o false junto con un recuento de entradas comprobadas. Un resultado false significa que un registro fue modificado, eliminado o insertado fuera del funcionamiento normal — la recomendación de VeriSwarm es tratarlo como un incidente de seguridad, no como un error de calidad de datos.

¿Qué eventos se registran realmente para un agente de IA?

En VeriSwarm Vault, cada evento registrado a través de la suite — decisiones de confianza (allow/review/deny), hallazgos de escaneo de seguridad de Guard, verificaciones de identidad de Passport, cambios del ciclo de vida del agente (kill switch, concesiones de delegación) — se escribe automáticamente una vez que Vault está activado. Cada entrada captura actor, sujeto, tipo de evento, marca de tiempo, payload y los hashes de encadenamiento. No se requiere ninguna llamada de registro independiente; es un efecto secundario del funcionamiento normal del agente a través de la plataforma.

¿Necesito un registro de auditoría inmutable si no estoy sujeto a una regulación específica?

La regulación es una razón para querer uno — el requisito de mantenimiento de registros del artículo 12 de la EU AI Act es un ejemplo directo — pero la necesidad subyacente es más amplia. Cualquier agente con autonomía significativa (acceso a herramientas, acciones de cara al cliente, manejo financiero o de PII) crea un momento en el que alguien preguntará «¿qué hizo realmente este agente, y podemos confiar en el registro?». Un registro mutable responde a eso con una afirmación. Uno inmutable e independientemente verificable lo responde con una prueba.

¿VeriSwarm Vault está disponible en todos los planes?

No — Vault, incluidos el libro encadenado por hash y el endpoint de verificación de la cadena, es una función del plan Max. El nivel gratuito de Gate cubre la puntuación de confianza y la ingesta de eventos, pero el propio libro de auditoría inmutable es una capacidad de pago. Consulta /pricing para conocer los detalles actuales del plan.

Consulta la estructura del libro y la API de verificación

Vault es una función del plan Max — el libro encadenado por hash, la verificación de la cadena y las exportaciones no están en el nivel gratuito. Lee la referencia técnica completa, o consulta cómo se relaciona con una regulación específica.

Leer la documentación de VaultGuía del artículo 12 del EU AI Act