Saltar al contenido

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

Actualizado el 2026-10-03

Narrativa del informe — el "Analista de IA"

El texto ejecutivo que la IA escribe en cada informe programado — qué va al modelo, cuánto cuesta, cuándo se niega y por qué nunca inventa una variación.

En esta página (10)

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 deltaPct es null y 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.

Enlaces relacionados