MadoHub Docs

Enrutamiento de Agentes

Transfiere salidas y contexto automáticamente entre agentes de IA con transformación inteligente.

El enrutamiento de agentes es el motor de orquestación fundamental de MadoHub. Cuando un agente completa su tarea, MadoHub captura automáticamente su resultado, lo transforma en una instrucción estructurada y lo entrega sin fricciones al siguiente agente para crear canales de trabajo autónomos.

Cómo funciona

  1. Activación (Trigger) — Un panel de origen conectado se dispara según la condición establecida (detección de inactividad, señal de finalización, patrón regex o streaming continuo).
  2. Extracción (Extract) — MadoHub extrae la respuesta del agente mediante captura estructurada de sesión para eliminar ruidos del terminal.
  3. Transformación (Transform) — La salida capturada se adapta para el agente de destino mediante reescritura con IA, plantillas personalizadas o paso directo.
  4. Entrega (Deliver) — MadoHub inyecta la instrucción en el terminal destino con cadencia adaptativa y protocolos de ejecución propios de cada CLI.

Captura de Sesión de Alta Fidelidad

En la automatización tradicional de terminales, raspar caracteres de pantalla suele capturar secuencias de escape ANSI, barras de progreso y saltos de línea rotos.

MadoHub utiliza una captura de sesión nativa y estructurada:

  • Extracción de contexto limpia: Se comunica con el registro estructurado del agente para extraer razonamientos, parches y resultados de herramientas sin interferencias visuales del terminal.
  • Alineación con el espacio de trabajo: Asocia automáticamente los paneles del lienzo con los directorios reales del proyecto para que las rutas relativas se conserven siempre durante el traspaso.
  • Monitoreo no invasivo: No requiere modificar el código fuente de los agentes, manteniendo la estabilidad y seguridad de las herramientas CLI oficiales.

Tipos de Disparo (Trigger Types)

TipoComportamiento y casos de uso
on-idleDetección de inactividad (Recomendado): Se activa tras completarse la tarea y confirmarse un breve periodo de silencio. Es el modo más fiable.
on-completeSeñal de finalización: Se activa en cuanto el agente emite explícitamente su señal de cierre.
on-keywordCoincidencia de patrón: Se ejecuta de inmediato cuando la salida coincide con una expresión regular o palabra clave.
alwaysFlujo continuo: Retransmite en tiempo real el texto generado al agente destino sin esperar a que termine.

Tipos de Transformación (Transform Types)

TipoDescripción
ai-routingSíntesis con IA (Esencial): Utiliza un modelo de IA para generar una orden adaptada al contexto del nuevo agente. Configurable en Ajustes.
prompt-wrapEnvoltura con plantilla: Aplica una plantilla con variables: {output}, {round}, {maxRounds}, {source}.
summaryResumen inteligente: Genera una síntesis con IA de las conclusiones y diferencias clave.
full-outputTraspaso completo: Envía las últimas 30 líneas del terminal.
rawTraspaso reducido: Envía las últimas 10 líneas del terminal.

Entrega Adaptativa en Terminal

Para asegurar la recepción precisa de instrucciones largas, MadoHub incorpora un protocolo de despacho adaptativo:

  • Control de flujo de entrada: Regula la cadencia de pulsaciones según la capacidad del búfer del terminal para evitar caracteres perdidos.
  • Protocolos de ejecución específicos: Adapta las secuencias de envío para Claude Code, Codex, Amp, OpenCode y shells estándar para asegurar su ejecución fiable.

Protección contra Bucles

Las conexiones disponen de límites y salvaguardas para impedir bucles infinitos:

ParámetroValor por defectoRangoDescripción
maxRounds51–20Número máximo de ciclos antes de desactivar la conexión automáticamente.
cooldownMs3s1–30sTiempo mínimo obligatorio entre ejecuciones consecutivas.
stopKeyword—Texto libreDetiene el enrutamiento al detectar expresiones como "LGTM" o "RESOLVED".

Ejemplo de Flujo de Trabajo

Terminal 1 (Claude Code: Refactor)       Terminal 2 (Claude Code: Code Review)
┌──────────────────────┐    →    ┌──────────────────────┐
│ "Refactor auth module"│         │ Recibe:              │
│                       │         │ "Revisa el refactor  │
│ ✓ Listo — 3 archivos │         │  en src/auth/..."    │
└──────────────────────┘         └──────────────────────┘

El Agente 1 finaliza su tarea. MadoHub extrae limpiamente las modificaciones, sintetiza un resumen enfocado mediante ai-routing y lo entrega al Agente 2 para iniciar la fase de revisión.

On this page