Manual de Operación

INMOV AI Cell

Sistema de inteligencia creativa autónoma: desde un correo hasta una propuesta completa en Google Slides, una célula convocada y un brief de clase mundial — en minutos.

v5.0 · Junio 2026 · Para uso del equipo INMOV
Contenido
¿Qué es? Cómo activar Tipos de solicitud Estructura del asunto Estado del proyecto Carpetas en Drive Los agentes Correos del sistema Timeline completo Panel de administración Aprendizaje automático Qué hacer si falla Credenciales

1 ¿Qué es el INMOV AI Cell?

Un sistema de agentes de inteligencia artificial que convierte cualquier correo de proyecto en un paquete creativo completo: brief profesional, big idea con tres conceptos, presentación en Google Slides, análisis financiero y célula creativa convocada — en menos de 10 minutos.

El problema que resuelve: Cuando llega un nuevo encargo, el equipo pierde horas coordinando quién hace qué, armando el brief, evaluando la idea, calculando si es rentable y convocando a los especialistas correctos. El AI Cell hace todo eso solo.

Lo que produce: Un brief creativo ISO 9001, la big idea con tres conceptos distintos, una presentación de Google Slides lista para presentar, una evaluación tipo jurado de Cannes, un análisis de rentabilidad, y los correos de convocatoria personalizados para cada especialista de la célula — más un resumen ejecutivo al ejecutivo que envió el brief.

⚡
Tiempo total: El pipeline completo demora entre 3 y 10 minutos desde que llega el correo, dependiendo de la complejidad del proyecto.

Los cuatro sistemas que trabajan juntos

SistemaQué haceCuándo corre
Pipeline principal
cell_graph.py · LangGraph		 Los agentes en secuencia. Recibe el correo y produce el paquete completo incluyendo Slides. Cada vez que llega un correo [celula] o se presiona Reprocesar.
Indexador
POST /indexer/run		 Indexa las carpetas de capacitación (briefs históricos, presupuestos, propuestas exitosas) y entrena la memoria vectorial. Una vez al instalar. Volver a correr cada vez que se agregan documentos.
Google Drive
Información del proyecto		 Repositorio de contexto. El sistema crea automáticamente la carpeta del proyecto y almacena la presentación allí. Se crea/consulta en cada ejecución del pipeline.
Panel de administración
/admin		 Kanban comercial, detalle de proyectos, gestión de expertos, edición de prompts, acciones manuales. Uso continuo por el equipo.

2 Cómo activar el sistema

El disparador es un correo electrónico enviado a la cuenta de la célula. El asunto es la instrucción principal — define qué tipo de trabajo se pide y a qué proyecto corresponde.

1
Enviar el correo a la cuenta de la célula

La dirección es la configurada en email_celula (ver panel admin → Configuración). El sistema revisa la bandeja cada 60 segundos buscando correos con [celula] en el asunto.

2
Elegir el tipo correcto y usar la estructura exacta del asunto

Hay cinco tipos de solicitud: BRIEF, REUNION, ACTUALIZACION, PROPUESTA y PERDIDA. Cada uno dispara un flujo diferente. Ver Sección 3 para los detalles de cada tipo.

3
Incluir el contenido relevante en el cuerpo del correo

Para un BRIEF: el encargo del cliente (mientras más detalle, mejor el brief). Para una REUNION: las notas y acuerdos de la sesión creativa. Para una ACTUALIZACION: la nueva información. Puedes adjuntar PDFs, DOCX, PPTX, imágenes, o pegar URLs.

4
El sistema responde automáticamente

Si el brief es completo: en 3–10 minutos el ejecutivo que envió el correo recibirá un resumen con el resultado. Cada especialista recibirá su convocatoria personalizada con 3 opciones de agenda.

Si el brief está incompleto: el sistema responde al mismo ejecutivo pidiendo la información faltante. El proyecto queda en ESPERANDO_INFO hasta que llegue.

⚠️
Regla de oro: El correo que recibe el sistema SIEMPRE lo envía un ejecutivo interno de INMOV — nunca el cliente externo. Los resúmenes y correos de información incompleta van de vuelta al ejecutivo que envió el brief, no al cliente final.

3 Tipos de solicitud — qué hace el sistema con cada uno

El segundo campo del asunto determina qué flujo ejecuta el sistema. Hay cinco tipos, cada uno con un comportamiento completamente distinto.

BRIEF

Nuevo proyecto desde cero

El ejecutivo recibió un encargo del cliente y lo manda al sistema para iniciar el proceso creativo completo.

El sistema hace: Pipeline completo de 14 pasos. Si el brief tiene información suficiente, produce propuesta + Slides. Si le falta info crítica, responde al ejecutivo pidiendo los datos y espera.

