La IA de ingestia.io traduce lenguaje natural a SQL sobre tu datamart, responde con citas y procedencia y sabe negarse cuando no tiene base.
Disponibilidad#
- Planes: el recurso de preguntar a los datos existe en todos los planes; la narrativa ejecutiva por IA y los informes de IA programados dependen del plan (Growth+ para narrativa; Business+ para informes completos).
- Protecciones: el camino está cubierto por pruebas automáticas (anti-inyección, procedencia).
Permisos#
- Usar la IA exige el rol admin/owner (acción RBAC recursos de IA) y corre detrás de los interruptores de apagado de consulta en lenguaje natural / insights de IA.
- Es una acción cara — bloqueada en caso de morosidad (402).
- Ver datos bajo RLS/PII: la IA respeta la seguridad por fila y el permiso
Ver datos PII (
viewPII) del miembro.
Configuración (paso a paso)#
- Abre el wizard de preguntas (Preguntar a los datos) en la app.
- Elige el alcance: una tabla Gold o el modelo semántico (recomendado — la IA queda "anclada" en el modelo certificado).
- Escribe la pregunta en lenguaje natural.
- La IA genera el SQL (con parámetros nombrados, anti-inyección), lo ejecuta con control de costo y responde con el resultado + citas de las fuentes usadas.
Validación#
- La respuesta trae procedencia: qué tablas/columnas/medidas se usaron.
- El SQL generado queda visible para auditoría.
- Si la pregunta no tiene base en el modelo, la IA se niega en vez de inventar.
Ejemplo#
En Comércio Aurora, Ana pregunta: "¿Qué sucursal vendió más en julio?". La IA
genera el SQL sobre prd_aurora_gold.vendas_por_filial, lo ejecuta con
el tope de volumen por consulta y responde "Campinas, R$ 128 mil" citando la tabla y el
período usados.
Costo#
- Cada pregunta consume créditos de IA (egress LLM) y procesamiento en el datalake.
- El presupuesto usa un ledger atómico (reserva → liquidación): nunca "te pasas" en silencio; al acabarse el crédito, el recurso falla cerrado (fail-closed).
- Hay un tope por workspace y rate limit fail-closed. BRL facturado = proyección.
Seguridad#
- Anti-inyección de prompt y de SQL (parámetros nombrados).
- Egress controlado: lo que sale hacia el proveedor de IA está mapeado; el egress queda desactivado por defecto donde exige opt-in.
- La IA respeta RLS/ABAC — no devuelve filas que la persona no podría ver.
- Las respuestas traen procedencia, no datos crudos sin contexto.
Límites#
- La IA no garantiza exactitud absoluta; usa la procedencia para verificar.
- Sin promesa de "paridad total" con herramientas de IA del mercado.
Solución de problemas#
| Síntoma | Causa probable | Qué hacer |
|---|---|---|
| IA bloqueada (402) | suscripción atrasada / sin crédito de IA | regulariza en Planes; recarga créditos |
| "Recurso de IA no disponible" | interruptor de apagado de consulta en lenguaje natural/insights de IA activo | recurso pausado; inténtalo más tarde |
| Respuesta rechazada | pregunta sin base en el modelo | reformula o ánclala en el modelo semántico |
| Resultado inesperado | alcance/tabla incorrectos | revisa la procedencia y ajusta el alcance |
Próximos pasos: Compartir el dashboard.