跳至主要內容
Telemetry
人工智慧和法學碩士 SQL查詢範例

檢測重複的 AI 代理工具迴圈

查詢代理執行重複呼叫一小組工具但未取得成功結果的情況。

中級agent_tool_calls已審查 2026-07-27測試用 阿帕奇 DataFusion 45.2.0

審閱者 Telemetry產品團隊 . SQL 相容性、事件契約、合成輸出和操作注意事項. 審查標準和所有權

問題已回答

哪些代理執行似乎陷入了重複的工具迴圈?

失敗的代理並不總是引發異常。重複呼叫相同的工具可能會消耗時間和權杖,而執行在技術上仍保持活動狀態。

活動合約

查詢期望的欄位

欄位型別為什麼存在
timestamp_utcTimestamp工具呼叫完成時間。
run_idUtf8一次代理執行的穩定識別符號。
agent_nameUtf8代理工作流程名稱。
tool_nameUtf8稱為工具名稱。
statusUtf8工具呼叫結果。
estimated_cost_usdFloat64成本歸因於該步驟(如果可用)。
DataFusion SQL

複製查詢

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;

此只讀查詢是針對空型別資料表計劃和執行的 阿帕奇 DataFusion 45.2.0。確定性樣本輸出是綜合的並單獨審查;根據您自己的資料驗證欄位型別、閾值和業務定義。 閱讀測試方法。

查詢結果

代理執行重複呼叫工具

計費調節器僅透過兩個工具進行了 17 次呼叫,但其中近一半失敗了。

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

綜合範例輸出。在將其用於操作決策之前,針對您自己的事件架構和閾值執行查詢。

Repeated tool calls by agent run:來自 Detect Repeating AI Agent Tool Loops 範例結果的合成 tool_calls 值的靜態圖表
確定性範例輸出的可索引 SVG。下載它以獲取帶有歸屬的文章、操作手冊或設計評論。

重現範例

下載公共裝置

JSON 包包含型別化事件契約, illustrative 輸入行、確切的 SQL、預期輸出、審閱註釋和引擎版本。 CSV 包含顯示的結果。

SQL 是如何工作的

  1. 1迴圈候選者結合了高呼叫次數和極低的工具多樣性。
  2. 2失敗的呼叫將顯式重試迴圈與從不提升狀態的重複成功呼叫區分開來。
  3. 3成本和經過的時間戳顯示了迴圈的財務和延遲影響。

需要決定的邊緣情況

  • 一些批次處理代理可以多次合法地呼叫一種工具;按代理工作流程和預期專案數進行細分。
  • 迴圈閾值應包括生產中的最大執行時間或狀態轉換。
  • 不要記錄原始工具參數或返回的客戶內容來診斷迴圈。

推薦儀表板

  • 酒吧:tool_calls by run_id
  • 統計:可疑迴圈和歸因成本
  • 資料表:所選執行的工具序列、狀態和分類錯誤

警示指導

當重複呼叫超過工作流程特定的安全閾值而沒有狀態轉換時,發出警示或終止執行。

讀取警示設定

讓查詢範例發揮作用

相關埋點和指南

定義源資料

此分析的事件模式

繼續分析

在真實事件中執行它

建立資料表,調整欄位並儲存結果

免費開始,傳送結構化事件,並將查詢結果用作圖表、共享儀表板小工具或警示輸入。

獲取 API 金鑰