Crear agentes con la API
Un agente es un modelo que se ejecuta en un bucle: persigue un objetivo llamando a herramientas, observando los resultados y decidiendo el siguiente paso hasta terminar. Antes de crear uno, elige lo más simple que funcione.
El test de decisión (no sobredimensiones)
- Llamada única — un solo prompt lo resuelve. La mayoría de las tareas. Lo más barato y fiable.
- Flujo de trabajo — orquestas una secuencia fija de llamadas en código (flujo de control determinista). Úsalo cuando los pasos son conocidos.
- Agente — el modelo decide los pasos dinámicamente. Úsalo solo cuando el camino realmente no se puede codificar de forma fija.
Recurre a un agente cuando la adaptabilidad sea la clave, no porque suene impresionante. Un flujo de trabajo que tú controlas es más fácil de probar y depurar.
Diseñar el bucle
Un agente personalizado mínimo:
- Prompt de sistema: el objetivo, las restricciones y las herramientas disponibles.
- Bucle: envía mensajes → si hay
tool_use, ejecuta la herramienta, añade eltool_result, repite → hasta una respuesta final o una condición de parada. - Salvaguardas: un límite máximo de iteraciones, un presupuesto de tokens/coste y validación de las entradas de las herramientas.
- Gestión del contexto: resume/recorta a medida que crece el historial (la misma idea que en Gestión del contexto).
El Claude Agent SDK te ofrece este bucle —herramientas, permisos, gestión del contexto— todo incluido, para que no tengas que construirlo a mano.
Hazlo robusto
- Acota todo: iteraciones, tiempo, coste. Los agentes pueden quedar en bucle.
- Gestiona los fallos de las herramientas con elegancia (devuelve el error como resultado).
- Mínimo privilegio + humano en el bucle para acciones arriesgadas: consulta Proteger agentes.
- Evalúalo con casos reales antes de confiar en él: consulta Evaluaciones.