1. Contrato de evento
una fila en agent_events, con los tipos utilizados por la consulta explícitos.
- timestamp_utc
- Timestamp
- event_name
- Utf8
- data.tool_name
- Utf8
- data.status
- Utf8
- data.args.operation
- Utf8
- data.latency_ms
- Float64
Utilice metadatos de tabla y un mensaje enfocado para obtener una primera consulta DataFusion o un plan de visualización, luego revise la lógica generada con el esquema y el resultado real.
Resultados
como funciona
Nombra la tabla, la definición de métrica, el rango de tiempo, la agrupación y el resultado esperado. El lenguaje empresarial ambiguo produce SQL ambiguo.
Verifique los tipos de campos, uniones, denominadores, manejo de nulos y límites de tiempo antes de confiar en el gráfico.
Utilice la IA para acelerar, no para obtener autoridad. Una consulta guardada debe ser comprensible para el siguiente humano o agente que la mantenga.
Generando una consulta editable con IA
Una captura de producto real que muestra una pregunta en lenguaje sencillo que se convierte en SQL y permanece visible para su revisión.
Límites
Ruta de prueba inspeccionable
Este ejemplo utiliza un esquema declarado, SQL de solo lectura y resultados sintéticos deterministas. Demuestra el flujo de trabajo sin presentar datos de muestra como punto de referencia del cliente.
una fila en agent_events, con los tipos utilizados por la consulta explícitos.
¿Qué herramientas y argumentos de IA están asociados con la mayor cantidad de llamadas fallidas?
SELECT
"data.tool_name" AS tool_name,
"data.args.operation" AS operation,
COUNT(*) AS calls,
SUM(CASE
WHEN "data.status" = 'failed' THEN 1 ELSE 0
END) AS failures,
100.0 * SUM(CASE
WHEN "data.status" = 'failed' THEN 1 ELSE 0
END) / NULLIF(COUNT(*), 0) AS failure_rate_pct,
approx_percentile_cont("data.latency_ms", 0.95) AS p95_latency_ms
FROM agent_events
WHERE event_name = 'agent_tool_called'
AND timestamp_utc >= now() - INTERVAL '7 days'
GROUP BY "data.tool_name", "data.args.operation"
HAVING COUNT(*) >= 20
ORDER BY failure_rate_pct DESC, calls DESC;La búsqueda de CRM es la operación de herramienta menos confiable y la más lenta en p95.
| tool_name | operation | calls |
|---|---|---|
| crm_lookup | search_contact | 842 |
| order_api | fetch_order | 2210 |
| knowledge_search | semantic_search | 4510 |
Capacidades
Ver el análisis
Filtre campos anidados con puntos y clasifique las herramientas que fallan sin aplanar la carga útil del evento original.
Receta abiertaConecte el gasto modelo con resultados de productos aceptados, ahorrados o útiles.
Receta abiertaAgrupe a los usuarios por primera semana de actividad y mida el porcentaje que regresa en semanas posteriores.
Receta abiertaCasos de clientes
Capacidades relacionadas
Ingestión de eventos estructurados
Banco de trabajo SQL y API de consulta
Explorar
Utilice un mensaje enfocado, envíe eventos sintéticos y verifique la primera consulta útil antes de ampliar la cobertura.