Estado final: PROPUESTA_LISTA (o ESPERANDO_INFO si el brief está incompleto)
REUNION

Notas de sesión creativa

La sesión creativa ya ocurrió. El ejecutivo manda las notas, acuerdos y decisiones de la reunión para que el sistema refine la propuesta.

El sistema hace: Carga todo el historial acumulado del proyecto (brief original + entradas anteriores), lo combina con las notas de la reunión, y relanza el pipeline completo. El Brief Validator no bloquea (si hubo reunión, había suficiente info). La presentación de Slides se actualiza, no se crea de nuevo.

Estado final: PROPUESTA_LISTA con propuesta enriquecida por la sesión
ACTUALIZACION

Nueva información al brief

El cliente o el ejecutivo envían información adicional, correcciones o cambios al encargo original.

El sistema hace: Igual que REUNION — carga todo lo acumulado, agrega la actualización al final, relanza el pipeline con el contexto completo. No bloquea por brief incompleto. Slides actualizado.

Estado final: PROPUESTA_LISTA con toda la información integrada
PROPUESTA

Enviar resumen al ejecutivo

El ejecutivo ya revisó la propuesta en el panel y quiere enviarla formalmente al ejecutivo que hizo el brief.

El sistema hace: No relanza el pipeline. Solo envía el correo de resumen ejecutivo al from_email del ejecutivo original con el link a la presentación en Slides.

Estado final: PROPUESTA_ENVIADA
PERDIDA

Registrar proyecto perdido

El cliente rechazó la propuesta. El ejecutivo registra la pérdida para que el sistema aprenda y nunca repita las mismas ideas con ese cliente.

El sistema hace: Extrae las razones de la pérdida (usando IA), guarda la lección en la base de datos, indexa el aprendizaje en la memoria vectorial, y actualiza el perfil del cliente para que los futuros proyectos con esa marca eviten los territorios creativos ya usados. Ver Sección 11.

Estado final: PERDIDO · La big idea y el territorio creativo quedan bloqueados para ese cliente
💡
Secuencia típica de un proyecto: BRIEF (semana 1) → ACTUALIZACION (si el cliente agrega info) → REUNION (después de la sesión creativa) → PROPUESTA (cuando la propuesta está lista para compartir) → PERDIDA o marcar como GANADO desde el panel.

4 Estructura del asunto del correo

El asunto tiene exactamente cuatro partes separadas por |. El sistema es estricto con el formato.

[celula] BRIEF| MA-0001-2026 | coca-cola | Campaña Verano 2026 ↑ TAG ↑ TIPO ↑ CÓDIGO ↑ CLIENTE ↑ TÍTULO DEL PROYECTO
Parte 1
[celula]
Etiqueta disparadora
Parte 2
TIPO
BRIEF / REUNION / etc.
Parte 3
MA-0001-2026
Código del proyecto
Parte 4
coca-cola
Nombre del cliente
Parte 5
Título proyecto
Descripción breve

Código del proyecto — formato obligatorio

Patrón: XX-0000-YYYY — letras mayúsculas, número de 3–4 dígitos con ceros a la izquierda, año de 4 dígitos.

✅
Válidos: MA-0001-2026, CP-0042-2026, DIG-0100-2026
Inválidos: ma-1-26, MA-01-2026, Proyecto-001

Ejemplos por tipo

[celula] BRIEF| MA-0001-2026 | coca-cola | Campaña Navidad 2026
[celula] REUNION| MA-0001-2026 | coca-cola | Notas sesión creativa 25 jun
[celula] ACTUALIZACION| MA-0001-2026 | coca-cola | Cambio de presupuesto y fechas
[celula] PROPUESTA| MA-0001-2026 | coca-cola | Enviar resumen ejecutivo
[celula] PERDIDA| MA-0001-2026 | coca-cola | El cliente eligió otra agencia
⚠️
Importante: El código del proyecto debe ser el mismo en todos los correos del mismo proyecto. El sistema usa ese código para acumular todas las entradas y construir la propuesta con el contexto completo.

5 Estado del proyecto — la máquina de estados

Cada proyecto tiene un estado que el sistema actualiza automáticamente. El estado indica exactamente en qué punto del flujo está cada proyecto.

