Ir al contenido principal
Español— Elegir un idioma
Menú

Crear agentes especializados y un enrutador

Lección 13 de 18 Actualizado el 3 de noviembre de 2026 Desarrollador
En esta página
  1. De la teoría a la práctica
  2. Paso 1: Crear los agentes especialistas
  3. Paso 2: Crear el agente enrutador
  4. Paso 3: Definir los objetivos de transferencia
  5. Paso 4: Iniciar la conversación
  6. La palanca principal: la descripción
  7. Ejemplo completo
  8. Puntos clave

De la teoría a la práctica

La lección anterior introdujo el concepto de transferencias. Ahora construirás el sistema completo siguiendo el orden real de construcción: primero los especialistas, luego el enrutador, después la conexión entre ellos y, finalmente, la conversación que pone todo en marcha. Este orden no es arbitrario: el enrutador solo puede señalar a agentes que ya existan.

Paso 1: Crear los agentes especialistas

Cada agente recibe un dominio de experiencia preciso y nada más.

from mistralai.client import Mistral
from mistralai.client.models import CompletionArgs, ResponseFormat, JSONSchema
import os

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

# Agente de búsqueda web
web_agent = client.beta.agents.create(
    model="mistral-large-latest",
    name="web-search-agent",
    description="Agente que busca información en línea.",
    instructions="Realiza búsquedas web precisas. Cita siempre tus fuentes.",
    tools=[{"type": "web_search"}]
)

# Agente financiero
finance_agent = client.beta.agents.create(
    model="mistral-large-latest",
    name="finance-agent",
    description="Agente especializado en preguntas financieras.",
    instructions="""Eres un experto financiero.
- Usa datos numéricos
- Explica los conceptos con claridad
- Señala los riesgos"""
)

# Agente calculadora
calculator_agent = client.beta.agents.create(
    model="mistral-large-latest",
    name="calculator-agent",
    description="Agente para cálculos matemáticos detallados.",
    instructions="Explica cada paso del cálculo. Usa el intérprete de código para cálculos complejos.",
    tools=[{"type": "code_interpreter"}]
)

Estos cuatro campos desempeñan funciones muy distintas, y uno merece una atención especial. El name en kebab-case es para ti: aparece en tus registros y pruebas, y un nombre legible te evita tener que comparar IDs opacos. Las instructions se dirigen al modelo una vez que empieza a trabajar, por lo que deben ser específicas del dominio: «señalar los riesgos» significa algo para un agente financiero, mientras que «ser útil» no significa nada para nadie. Las tools siguen el principio de estricta necesidad: el agente financiero anterior no tiene herramientas porque razona sin necesitarlas, y dárselas solo invitaría a un uso indebido. Por último, la description no es documentación: es el texto que lee el enrutador para decidir si transferir la solicitud aquí o a otro lugar.

Paso 2: Crear el agente enrutador

El enrutador no tiene herramientas. Su única tarea consiste en analizar la solicitud y elegir al destinatario.

router_agent = client.beta.agents.create(
    model="mistral-large-latest",
    name="router-agent",
    description="Agente enrutador que distribuye solicitudes.",
    instructions="""Eres un orquestador.
Analiza cada solicitud y transfiérela al agente adecuado:
- Preguntas que requieren datos en línea → web-search-agent
- Preguntas financieras → finance-agent
- Cálculos y análisis numérico → calculator-agent

Nunca respondas directamente; transfiere siempre."""
)

Esa última línea evita que el sistema colapse. Sin ella, un enrutador basado en un modelo grande responderá a preguntas que le parezcan fáciles, omitirá a tus especialistas y producirá respuestas sin las herramientas que habrían utilizado. Acabarás con una arquitectura multiagente donde la mitad de los agentes nunca se usan.

Paso 3: Definir los objetivos de transferencia

Ahora debes indicarle al enrutador a qué agentes tiene permiso para transferir.

router_agent = client.beta.agents.update(
    agent_id=router_agent.id,
    handoffs=[web_agent.id, finance_agent.id, calculator_agent.id]
)

