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(conrejeitada,cancelada,falhaen 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:
| Evento | Qué registra |
|---|---|
ai.reserva / ai.reserva_liquidada / ai.reserva_cancelada | Ciclo del presupuesto (reserva → liquidación). |
ai.usage | Costo real (tokens × precio, en R$) + resumen de egress. |
ai.blocked | Negativa por tope de presupuesto (costo 0) — muestra la demanda bloqueada. |
| generación asistida por IA | Pedido de generación asistida, tipo y si salió como borrador. |
| preguntas sobre el panel / insights del panel | Preguntas 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#
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.
Borrador honesto
Pide algo imposible y confirma
rascunho: truecon los errores listados.Segregación de funciones
En una acción con aprobación, confirma que quien la propone no puede aprobar su propia acción.
Auditoría
Verifica en el registro de auditoría los eventos
ai.reserva,ai.usage,ai.blockedy laproveniencia(opId) que vincula reserva ↔ uso.
Relacionados#
- Generación asistida
- Alucinaciones y validación
- Privacidad, envío externo, presupuesto y apagado
- Roles (RBAC)
Última revisión: 2026-09-08.