ESPERANDO_INFO ↓ PROCESANDO → PROPUESTA_LISTA → PROPUESTA_ENVIADA →
GANADO PERDIDO AJUSTE_SOLICITADO
EstadoQué significaQué puede hacer el equipo
ESPERANDO_INFO El brief llegó pero le falta información crítica. El sistema ya le escribió al ejecutivo pidiendo los datos que faltan. Esperar que el ejecutivo reenvíe con más info. El sistema lo retoma automáticamente cuando llega el nuevo correo con el mismo código.
PROCESANDO El pipeline está corriendo ahora. El panel muestra el progreso en tiempo real con cada agente que completa su trabajo. Monitorear el progreso en tiempo real en el panel. No hacer nada — el sistema trabaja solo.
PROPUESTA_LISTA El pipeline terminó. La propuesta y la presentación en Slides están listas. Los especialistas ya fueron convocados. Revisar la propuesta en el panel. Hacer clic en "Enviar resumen al ejecutivo" cuando esté lista para compartir. O hacer clic en "Reprocesar" si se recibió nueva información.
PROPUESTA_ENVIADA El resumen fue enviado al ejecutivo que hizo el brief. La propuesta está en manos del equipo comercial. Esperar respuesta del cliente. Marcar como GANADO o PERDIDO desde el panel cuando se conozca la decisión.
AJUSTE_SOLICITADO El ejecutivo respondió al correo de resumen pidiendo cambios. El sistema capturó el feedback del correo de respuesta. Usar "Reprocesar" en el panel para que el sistema genere una propuesta ajustada con el feedback integrado.
GANADO El cliente eligió a INMOV. El proyecto está en producción. El sistema ya aprendió de este éxito y registró qué funcionó. No repetir esta big idea con este cliente en futuros proyectos (el sistema lo bloquea automáticamente).
PERDIDO El cliente eligió otra agencia o rechazó la propuesta. El sistema ya aprendió de este fracaso. Las ideas y territorios usados quedan bloqueados para futuros proyectos con este cliente.
ℹ️
Reprocesar: El botón "Reprocesar" en el panel recarga todas las entradas acumuladas del proyecto (todos los correos desde el primero) y relanza el pipeline completo. La presentación de Slides se actualiza (no se crea una nueva). Los especialistas ya notificados no reciben correo duplicado.

6 Carpetas en Google Drive

El sistema mantiene una estructura de carpetas en Google Drive. Las carpetas de capacitación entrenan la memoria del sistema. Las carpetas de proyecto se crean automáticamente y también almacenan la presentación en Slides generada por el sistema.

Estructura completa de la raíz

📁 Raíz de Drive
    ├── 📁 brief ← entrena al Brief Master con briefs históricos de INMOV
    ├── 📁 presupuesto ← entrena al CFO Creativo con cómo se manejan los valores
    ├── 📁 propuesta creativa ← entrena al Idea Generator con propuestas exitosas pasadas
    └── 📁 Información del proyecto
           ├── 📁 [celula] BRIEF| MA-0001-2026 | coca-cola | Campaña Navidad
           │    ├── brief_semilla.pdf
           │    ├── referencia_visual.jpg
           │    ├── propuesta_cliente.docx
           │    └── 🎨 Propuesta MA-0001-2026.pptx ← generado automáticamente por el Slides Creator
           ├── 📁 [celula] BRIEF| MA-0042-2026 | banco-popular | App Móvil
           │    ├── concepto_banco.pdf
           │    └── ...
           └── 📁 ...

Convención de nombres para carpetas de proyecto

El nombre de la carpeta dentro de "Información del proyecto" debe coincidir exactamente con la estructura del asunto del correo:

[celula] BRIEF| MA-0001-2026 | coca-cola | Campaña Navidad 2026 El nombre de la carpeta es idéntico al asunto del correo que disparó el proyecto.
ℹ️
El sistema busca la carpeta del proyecto usando el código de proyecto (ej: MA-0001-2026). No es necesario que el nombre completo sea exacto para que funcione la búsqueda — pero usar la convención completa mantiene el Drive ordenado y facilita la búsqueda manual.

Qué documentos poner en la carpeta del proyecto

Tipo de documentoEjemploPara qué sirve
Brief semilla brief_cliente.pdf, brief_semilla.docx El Brief Master lo usa como input principal para construir el brief profesional
Referencias visuales referencias.jpg, moodboard.pdf El Idea Generator puede incorporar el estilo visual al concepto
Documentos del cliente manual_marca.pdf, lineamientos.docx Restricciones y mandatorios que los agentes respetan
Propuestas anteriores propuesta_2025.pdf Contexto de lo que ya se intentó con este cliente
Notas de reunión notas_kickoff.txt Cualquier información capturada antes del correo disparador
💡
Recomendación: Crear la carpeta en Drive antes de enviar el correo disparador. Así cuando el sistema inicia la ejecución ya tiene contexto disponible y el brief resultante será mucho más preciso.

Las carpetas de capacitación

