跳到正文
DEV Community· Christian Gonzales Komiya·· 2 天前AI 評分54

vegapunk-agents 的 Vegapunk 模式:為何我的 AI 智能體不互相對話

[Spanish] Por qué mis agentes de IA no hablan entre sí: el patrón Vegapunk

AI 導讀

作者提出 vegapunk-agents 多智能體架構模式,讓六個專責智能體透過共享的 Punk Records 協作,而不直接互相對話。模式採用只追加的共享記錄,由 Shaka 獨自作最終裁決;批評與修訂預設最多迭代兩輪,涉及 Atlas 執行的工作須先由 Stella 批准。

正文

This post is also available in English.

Empezó con un manga, no con un paper

Soy fan de One Piece. Hace un tiempo estaba releyendo el arco de Egghead, el del Dr. Vegapunk, el genio que divide su mente en seis "satélites". Cada uno lleva una parte distinta de su personalidad: la lógica, la maldad, las ideas, el conocimiento, la violencia, la codicia. El cuerpo original, Stella, sigue al mando. Y todos comparten un mismo cerebro en la nube llamado Punk Records.

Me detuve en una página y pensé: un momento, estos son agentes.

Seis especialistas con roles claros. Un coordinador que decide. Una memoria compartida donde termina todo lo que aprenden. Me dedico al software y llevo meses experimentando con sistemas multiagente. Era la imagen más clara de un sistema multiagente que había visto, y venía de un manga.

Pero el detalle que de verdad me atrapó fue otro: los satélites no necesitan conversar entre ellos todo el tiempo para trabajar juntos. Se sincronizan a través de Punk Records. Esa idea se convirtió en vegapunk-agents, un Patrón de Arquitectura Multiagente (y Framework Conceptual). Este post explica por qué mis agentes no hablan entre sí, y por qué creo que eso es una ventaja.

El problema de los agentes que conversan

La forma más común de construir sistemas multiagente hoy es la conversación: el agente A le manda un mensaje al agente B, B responde, quizá C se suma. Parece natural, porque así trabajan los equipos humanos. En la práctica, falla de formas predecibles:

  • Bucles. Dos agentes discrepan con cortesía, o coinciden con cortesía, para siempre. Nadie tiene la autoridad para cortar.
  • Contexto perdido. Cada agente solo ve su parte de la conversación. Un hallazgo del paso 2 ya no existe en el paso 7.
  • Facturas de tokens impredecibles. Cada mensaje arrastra el historial. El costo crece con la cantidad de conexiones, no con el tamaño de la tarea.
  • Sin trazabilidad. Cuando la respuesta final está mal, no puedes señalar el momento en que el razonamiento se desvió.
  • Nadie es dueño de la decisión. Si todos pueden hablar con todos, ¿quién dice "listo"?

Con seis agentes conversando libremente, hay quince canales posibles entre ellos. Es la red enredada que ves a la izquierda de esta imagen.

Agentes que conversan (15 canales) vs. agentes con pizarra compartida (6 canales)

La idea: una pizarra compartida

En vegapunk-agents, los satélites nunca hablan directamente entre sí. Todo pasa por Punk Records, una memoria compartida que funciona como pizarra (blackboard). Un satélite lee lo que hay, hace su trabajo y escribe una entrada nueva. El siguiente satélite continúa desde ahí.

No es algo nuevo. La arquitectura de pizarra viene de la investigación en IA de los años 70 y 80. Lo nuevo es aplicarla a agentes basados en LLM, donde el costo de conversar libremente se mide en tokens, bucles y acuerdos alucinados.

Lo que ganas a cambio:

  • Una sola fuente de verdad. Cada hallazgo, idea, crítica y veredicto vive en un solo lugar, en orden.
  • Seis conexiones en vez de quince. Cada satélite solo se conecta con Punk Records.
  • Trazabilidad completa. Puedes repasar la ejecución entrada por entrada y ver exactamente quién escribió qué, y por qué.
  • Contexto controlado. Cada satélite recibe las entradas que necesita, no todo el historial de un chat.

La regla aplica a todas las implementaciones del patrón. Incluso en CrewAI, donde los agentes pueden delegarse tareas entre sí, la delegación está desactivada.

El reparto: Stella y seis satélites

Cada satélite tiene un sesgo cognitivo deliberado. Esa es la idea: no quieres seis copias del mismo asistente equilibrado, quieres especialistas que tiren en direcciones distintas, y un proceso que convierta esa tensión en una decisión.

Rol Nombre Sesgo Qué hace
Orquestador Stella El humano Define el objetivo, elige el modo, aprueba las acciones críticas
Memoria Punk Records Ninguno Registro compartido, solo de escritura incremental, que todos leen y escriben
Punk-01 Shaka Lógica Valida coherencia, reglas y seguridad; es el único que da el veredicto final
Punk-02 Lilith Crítica Red team: ataca las propuestas, busca fallas y puntos de quiebre
Punk-03 Edison Ideación Ideas sin filtro, lluvia de ideas, primer diseño de la solución
Punk-04 Pitágoras Investigación Busca fuentes, extrae datos y los estructura para Punk Records
Punk-05 Atlas Ejecución Trabajo pesado: código masivo, activos, procesamiento por lotes
Punk-06 York Operaciones Tareas de fondo: limpieza, formato, logs, verificación de entregables

