한 메시지가 어떤 단계를 거쳐 처리됐는지, 각 단계에 무엇이 들어가고 나왔는지를 모두 여기서 봅니다.
(배지·기호 같은 세부 표기는 각 탭 안에 접어 두었습니다 — 처음 보는 표시를 만났을 때 펼쳐 보세요.)
트레이스 상세 — 좌측 Run 트리에서 단계를 고르면 우측에 그 단계의 입·출력이 표시됩니다
화면은 좌측 Run 트리(처리 단계를 순서·계층대로 나열, 상단에 전체 지연·총 토큰)와 우측 상세 패널(고른 단계의 입·출력·토큰)로 나뉩니다.한 메시지는 보통 — 에이전트(CH)가 LM 추론과 도구 호출을 반복해 데이터를 모으고, 마지막에 final_answer(LM)가 답을 씁니다.
좌측 — Run 트리
우측 — 상세 패널
각 줄(Run)은 색 배지 + 이름 + ● 상태 + 지연 시간으로 표시됩니다. 자주 보이는 배지만 알면 트리를 읽을 수 있습니다. (색 포함 전체 종류는 아래 범례를 펼쳐 보세요.)
배지
하는 일
CH
에이전트 실행 — 메시지 처리 전체를 감싸는 단계 (이름은 에이전트명, 예 dv_test)
LM
LLM 호출 — 추론하거나 최종 답 작성(final_answer)
TL
도구 실행 — SQL 조회·함수 호출(run_sql_read 등)
EM
임베딩 — 검색용 벡터 생성
ACT
작업 그룹 — 도구 + 하위 단계 묶음 (화살표로 펼침)
● 상태 — 초록이면 정상, 빨강이면 그 단계에서 오류.
옆 시간 — 그 단계의 지연. 값이 가장 큰 단계가 병목입니다.
제목·태그·검색 쿼리 자동 생성 같은 보조 작업은 응답과 별개로 background_tasks 트레이스에 따로 기록됩니다.
Run 종류 전체 (색상 범례)
상세 트리는 단계 종류를 색 배지로 구분합니다. (검색 결과 카드에서는 Agent·LLM·Embed 같은 라벨로 묶여 표시됩니다.)
배지
종류
색
설명
CH
Chain
보라
복합 작업 — 메시지 처리 전체/에이전트 실행
LM
LLM
파랑
LLM 호출 (추론·최종 답변)
TL
Tool
초록
도구 실행 (SQL·함수 등)
RG
Retrieval
주황
지식 기반 문서 검색
WB
Web Search
시안
웹 검색
GD
Guardrail
빨강
가드레일 점검
EM
Embedding
노랑
임베딩(벡터) 생성
FL
Filter
분홍
필터 함수 실행
PP
Pipeline
남색
파이프라인 처리
TK
Task
회색
백그라운드 태스크
IM
Image
회색
이미지 생성 (전용 색 없이 회색으로 표시)
ACT
Action
보라
도구 + 하위 단계 그룹 (펼치기 가능, 합성 배지)
상태 표시 (● 기호·색)
상태
기호
색
Success
●
초록
Error
●
빨강
Running
◐
노랑
Pending
○
회색
트레이스 전체 상태는 포함된 Run 중 하나라도 Error면 Error, Error가 없고 Running이 있으면 Running으로 표시됩니다.
트리에서 단계를 클릭하면 우측에 그 단계의 상세가 표시됩니다.
섹션
내용
상단 요약
상태 · 지연 시간 · 사용 모델
Inputs
입력 (시스템 프롬프트, 정규화된 질문 등)
Outputs
출력 (응답, 검색된 출처 수 sources_count·source_names 등)
Token Usage
Input · Output · Total 토큰
Tree · JSON · Text 토글로 입·출력을 트리/원본 JSON/평문으로 전환합니다.
Outputs의 Search… 칸으로 긴 출력에서 텍스트를 찾을 수 있습니다.
입·출력 보기 모드 · 텍스트 검색
보기 모드
설명
Tree
계층적 트리 (기본)
JSON
원본 JSON
Text
평문 텍스트
Outputs 영역에서는 텍스트 검색이 됩니다. 검색어를 입력하면 하이라이트되고, Enter로 다음·Shift+Enter로 이전 매치로 이동하며, 검색창 옆에 1/5처럼 매치 수가 표시됩니다.