Estas tres carpetas son el "cerebro aprendido" del sistema. A diferencia de las carpetas de proyecto que se leen en el momento, estas se indexan con el Workflow B y se almacenan como vectores en la base de datos.

📁 brief

Briefs históricos reales de INMOV. Cuantos más y de mejor calidad, mejor aprende el Brief Master a replicar el estilo y profundidad de la agencia. Formato ideal: PDF o DOCX con el brief completo.

📁 presupuesto

Propuestas económicas, tablas de honorarios, rangos de precios por tipo de proyecto. El CFO Creativo usa esto para calibrar si la rentabilidad estimada es realista.

📁 propuesta creativa

Propuestas creativas completas que INMOV haya presentado, especialmente las ganadoras. El Idea Generator aprende el nivel de ejecución, el formato y el estilo narrativo de INMOV.

⚠️
Cada vez que se agreguen nuevos documentos a estas carpetas, hay que volver a correr el Workflow B para que el sistema aprenda el contenido nuevo.

7 Los agentes — qué hace cada uno

El pipeline ejecuta los agentes en secuencia. Cada uno recibe el trabajo del anterior y lo enriquece. Hay tres etapas paralelas al final (Slides + Memory + DB corren al mismo tiempo).

01
Parser / Normalizador Organización
Extrae y valida el código de proyecto, nombre del cliente, tipo de solicitud y título desde el asunto del correo. Normaliza los datos para que todos los agentes siguientes hablen el mismo idioma.
Produce: proyecto_codigo, cliente, tipo_solicitud, titulo_proyecto
02
Brief Master IA Gemini
Toma todas las entradas acumuladas del proyecto (correo actual + histórico para REUNION/ACTUALIZACION + documentos de Drive), las combina con los briefs históricos más similares de la memoria vectorial, y construye un brief creativo profesional. Cubre 12 secciones: contexto de marca, problema, público, insight, propuesta de valor, mensaje único, tono, plataforma, entregables, mandatorios, KPIs y resumen ejecutivo.

Para REUNION: integra los acuerdos de la sesión, priorizando las decisiones tomadas en reunión sobre el brief original. Para ACTUALIZACION: fusiona la nueva información sin descartar el contexto acumulado.
Produce: brief_iso (JSON completo), brief_resumen, tipo_proyecto, complejidad, disciplinas
01b
Brief Validator Control de calidad
Evalúa si el brief tiene suficiente información para que un equipo creativo pueda trabajar. Verifica que estén presentes: público objetivo claro, problema de negocio definido, fecha o plazo, y entregables o formato. Si faltan 2 o más de estos elementos críticos, detiene el pipeline, cambia el estado a ESPERANDO_INFO y envía un correo al ejecutivo pidiendo los datos específicos que faltan.

No aplica para REUNION ni ACTUALIZACION — si ya hubo suficiente contexto para reunirse, no se vuelve a validar.
Produce: brief_incompleto (true/false), campos_faltantes (si aplica)
03
Cell Architect IA Gemini
Lee el brief y consulta el catálogo de expertos disponibles en la base de datos. Selecciona la combinación óptima de especialistas, asigna roles y responsabilidades, genera la agenda detallada para la sesión creativa, y construye la hoja de ruta de producción con 5 fases.

La fecha de la sesión viene del brief si el cliente especificó una fecha de debrief o kick-off. Si no, propone el día hábil siguiente como mínimo — nunca una fecha pasada.
Produce: celula_ideal (líder + especialistas), agenda_sesion, hoja_de_ruta, fecha_sugerida_sesion
04a
Cell Coordinator IA Gemini
Para cada especialista seleccionado, redacta un correo de convocatoria personalizado. Incluye el contexto del proyecto, la responsabilidad específica del especialista, la tarea previa a preparar, y las preguntas que debe responder en la sesión.
Produce: asunto y cuerpo HTML para cada correo de convocatoria
04b
Cliente Intel IA Gemini
Carga todo el historial del cliente: proyectos ganados, proyectos perdidos, ideas ya propuestas y territorios creativos ya usados. Construye un bloque de restricciones absolutas que se inyecta en los agentes creativos para garantizar que ninguna idea repita lo que ya se le propuso a este cliente.

