Agentes
Referencia para construir agentes con la API de Mensajes, desde el bucle básico hasta subagentes y aprobación humana.
DocsUn agente es un modelo que decide sus propios pasos dentro de un bucle: pide herramientas, lee los resultados y sigue hasta terminar la tarea. Este grupo reúne la referencia técnica para construirlo bien. Aquí no hay teoría de introducción: para eso está el nivel Nivel 40 · Tu primer agente del roadmap.
Qué cubre
- El bucle agéntico. La pieza central. Cómo se escribe el bucle, qué hacer con cada
stop_reason, cómo devolver lostool_resulty cómo poner límites de pasos y de gasto. Si solo lees un artículo, que sea este. - Subagentes. Cuándo conviene que un agente delegue en otros con contexto propio, cómo se reparte el trabajo y qué cuesta. Úsalo cuando el contexto de un único agente se te llena o cuando hay subtareas independientes que pueden ir en paralelo.
- Humano en el bucle. Dónde poner puntos de aprobación, cómo pausar el bucle sin perder el estado y cómo devolverle al modelo un «no» del usuario.
Antes de empezar
Necesitas dominar el ciclo de herramientas: Uso de herramientas lo explica en detalle. Y antes de construir un agente, pregúntate si te basta un workflow con pasos fijos. Workflows frente a agentes te ayuda a decidirlo; la respuesta suele ser que sí, al menos al principio.
Para seguir
Cuando el agente funcione, pasa a medirlo con Evals y a vigilarlo con Producción. Antes de darle herramientas que escriben o borran, lee Seguridad.
Artículos
3- El bucle agéntico 4 min
Referencia del bucle que convierte una llamada al modelo en un agente, con el manejo de cada stop_reason y los límites que lo hacen seguro.
- Subagentes 3 min
Qué es un subagente, cuándo merece la pena delegar en uno, cómo se implementa como herramienta y qué cuesta en tokens y en control.
- Humano en el bucle 4 min
Cómo y dónde pedir aprobación humana dentro de un agente, cómo pausar el bucle sin perder el estado y cómo devolver un rechazo al modelo.