活動合約
查詢期望的欄位
| 欄位 | 型別 | 為什麼存在 |
|---|---|---|
| timestamp_utc | Timestamp | 當工具呼叫完成時。 |
| event_name | Utf8 | agent_tool_called 用於這些事件。 |
| data.tool_name | Utf8 | 巢狀工具識別符號顯示為虛線列。 |
| data.status | Utf8 | 巢狀成功或失敗狀態。 |
| data.args.operation | Utf8 | 安全、分類的操作而不是原始參數。 |
| data.latency_ms | Float64 | 巢狀工具呼叫延遲。 |
DataFusion SQL
複製查詢
sql
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;此只讀查詢是針對空型別資料表計劃和執行的 阿帕奇 DataFusion 45.2.0。確定性樣本輸出是綜合的並單獨審查;根據您自己的資料驗證欄位型別、閾值和業務定義。 閱讀測試方法。
查詢結果
工具呼叫失敗率
CRM 查詢是最不可靠的工具操作,而且在 p95 上也是最慢的。
crm_lookup
7.24%
order_api
1.99%
knowledge_search
0.42%
| tool_name | operation | calls | failures | failure_rate_pct | p95_latency_ms |
|---|---|---|---|---|---|
| crm_lookup | search_contact | 842 | 61 | 7.24 | 2,180 |
| order_api | fetch_order | 2,210 | 44 | 1.99 | 940 |
| knowledge_search | semantic_search | 4,510 | 19 | 0.42 | 720 |
綜合範例輸出。在將其用於操作決策之前,針對您自己的事件架構和閾值執行查詢。
SQL 是如何工作的
- 1點式欄位名稱用雙引號引起來,因為點是推斷的列名稱的一部分。
- 2查詢按工具和分類操作進行分組,保留足夠的上下文來區分一種工具的不同行為。
- 3預設情況下不應記錄原始工具參數。而是儲存安全類別、識別符號和結果欄位。
需要決定的邊緣情況
- 隨著架構的發展,保持巢狀欄位型別穩定。
- 不同的工具可能有不同的成功語義;在檢測時標準化狀態值。
- 高基數原始參數可能會產生隱私、成本和可用性問題。
推薦儀表板
- 條形圖:failure_rate_pct by tool_name
- 折線圖:p95_latency_ms 隨著時間的推移按工具劃分
- 資料表:error_type 和代理工作流程的最近故障
讓查詢範例發揮作用
相關埋點和指南
定義源資料
此分析的事件模式
繼續分析
在真實事件中執行它
建立資料表,調整欄位並儲存結果
免費開始,傳送結構化事件,並將查詢結果用作圖表、共享儀表板小工具或警示輸入。