콘텐츠로 건너뛰기
Telemetry
AI 및 LLM SQL 레시피

반복되는 AI 에이전트 도구 Loops 감지

성공적인 결과에 도달하지 못한 채 소규모 도구 세트를 반복적으로 호출하는 에이전트 실행을 찾아보세요.

중급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 키 받기