GuíasIA y agentes
El bucle de un agente de IA: presupuesto de pasos, parada y relevo
El bucle
const MAX_PASOS = 15;
for (let paso = 1; paso <= MAX_PASOS; paso++) {
const resp = await client.messages.create({ model: process.env.CLAUDE_MODEL!, max_tokens: 2048, tools, messages });
messages.push({ role: 'assistant', content: resp.content });
if (resp.stop_reason !== 'tool_use') return resp; // respuesta final
const resultados = [];
for (const bloque of resp.content) {
if (bloque.type !== 'tool_use') continue;
resultados.push({ type: 'tool_result', tool_use_id: bloque.id, content: await ejecutar(bloque.name, bloque.input) });
}
messages.push({ role: 'user', content: resultados });
}
return resumirYParar(messages); // última llamada sin herramientas
Las cuatro protecciones
- PasosUn número máximo de vueltas.
- TokensUn total acumulado que no superar.
- TiempoUn plazo global para la tarea.
- RepeticiónMisma llamada, mismos argumentos: parar.
Qué registrar en cada vuelta
| Dato | Para qué |
|---|---|
| Herramienta y argumentos | Entender lo que hizo el agente |
| Tokens de entrada y salida | Seguir el coste de la tarea |
| Duración de la herramienta | Encontrar el paso lento |
| Error eventual | Devolverlo al modelo, o parar |
Una salida limpia
- 1Límite alcanzadoEl bucle se detiene.
- 2Última vuelta sin herramientasEl modelo resume lo hecho y lo que queda.
- 3RelevoAl usuario, con ese resumen.
Las bases: la llamada a herramientas y agentes de IA con datos reales. El coste: limitar la factura de la API de IA.
Preguntas frecuentes
- ¿Cuántos pasos hay que permitir?
- Depende de la tarea. Mide el número de pasos en casos reales y fija el límite un poco por encima. Una tarea que lo alcanza a menudo está mal dividida o mal equipada.
- ¿Qué hacer cuando se alcanza el límite?
- Pedir al modelo una última vuelta sin herramientas para resumir lo hecho y lo que falta, y devolver el control al usuario o a una persona.
- ¿Cómo detectar un bucle que da vueltas?
- Comparando las llamadas: la misma herramienta con los mismos argumentos varias veces seguidas es una señal. Se para y se avisa.