GuíasIA y agentes

El bucle de un agente de IA: presupuesto de pasos, parada y relevo

Por el equipo de Banzai LabsActualizado el 3 min de lectura

ClaudeHerramientaResultadoPresupuestopaso 7 / 15luego pararCada vuelta cuesta: se fija un número de pasos, un presupuesto y una salida
El agente llama a herramientas en bucle; un presupuesto de pasos lo detiene antes de que gire sin fin.

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

  1. 1Límite alcanzadoEl bucle se detiene.
  2. 2Última vuelta sin herramientasEl modelo resume lo hecho y lo que queda.
  3. 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.

Para leer después

Todas las guías