E-map Grupal — Anexo B-04: Generación de contenido IA para el líder

Tema: E-map Grupal — Cómo y cuándo genera la IA el análisis del equipo para el líder
DRF base: 14-e-map-grupal.md
Idioma: ES

Resumen en pocas palabras

Cuando un liderado completa una sesión con Brun-E, su E-map individual se actualiza. El DRF 14 establece que la IA también debe generar un análisis del equipo para el líder: insights grupales, alertas, recomendaciones y un resumen de cada persona. Este anexo define cómo y cuándo ocurre esa generación, qué cuesta y qué riesgos existen. Dos de las decisiones clave ya están resueltas e implementadas: la frecuencia de generación (cooldown fijo de 12 horas, B-04.1) y la conservación del historial de diagnósticos (B-04.3). Las demás siguen abiertas.

Por qué este anexo existe

El DRF 14 describe qué ve el líder (los insights, las alertas, los resúmenes por persona). No define cuándo se genera ese contenido ni qué pasa cuando algo falla. Estas decisiones tienen consecuencias directas en el costo mensual, la frescura de la información y la confiabilidad del sistema. Son decisiones que no puede tomar el equipo técnico unilateralmente — requieren acuerdo con el cliente.

Cómo funciona la generación de contenido IA

Cuando un liderado completa una sesión Brun-E:

El sistema crea el E-map individual del liderado (ya implementado)
El sistema detecta que ese liderado tiene un líder asignado
Si venció el cooldown de 12 horas para ese líder, el sistema reúne los datos del equipo:
Para el score grupal que alimenta a la IA: los E-maps del período (últimas 4 semanas) de toda la cascada de liderados más el propio líder.
Para el detalle por miembro que recibe la IA (scores, insights y recomendaciones por persona): solo los liderados directos.
Con esos datos, hace una llamada a la IA para generar el análisis grupal
La IA devuelve: insights del equipo, alertas, recomendaciones y un resumen por cada liderado directo
El sistema guarda ese contenido como una nueva entrada del historial y lo pone disponible en la vista del líder

El paso 4 es el que tiene costo variable. El cooldown de 12 horas (paso 3) es lo que acota ese costo.

Decisión 1 — ¿Cuándo se genera el análisis? (RESUELTO: cooldown de 12 horas)

Esta era la decisión más importante porque define el costo mensual y la frescura de la información.

Decisión tomada (implementada): el análisis del líder se regenera con un cooldown fijo de 12 horas. Entre dos generaciones para el mismo líder deben pasar al menos 12 horas; si se solicita antes, el sistema rechaza la operación e informa cuánto falta. Esto acota el costo a un máximo de dos generaciones por líder por día, con independencia de cuántas sesiones complete el equipo. En la práctica es un punto intermedio entre "tiempo real" y "diario": se regenera al primer disparo tras vencer el cooldown, no en horario fijo.

Las opciones que siguen se conservan como contexto de la evaluación de costos que llevó a esta decisión.

Opción A — Cada vez que un liderado completa una sesión (tiempo real)

El análisis del líder se regenera automáticamente cada vez que cualquier liderado termina una sesión Brun-E.


Ventaja	El líder siempre ve el análisis más actualizado posible.
Desventaja	Cada sesión completada genera una llamada adicional a la IA. En equipos activos, esto puede representar varias llamadas por día.
Caso problemático	Si tres liderados completan sesión el mismo día, se hacen tres llamadas a la IA y se paga tres veces — aunque el análisis resultante solo va a reflejar el estado del equipo una vez que las tres sesiones estén cargadas. Las dos primeras llamadas producen análisis parcialmente desactualizados.

Opción B — Una vez por día (procesamiento nocturno)

El sistema acumula las sesiones completadas durante el día y genera el análisis del líder una vez, al final del día o en la madrugada.


Ventaja	Si cinco liderados completan sesión el mismo día, se hace una sola llamada a la IA en lugar de cinco. El análisis refleja todos los datos del día de forma completa.
Desventaja	El líder no ve el análisis actualizado hasta el día siguiente. Si un liderado completa su sesión a las 9am, el líder recién lo ve actualizado al día siguiente.
Adecuado cuando	Los líderes no necesitan reaccionar en el mismo día a lo que muestran los E-maps de su equipo.

Opción C — Una vez por semana (procesamiento semanal)

El sistema genera el análisis del líder una vez por semana, independientemente de cuántas sesiones completó el equipo durante esa semana.


Ventaja	Costo mínimo. Una llamada por líder por semana, sin importar la actividad del equipo.
Desventaja	El análisis puede tener hasta 6 días de antigüedad. Si un liderado tuvo una sesión importante el lunes, el líder recién ve el análisis actualizado el domingo siguiente.
Adecuado cuando	El uso de la plataforma es bajo o moderado, y la cadencia de revisión del líder es semanal.

Tabla comparativa

	Tiempo real	Diario	Semanal