El parámetro handoffs acepta una lista de IDs de agente, y el enrutador puede transferir a cualquiera de ellos. Esto no es un privilegio reservado al enrutador: los especialistas también pueden declarar sus propios objetivos.

# El agente financiero puede transferir a la búsqueda web y a la calculadora
finance_agent = client.beta.agents.update(
    agent_id=finance_agent.id,
    handoffs=[web_agent.id, calculator_agent.id]
)

Entonces se hace posible una cadena como enrutador → finanzas → búsqueda web → calculadora. Cuando el agente financiero se enfrenta a una pregunta que requiere una tasa actual, no devuelve la solicitud al enrutador: va directamente al especialista que necesita, igual que un consultor llama a un colega en lugar de volver a pasar por recepción.

Paso 4: Iniciar la conversación

response = client.beta.conversations.start(
    agent_id=router_agent.id,
    inputs="Encuentra el tipo de interés clave actual del BCE y calcula el interés compuesto durante 10 años para 100.000 €."
)

# Analizar el flujo
for entry in response.outputs:
    if entry.type == "agent.handoff":
        print(f"[TRANSFERENCIA] → {entry.next_agent_id}")
    elif entry.type == "tool.execution":
        print(f"[HERRAMIENTA] {entry.tool_name}")
    elif entry.type == "message.output":
        print(f"[RESPUESTA] {entry.content[:200]}...")

Ejecuta esta solicitud y observa el rastro antes de mirar la respuesta. Deberías ver dos transferencias y al menos una ejecución de herramienta; si no ves ninguna, tu enrutador ha respondido por su cuenta y es momento de ajustar sus instrucciones.

La palanca principal: la descripción

Cuando el enrutamiento falla, casi siempre la culpa es de la descripción. El enrutador no conoce tus intenciones; solo lee este texto para cada agente candidato.

# Malo: demasiado vago
description="Un agente útil."

# Bueno: el enrutador sabe cuándo transferir
description="Agente que busca información actual en Internet y cita sus fuentes."

Escribe cada descripción como respuesta a la pregunta «¿en qué caso debo llamar a este agente?» en lugar de como un resumen de lo que es. El segundo ejemplo nombra la situación —información actual, en Internet—, mientras que el primero deja al enrutador adivinando. Verifica también que ningún par de descripciones se solape: dos agentes descritos en términos similares producirán un enrutamiento inestable de una ejecución a otra.

Ejemplo completo

Aquí tienes la versión condensada, con handoffs pasados directamente durante la creación del enrutador, ya que los especialistas ya existen en ese punto.

from mistralai.client import Mistral
import os

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])

# 1. Agentes especialistas
research = client.beta.agents.create(
    model="mistral-large-latest",
    name="research-agent",
    description="Búsqueda de información en línea con fuentes.",
    tools=[{"type": "web_search"}]
)

analyst = client.beta.agents.create(
    model="mistral-large-latest",
    name="analyst-agent",
    description="Análisis de datos y cálculos con Python.",
    tools=[{"type": "code_interpreter"}]
)

writer = client.beta.agents.create(
    model="mistral-large-latest",
    name="writer-agent",
    description="Redacción de informes estructurados y profesionales.",
    instructions="Escribe informes claros con una introducción, análisis y recomendaciones."
)

# 2. Enrutador con transferencias
router = client.beta.agents.create(
    model="mistral-large-latest",
    name="router",
    description="Orquesta solicitudes complejas.",
    instructions="Analiza la solicitud y transfiérela al especialista adecuado.",
    handoffs=[research.id, analyst.id, writer.id]
)

# 3. Lanzamiento
response = client.beta.conversations.start(
    agent_id=router.id,
    inputs="Analiza el mercado europeo de computación en la nube en 2026: tamaño, actores, tendencias."
)

Puntos clave

  • Crea agentes especialistas con descripciones precisas y orientadas a tareas
  • El enrutador usa las descripciones para elegir el agente objetivo
  • client.beta.agents.update(handoffs=[...]) define los objetivos de transferencia
  • Las transferencias pueden anidarse (agente A → agente B → agente C)
  • La descripción de cada agente es la palanca principal para la calidad del enrutamiento