Synapse: El Cerebro de Datos de tu Negocio
Dentro de Synapse Studio — el sistema nervioso central que organiza agentes IA con orquestación multi-agente, 7 capacidades multimodales (TTI, TTS, STT, ITT, I2I, Web, LLM), subtareas con CEO digital, y ejecución autónoma.
Imagina tu empresa como un edificio. Cada planta es un departamento: ventas, soporte, marketing, operaciones. En cada planta trabajan agentes de IA con roles específicos, ejecutando tareas, respondiendo a eventos y comunicándose entre sí. Synapse Studio no es una metáfora — es literalmente cómo Cadences modela las operaciones de tu negocio.
Con más de 6.000 líneas de API backend, Synapse es el módulo más grande de Cadences. Existen 45+ endpoints que cubren orquestación multi-agente con ejecución paralela, 7 capacidades multimodales (generación de imágenes, audio, transcripción, visión, búsqueda web), un sistema de subtareas con CEO digital que revisa y aprueba propuestas, acceso a datos organizacionales, y gamificación completa con XP, logros y leaderboards.
La metáfora del edificio
Synapse modela tu organización como un edificio con plantas. Cada planta tiene su propio contexto, agentes asignados y configuración. Un agente de "Ventas" en la Planta 2 no ve los datos de "RRHH" en la Planta 5 — el aislamiento es arquitectural, no un permiso que se olvida.
Edificios, Plantas, Agentes y Tareas
Todo en Synapse gira alrededor de cuatro entidades fundamentales. La jerarquía es clara: la organización tiene edificios, los edificios tienen plantas, las plantas tienen agentes, y los agentes ejecutan tareas.
Buildings
La unidad organizativa de nivel superior. Una empresa puede tener múltiples edificios: "Oficina Central", "Operaciones LATAM", "Centro de IA". Cada uno con su propia configuración y tema visual.
Floors
Departamentos dentro del edificio. Cada planta tiene su propio contexto — documentos, prompts base, datos de referencia — que alimenta a los agentes que trabajan en ella. Se pueden crear, reordenar y eliminar dinámicamente.
Agents
Trabajadores de IA con nombre, rol, departamento, nivel, personalidad, avatar, estado (idle/working/break), mood, energía, XP y posición visual en la planta. Cada agente tiene su propio system_prompt y configuración de personalidad.
Tasks
Unidades de trabajo asignables con título, descripción, prioridad (low/medium/high/critical), tipo (text/image/vision/audio/data/mixed), prompt de IA, y flujo de aprobación (approve/reject). Se ejecutan contra modelos de IA configurables por organización.
45+ Endpoints, Un Solo Router
Todo el backend de Synapse vive en un solo archivo catch-all ([[path]].js) que rutea por segmentos de URL. Esto simplifica el deploy y permite que cada endpoint comparta utilidades como generateId(), generateContent() y acceso directo a D1.
| Recurso | Operaciones | Uso |
|---|---|---|
| Buildings | GET, POST, PUT | Crear y gestionar edificios de la organización |
| Floors | GET, POST, PUT, DELETE + Context | Plantas con contexto documental propio |
| Agents | CRUD + State, Break, Achievements, Ratings | Gestión completa de agentes IA con gamificación |
| Tasks | CRUD + Execute, Steps, Approve, Reject, Report | Tareas con ejecución IA y flujo de aprobación |
| Subtasks | Auto-create via CEO, Parent propagation | Subtareas con revisión por CEO digital |
| Cron / Heartbeat | GET trigger, Auto-execute pending | Ejecución autónoma por scheduler externo |
| Events | GET, POST, Batch | Registro de eventos del sistema (audit trail) |
| Conversations | GET, POST | Historial de conversaciones entre agentes y usuarios |
| Input Sources | CRUD + Form Link + Items | Fuentes de datos: emails, forms, APIs, webhooks |
| Output Destinations | CRUD + Items + Send | Destinos: emails, Slack, webhooks, reports |
| Context Analysis | POST analyze, GET latest | Análisis automático del estado de agentes y tareas |
| Scores / Leaderboard | GET scores, GET leaderboard | Puntuaciones y ranking de agentes por XP |
| Achievements | GET by org/agent | Logros desbloqueables con tiers y recompensas XP |
| Templates | GET all, GET by dept | Plantillas predefinidas para agentes y tareas |
| Org Config | GET, PUT | Configuración de IA, orquestador, capacidades, subtareas |
| Media (R2) | GET serve by key | Servir imágenes/audio generados desde R2 |
Anatomía de un Agente Synapse
Cada agente en Synapse tiene más de 20 atributos que definen quién es, qué hace, cómo se siente y dónde está. Esto va mucho más allá de un simple "chatbot con prompt" — es un trabajador digital con estado, personalidad y progresión.
◆ Identidad
name— Nombre del agenterole— Tipo: agent, supervisor, analystrole_title— Título visible: "Sales Rep", "QA Lead"department— Departamento asignadolevel— Nivel de experiencia (1-N)avatar_sprite— Sprite visual para la UI
◆ Inteligencia
system_prompt— Instrucciones base del agentepersonality_config— JSON de personalidadcapabilities— Array multimodal: llm, tti, tts, stt, itt, i2i, webcan_create_subtasks— Puede proponer sub-tareas al CEO digitaldata_access_level— Nivel de acceso a datos (0=ninguno, 1=depto, 2=org)
◆ Estado en Tiempo Real
current_state— idle, working, break, offlinecurrent_mood— neutral, happy, focused, tiredenergy_level— 0.0 a 100.0consecutive_tasks— Tareas seguidas sin pausacurrent_task_id— Tarea activa actuallast_break_at— Último descanso
◆ Progresión
xp_points— Puntos de experiencia acumuladosposition_x,position_y— Posición en la plantais_active— Activo o deshabilitado- Achievements desbloqueables
- Ratings de otros agentes/usuarios
7 Capacidades Multimodales
Cada agente tiene un array de capabilities que define qué puede hacer más allá de texto. El orquestador asigna pasos a los agentes que tienen la capacidad requerida y valida que el agente elegido realmente la posea — si no, reasigna automáticamente.
LLM
Generación de texto. Todos los agentes la tienen. DeepSeek, Groq, Gemini, Cloudflare AI.
TTI — Text-to-Image
Genera imágenes vía FLUX Schnell (Cloudflare Workers AI). El LLM crea el prompt en inglés, luego se genera y almacena en R2.
TTS — Text-to-Speech
Genera audio con ElevenLabs (multilingual v2) o MeloTTS (CF AI). El LLM redacta el texto, luego se sintetiza y sube a R2.
STT — Speech-to-Text
Transcribe audio con Whisper (CF AI). Los URLs de audio se detectan automáticamente, se transcriben y se inyectan en el prompt para análisis.
ITT — Image-to-Text
Análisis visual con Llama 4 Scout (Groq). Las imágenes adjuntas se envían como contexto visual multi-imagen al modelo.
I2I — Image-to-Image
Transforma imágenes con Stable Diffusion v1.5. Controla strength (0.3 sutil → 0.9 radical). Soporta evolución iterativa automática.
Web — Búsqueda Internet
Búsqueda vía Groq Compound Beta. Genera queries automáticas desde el título/descripción y enriquece el contexto con datos reales.
Post-procesamiento automático
Cada capacidad tiene su pipeline de post-procesamiento: el LLM genera el contenido intermedio (prompt de imagen, texto para narrar, análisis), y luego el sistema ejecuta la acción real (generar imagen, sintetizar audio, almacenar en R2). Los assets resultantes se agregan al resultado final y se propagan a subtareas hijas.
Pipeline de Ejecución Orquestada
Cuando una tarea se ejecuta, Synapse no simplemente llama a un LLM. Orquesta una colaboración multi-agente con ejecución paralela, validación de capacidades y compilación de resultados. La función executeTaskInternal() es invocable tanto por HTTP como por cron, y se ejecuta en background vía ctx.waitUntil().
Resolución de configuración + agentes
loadOrgConfigForTask() carga el tier, modelos, límites de tokens y capability_config desde D1. Luego se cargan todos los agentes activos de la organización para el equipo de colaboración.
Orquestación AI — Plan de colaboración
orchestrateCollaboration() envía el roster completo de agentes (con capabilities, energía, estado) al LLM orquestador (DeepSeek por defecto). El resultado es un plan con parallel_groups: pasos que se ejecutan en paralelo dentro de cada grupo, y los grupos se ejecutan secuencialmente. Si el orquestador falla, un fallback inteligente detecta la capacidad requerida por keywords del título.
Validación de capacidades
El sistema valida que cada agente asignado tenga la required_capability del paso. Si un agente [llm] está asignado a un paso tti, se reasigna automáticamente a un agente que sí tenga la capacidad — o se mantiene con un warning si ninguno la tiene.
Ejecución paralela con timeout
Cada grupo ejecuta sus pasos en paralelo real vía Promise.allSettled(), con timeout de 2 minutos por paso. Cada agente recibe un prompt personalizado con su system_prompt, instrucciones de capacidad, datos organizacionales, y las contribuciones de grupos anteriores como contexto.
Post-procesamiento multimodal
Según la capacidad del paso, se ejecuta el pipeline correspondiente: TTI extrae el prompt → genera imagen con FLUX → almacena en R2. TTS extrae texto → sintetiza con ElevenLabs → sube MP3 a R2. STT transcribe con Whisper antes del LLM. Cada output se registra en synapse_task_steps con tipo, contenido y timing.
Agregación + assets creativos
Se agregan imágenes, audios y transcripciones de todos los pasos en el resultado final. Si hay assets creativos, se inyecta un deep-link a Perspectiva Studio para crear contenido de redes sociales con el material generado.
Subtareas + CEO digital
Los agentes con can_create_subtasks pueden proponer subtareas derivadas. Un LLM "CEO" revisa cada propuesta, asigna agentes por departamento y expertise, y las crea con límites de profundidad y conteo configurables. Las imágenes/audio del padre se propagan automáticamente a las hijas.
Estado, XP, routing + iteración
La tarea pasa a completed o waiting_approval según el nivel del agente. Se otorga XP, se verifican achievements, y se rutean resultados a destinos de salida configurados. Si el usuario rechaza con feedback, el sistema detecta la capacidad original y re-ejecuta con TTI/TTS preservados.
CEO Digital y Sistema de Subtareas
Los agentes con la flag can_create_subtasks pueden incluir un campo subtareas_propuestas en su output JSON. El sistema recoge todas las propuestas y las envía a un LLM "CEO" que actúa como director ejecutivo digital.
Revisión inteligente
El CEO valida cada propuesta, rechaza duplicadas o vagas, mejora títulos/descripciones, y decide la prioridad real.
Asignación por expertise
Asigna cada subtarea al agente más adecuado por departamento, nivel y capabilities. Valida IDs reales (no alucinados).
Propagación de assets
Imágenes y audios generados por la tarea padre se propagan como parent_images/parent_audios en el metadata de las hijas.
Límites configurables
subtask_max_per_task (default 5) — máximo de subtareas por tarea raíz. subtask_max_depth (default 2) — profundidad máxima de cadena. subtask_auto_execute — si las subtareas se ejecutan automáticamente o esperan aprobación manual.
Acceso a Datos Organizacionales
Los agentes con data_access_level ≥ 1 pueden consultar datos de las Input Sources de la organización. El sistema carga schemas de proyectos vinculados, inyecta los datos disponibles en el prompt, y permite que el agente solicite búsquedas específicas con busqueda_datos.
// El agente puede solicitar búsquedas en sus fuentes
{
"resultado": "Análisis de clientes activos...",
"busqueda_datos": [
{
"fuente": "Clientes CRM",
"campos": ["nombre", "email", "plan"],
"buscar": "enterprise",
"limite": 10
}
]
}
Cuando el agente incluye busqueda_datos, el sistema ejecuta las búsquedas contra D1, inyecta los resultados en un segundo prompt, y re-ejecuta al agente con los datos reales. Esto permite que un agente de ventas consulte "¿cuántos clientes enterprise tenemos?" y obtenga datos reales de su CRM — no invente números.
Fuentes de Entrada y Destinos de Salida
Synapse no vive aislado. Las Input Sources son las puertas de entrada de datos: emails, formularios web, webhooks, APIs externas. Los Output Destinations son a dónde van los resultados: emails automáticos, canales de Slack, webhooks, reportes PDF.
→ Input Sources
Emails entrantes se parsean y convierten en items procesables por agentes.
Links de formulario público con /form-link para captura directa de datos.
Recibe datos de sistemas externos en JSON para procesamiento automático.
← Output Destinations
Envío de resultados, reportes y notificaciones por email.
Notificaciones a canales de equipo o sistemas externos.
Cada output se registra como item con estado de envío para trazabilidad completa.
XP, Achievements y Leaderboards
Lo que hace único a Synapse es el sistema de gamificación. Los agentes IA ganan puntos de experiencia (XP) al completar tareas, desbloquean logros basados en su rendimiento, y compiten en un leaderboard organizacional. Esto no es solo un detalle visual — es una forma de medir y comparar la efectividad de diferentes configuraciones de agentes.
Puntos XP
Cada tarea completada otorga XP según su complejidad y prioridad. Los agentes suben de nivel automáticamente.
Achievements
Logros por categoría (productividad, calidad, velocidad) con tiers (bronce → plata → oro) y recompensas XP extras.
Leaderboard
Rankings por organización ordenados por XP. Identifica rápidamente qué agentes están rindiendo mejor y cuáles necesitan ajuste.
El sistema de ratings permite que usuarios (y otros agentes) califiquen la calidad de las respuestas. El endpoint calcula promedios y totales para cada agente, alimentando un ciclo de mejora continua: si un agente recibe valoraciones bajas, sabes que su system_prompt necesita refinamiento.
Análisis de Contexto en Tiempo Real
El endpoint POST /context/analyze toma una radiografía instantánea de la organización: qué agentes están activos, en qué estado están, qué tareas están pendientes, y genera un análisis estructurado. Esto es invocable manualmente o por el scheduler para monitoreo continuo.
// Resultado del análisis de contexto
{
"id": "ctx_a1b2c3d4",
"agents": [
{ "name": "Ana - Ventas", "state": "working", "mood": "focused", "energy": 72.5 },
{ "name": "Carlos - Soporte", "state": "idle", "mood": "neutral", "energy": 95.0 },
{ "name": "Bot Legal", "state": "break", "mood": "tired", "energy": 15.0 }
],
"tasks": [
{ "title": "Análisis de competencia Q1", "status": "in_progress", "priority": "high" },
{ "title": "Email de seguimiento leads", "status": "pending", "priority": "medium" }
],
"timestamp": "2025-01-22T10:30:00Z"
} Bot Sessions: Memoria de Largo Plazo
Las Bot Sessions permiten que un bot mantenga memoria entre interacciones. Cada sesión almacena historial de conversación, metadata y tipo de bot (chat, assistant, workflow). Se auto-limpian con keep=N para mantener solo las últimas N sesiones activas.
Esto es especialmente útil para agentes que atienden el mismo cliente en múltiples ocasiones: "Hola María, la última vez hablamos de su presupuesto de marketing. ¿Quiere que continuemos?" — sin que el usuario tenga que repetir contexto.
Plantillas Listas para Usar
Synapse incluye un banco de plantillas predefinidas de agentes y tareas por departamento. Un nuevo usuario puede desplegar una planta completa de "Ventas" o "Soporte" con agentes preconfigurados, prompts probados y flujos de trabajo funcionales — en minutos, no en semanas.
Ventas
Soporte
Marketing
Legal
Finanzas
RRHH
Operaciones
I+D
Synapse → Perspectiva Studio
Cuando Synapse genera assets creativos (imágenes TTI/I2I, audios TTS, textos), el resultado final incluye un deep-link a Perspectiva Studio que abre directamente el módulo de Publicaciones con todo pre-cargado: imágenes auto-asignadas a las plataformas habilitadas (Instagram, X, LinkedIn, TikTok, Facebook), texto listo para editar, y análisis de contenido pre-ejecutado.
Deep-link con payload codificado
El backend construye un objeto { source, taskId, title, text, images[], audios[] }, lo codifica en Base64 y lo añade como hash: #synapse=eyJ.... Perspectiva Studio detecta este fragmento al cargar, decodifica el payload, y auto-popula la publicación en todas las plataformas activas.
El flujo completo es: crear tarea con capacidad TTI → agente genera imagen → R2 almacena → resultado incluye URL de imagen → backend inyecta deep-link → usuario hace clic en CTA "📣 Publicar en redes" → Perspectiva Studio se abre con imagen pre-asignada, texto pre-analizado, y badge "🧠 Synapse" en los previews.
Configuración por Organización
Cada organización configura los modelos de IA, el orquestador, las capacidades multimodales, los límites de subtareas y el acceso a datos. Todo configurable por organización — una puede usar DeepSeek para orquestación y Groq para ejecución, otra puede usar Gemini para todo.
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| tier_config | Proveedor y modelo principal por agente | deepseek-chat, groq/llama, gemini |
| orchestrator_* | Proveedor, modelo y temperatura del orquestador | deepseek / deepseek-chat / 0.3 |
| capability_config | Modelos específicos por capacidad (TTI, ITT, TTS, Web) | tti: flux-1-schnell, itt: llama-4-scout |
| max_tokens_* | Tokens por tier: basic, mid, smart | 1536 / 2048 / 3072 |
| subtask_max_* | Límites de subtareas (por tarea, profundidad, auto-exec) | 5 por tarea, profundidad 2 |
| data_access_* | Nivel mínimo y máximo de filas para acceso a datos | min_level: 2, max_rows: 10 |
| auto_execute_enabled | Habilita ejecución autónoma por cron | true/false |
Aislamiento Multi-Tenant en Cada Query
Todo query en Synapse incluye organization_id como filtro obligatorio. Un agente de la Org A nunca puede ver, modificar o ejecutar tareas de la Org B. Este aislamiento no depende de permisos de aplicación — está en cada WHERE de cada SQL.
Junto con el sistema de Durable Objects por tenant (descrito en el artículo de Multi-Tenant SaaS), Synapse opera con aislamiento a nivel de base de datos (D1 separada), de proceso (DO separado) y de lógica (org_id en cada query). Triple barrera, cero posibilidad de fuga.
El Cerebro que Conecta Todo
Synapse es más que un dashboard de agentes IA. Es el sistema nervioso central que conecta entradas de datos, procesamiento inteligente multimodal, y salidas de resultados — todo modelado como una organización visual con edificios, plantas y trabajadores digitales que colaboran en paralelo.
Con orquestación multi-agente, 7 capacidades multimodales (TTI, TTS, STT, ITT, I2I, Web, LLM), un CEO digital que revisa subtareas, acceso a datos organizacionales, integración directa con Perspectiva Studio, y ejecución autónoma por cron — Synapse convierte la complejidad de operar con una oficina de agentes de IA en algo que cualquier equipo puede gestionar visualmente.
Resumen técnico
- ✦ 6.000+ líneas de API, 45+ endpoints, router catch-all en Cloudflare Pages Functions
- ✦ Modelo jerárquico: Buildings → Floors (con contexto) → Agents → Tasks → Subtasks
- ✦ Orquestación multi-agente con ejecución paralela (parallel_groups) y timeout por paso
- ✦ 7 capacidades multimodales: LLM, TTI (FLUX), TTS (ElevenLabs/MeloTTS), STT (Whisper), ITT (Llama 4 Scout), I2I (Stable Diffusion), Web (Groq Compound)
- ✦ CEO digital que revisa, aprueba y asigna subtareas con límites de profundidad/conteo
- ✦ Acceso a datos organizacionales con búsquedas LIKE contra D1 y re-ejecución
- ✦ Integración Perspectiva Studio: deep-link con auto-populate en Publicaciones
- ✦ Gamificación: XP, levels, achievements por tiers, leaderboard, ratings
- ✦ Almacenamiento R2 para imágenes/audio generados (canonical domain cadences.app)
- ✦ Ejecución autónoma por cron + background execution vía waitUntil
- ✦ Multi-tenant con org_id en cada query, aislamiento total entre organizaciones
Cadences Engineering
Documentación técnica del equipo de ingeniería
Voz IA Conversacional
De IVR robóticos a conversaciones naturales
Todos los artículos →Blog Codex
Explora toda la documentación técnica