Gobernanza y cumplimiento

La Aptabit Platform registra lo que ocurre en la instalación y de dónde proviene cada respuesta de IA, para que su organización demuestre trazabilidad, calidad de la información y control sobre sus datos.

Registro unificado

En Configuración > Logs, un único registro reúne:

• cada interacción de chat, de agente y de flujo, con contenido, modelo, workspace, persona, tokens, latencia y calificación;
• los eventos de auditoría de la instalación.

El registro tiene filtros por persona, workspace, modelo, origen, evento, severidad, texto y período. La misma pestaña muestra el uso por persona: conversaciones, mensajes, tokens de entrada y de salida, calificaciones, archivos, almacenamiento, flujos, ejecuciones y agentes.

Registro de auditoría

El registro se guarda en PostgreSQL y contiene organización, workspace, persona, sesión, IP de origen, recurso, severidad y metadatos. Entre los eventos auditados:

• inicios de sesión, intentos fallidos y cierres de sesión;
• cambios en personas, workspaces, SSO y modo de inicio de sesión;
• cambios en secretos y proveedores, con valores anteriores y posteriores en las configuraciones sensibles;
• instalación de licencia, bloqueo y recuperación de la cuenta root;
• consultas y cargas de datos;
• eliminación de documentos, conversaciones, contextos y tablas, con lo que se eliminó y quién lo hizo;
• cambios en la retención y en la exportación de telemetría.

Los eventos de auditoría no se borran en las depuraciones de retención y no pueden editarse ni eliminarse por la API. La base de datos no impone inmutabilidad técnica; restrinja el acceso administrativo a PostgreSQL según la política de la organización.

Procedencia de las respuestas

• Cada respuesta del chat guarda el modelo que la produjo y las fuentes que la fundamentaron: documentos con puntuación o el SQL con el número de filas.
• El inspector del chat muestra la solicitud exacta enviada al modelo.
• Cada ejecución de flujo guarda la traza de cada bloque, de la entrada a la salida.

En Configuración > Gobernanza, dos indicadores siguen la cobertura: la proporción de respuestas con fuentes registradas y la proporción de documentos con indexación semántica.

Calidad de la información

Las capacidades de esta sección están alineadas con la Resolución Conjunta CMN/BCB n.º 18/2025, sobre la política de calidad de la información proporcionada en el ámbito de actuación del Banco Central de Brasil.

Registro de irregularidades

El registro se completa automáticamente, por ejemplo cuando una entrada infringe el contrato de un flujo o cuando una carga de datos rechaza líneas. Cada irregularidad tiene categoría (validation, provenance, embedding y otras), estado (open, acknowledged o resolved) y plan de acción.

Diccionario de datos

El diccionario describe las entidades reguladas que maneja la plataforma (documents, document_chunks, flow_runs, chat_messages, audit_events y data_quality_irregularities), sus campos relevantes y las dimensiones de calidad que sustentan: exactitud, completitud, trazabilidad, oportunidad, integridad, consistencia y gobernanza.

Endpoints de gobernanza

Disponibles para sesiones de administrador:

GET  /api/v1/admin/data-quality/dictionary
GET  /api/v1/admin/data-quality/irregularities
POST /api/v1/admin/data-quality/irregularities/:id/resolve
GET  /api/v1/admin/data-quality/report

El informe agrega las irregularidades por estado y categoría, la cobertura de procedencia de las respuestas de IA y la indexación de los documentos, como base para el informe semestral.

Retención y eliminación

• La retención es opcional y se define por organización: las ejecuciones de flujos, los mensajes de chat y las cargas de datos pueden depurarse automáticamente después de un número de días.
• De forma predeterminada, no se depura nada.
• El registro de auditoría no entra en las depuraciones.
• Cada eliminación de documentos, adjuntos, contextos, conversaciones y tablas queda registrada: qué se eliminó y quién lo hizo.

LGPD

• Residencia: el contenido, los datos y los embeddings permanecen en las bases de datos y el almacenamiento de la instalación.
• Minimización: retención con depuración automática, módulos concedidos por persona y workspaces separados.
• Trazabilidad: eliminaciones registradas y procedencia de las respuestas.
• Anonimización: la plantilla de flujo "Anonimización de datos (LGPD)" utiliza un modelo de IA para enmascarar datos personales; revise el resultado según el riesgo de cada caso.
• Etiquetas: la clasificación de documentos y la sensibilidad de columnas organizan el acervo; el control de acceso se realiza por módulo, workspace y uso compartido.

Estas capacidades respaldan el programa de cumplimiento de la organización; no sustituyen la evaluación jurídica ni constituyen una certificación.

Exportación para observabilidad

En Configuración > Logs, configure la exportación de trazas y logs mediante OpenTelemetry (OTLP) al colector de la organización, como Grafana Tempo, Jaeger o Datadog. La conexión tiene prueba y entra en vigor en el próximo reinicio. La exportación viene desactivada de forma predeterminada.