Lección 25 de 27

Enrutamiento multi-agente

El enrutamiento multi-agente te permite tener diferentes agentes especializados: uno para programacion, otro para soporte, otro para creatividad. El Gateway analiza cada mensaje y lo enruta al agente mas apropiado.

Por que multi-agente

Un solo agente generico puede hacer muchas cosas pero ninguna excepcional. Con multi-agente, cada agente es experto en un area: el de codigo usa Claude Opus con temperatura 0.2, el creativo usa GPT-4o con temperatura 0.9, el de soporte tiene acceso a la base de conocimientos de tu negocio.

Configuracion multi-agente

Define multiples agentes con diferentes especialidades.

config.yaml - Multi-agente
# ~/.openclaw/config.yaml
agents:
  router:
    enabled: true
    model: claude-haiku-4-5-20251001  # Modelo rapido para clasificar

  profiles:
    - id: "coder"
      name: "Dev Agent"
      description: "Experto en programacion y DevOps"
      llm:
        model: claude-opus-4-6
        temperature: 0.2
      system_prompt: |
        Eres un experto en programacion.
        Responde con codigo cuando sea apropiado.
        Siempre en espanol.
      skills:
        - shell_exec
        - file_read
        - file_write
        - code_execute

    - id: "assistant"
      name: "Personal Assistant"
      description: "Asistente personal para tareas del dia a dia"
      llm:
        model: claude-sonnet-4-5-20250929
        temperature: 0.7
      system_prompt: |
        Eres un asistente personal amable.
        Ayudas con tareas diarias, recordatorios, resumen de info.
      skills:
        - web_search
        - calendar
        - email

    - id: "creative"
      name: "Creative Writer"
      description: "Escritor creativo para contenido y marketing"
      llm:
        model: gpt-4o
        temperature: 0.9
      system_prompt: |
        Eres un escritor creativo excepcional.
        Generas contenido atractivo y original.

El Router inteligente

El router es un modelo ligero (como Claude Haiku) que analiza cada mensaje entrante y decide que agente debe responder. Evalua el contenido del mensaje, las descripciones de los agentes y el historial de la conversacion para elegir el mejor agente.

  1. 1

    Define 2 o mas perfiles de agente en config.yaml

  2. 2

    Configura el router con un modelo rapido (Haiku)

  3. 3

    Reinicia el daemon

  4. 4

    Envia mensajes de diferentes tipos para probar el enrutamiento

  5. 5

    Verifica en los logs que agente respondio a cada mensaje

Forzar un agente

Puedes forzar un agente especifico con el prefijo @agente. Ejemplo: "@coder explica este error" siempre va al agente de programacion, sin pasar por el router.

Flujo de enrutamiento

Asi funciona el router en la practica.

Ejemplos de enrutamiento
# Mensaje: "Escribe un script de Python para scraping"
# Router: -> coder (programacion detectada)

# Mensaje: "Resumeme los emails de hoy"
# Router: -> assistant (tarea personal)

# Mensaje: "Crea un slogan para mi cafeteria"
# Router: -> creative (contenido creativo)

# Mensaje: "@coder que hace esta funcion?"
# Router: Bypass -> coder (forzado con @)

# Ver logs de enrutamiento:
openclaw logs --filter router

Costo del multi-agente

El router agrega un costo pequeno (usa Haiku, el modelo mas barato) por cada mensaje para clasificarlo. Pero los agentes especializados pueden usar modelos diferentes, permitiendote usar Opus solo cuando es necesario y Haiku/Sonnet para tareas simples.

Que componente decide a que agente enviar cada mensaje?

Como fuerzas un agente especifico sin pasar por el Router?
Usando el prefijo @agente. Ejemplo: "@coder explica este error" envia el mensaje directamente al agente "coder".

Puntos clave

  • Multi-agente permite agentes especializados (codigo, asistente, creativo)
  • El Router (modelo ligero) clasifica y dirige cada mensaje
  • Cada agente puede tener diferente LLM, temperatura y skills
  • Prefijo @agente para forzar un agente especifico
  • Costo minimo adicional del Router (usa Haiku)

Quiz Generado por IA

Evalua tu comprension de esta leccion con preguntas personalizadas.