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
- 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).
- Extracción (Extract) — MadoHub extrae la respuesta del agente mediante captura estructurada de sesión para eliminar ruidos del terminal.
- Transformación (Transform) — La salida capturada se adapta para el agente de destino mediante reescritura con IA, plantillas personalizadas o paso directo.
- 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)
| Tipo | Comportamiento y casos de uso |
|---|---|
| on-idle | Detección de inactividad (Recomendado): Se activa tras completarse la tarea y confirmarse un breve periodo de silencio. Es el modo más fiable. |
| on-complete | Señal de finalización: Se activa en cuanto el agente emite explícitamente su señal de cierre. |
| on-keyword | Coincidencia de patrón: Se ejecuta de inmediato cuando la salida coincide con una expresión regular o palabra clave. |
| always | Flujo continuo: Retransmite en tiempo real el texto generado al agente destino sin esperar a que termine. |
Tipos de Transformación (Transform Types)
| Tipo | Descripción |
|---|---|
| ai-routing | Síntesis con IA (Esencial): Utiliza un modelo de IA para generar una orden adaptada al contexto del nuevo agente. Configurable en Ajustes. |
| prompt-wrap | Envoltura con plantilla: Aplica una plantilla con variables: {output}, {round}, {maxRounds}, {source}. |
| summary | Resumen inteligente: Genera una síntesis con IA de las conclusiones y diferencias clave. |
| full-output | Traspaso completo: Envía las últimas 30 líneas del terminal. |
| raw | Traspaso 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ámetro | Valor por defecto | Rango | Descripción |
|---|---|---|---|
| maxRounds | 5 | 1–20 | Número máximo de ciclos antes de desactivar la conexión automáticamente. |
| cooldownMs | 3s | 1–30s | Tiempo mínimo obligatorio entre ejecuciones consecutivas. |
| stopKeyword | — | Texto libre | Detiene 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.