Stella es el humano en el bucle (human in the loop). Si un coordinador de IA lleva el ciclo en su nombre, puede hacer avanzar las cosas, pero nunca aprueba ni aborta por su cuenta.

El patrón Vegapunk: Stella, Punk Records y los seis satélites

Las reglas que lo hacen funcionar

Una pizarra sola no basta. Sin reglas, solo mudaste el caos a un archivo compartido. Estas son las reglas que impone la especificación del núcleo:

  1. Solo se agrega (append-only). Las entradas nunca se editan. Una corrección es una entrada nueva que referencia a la anterior. El historial queda intacto.
  2. Bloqueo explícito. Toda crítica de Lilith debe indicar blocking: true o false. Es true solo si hay un problema crítico o mayor. Las implementaciones nunca lo deducen del texto.
  3. Un solo juez. Solo Shaka escribe un verdict. El esquema define qué autor puede escribir cada tipo de entrada.
  4. Shaka puede desestimar. Si una crítica bloqueante no se sustenta en el objetivo, las restricciones o los hallazgos, Shaka puede descartarla, con una justificación escrita.
  5. Debate acotado. El ciclo de crítica y revisión tiene dos iteraciones por defecto. Al llegar al límite, Shaka debe elegir: aprobado o rechazado. No hay bucles infinitos.
  6. El humano antes de actuar. Si Atlas va a ejecutar algo, Stella aprueba primero.

No siempre necesitas al equipo completo, así que el patrón tiene tres modos de activación. Shaka está en todos:

  • Ligero (2): Edison y Shaka. Idea rápida, validación rápida.
  • Estándar (4): Pitágoras, Edison, Lilith y Shaka. Investigar, proponer, atacar, decidir.
  • Egghead completo (6): los seis satélites, incluyendo ejecución y operaciones.

Tres modos de activación: Ligero (2), Estándar (4), Egghead completo (6)

El ciclo de vida

Toda ejecución sigue la misma máquina de estados:

DEFINED → RESEARCH → IDEATION → CRITIQUE ⇄ REVISION → VERDICT → [HITL_APPROVAL] → EXECUTION → OPERATIONS → COMPLETED

La máquina de estados del ciclo de vida, con el bucle entre CRITIQUE y REVISION

Más dos salidas: FAILED y ABORTED. Los nombres de los estados van en inglés porque son los valores que usa la especificación.

Lo interesante está en el medio. Edison propone, Lilith ataca, Edison revisa, hasta que a Lilith no le queda nada bloqueante o se llega al límite de iteraciones. Entonces decide Shaka. Si una fase no tiene satélite en el modo actual, se salta: en modo Ligero no hay investigación ni crítica, solo ideación y veredicto.

Cada transición además emite un evento. Ese flujo (events.jsonl) alimentará el Egghead Monitor, un visualizador en vivo donde verás a los satélites encenderse a medida que escriben en Punk Records.

Un patrón, no otra librería

Ya existen muchos frameworks multiagente. No quería construir uno nuevo y pedirte que te cambies. vegapunk-agents es, antes que nada, una especificación.

La carpeta core/ es la única fuente de verdad:

  • architecture.md: el protocolo, escrito con las palabras clave del RFC 2119 (MUST, SHOULD, MAY).
  • punk-records.md más los JSON Schemas de entradas y eventos, con ejemplos.
  • prompts/: los system prompts canónicos de Stella y los seis satélites, que comparten un protocolo común.
  • Un validador que corre en CI con cada cambio.

Sobre eso vienen los sabores (flavors): implementaciones de la misma especificación en distintos motores. Subagentes nativos de Claude Code, LangGraph, CrewAI y el Anthropic SDK puro. Pueden aprovechar las fortalezas de cada motor, como la salida estructurada nativa, pero no pueden redefinir las reglas. Las demos viven aparte, en examples/, para que el framework nunca dependa de un caso de uso.

Si ya usas alguno de esos motores, la idea es que puedas adoptar el patrón sin dejarlo.

Lo que viene

La especificación del núcleo ya salió como v0.1.0. De aquí en adelante, la hoja de ruta avanza sabor por sabor:

  1. Claude Code nativo: cada satélite como un subagente, generado desde core/.
  2. LangGraph + primera demo: un ciclo real Edison ⇄ Lilith → Shaka, más el Egghead Startup Validator, que usa la búsqueda gratuita de DuckDuckGo, sin API keys adicionales.
  3. Egghead Monitor: el visualizador en vivo.
  4. CrewAI y Anthropic SDK: la misma demo, el mismo comportamiento.

Voy a escribir sobre cada paso en esta serie.

Si la idea te hace sentido, date una vuelta por el repo, abre un issue o prueba la especificación con tus propios agentes. Me encantaría saber dónde se rompe.

vegapunk-agents está inspirado en el Dr. Vegapunk de One Piece, creado por Eiichiro Oda y publicado por Shueisha. Es un proyecto open-source hecho por un fan, sin afiliación comercial.

來源:DEV Community · dev.to