Blog
Plataforma · 22 min lectura

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.

Modelo de Datos

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.

API

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
Agentes

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 agente
  • role — Tipo: agent, supervisor, analyst
  • role_title — Título visible: "Sales Rep", "QA Lead"
  • department — Departamento asignado
  • level — Nivel de experiencia (1-N)
  • avatar_sprite — Sprite visual para la UI

Inteligencia

  • system_prompt — Instrucciones base del agente
  • personality_config — JSON de personalidad
  • capabilities — Array multimodal: llm, tti, tts, stt, itt, i2i, web
  • can_create_subtasks — Puede proponer sub-tareas al CEO digital
  • data_access_level — Nivel de acceso a datos (0=ninguno, 1=depto, 2=org)

Estado en Tiempo Real

  • current_state — idle, working, break, offline
  • current_mood — neutral, happy, focused, tired
  • energy_level — 0.0 a 100.0
  • consecutive_tasks — Tareas seguidas sin pausa
  • current_task_id — Tarea activa actual
  • last_break_at — Último descanso

Progresión

  • xp_points — Puntos de experiencia acumulados
  • position_x, position_y — Posición en la planta
  • is_active — Activo o deshabilitado
  • Achievements desbloqueables
  • Ratings de otros agentes/usuarios
Multimodal

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.

Orquestación

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().

1

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.

2

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.

3

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.

4

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.

5

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.

6

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.

7

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.

8

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.

Subtareas

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.

Datos

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.

Agent output → Data Search
// 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.

I/O

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

Email

Emails entrantes se parsean y convierten en items procesables por agentes.

Formularios

Links de formulario público con /form-link para captura directa de datos.

Webhooks / APIs

Recibe datos de sistemas externos en JSON para procesamiento automático.

Output Destinations

Email

Envío de resultados, reportes y notificaciones por email.

Slack / Webhooks

Notificaciones a canales de equipo o sistemas externos.

Items enviables

Cada output se registra como item con estado de envío para trazabilidad completa.

Gamificación

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.

Contexto

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.

POST /api/synapse/context/analyze
// 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"
}
Sesiones

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.

Templates

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

Integración

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

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

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.

Conclusión

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
C

Cadences Engineering

Documentación técnica del equipo de ingeniería