Contrato de evento
Campos que espera la consulta
| Campo | Tipo | Por que existe |
|---|---|---|
| timestamp_utc | Timestamp | Tiempo de finalización de la llamada de herramienta. |
| run_id | Utf8 | Identificador estable para la ejecución de un agente. |
| agent_name | Utf8 | Nombre del flujo de trabajo del agente. |
| tool_name | Utf8 | Nombre de la herramienta llamada. |
| status | Utf8 | Resultado de la llamada de herramienta. |
| estimated_cost_usd | Float64 | Costo atribuido al paso cuando esté disponible. |
Copiar la consulta
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_id | agent_name | tool_calls | distinct_tools | failed_calls | tool_loop_cost_usd | first_call_at | last_call_at |
|---|---|---|---|---|---|---|---|
| run_9021 | billing_reconciler | 17 | 2 | 8 | 0,84 | 12:02:11 | 12:06:48 |
| run_9154 | support_agent | 11 | 1 | 0 | 0,31 | 12:44:10 | 12:45:32 |
Salida de ejemplo sintético. Ejecute la consulta con su propio esquema de eventos y umbrales antes de utilizarla para decisiones operativas.
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
- 1Un candidato de bucle combina un alto número de llamadas con una diversidad de herramientas muy baja.
- 2Las llamadas fallidas distinguen los bucles de reintento explícitos de las llamadas exitosas repetidas que nunca avanzan de estado.
- 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 alertaPon 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
Calcular el costo de LLM por característica y modelo
Atribuya el gasto del modelo, los tokens, el volumen de solicitudes y el costo por solicitud a las características del producto.
Receta abiertaMedir las producciones de IA aceptadas por dólar
Conecte el gasto modelo con resultados de productos aceptados, ahorrados o útiles.
Receta abiertaConsultar eventos de llamadas de herramientas de IA anidadas
Filtre campos anidados con puntos y clasifique las herramientas que fallan sin aplanar la carga útil del evento original.
Receta abiertaEjecú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.