Frescura	Inmediata	Hasta 24h de retraso	Hasta 7 días de retraso
Llamadas IA / líder / mes (equipo de 10, 2 sesiones/persona)	Hasta 20	Hasta 20 días activos	4
Llamadas IA / líder / mes (equipo de 10, 8 sesiones/persona)	Hasta 80	Hasta 20 días activos	4
Desperdicio por sesiones simultáneas	Alto	Nulo	Nulo
Complejidad técnica	Media	Media	Baja

Nota sobre costo: El costo por llamada depende del tamaño del equipo (cuánta información se envía a la IA). Se detalla en la sección de costos.

Decisión 2 — ¿El análisis se regenera solo para el líder directo o para toda la cadena?

Cuando Empleado 1 completa una sesión, su líder directo es Gerente A. Pero el Director también puede ver a Empleado 1 en su vista en cascada.

¿Cuándo se actualiza el análisis del Director?

Opción A — Solo el líder directo

Cuando Empleado 1 completa sesión → se regenera el análisis de Gerente A.
El análisis del Director se actualiza solo cuando alguno de sus liderados directos (Gerente A o Gerente B) completa sesión.


Ventaja	Costo controlado. Una sesión = una llamada a la IA como máximo (salvo en tiempo real con sesiones simultáneas).
Consideración	El Director puede ver en su vista grupal que el E-map de Empleado 1 cambió, pero el análisis grupal que generó la IA para él todavía no lo refleja hasta que Gerente A complete su próxima sesión.

Opción B — Toda la cadena jerárquica

Cuando Empleado 1 completa sesión → se regenera el análisis de Gerente A y el del Director y el del VP (si existe), etc.


Ventaja	Todos los líderes en la cadena tienen siempre el análisis actualizado.
Desventaja	Una sesión puede generar 2, 3 o 4 llamadas a la IA dependiendo de la profundidad de la jerarquía. Los costos escalan exponencialmente en organizaciones con estructura multinivel.

Recomendación del equipo técnico: Opción A. El costo de la Opción B crece rápidamente y los beneficios son marginales — los líderes de niveles superiores suelen revisar con menor frecuencia y no necesitan actualización en tiempo real por cada sesión de nivel inferior.

Decisión 3 — ¿Se conserva el historial de análisis anteriores? (RESUELTO: se conserva)

Decisión tomada (implementada): se adopta la Opción B — Conservar historial. Cada diagnóstico generado se guarda como una nueva entrada con fecha; la vista del líder expone las últimas entradas (~12). Es compatible con R-1.10 del DRF 14.

Cada vez que se regenera el análisis, el sistema puede:

Opción A — Reemplazar (solo el último)

El nuevo análisis sobreescribe al anterior. El líder siempre ve el análisis más reciente, pero no puede consultar qué decía el análisis de hace dos semanas.


Ventaja	Simple. Sin costo de almacenamiento adicional.
Limitación	No permite comparar cómo evolucionó el análisis del equipo a lo largo del tiempo. No es compatible con futuros reportes que crucen datos cualitativos e históricos (mencionados en DRF 14, R-1.10).

Opción B — Conservar historial (append)

Cada análisis generado se guarda como una nueva entrada con fecha. El líder puede ver el análisis de hoy y el de semanas anteriores.


Ventaja	Permite trazabilidad y reportes históricos. Compatible con R-1.10 del DRF 14.
Consideración	Requiere más espacio de almacenamiento (bajo costo en la práctica). Requiere definir por cuánto tiempo se conservan los análisis anteriores.

Nota: El DRF 14, R-1.10 establece que "el contenido IA histórico se conserva al menos en formato de resumen/sumup del historial". La Opción A incumple este requisito tal como está redactado.

Decisión 4 — ¿Qué pasa si la IA falla?

La generación del análisis es una operación que depende de un servicio externo (OpenAI). Ese servicio puede estar caído, demorar más de lo esperado o devolver un error.

Opción A — Fallo silencioso (best effort)

Si la llamada falla, el sistema lo registra internamente y sigue adelante. El líder sigue viendo el análisis anterior (o ninguno si es la primera vez). No se genera ningún aviso.


Ventaja	Simple. No interrumpe ningún flujo.
Riesgo	El líder puede ver análisis desactualizado sin saberlo. Si el servicio de IA falla por varias horas, todos los análisis pueden quedar obsoletos sin que nadie lo note.

Opción B — Reintento automático

Si la llamada falla, el sistema lo vuelve a intentar automáticamente en intervalos progresivos (ej: 2 minutos, luego 8, luego 30). Si después de N intentos sigue fallando, lo marca como fallido para revisión manual.


Ventaja	Mayor confiabilidad. Los fallos transitorios se resuelven solos.
Consideración	Requiere una cola de reintentos dedicada (más complejo técnicamente). Si la IA está caída varias horas, puede acumular muchos reintentos en cola. Cada reintento exitoso paga el costo de una llamada adicional.

Recomendación del equipo técnico: Opción B con un máximo de 3 reintentos. El análisis del líder no es crítico en tiempo real pero sí debe generarse eventualmente.

Costo estimado

El costo por llamada depende del tamaño del equipo porque cuanta más gente tiene el líder, más información se envía a la IA.

Costo aproximado por llamada (USD)

Tamaño del equipo	Costo por llamada
5 personas	~$0.03
15 personas	~$0.06
30 personas	~$0.10
50 personas	~$0.15

