Saltar al contenido
Telemetry
IA y LLM receta SQL

Detectar bucles repetidos de herramientas de agentes de IA

Encuentre ejecuciones de agentes que llamen repetidamente a un pequeño conjunto de herramientas sin alcanzar un resultado exitoso.

Intermedioagent_tool_callsRevisado 2026-07-27Probado con Apache DataFusion 45.2.0

Revisado por el equipo de producto Telemetry en . Compatibilidad con SQL, contrato de eventos, resultados sintéticos y advertencias operativas. Revisar los estándares y la propiedad

Pregunta respondida

¿Qué ejecuciones de agentes aparecen atrapadas en un bucle de herramientas repetitivo?

Un agente fallido no siempre genera una excepción. Las llamadas repetidas a las mismas herramientas pueden consumir tiempo y tokens mientras la ejecución permanece técnicamente activa.

Contrato de evento

Campos que espera la consulta

CampoTipoPor que existe
timestamp_utcTimestampTiempo de finalización de la llamada de herramienta.
run_idUtf8Identificador estable para la ejecución de un agente.
agent_nameUtf8Nombre del flujo de trabajo del agente.
tool_nameUtf8Nombre de la herramienta llamada.
statusUtf8Resultado de la llamada de herramienta.
estimated_cost_usdFloat64Costo atribuido al paso cuando esté disponible.
DataFusionSQL

Copiar la consulta

sql
SELECT
  run_id,
  agent_name,
  COUNT(*) AS tool_calls,
  COUNT(DISTINCT tool_name) AS distinct_tools,
  SUM(CASE WHEN status = 'failed' THEN 1 ELSE 0 END) AS failed_calls,
  SUM(estimated_cost_usd) AS tool_loop_cost_usd,
  MIN(timestamp_utc) AS first_call_at,
  MAX(timestamp_utc) AS last_call_at
FROM agent_tool_calls
WHERE timestamp_utc >= now() - INTERVAL '24 hours'
GROUP BY run_id, agent_name
HAVING COUNT(*) >= 8
  AND COUNT(DISTINCT tool_name) <= 2
ORDER BY tool_calls DESC, tool_loop_cost_usd DESC
LIMIT 100;

Esta consulta de solo lectura se planifica y ejecuta en una tabla escrita vacía con Apache DataFusion 45.2.0. El resultado de la muestra determinista es sintético y se revisa por separado; valide tipos de campos, umbrales y definiciones comerciales con sus propios datos. Lea la metodología de prueba.

Resultado de la consulta

Llamadas repetidas a herramientas por ejecución del agente

El conciliador de facturación realizó 17 llamadas en solo dos herramientas y falló en casi la mitad de ellas.

run_idagent_nametool_callsdistinct_toolsfailed_callstool_loop_cost_usdfirst_call_atlast_call_at
run_9021billing_reconciler17280,8412:02:1112:06:48
run_9154support_agent11100,3112:44:1012:45:32

Salida de ejemplo sintético. Ejecute la consulta con su propio esquema de eventos y umbrales antes de utilizarla para decisiones operativas.

Repeated tool calls by agent run: gráfico estático de valores sintéticos de tool_calls del resultado del ejemplo Detect Repeating AI Agent Tool Loops
SVG indexable de la salida del ejemplo determinista. Descárguelo para ver un artículo, un runbook o una revisión de diseño con atribución.

Reproducir el ejemplo

Descargar el accesorio público

El paquete JSON incluye el contrato de evento escrito, illustrative filas de entrada, SQL exacto, resultado esperado, notas de revisión y versión del motor. El CSV contiene el resultado mostrado.

Cómo funciona el SQL

  1. 1Un candidato de bucle combina un alto número de llamadas con una diversidad de herramientas muy baja.
  2. 2Las llamadas fallidas distinguen los bucles de reintento explícitos de las llamadas exitosas repetidas que nunca avanzan de estado.
  3. 3Las marcas de costo y tiempo transcurrido muestran el impacto financiero y de latencia del bucle.

Casos extremos para decidir

  • Algunos agentes por lotes llaman legítimamente a una herramienta muchas veces; segmentar por flujo de trabajo del agente y recuento esperado de elementos.
  • Un umbral de bucle debe incluir un tiempo de ejecución máximo o una transición de estado en producción.
  • No registre argumentos de herramientas sin procesar ni contenido devuelto por el cliente para diagnosticar bucles.

Panel recomendado

  • Barras: tool_calls por run_id
  • Estadística: bucles sospechosos y coste atribuido
  • Tabla: secuencia de herramientas, estado y error categorizado para ejecuciones seleccionadas

Guía de alerta

Alerte o finalice una ejecución cuando las llamadas repetidas excedan el umbral de seguridad específico del flujo de trabajo sin una transición de estado.

Leer configuración de alerta

Pon la receta a trabajar

Instrumentación y guías relacionadas.

Definir los datos de origen

Esquemas de eventos para este análisis.

Continuar el análisis

Ejecútelo en eventos reales.

Crea una tabla, adapta los campos y guarda el resultado.

Comience gratis, envíe eventos estructurados y utilice el resultado de la consulta como un gráfico, un widget de panel compartido o una entrada de alerta.

Obtén una clave API