Motor: Usa LLM (Anthropic)
Dónde está en la pantalla
En IA → Informes, haz clic en Nuevo informe. La etapa de narrativa de IA es la segunda de las cinco; una vez creado, Ejecutar ahora genera el informe en el momento. El paso a paso con cada etiqueta está en Pantallas de Informes.
1. Qué hace
Al generar un informe programado, la IA escribe la narrativa ejecutiva de los resultados: titular, resumen, destacados (con variación vs. el período anterior), anomalías y recomendaciones — en tono ejecutivo o técnico, en portugués.
2. ¿Determinístico o LLM?
LLM, con salida estructurada. Es la misma generación que se activa tanto desde la pantalla como desde el cron de informes — por eso el ledger de presupuesto vive dentro de ella, cubriendo a todos los que la llaman.
Sin proveedor en dev/preview → narrativa mock determinística (resume los números sin inventar). En producción sin proveedor de modelo, la llamada falla con un error explícito en lugar de simular. Si la llamada falla, recurre a la misma narrativa mock y el presupuesto reservado se libera.
3. Datos enviados y egress
- Van los resultados de las consultas del informe (filas actuales y del período anterior),
dentro de un fence
<dados>, sujetos a la política de egress (tope de 50 filas por consulta o resumen estadístico cuando el envío de filas está desactivado). - Va también el contexto de negocio libre que el cliente escribió en el informe — dentro de un fence
como
<dados id="contexto-do-negocio">y tratado como dato, nunca como instrucción. - El nombre del informe y la etiqueta del período van con los tokens de fence neutralizados.
4. Privacidad y retención
- El informe es el producto principal; la narrativa es un complemento. Los datos que ve la IA son los mismos ya materializados para el informe.
- Uso/costo en
ai.usage; la ejecución del informe guarda los tokens de entrada y de salida (el total de entrada incluye caché) para el historial.
5. Tokens, costo y presupuesto
- Mismo ledger de reserva→liquidación y tope mensual de gasto en IA.
- Si se supera el tope, el informe NO se aborta — los datos salen normalmente; solo la narrativa recurre al resumen determinístico y dice por qué no hubo IA.
- Caché de prompt: las reglas del analista son estables entre ejecuciones (solo el tono cambia entre 2 valores) y se vuelven a leer a ~0,1× del precio.
6. Cómo activarlo, quién puede usarlo y cómo desactivarlo
- Disponible a partir del plan Growth. La matriz completa está en Planes (5).
- Con el envío a proveedores desactivado, la narrativa es determinística y nada sale de la plataforma.
- En el cron, cada ejecución pasa por el mismo ledger/tope por workspace.
7. Rechazos
- Sin resultados útiles (todas las consultas vacías/con error) → no llama al LLM; la narrativa mock resume lo que pasó (incluso listando las consultas que fallaron como "anomalías").
- Tope alcanzado → narrativa mock con un aviso claro (
blocked: true), costo cero.
8. Limitaciones y ausencia de causalidad
- Regla innegociable en el prompt: usar exclusivamente números presentes en los datos; nunca
estimar, extrapolar ni inventar. Sin período anterior en los datos, el
deltaPctesnully la narrativa declara que no hay base de comparación — nunca inventa una variación. - No afirma causalidad: describe variaciones y destacados, no concluye que una cosa causó la otra.
- La calidad del texto depende de la calidad de los datos; la narrativa no corrige datos erróneos.
9. Cómo validar
- Grounding sin invención: genera un informe sin período anterior y verifica que la variación aparezca como "sin base de comparación", nunca como un número inventado.
- Desactivación: con el envío a proveedores desactivado, confirma que la narrativa se convierte en el resumen determinístico y nada sale del producto.
- El tope no tumba el informe: fuerza el tope de presupuesto y verifica que los datos salen y solo la narrativa se reemplaza por el resumen determinístico.
- El contexto del cliente es dato, no instrucción: incluye en el contexto de negocio un texto que intente cambiar las reglas y confirma que la IA lo ignora.