Trace

에이전트 요청 처리 과정의 단계별 추적

에이전트가 요청을 처리하는 전체 과정을 단계별로 추적하는 방법을 다룹니다.

1. 실행 경로(Execution Path) 시각화

사용자 질문부터 최종 답변까지의 전 과정을 타임라인 형태로 추적:

생각(Thought): 에이전트의 추론 과정
도구 호출: 외부 도구/함수 실행
결과 수신: 도구 실행 결과 수신
답변 생성: 최종 응답 생성

2. 원인 분석

에이전트가 잘못된 답변을 했을 때 정확한 실패 지점을 식별:

프롬프트 문제: 지시문이 불명확한 경우
검색(RAG) 실패: 관련 문서를 찾지 못한 경우
도구 오류: 도구 실행 중 에러 발생

3. 입출력 검증

각 단계(Span)별로 모델에 입력된 데이터와 출력된 결과를 상세 로그로 확인합니다.

4. Trace 뷰 유형

4.1. Session View

세션 단위로 대화 흐름을 확인:

Session ID
평균 지속 시간 (Avg. duration)
Agent 호출 횟수
Model 호출 횟수/에러
Tool 호출 횟수/에러
토큰 사용량
마지막 활동 시간

4.2. Trace Span View

개별 트레이스 스팬 상세 분석:

Trace span ID
에이전트 이름
타입 (Invoke Agent)
지속 시간
토큰 사용량
시작 시간
상태 (Unset, Error 등)

4.3. Directed Acyclic Graph (DAG)

에이전트의 실행 흐름을 그래프 형태로 시각화:

각 노드는 실행 단계를 나타냄
엣지는 실행 순서를 표시
병렬 실행 경로 확인 가능