También carga el perfil de decisión del cliente (qué le gusta, qué no le gusta, quiénes son los decisores) para personalizar el enfoque estratégico.
Produce: cliente_intel, restricciones_txt, ideas_usadas, territorios_agotados, razones_perdida
05
Strategic Challenger IA Gemini
El investigador y estratega del sistema. Lee el brief e investiga marca, competencia, mercado y público objetivo. Para encontrar el reto estratégico real confronta el brief internamente desde cuatro voces (CEO del cliente, consumidor escéptico, competencia agresiva, director creativo de Cannes) sin exponerlas como campos separados. No genera ideas creativas — solo investigación y planteamiento estratégico. Recibe también el perfil del cliente y las restricciones de historial para que su análisis sea específico.
Produce: contexto_y_estado_del_arte, el_verdadero_reto_estrategico, planteamiento_investigacion, planteamiento_estrategico
06
Idea Generator IA Gemini
El creativo del sistema. Genera tres ideas radicalmente distintas. Para cada una produce: nombre del concepto, big idea, manifiesto, dirección de arte completa, textos de ejemplo, plan de medios sugerido y justificación Cannes.

Regla absoluta: ninguna idea puede ser variación de las ideas o territorios creativos ya usados con este cliente (inyectadas por el Agente 04b). El sistema rechaza internamente cualquier idea que viole esta restricción.
Produce: 3 ideas completas con scores, big_idea seleccionada, nombre_concepto
07
Cannes Judge IA Gemini
Evalúa las ideas como jurado de Cannes Lions. Puntúa cada idea en originalidad, relevancia cultural, impacto de negocio y potencial de ejecución. Identifica si alguna tiene potencial real para premios y da retroalimentación específica y accionable.
Produce: score_cannes (0–100), nivel_cannes, tiene_potencial_cannes, feedback por idea
08
CFO Creativo IA Gemini
Evalúa la rentabilidad desde la perspectiva financiera de la agencia. Cruza la complejidad, las disciplinas requeridas y los datos históricos de presupuestos para estimar el margen, el riesgo financiero y la probabilidad de pérdida. Genera recomendaciones para el equipo comercial.
Produce: score_rentabilidad (0–100), probabilidad_perdida (0–100), recomendaciones financieras
09a
Propuesta Creativa IA Gemini
Consolida todo y genera la propuesta narrativa completa — el documento que se presenta internamente. Integra brief, big idea, evaluación Cannes y análisis financiero en un paquete coherente y bien estructurado.
Produce: propuesta_creativa (documento narrativo completo)
09b
Slides Creator Salida · Google Slides
Crea (o actualiza) la presentación en Google Slides dentro de la carpeta del proyecto en Drive. Si el proyecto ya tiene una presentación, la actualiza en el mismo archivo — no crea una nueva. La presentación incluye: portada, brief ejecutivo, big idea, los tres conceptos, evaluación Cannes, análisis financiero y propuesta narrativa.

El link a la presentación se incluye en el correo kick-off al ejecutivo.
Produce: slides_url (link de Google Slides), slides_id para futuras actualizaciones
10
Memory Writer Aprendizaje
Guarda el resumen del proyecto en la memoria vectorial. Extrae los puntos clave del brief, la big idea y la evaluación, y los almacena como embeddings en PostgreSQL con pgvector. Con el tiempo esto enriquece la calidad de todos los agentes que consultan la memoria.
Produce: registro de memoria vectorial, memoria_guardada = true
11
DB Writer Persistencia
Persiste todos los resultados en PostgreSQL. Guarda el brief, las ideas, los scores, los especialistas seleccionados y el paquete completo. Actualiza el estado del proyecto a PROPUESTA_LISTA. Los especialistas se insertan con ON CONFLICT DO UPDATE — si ya existían de un procesamiento anterior, se actualizan sin duplicar.
Produce: registro completo en DB, estado → PROPUESTA_LISTA
12
Notificador Salida · Gmail
Envía los correos de convocatoria a cada especialista vía Gmail. Omite automáticamente a los especialistas que ya fueron notificados en un procesamiento anterior — no hay correos duplicados si se usa Reprocesar.

Si un especialista delegó su participación a otro miembro del equipo, el correo se redirige al delegado automáticamente.
Produce: correos enviados a especialistas nuevos, lista de notificados

8 Correos que genera el sistema

El sistema envía cuatro tipos de correo, todos a través de la cuenta de la célula. Nunca se envía correo al cliente externo — todos los correos van al equipo interno de INMOV.

Tipo 1 — Correo disparador (lo envía el ejecutivo, lo recibe el sistema)

Tipo 2 — Solicitud de información (si el brief está incompleto)

El sistema envía este correo al mismo ejecutivo que mandó el brief cuando le falta información crítica. El proyecto queda en ESPERANDO_INFO.

Tipo 3 — Convocatoria a especialista con opciones de agenda

El sistema genera un correo diferente para cada especialista, personalizado según su rol y tarea. Incluye 3 opciones de fecha para manejar conflictos de agenda — el sistema consulta Google Calendar de todos los expertos para proponer horarios donde todos estén libres.

Tipo 4 — Resumen ejecutivo (al ejecutivo que envió el brief)

