Saltar al contenido

Traducción automática — la versión en portugués es la referencia. Ver en portugués

Actualizado el 2026-09-08

Aprobación humana y auditoría

La IA propone, el humano confirma — cómo funcionan la aprobación (incluso doble), la idempotencia y el rastro de auditoría de la IA.

En esta página (7)

Un principio atraviesa toda la IA de ingestia.io: la IA propone; el humano confirma. Nada material ocurre sin que una persona autorizada apriete el botón — y todo lo que la IA hace deja un rastro de auditoría. Esta página reúne cómo funciona eso en la generación asistida y en las acciones/writeback, y lo que queda registrado.

Interruptores de acciones y de egress

La máquina de estados de aprobación está cubierta por pruebas automáticas. Los interruptores (ACTIONS_DISABLE para acciones, AI_EGRESS_DISABLE para el egress de IA) son opcionales y quedan DESACTIVADOS cuando no están configurados — es decir, sin configuración explícita la ejecución está activada, no bloqueada. Y no existe, en ninguna parte del producto, una puerta de liberación caso por caso operada por nosotros. Quien quiera la postura conservadora necesita activar el interruptor deliberadamente.

1. La IA nunca publica sola#

En la generación asistida, la IA devuelve un artefacto estructurado (medida, visual, esqueleto de panel) acompañado de un campo validacao llenado por código determinista. La vista previa es el propio artefacto; la escritura solo ocurre cuando confirmas mediante las acciones existentes del editor (addMeasureAction, addWidgetAction, updateWidgetAction, saveModelAction). Ninguna escritura nace de la IA.

Lo mismo vale para el text-to-SQL: propone solo SELECT — nunca DML/DDL —, y tú lo revisas antes de ejecutarlo.

2. Acciones y writeback con aprobación#

Para efectos materiales (escribir de vuelta en un sistema, disparar una acción), existe una gobernanza de aprobación con segregación de funciones:

  • Quien propone no puede aprobar su propia acción.
  • Las acciones de alto impacto exigen dos aprobadores distintos (aprobación doble) — un insider o una cuenta comprometida no causa daño por sí solo.
  • Flujo de estados: pendente → aprovada → executada (con rejeitada, cancelada, falha en las desviaciones).
  • Idempotencia: la clave es sha256(ação ‖ parâmetros canônicos) — la misma acción con los mismos parámetros tiene la misma clave, y el ejecutor nunca aplica el mismo efecto dos veces (los parámetros se ordenan de forma canónica, así que el orden de las claves no cambia el resultado).

Aviso

Las acciones/writeback no vienen desactivadas por defecto: el interruptor ACTIONS_DISABLE solo bloquea la ejecución cuando lo configuras. No existe liberación caso por caso por parte de nuestro equipo. Si la postura deseada es "nada material sale de aquí sin que yo lo ordene", activa el interruptor — no cuentes con un valor por defecto conservador que no existe.

3. Rastro de auditoría de la IA#

Todo lo que hace la IA se guarda en el registro de auditoría, con alcance por workspace. Los eventos principales:

EventoQué registra
ai.reserva / ai.reserva_liquidada / ai.reserva_canceladaCiclo del presupuesto (reserva → liquidación).
ai.usageCosto real (tokens × precio, en R$) + resumen de egress.
ai.blockedNegativa por tope de presupuesto (costo 0) — muestra la demanda bloqueada.
generación asistida por IAPedido de generación asistida, tipo y si salió como borrador.
preguntas sobre el panel / insights del panelPreguntas de Q&A / insights, con marca de negativa/evidencia débil.

Además, toda respuesta trae proveniencia: modelo, versión del prompt, costo real (R$) y opId — que vincula ai.reserva ↔ ai.usage ↔ ai.reserva_liquidada. Eso permite correlacionar una respuesta en producción con el prompt y el costo exactos que la generaron.

4. Lo que NO se guarda#

El producto no guarda un "historial de conversaciones" con la IA. Lo que queda es el rastro de auditoría (uso/costo/negativa) y, en el informe, los contadores de tokens en el registro de la ejecución del informe. Es decir: se puede auditar que hubo una llamada, su costo y su procedencia — sin retener un log de chat.

Quién puede aprobar#

  • Confirmar artefactos de generación y publicar depende de un rol de edición/publicación (ver Roles (RBAC)).
  • Aprobar acciones materiales depende de un rol aprobador (owner/admin); una acción de alto impacto exige dos aprobadores distintos, ambos diferentes de quien la propuso.

Cómo validar#

  1. Nada se publica solo

    Pide una medida en la generación asistida y confirma que la escritura solo ocurre después de la confirmación humana.

  2. Borrador honesto

    Pide algo imposible y confirma rascunho: true con los errores listados.

  3. Segregación de funciones

    En una acción con aprobación, confirma que quien la propone no puede aprobar su propia acción.

  4. Auditoría

    Verifica en el registro de auditoría los eventos ai.reserva, ai.usage, ai.blocked y la proveniencia (opId) que vincula reserva ↔ uso.

Relacionados#


Última revisión: 2026-09-08.

Enlaces relacionados