Orquestación multiagente

Capítulo 21 · cuando un agent pega en su techo

La hora

• Divide los roles: un trabajo por agent
• La orquestación es control flow, no un framework
• Tres patrones: pipeline, router, debate
• Más agents = más costo + un nuevo modo de falla

¿Por qué más de uno?

"Escríbelo, critícalo, reescríbelo, verifica los datos, mantente amigable" — las instrucciones se pelean entre sí.

Un writer que solo escribe + un critic que solo critica le ganan a un solo agent haciendo ambos.

La orquestación es solo Python

def collaborate(task):
    draft    = agent(WRITER, task)
    critique = agent(CRITIC, f"DRAFT:\n{draft}")
    final    = agent(WRITER, f"Fix these:\n{critique}")
    return final

Pasar salidas entre agents es una llamada a función.

Tres patrones

• Pipeline — draft → critica → revisa
• Router — clasifica, luego despacha a un especialista
• Debate — a favor / en contra / juez

Cada uno es control flow sobre prompts de un solo trabajo.

Router = un if sobre una clasificación

route = agent(ROUTER, message).strip()   # "billing"
answer = agent(SPECIALISTS[route], message)

Escala a través de dominios sin un solo prompt inflado.

Los costos y el nuevo modo de falla

• 3 agents = 3× las llamadas, latencia, y cuenta
• Los agents pueden hablarse sin escucharse

Paga cuando la calidad lo valga. Evalúa la SALIDA, no tu fe en la arquitectura (semana 15).

Ponlo a trabajar — tres apps

• Writer + critic — el paso de crítica, hecho visible
• Router — clasifica → especialista
• Debate — a favor / en contra / juez

Lo que te llevas

Divide los roles, compón con control flow simple. Pipeline, router, debate. Los frameworks agregan comodidad, no magia. Próximo: el proyecto final — el curso entero en una app.