Este correo llega cuando el equipo hace clic en "Enviar resumen al ejecutivo" desde el panel, o cuando se usa tipo PROPUESTA en el asunto. Va al mismo from_email que envió el brief original.

9 Timeline completo — De correo a célula convocada

Lo que sucede desde que el ejecutivo envía el correo hasta que cada especialista tiene su convocatoria — y el ejecutivo tiene el link a la presentación en Slides.

📧
T+0 seg
El ejecutivo envía el correo a la célula
Correo a celula@inmov.com con el asunto en formato correcto y el brief en el cuerpo. El from_email del ejecutivo queda registrado — todos los correos del sistema irán a esa dirección.
🔍
T+0 a 60 seg
El listener detecta el correo
El Gmail Listener revisa la bandeja cada 60 segundos. Al detectar [celula], extrae el código, cliente, tipo y título. Guarda la entrada en BD con el from_email del ejecutivo. Verifica el estado actual del proyecto — si ya existe y está en PROPUESTA_ENVIADA/AJUSTE_SOLICITADO, el correo entrante se trata como feedback y cambia el estado a AJUSTE_SOLICITADO sin relanzar el pipeline.
📂
T+60 a 90 seg
Drive: carpeta y contexto del proyecto
El sistema crea la carpeta del proyecto en Drive si no existe. Si ya existe, la reutiliza. Lee todos los documentos de la carpeta (PDFs, DOCX, etc.) y los agrega al contexto. Estado → PROCESANDO.
📋
T+90 seg a T+2 min
Brief Master construye el brief profesional
Consulta la memoria vectorial (briefs históricos similares) y construye el brief en formato ISO 9001 — 12 secciones completas. Para REUNION: fusiona el brief original con las notas de la sesión, priorizando las decisiones tomadas. Para ACTUALIZACION: integra la nueva información al contexto acumulado.
✅
T+2 min (decisión)
Brief Validator — ¿continuar o pedir más info?
Evalúa si el brief tiene los 4 elementos críticos. Si está completo: continúa. Si le faltan 2+ elementos: cambia estado a ESPERANDO_INFO, envía correo al ejecutivo con las preguntas específicas, y el pipeline se detiene. El sistema retoma automáticamente cuando llega el correo de respuesta. No aplica para REUNION ni ACTUALIZACION.
🏗️
T+2 a T+3 min
Cell Architect + Cliente Intel
Cell Architect selecciona la célula ideal, genera la agenda y la hoja de ruta. Fecha de sesión: usa la del brief si el cliente la especificó; si no, propone el día hábil siguiente mínimo. Cliente Intel carga el historial completo del cliente y construye las restricciones de ideas para los agentes creativos.
⚡
T+3 a T+6 min
Strategic Challenger → Idea Generator → Cannes Judge + CFO
El challenger ataca el brief desde 4 ángulos. El generador produce 3 conceptos creativos completamente nuevos (garantizado por las restricciones de historial). Cannes Judge y CFO Creativo evalúan en paralelo. El mejor concepto es seleccionado automáticamente.
🎨
T+6 a T+8 min
Propuesta Creativa → Slides + Memory + DB (en paralelo)
El agente narrativo consolida todo en la propuesta completa. Simultáneamente: Slides Creator crea o actualiza la presentación en Google Drive; Memory Writer indexa el aprendizaje; DB Writer persiste todo y cambia estado a PROPUESTA_LISTA.
📬
T+8 a T+10 min
Notificador — convocatorias a especialistas nuevos
El Notificador consulta Google Calendar de todos los especialistas para proponer 3 opciones de agenda donde todos estén libres. Envía el correo personalizado a cada especialista que no fue notificado previamente. El panel muestra la propuesta lista. El equipo puede hacer clic en "Enviar resumen al ejecutivo" cuando quiera.

10 Panel de administración

El panel de administración es el centro de control del sistema. Desde aquí se monitorean proyectos, se gestionan expertos, se editan prompts y se ejecutan acciones sobre proyectos individuales.

Cómo acceder

Navegar a https://tu-servidor/admin y hacer login con las credenciales de admin configuradas en el .env. En local: http://localhost:8000/admin.

Pestaña Pipeline — Vista Kanban

La vista principal de trabajo comercial. Muestra todos los proyectos activos agrupados por estado en columnas.

Esperando Info
MA-0003-2026

banco-popular

Brief incompleto

Procesando
MA-0007-2026

coca-cola

Corriendo pipeline...

Propuesta Lista
MA-0005-2026

claro

Listo para enviar

Propuesta Enviada
MA-0002-2026

bavaria

En manos del cliente

