La IA (text-to-SQL, insights, Q&A) tiene presupuesto con reserva→liquidación, egress controlado y procedencia en las respuestas. El costo de datos proviene del procesamiento en el datalake, con protección de costo y caché. Consulta Privacidad, egress y presupuesto y Consumo y cuotas.
IA (text-to-SQL, insights, Q&A)#
| Síntoma | Causa probable | Cómo verificar | Solución | Prevención |
|---|---|---|---|---|
| La IA rechaza la acción | créditos de IA agotados (ledger fail-closed) | revisa el saldo en Consumo | recarga créditos | da seguimiento a la franquicia mensual |
| La IA "no responde" / no disponible | LLM no configurado o interruptor de apagado | consulta Estado | espera; confirma la configuración | monitorea el estado de la capacidad |
| Respuesta de la IA sin números/rechazo explicado | Q&A exige evidencia/cita | lee la procedencia de la respuesta | reformula con la métrica/período claros | pregunta sobre datos publicados (Gold) |
| SQL generado bloqueado | defensas del text-to-SQL (solo SELECT, marts publicados) | revisa el mensaje 403 | ajusta la pregunta al alcance permitido | consulta solo marts publicados |
| Consumo de IA mayor de lo esperado | preguntas amplias/repetidas | revisa la Auditoría (costo por acción) | reduce el alcance; reutiliza respuestas | orienta a hacer preguntas objetivas |
Costo y rendimiento#
| Síntoma | Causa probable | Cómo verificar | Solución | Prevención |
|---|---|---|---|---|
| Consulta cortada por costo | alcanzó el tope de volumen por consulta | revisa el error/costo de la ejecución | filtra/agrega; reduce el período | modela un Gold compacto; particiona |
| Factura/costo proyectado alto | escaneo de tabla grande | revisa los bytes en la Auditoría | filtra/agrega; usa particiones | evita paginar la tabla entera |
| Paginar la API no reduce el costo | LIMIT/OFFSET no recortan bytes | el cobro es por bytes reales | usa $select/$filter (OData) | prefiere pushdown a la paginación bruta |
| Dashboard lento en el refresh | consulta pesada / sin caché | compara la 1.ª ejecución vs. la repetición | las consultas idénticas se sirven desde la caché (R$ 0) | programa el refresh fuera de la hora pico |
Refresh manual bloqueado (402) | morosidad (no es rendimiento) | consulta Suspensión | el owner regulariza | da seguimiento a la facturación |
| La consulta sobre miles de millones de filas es lenta | volumen demasiado grande para consulta directa | \1 | agrega en Gold y usa el modelo Import | dimensiona con margen |
Los valores en BRL son una proyección hoy
El x-ingestia-cost-brl y el costo por evento son una proyección, no un precio facturado
garantizado. El tope de volumen por consulta limita el costo de cada consulta.
Verificación rápida de costo#
- Abre la Auditoría y ordena por costo.
- Expande el SQL del evento costoso; revisa los bytes procesados.
- Reescribe con filtro/agregación; confirma que la repetición se sirve desde la caché.
Seguridad y privacidad#
- Egress controlado: la IA no filtra datos más allá de lo necesario; las respuestas traen procedencia — consulta Privacidad, egress y presupuesto.
- La protección anti-inyección y los interruptores de apagado protegen el camino de la IA.
Relacionados#
- Text-to-SQL · Insights · Q&A
- Privacidad, egress y presupuesto
- Consumo y cuotas
- Capacidades e interruptor de apagado
Última revisión: 2026-09-08. Los valores de costo en pantalla son estimaciones; el valor cobrado es el de la factura.