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

Introducción a las transferencias entre múltiples agentes

Lección 12 de 18 Actualizado el 3 de noviembre de 2026 Desarrollador
En esta página
  1. ¿Por qué orquestar múltiples agentes?
  2. Cómo funcionan las transferencias
  3. Arquitectura típica
  4. Modos de ejecución
  5. Eventos de salida
  6. Puntos clave

¿Por qué orquestar múltiples agentes?

Hasta ahora, has trabajado con agentes individuales: un agente, sus instrucciones y sus herramientas. Este modelo alcanza sus límites rápidamente cuando una tarea requiere habilidades heterogéneas. Tomemos una solicitud de investigación de mercado: necesitas buscar datos, analizarlos numéricamente y luego producir un informe legible. Podrías intentar encomendarlo todo a un único agente, con instrucciones que crecen desmesuradamente con cada nuevo requisito hasta convertirse en un bloque de texto contradictorio que el modelo aplica cada vez con menos eficacia. La API de Mistral ofrece una alternativa: cadenas de agentes especializados que se pasan el testigo.

Este es el concepto de transferencia (handoff): un agente transfiere el control de la conversación a otro agente mejor equipado para la subtarea actual. La conversación en sí no cambia; solo cambia la mano que lleva las riendas.

Cómo funcionan las transferencias

El mecanismo refleja exactamente lo que hace una organización humana al enfrentarse a una solicitud compuesta. Un agente enrutador recibe la consulta inicial, como una operadora de centralita que atiende una llamada. Analiza la solicitud, identifica qué agente especialista está mejor posicionado para gestionarla y, a continuación, transfiere la conversación a dicho especialista. El especialista gestiona su subtarea y, si encuentra una necesidad que excede su ámbito, puede transferir la conversación a un tercer agente. La respuesta final regresa al usuario, quien solo ve a un único interlocutor.

De esto se derivan cuatro beneficios que se refuerzan mutuamente. En primer lugar, la especialización: cada agente tiene un ámbito limitado e instrucciones precisas. El agente de búsqueda web no realiza cálculos, y viceversa. Esto mejora la calidad de la respuesta porque ninguna instrucción contradice a otra. En segundo lugar, la mantenibilidad: cambiar el comportamiento de un especialista no afecta a los demás. Puedes swapping su modelo, instrucciones o herramientas sin tocar el resto del sistema. En tercer lugar, la escalabilidad se deriva directamente: añadir una capacidad significa crear un nuevo agente especialista y registrarlo como destino de transferencia. El enrutador lo seleccionará entonces cuando la solicitud coincida. Por último, la trazabilidad: cada transferencia genera un evento agent.handoff en las salidas, lo que te permite reconstruir a posteriori qué agente gestionó qué parte de la solicitud sin necesidad de instrumentar nada por tu cuenta.

Arquitectura típica

Usuario
    │
    ▼
Agente Enrutador (orquestador)
    ├── Agente de Búsqueda Web (web_search)
    ├── Agente Calculadora (code_interpreter)
    ├── Agente Redactor (instrucciones específicas)
    └── Agente de Documentos (document_library)

El enrutador decide dinámicamente a qué agente transferir en función de la consulta. No está limitado a una única transferencia: también puede orquestar flujos secuenciales, como buscar, luego calcular y luego redactar, enriqueciendo cada paso el contexto para el siguiente.

Sigamos una solicitud real: «Encuentra el tipo de interés actual del BCE y calcula el efecto compuesto durante 10 años para una inversión de 100 000 €». El agente de Finanzas, actuando como enrutador, recibe la solicitud y observa que contiene dos necesidades distintas. Primero transfiere al agente de Búsqueda Web, que recupera el tipo actual del BCE, un dato que ningún modelo puede conocer de memoria. Una segunda transferencia pasa el control al agente Calculadora, que aplica la fórmula de interés compuesto al tipo acaba de encontrar. El usuario recibe un único resultado, acompañado de las fuentes de la búsqueda y los detalles del cálculo.

Modos de ejecución

La API de Mistral ofrece dos modos para las transferencias, y tú eliges cuál usar al iniciar la conversación. El modo servidor es el predeterminado.

response = client.beta.conversations.start(
    agent_id=router_agent.id,
    inputs="Complex query",
    handoff_execution="server"
)

Mistral gestiona entonces todo automáticamente: las transferencias, la ejecución de los agentes y la síntesis de la respuesta. Solo recibes el resultado final, lo cual es cómodo y suficiente mientras no necesites interponer nada entre los pasos.

response = client.beta.conversations.start(
    agent_id=router_agent.id,
    inputs="Complex query",
    handoff_execution="client"
)

En el modo cliente, recibes eventos de transferencia y decides qué hacer en cada paso. Elige este modo cuando un humano deba aprobar una transferencia sensible, cuando necesites registrar cada transferencia para fines de auditoría o cuando tu lógica de negocio requiera un enrutamiento que el modelo no pueda inferir. La lección dedicada a estos dos modos detallará las compensaciones implicadas.

Eventos de salida

Cuando ocurre una transferencia, aparecen tres tipos de eventos en las salidas:

  • agent.handoff — El agente A transfiere al agente B (contiene ambos ID de agente)
  • tool.execution — El agente B ejecuta sus herramientas
  • message.output — Respuesta del agente B
for entry in response.outputs:
    if entry.type == "agent.handoff":
        print(f"Transferencia: {entry.previous_agent_id} → {entry.next_agent_id}")
    elif entry.type == "tool.execution":
        print(f"Herramienta ejecutada: {entry.tool_name}")
    elif entry.type == "message.output":
        print(f"Respuesta: {entry.content}")

Escribe este bucle durante tus primeras pruebas, incluso antes de que el sistema esté completo. Un sistema multiagente que responde correctamente pero cuyo recorrido no puedes trazar se vuelve imposible de arreglar el día que responda mal: no sabrás si el enrutador derivó incorrectamente, si el especialista tuvo un bajo rendimiento o si la transferencia se perdió por el camino. Tres sentencias print bien colocadas te ahorran esta ceguera.

Puntos clave

  • Las transferencias permiten que un agente pase el control a otro agente especializado
  • Arquitectura típica: agente enrutador → agentes especialistas
  • Modo servidor = totalmente automático; modo cliente = control manual de las transferencias
  • Cada transferencia genera un evento trazable en las salidas
  • No hay límite en la profundidad de encadenamiento entre agentes