Hacer clic en cualquier tarjeta del Kanban abre el detalle completo del proyecto.

Acciones disponibles por estado

EstadoBotones disponiblesQué hacen
ESPERANDO_INFO Reprocesar Relanza el pipeline con las entradas acumuladas hasta el momento. Útil si el equipo agregó información manualmente en Drive.
PROCESANDO Progress bar en tiempo real Muestra cada agente que completa su trabajo vía SSE. No hay acciones manuales mientras corre.
PROPUESTA_LISTA Enviar resumen al ejecutivo · Ver Slides · Reprocesar Enviar resumen: manda el correo de resumen ejecutivo al ejecutivo que hizo el brief. Ver Slides: abre la presentación en Google Drive. Reprocesar: relanza el pipeline completo.
PROPUESTA_ENVIADA Marcar Ganado · Marcar Perdido · Ver Slides Cuando se conozca la decisión del cliente, marcar el resultado. El sistema aprende de ambos resultados.
AJUSTE_SOLICITADO Reprocesar · Ver Slides El ejecutivo respondió con feedback. Reprocesar relanza el pipeline con todos los correos acumulados (incluyendo el feedback) para generar una propuesta ajustada.

Pestaña Proyectos — Lista completa

Vista de todos los proyectos con filtros por estado, cliente y fecha. Permite buscar y acceder al historial completo de cualquier proyecto.

Pestaña Expertos

Catálogo completo de especialistas. El Cell Architect solo convoca expertos registrados aquí. Campos clave: nombre, correo, especialidad, áreas de dominio, disponibilidad. Si un experto está desactivado, no aparece como candidato en ningún proyecto nuevo.

Pestaña Configuración

Variables del sistema editables sin tocar código ni reiniciar: email de la célula, URL base, configuración de Google Calendar para búsqueda de slots, y ajustes de los listeners.

Pestaña Prompts

Cada agente tiene un prompt editable en tiempo real. Los cambios se guardan en la base de datos y aplican al siguiente procesamiento sin reiniciar el servidor. Útil para ajustar el tono, el nivel de detalle o las instrucciones de cualquier agente.

Pestaña Indexador

Lanza el indexador de Drive para actualizar la memoria vectorial con los documentos nuevos de las carpetas de capacitación (brief, presupuesto, propuesta creativa). Requiere token de admin.

11 Aprendizaje automático — ganadas y perdidas

Cada vez que un proyecto se marca como ganado o perdido, el sistema extrae lecciones estructuradas y las usa para nunca repetir los mismos errores ni las mismas ideas con el mismo cliente.

Qué aprende de cada PERDIDA

Al marcar un proyecto como perdido (desde el panel o enviando tipo PERDIDA), el sistema extrae automáticamente:

  • Razón de la pérdida: por qué el cliente eligió otra opción
  • Factores clave: qué elementos de la propuesta fallaron
  • Ideas ya rechazadas: la big idea y el territorio creativo usados quedan bloqueados para este cliente
  • Lección indexada: se guarda en la memoria vectorial como leccion_perdida para que futuros briefs similares la consulten
⚠️
Regla absoluta: Ningún proyecto futuro para el mismo cliente puede proponer una big idea que sea variación de las ideas ya rechazadas. El Idea Generator recibe estas restricciones como regla de hierro antes de generar.

Qué aprende de cada GANADA

Al marcar un proyecto como ganado (desde el panel), el sistema extrae:

  • Razón del éxito: qué convenció al cliente
  • Factores clave para replicar: qué elements de la propuesta ganadora deben repetirse en futuros proyectos
  • Territorio agotado: la big idea ganadora también queda bloqueada para no repetirse — un cliente que ya vio una idea no quiere ver la misma de nuevo
  • Lección indexada: se guarda como leccion_ganada para que futuros proyectos aprendan qué funciona con este cliente

Dónde se usa este aprendizaje

AgenteCómo usa el historial
Cliente Intel (04b) Carga todo el historial y construye el bloque de restricciones. Es el único agente que toca la BD de ganadas/perdidas directamente.
Strategic Challenger (05) Recibe el perfil del cliente (qué le gusta, qué no, razones de pérdidas anteriores) para que sus desafíos sean específicos a ese cliente.
Idea Generator (06) Recibe la lista de ideas ya usadas y territorios agotados con instrucción explícita: "REGLA ABSOLUTA — no proponer ninguna big idea que sea variación de las ideas listadas."
Brief Master (02) Consulta la memoria vectorial que incluye lecciones de ganadas y perdidas para construir un brief que evite los errores documentados.
💡
Resultado a largo plazo: Con el tiempo, el sistema acumula un perfil de decisión detallado para cada cliente. Sabe qué territorios creativos están agotados, qué razones han causado pérdidas, qué ha convencido en el pasado, y quiénes son los decisores. Cada proyecto con el mismo cliente es más preciso que el anterior.

