Nivel 40 · Tu primer agente

En el nivel 20 hiciste que el modelo pidiera herramientas una vez. En este nivel le dejas pedirlas tantas veces como necesite, en un bucle, hasta resolver la tarea. Eso es un agente. El código es corto; lo difícil es que se comporte bien: que elija la herramienta correcta, que no dé vueltas, que no gaste sin límite y que puedas entender qué hizo cuando falla.

Para quién es

Para quien domina el ciclo tool_use → tool_result y sabe definir herramientas con JSON Schema (Nivel 20 · Uso de herramientas). Conviene haber hecho el nivel 30, porque una de las herramientas típicas de un agente es buscar en documentos.

Qué vas a construir

Un agente de soporte sobre pedidos con datos simulados. Simulados a propósito: así puedes provocar errores, repetir ejecuciones y comparar trazas sin tocar sistemas reales. El agente puede leer libremente, pero abrir una incidencia requiere tu aprobación, que es tu primer contacto con el humano en el bucle.

Lecciones

1. Qué es un agente (y cuándo basta un workflow). La diferencia entre un agente y un workflow, según Building effective agents, y cómo decidir si tu problema necesita un agente.
2. El bucle agéntico. El bucle completo y correcto en Python y TypeScript, con todos los stop_reason tratados.
3. Condiciones de parada y presupuesto. Límites de pasos, tokens, max_tokens, tiempo y aprobación humana, y qué devolver cuando se agota el presupuesto.
4. Planificar antes de actuar. Pedir un plan antes de ejecutar, revisarlo y mantenerlo actualizado durante la ejecución.
5. Un agente con varias herramientas. Diseñar y describir herramientas para que el modelo elija bien, y probar esa elección.
6. Depurar un agente leyendo sus trazas. Un formato de traza sencillo y qué buscar en él cuando el agente se equivoca.

Después de este nivel

Con un agente fiable, el siguiente paso es coordinar varios: Nivel 60 · Sistemas multiagente. Para medir si tu agente mejora o empeora con cada cambio, salta a Evals de trayectoria: cómo llegó, no solo qué dijo. Y si quieres un sistema completo como referencia, mira Agente de soporte con aprobación humana.