Los valores son estimaciones basadas en el modelo gpt-4o. Pueden variar según el modelo elegido y los precios vigentes de OpenAI.

Ejemplos de costo mensual por organización

Organización pequeña — 5 líderes, equipos de 8 personas, uso moderado (3 sesiones/persona/mes):

Estrategia	Llamadas/mes	Costo estimado/mes
Tiempo real	~120	~$4
Diaria	~100	~$3
Semanal	~20	<$1

Organización mediana — 20 líderes, equipos de 15 personas, uso activo (6 sesiones/persona/mes):

Estrategia	Llamadas/mes	Costo estimado/mes
Tiempo real	~1,800	~$108
Diaria	~600	~$36
Semanal	~80	~$5

Organización grande — 50 líderes, equipos de 20 personas, uso intensivo (8 sesiones/persona/mes):

Estrategia	Llamadas/mes	Costo estimado/mes
Tiempo real	~8,000	~$640
Diaria	~1,500	~$120
Semanal	~200	~$16

En todos los casos, el costo de cascade (Decisión 2, Opción B) multiplica estos valores por la profundidad de la jerarquía (2x, 3x, etc.).

Decisión 5 — El prompt: qué tiene que analizar la IA

Para generar el análisis, la IA necesita instrucciones precisas sobre qué observar, qué producir y con qué tono. Esto es lo que define si el análisis le resulta útil al líder o no.

Necesitamos que el cliente defina:

¿Qué preguntas tiene que responder el análisis grupal?
Ejemplos: ¿Cómo está la energía del equipo esta semana? ¿Quién necesita atención? ¿Qué fortalezas o riesgos se detectan en el grupo?
¿Qué tono tiene que tener el análisis?
Ejemplos: ejecutivo y directo / empático y narrativo / orientado a acción concreta.
¿Qué tiene que incluir el resumen por persona?
Ejemplos: observación del estado actual + una recomendación de acción para el líder.
¿En qué idioma se genera?
¿Siempre en español? ¿En el idioma de la sesión del liderado? ¿En el idioma configurado del líder?
¿Hay temas que la IA no debe tocar?
Por ejemplo: no dar diagnósticos, no comparar personas entre sí, no emitir juicios de valor sobre desempeño laboral.

Sin estas definiciones, el equipo técnico puede construir toda la infraestructura pero no puede escribir el análisis que la IA va a generar.

Decisiones tomadas y preguntas abiertas

#	Pregunta	Estado / decisión	Impacto
B-04.1	¿Con qué frecuencia se regenera el análisis del líder?	✅ Resuelto: cooldown fijo de 12 horas (máx. 2 generaciones por líder/día)	Costo mensual
B-04.2	¿Se regenera solo para el líder directo o para toda la cadena jerárquica?	Solo directo / Toda la cadena	Costo × profundidad de jerarquía
B-04.3	¿Se conserva historial de análisis anteriores o solo el último?	✅ Resuelto: se conserva historial (append con fecha; se exponen ~12 entradas). Compatible con R-1.10	Compatibilidad con R-1.10 del DRF 14
B-04.4	¿Qué pasa si la IA falla? ¿Se reintenta o se acepta el fallo?	Fallo silencioso / Reintento automático	Confiabilidad del contenido
B-04.5	¿Cuál es el prompt? ¿Qué preguntas responde la IA, con qué tono, qué límites tiene?	Definición del cliente	Bloqueante total de implementación

Lo que ya está implementado

Para que el cliente entienda el estado actual:

Componente	Estado
E-map individual del liderado (creación automática al completar sesión)	✅ Implementado
Vista grupal del líder con scores y evolución temporal (`GET /emap/team`)	✅ Implementado
Vista del líder sobre un liderado específico (`GET /emap/team/:userId`)	✅ Implementado
Tabla de base de datos para el contenido IA del líder	✅ Implementado
Endpoints para exponer el contenido IA al líder (historial, ~12 entradas)	✅ Implementado
Generación del diagnóstico IA grupal con cooldown de 12h (B-04.1)	✅ Implementado
Conservación del historial de diagnósticos (B-04.3)	✅ Implementado
Score del diagnóstico sobre cascada completa + líder; detalle por miembro solo de directos	✅ Implementado
Estrategia de cascada (B-04.2), manejo de fallos (B-04.4) y prompt final (B-04.5)	⏳ Pendiente

Correcciones / historial de validación

Fecha	Versión	Cambio
2026-04-29	v1.0	Documento inicial. Análisis de estrategias de generación, costo, confiabilidad y preguntas abiertas para B-04.
2026-07-02	v1.1	Alineación con el código actual. B-04.1 resuelto: frecuencia de generación implementada como cooldown fijo de 12 horas (ya no pendiente). B-04.3 resuelto: se conserva historial de diagnósticos (append con fecha, ~12 entradas). Aclarado que el score que alimenta a la IA se computa sobre la cascada completa + líder y que el detalle por miembro es solo de los liderados directos. Actualizada la tabla "Lo que ya está implementado". Se conserva el contexto de costos de las opciones evaluadas.