12 Qué hacer si algo falla

Los fallos más comunes y cómo resolverlos sin tocar el código.

SíntomaCausa probableQué hacer
El sistema no procesa el correo Asunto incorrecto o cuenta equivocada Verificar que el asunto empieza con [celula] (con corchetes). Verificar que el correo fue a la cuenta de célula configurada. Ver logs en el panel admin.
Proyecto se queda en ESPERANDO_INFO para siempre El ejecutivo respondió pero con asunto diferente, perdiendo el código Pedir al ejecutivo que reenvíe el correo con el mismo asunto original (mismo código). O usar "Reprocesar" desde el panel después de agregar información manualmente en Drive.
El brief generado es genérico El cuerpo del correo tenía muy poco contexto, carpeta Drive vacía, o las carpetas de capacitación no están indexadas Reenviar con tipo ACTUALIZACION y más información. Agregar documentos en Drive. Correr el indexador desde el panel si las carpetas de entrenamiento no están al día.
Los correos de convocatoria no llegaron Especialistas no registrados o correos incorrectos Revisar la tabla de Expertos en el panel. Verificar emails. Si el especialista existe pero no llegó, puede que ya estuviera marcado como notificado de un procesamiento anterior — verificar en el detalle del proyecto.
La presentación de Slides no se genera Token de Google Slides vencido o sin permisos de presentaciones Regenerar el token OAuth en el servidor. Asegurarse de que el scope presentations está autorizado. El token se regenera corriendo el flujo de autorización de Google en el servidor.
Las opciones de agenda son genéricas (no consultan Calendar) Los especialistas tienen calendarios de dominio diferente al de la célula, o Calendar no está compartido Normal — el sistema usa fallback de 3 opciones estándar (9h, 10h, 14h en días hábiles) cuando no puede consultar los calendarios. Pedir a los especialistas que compartan sus calendarios con la cuenta de la célula.
Pipeline tarda más de 15 minutos Timeout de un agente o error de conexión con Gemini Revisar los logs. Si el error es de API Gemini, verificar que la clave siga activa. Usar "Reprocesar" desde el panel una vez resuelto el problema de conectividad.
Las ideas repiten territorios de proyectos anteriores del cliente Las pérdidas/ganancias no fueron marcadas en el sistema, o el nombre del cliente no es consistente Verificar que el nombre del cliente en el asunto del correo es siempre el mismo (ej: siempre coca-cola, nunca cocacola ni Coca Cola). Marcar los proyectos ganados y perdidos desde el panel para que el sistema aprenda.

13 Credenciales y configuración inicial

El sistema necesita seis credenciales para funcionar. Todas deben estar configuradas antes del primer uso.

CredencialTipoCómo obtenerla
CRED_GEMINI Google AI API Key Ir a aistudio.google.com → Get API Key. Esta es la clave principal para todos los agentes de IA.
CRED_POSTGRES Conexión PostgreSQL Host, puerto (5432), nombre de base de datos, usuario y contraseña de tu instancia de Postgres con pgvector habilitado.
CRED_GMAIL Google OAuth2 Autorizar la cuenta celula@inmov.com vía OAuth2. El archivo de token queda en credentials/token.json.
CRED_GDRIVE Google Drive OAuth2 Misma cuenta Google que Gmail. Se autoriza en el mismo flujo OAuth2.
CRED_GCALENDAR Google Calendar OAuth2 Misma cuenta Google. Permite que el listener de Calendar detecte reuniones relacionadas con proyectos.
CRED_GEMINI_EMBED HTTP Query Auth Misma API Key de Gemini. Se configura como parámetro de URL con nombre key y el valor de la API Key.

Variables de entorno que deben ajustarse

# Archivo .env en la raíz del proyecto
 
EMAIL_CELULA=celula@inmov.com ← cuenta que recibe los correos disparadores
EMAIL_LIDER=lider@inmov.com ← quien recibe el resumen ejecutivo
EMAIL_COMERCIAL=comercial@inmov.com ← para notificaciones al equipo comercial
GDRIVE_CARPETA_PROYECTOS=ID_DE_CARPETA ← ID de la carpeta "Información del proyecto" en Drive
GEMINI_API_KEY=AIza...
DATABASE_URL=postgresql://user:pass@host:5432/inmov
💡
El ID de una carpeta de Google Drive se obtiene abriendo la carpeta en el navegador. La URL tiene el formato drive.google.com/drive/folders/ID_AQUI. El ID es la cadena alfanumérica al final.