추적하려는 응답 메시지 하단 액션바의 링크 아이콘(툴팁 추적 보기)을 누릅니다. 새 탭에서 평가 › 추적이 열리며 그 채팅의 모든 메시지 트레이스 카드가 표시되므로, 방금 그 응답만 보려면 시각·메시지 내용으로 카드를 고르세요. 특정 메시지 하나를 바로 열려면 ① 대화 로그 › 추적을 쓰세요(메시지 ID로 조회됩니다).
응답 하단 액션바의 링크 아이콘(툴팁 '추적 보기')
표시되는 버튼은 권한에 따라 다릅니다.
권한
표시되는 버튼
관리자 또는 평가 읽기/쓰기 권한
툴팁 추적 보기 → 새 탭으로 평가 › 추적 열기
그 외 사용자
툴팁 메시지 ID 복사 → 누르면 Chat ID와 Message ID 두 줄이 클립보드에 복사됩니다. 관리자에게 전달해 조사를 요청하세요
평가 › 추적 화면에서 Chat ID 또는 Message ID로 검색하면, 위 화면처럼 메시지 카드 목록이 나옵니다.
카드 하나가 사용자 메시지 하나의 트레이스 요약이고, 카드를 클릭하면 상세 화면이 열립니다.
검색 기준과 카드 항목 표는 아래에 접어 두었습니다.
검색 기준 — Chat ID vs Message ID
검색 기준
찾는 범위
값을 얻는 곳
Chat ID
그 채팅의 모든 메시지 트레이스
채팅 URL의 /c/ 다음 부분
Message ID
특정 메시지 하나의 트레이스
사용자가 메시지 옵션에서 메시지 ID 복사
검색은 입력한 ID에 해당하는 모든 트레이스를 기간 제한 없이 가져옵니다. (날짜·상태 같은 별도 필터는 없습니다.) 목록은 20건 단위로 나뉘어 표시되므로, 결과가 많으면 하단 페이지 버튼으로 이동하세요.
메시지 카드 항목
카드 항목
설명
사용자 메시지
원본 입력 (카드에는 2줄까지 표시)
트레이스 ID
식별자 축약 표시 (예: 3fb13ae9…)
시각
요청 시각 (MM/DD HH:MM:SS)
지연 시간
최상위 단계 소요의 합계 (2.39s·1m 22s처럼 단위가 자동으로 바뀝니다)
종류 배지
그 트레이스의 최상위 단계 종류 — 에이전트 · LLM · 임베딩 등
Run 수
최상위 단계 개수 (예: 4 runs). 에이전트 안에 중첩된 단계는 포함되지 않으며, 전체 단계는 카드를 눌러 상세에서 확인합니다
트레이스 상세 화면 읽는 법
여기가 추적의 핵심입니다.
한 메시지가 어떤 단계를 거쳐 처리됐는지, 각 단계에 무엇이 들어가고 나왔는지를 모두 여기서 봅니다.
(배지·기호 같은 세부 표기는 각 탭 안에 접어 두었습니다 — 처음 보는 표시를 만났을 때 펼쳐 보세요.)
트레이스 상세 — 좌측 Run 트리에서 단계를 고르면 우측에 그 단계의 입·출력이 표시됩니다
화면은 좌측 Run 트리(처리 단계를 순서·계층대로 나열, 상단에 전체 지연·총 토큰)와 우측 상세 패널(고른 단계의 입·출력·토큰)로 나뉩니다. 좌측 패널 헤더에서 트리 · 타임라인 · 토큰 세 가지 보기로 전환할 수 있습니다.한 메시지는 보통 — 에이전트(CH)가 LM 추론과 도구 호출을 반복해 데이터를 모으고, 마지막에 final_answer(LM)가 답을 씁니다.
좌측 — Run 트리
우측 — 상세 패널
각 줄(Run)은 색 배지 + 이름 + ● 상태 + 지연 시간으로 표시됩니다. 자주 보이는 배지만 알면 트리를 읽을 수 있습니다. (색 포함 전체 종류는 아래 범례를 펼쳐 보세요.)
배지
하는 일
CH
에이전트 실행 — 메시지 처리 전체를 감싸는 단계 (이름은 에이전트 이름입니다)
LM
LLM 호출 — 추론하거나 최종 답 작성(final_answer)
TL
도구 실행 — SQL 조회·함수 호출(run_sql_read 등)
EM
임베딩 — 검색용 벡터 생성
ACT
작업 그룹 — 도구 + 하위 단계 묶음 (화살표로 펼침)
● 상태 — 초록이면 정상, 빨강이면 그 단계에서 오류.
옆 시간 — 그 단계의 지연. 단, 상위 단계(CH·ACT)의 시간에는 하위 단계 시간이 포함되므로 단순 최댓값을 병목으로 보면 안 됩니다. 제품이 계산한 병목 단계는 지연 시간이 붉게 강조되어 표시됩니다.
좌측 패널 헤더의 보기 토글로 같은 단계 목록을 세 가지 방식으로 볼 수 있습니다.
보기
보여주는 것
트리
단계를 부모-자식 계층으로 나열 (기본)
타임라인
단계별 소요 구간을 가로 막대로 배치하고, 하단에 시간 눈금과 가장 느린 추출 단계: <이름> · 시간 (n%) 요약을 표시
토큰
트레이스 전체 토큰 구성(입력·캐시·출력) 막대와 프롬프트 캐시 적중률·실효 토큰, 단계별 토큰 막대 (막대를 누르면 우측 상세가 그 단계로 전환)
제목·태그·검색 쿼리 자동 생성 같은 보조 작업은 응답과 별개로 background_tasks 트레이스에 따로 기록됩니다.
Run 종류 전체 (색상 범례)
상세 트리는 단계 종류를 색 배지로 구분합니다. (검색 결과 카드에서는 에이전트 · LLM · 임베딩 같은 라벨로 묶여 표시됩니다.)
배지
종류
색
설명
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
보라
도구 + 하위 단계 그룹 (펼치기 가능, 합성 배지)
환경·버전에 따라 나타나지 않는 종류도 있습니다 — 실제 트레이스에는 주로 CH·LM·TL·RG·GD·EM·TK가 기록됩니다.
상태 표시 (● 색)
상태
표시
Success
초록 점
Error
빨강 점
Running
주황 점 (깜박이는 펄스 애니메이션)
Pending
회색 점
네 상태 모두 같은 모양의 점이며 색으로만 구분합니다.
트레이스 전체 상태는 포함된 Run 중 하나라도 Error면 Error, Error가 없고 Running이 있으면 Running으로 표시됩니다.
트리에서 단계를 클릭하면 우측에 그 단계의 상세가 표시됩니다.
섹션
내용
상단 요약
상태 · 지연 시간 · 사용 모델 (답변 양식이 지정된 단계에는 ‘답변 양식’ 배지가 함께 표시됩니다)
입력
그 단계에 들어간 값 (시스템 프롬프트, 정규화된 질문 등)
출력
그 단계가 내놓은 값 (응답, 출처 묶음 수 sources_count·source_names 등)
오류
그 단계가 실패한 경우에만 출력 아래에 빨간 영역으로 표시 — 도구 실패 진단은 여기부터 봅니다
토큰 사용량
입력 · 출력 · 합계 토큰. 프롬프트 캐시가 적중하면 프롬프트 캐시 줄에 입력 N 중 캐시 적중 M (x%)와 캐시 생성 값이 덧붙습니다
트리 · JSON · 텍스트 토글로 입·출력을 트리/원본 JSON/평문으로 전환합니다.
출력의 Search... 칸으로 긴 출력에서 텍스트를 찾을 수 있습니다.
트레이스에 기록되는 사용자 메시지는 500자까지입니다. 입력 끝의 ...은 기록 한도 때문이며, 모델에 전달된 내용이 잘린 것은 아닙니다. (시스템 프롬프트도 경로에 따라 길이가 제한될 수 있습니다.)
입·출력 보기 모드 · 텍스트 검색
보기 모드
설명
트리
계층적 트리 (기본)
JSON
원본 JSON
텍스트
평문 텍스트
출력 영역에서는 텍스트 검색이 됩니다. 검색어를 입력하면 하이라이트되고, Enter로 다음·Shift+Enter로 이전 매치로 이동하며, 검색창 옆에 1/5처럼 매치 수가 표시됩니다.
두 단계(Phase)로 읽기
에이전트 응답은 두 단계로 나눠 읽으면 원인을 빨리 찾을 수 있습니다.
단계
무엇을
여기서 보는 것
Phase 1
에이전트(CH)가 LM 추론으로 도구(TL)를 호출하며 데이터를 모음
어떤 도구를 썼나, 결과가 비지 않았나
Phase 2
final_answer(LM)가 모은 데이터로 답을 작성
모은 데이터가 답에 제대로 반영됐나
좌측 패널 헤더에는 이 두 구간을 자동 계산한 막대가 함께 표시되므로 단계별 시간을 직접 더할 필요가 없습니다 — 추출(트레이스 시작 ~ 최종 답변 시작) 소요와 비율, 첫 토큰 (전체)(추출 + 답변 첫 토큰까지 = 사용자가 실제로 기다린 시간), 첫 토큰 (답변 기준)(최종 답변 시작 후 첫 토큰까지). 최종 답변 단계가 없는 트레이스(백그라운드 작업 등)에서는 표시되지 않습니다.
디버깅 포인트
에이전트가 도구(지식 기반·DB)를 쓰지 않았다면?
Phase 1의 첫 LM 추론 Run의 입력에서 tool_descriptions(그 실행에 연결된 도구 이름과 설명)를 확인하세요. 트레이스 용량을 줄이기 위해 이 항목은 첫 LLM 호출 1회에만 기록되므로, 중간 LM Run에는 없을 수 있습니다.
tool_descriptions에 원하는 도구가 없음 → 에이전트에 해당 기능(지식 기반·DB 등)이 연결되지 않음
도구가 있는데 호출 안 함 → 모델이 질문과 도구의 관련성을 낮게 판단. 도구·기능 설명을 더 구체적으로 수정
active_capabilities(그 시점에 켜져 있던 기능 묶음)는 Phase 2 final_answer Run의 입력에서 볼 수 있습니다.
검색은 됐는데 답변이 부정확하다면?
지식 기반 검색은 RG(Retrieval) Run(knowledge_search, 청크를 다시 가져올 때는 knowledge_fetch_chunks)으로 따로 기록됩니다. 검색 건수·점수·리랭크 여부는 이 Run의 출력에서 total_results·top_scores·reranked·sources로 확인하세요.
RG Run이 아예 없음 → 검색을 실행하지 않음. 에이전트에 지식 기반이 연결됐는지 확인
total_results가 0 → 검색 0건. 지식 기반 문서 누락 또는 검색 설정(Top K·Reranker 등) 점검 필요
출처는 있는데 답이 엉뚱 → final_answer(LM) Run의 입력에서 전달된 내용을 확인하고 답변 프롬프트를 조정
final_answer 출력의 sources_count·source_names는 답변 프롬프트에 실린 출처 묶음 수라 검색 건수와 다를 수 있습니다.
도구 실행이 실패했다면?
빨간 점이 찍힌 TL(도구) Run을 클릭해 출력 아래 오류 영역의 메시지를 먼저 확인하고, 입력으로 전달된 파라미터를 함께 검증하세요.
응답이 너무 느리다면?
Run 트리에서 지연 시간이 붉게 강조된 단계가 제품이 계산한 병목입니다. 타임라인 보기로 바꾸면 하단에 가장 느린 추출 단계: <이름> · 시간 (n%) 요약이 함께 표시됩니다. 최종 답변 작성 단계와 그 이후 후처리는 답변이 전달된 뒤의 시간이라 병목 계산에서 제외됩니다.
LM이 느림 → 더 빠른 모델로 변경 고려
TL/EM이 느림 → 도구·검색 설정 또는 외부 서비스 확인
GD(가드레일)가 느림 → LLM 판정 비활성화 또는 빠른 모델로 변경
트레이스 분석 보고서
트레이스 데이터를 LLM으로 분석하여 문제의 근본 원인을 자동으로 파악하는 기능입니다.상세 모달 상단에는 트레이스 복사와 트레이스 분석 버튼이 있습니다(이전 분석 결과가 있으면 보고서 보기도 함께). 트레이스 복사는 트레이스 요약(트레이스 ID·Chat ID·상태·총 지연·총 토큰)과 들여쓴 단계 목록(성공/실패, 단계 종류, 이름, 지연, 토큰, 모델, 입·출력 앞부분 미리보기)을 텍스트로 클립보드에 담습니다 — 이슈 공유나 문의 첨부에 사용하세요.
1
분석 시작
트레이스 상세 모달 상단의 트레이스 분석 버튼을 클릭합니다.
입력 항목
설명
필수
분석 모델
분석에 사용할 LLM 모델
필수
설명
관찰된 문제 상황 (입력란에 예시 안내 문구가 표시됩니다)
선택
분석 모델 목록에는 기본 모델만 표시됩니다. 다른 모델을 상속해 만든 커스텀 모델, 프리셋 모델, 아레나 모델은 선택할 수 없습니다.
2
분석 결과 확인
LLM이 트레이스 데이터 + 에이전트 설정 + 대화 이력 + KB/DB/가드레일 설정 + 용어집 설정 + 자동 평가 결과를 종합 분석하여 구조화된 보고서를 생성합니다.
보고서 섹션
내용
요약
분석 결과 2~3문장 핵심 요약
트레이스 개요
ID, 상태, 지연시간, 토큰, Run 수, 오류 수
근본 원인 분석
주요 원인 + 기여 요인
Phase 1 분석
도구 선택이 적절했는지, 사용 가능한 도구 vs 실제 호출 비교
Phase 2 분석
수집된 데이터 대비 최종 답변의 적절성
프롬프트/설정 이슈
시스템 프롬프트, 모델 선택 문제
KB/RAG 이슈
검색 설정, 문서 품질, 필터 문제
DB/SQL 이슈
NL-to-SQL 변환, 스키마 문제
가드레일 이슈
과도한 차단, 오탐
용어집 커버리지 이슈
질문에 쓰인 용어를 용어집이 덮지 못한 부분
오류 분석
Error Run 상세 진단
개선 권장사항
즉시 조치, 설정 변경, 데이터 개선, 아키텍처 제안(중장기 개선)
관련 발견이 없는 섹션은 생략되므로, 모든 섹션이 항상 나오지는 않습니다.
설명을 입력하면 해당 맥락에 집중한 분석이 가능합니다. 예: “KB에서 문서를 찾았는데 답변에 반영되지 않음”보고서는 설명에 사용한 언어와 같은 언어로 작성됩니다. 한국어 보고서가 필요하면 설명을 한국어로 적으세요 — 비워 두면 영어로 작성될 수 있습니다.
3
보고서 저장/공유
분석 보고서 모달 안의 버튼입니다.
기능
설명
복사
클립보드에 전체 텍스트 복사
다운로드
마크다운 파일(.md)로 다운로드
이전에 분석한 결과가 있으면 보고서 보기 버튼으로 재분석 없이 트레이스 분석 보고서를 바로 확인할 수 있습니다.
트레이스 관리
권한
역할
권한
일반 사용자
자신의 트레이스만 조회 가능
관리자
모든 사용자의 트레이스 조회 및 관리
추적 화면에 들어가려면 관리자이거나 평가 읽기 이상 권한이 필요합니다. 권한이 없는 사용자는 자신의 트레이스라도 화면으로 열 수 없고, 추적 라이선스가 없으면 버튼 자체가 표시되지 않습니다.
데이터 정리
오래된 트레이스는 두 가지 방법으로 정리합니다.
관리자 › 설정 › 데이터 보존 — ‘트레이스’ 보존 일수를 지정해 자동으로 정리하거나, 지금 정리 실행으로 즉시 삭제합니다. (권장)
개발자용 API — DELETE /api/v1/traces/cleanup?before_timestamp_ms=<타임스탬프>. 밀리초 단위 타임스탬프 이전의 트레이스를 일괄 삭제하며, 모니터링 쓰기 권한이 필요합니다.
트레이스 삭제는 복구할 수 없습니다. 삭제 전 필요한 분석 보고서를 먼저 다운로드하세요.
활용 사례
응답 품질 디버깅
채팅 메시지의 추적 보기 버튼을 클릭합니다
좌측 Run 트리에서 final_answer(LM) 단계를 선택합니다
출력에서 sources_count·source_names로 검색 결과 반영 여부를 확인합니다
입력에서 모델에 전달된 내용을 확인합니다
트레이스 분석 보고서를 생성하여 근본 원인을 자동 파악합니다
지연 시간 분석
느린 응답의 트레이스를 엽니다
타임라인 보기로 전환해 단계별 소요 구간을 비교합니다
붉게 강조된 병목 단계를 확인합니다 (상위 단계 시간에는 하위 단계 시간이 포함되므로 단순 최댓값으로 판단하지 않습니다)
해당 단계를 최적화합니다 (검색 설정 조정, 모델 변경 등)
도구 실행 오류 추적
문제가 의심되는 트레이스를 엽니다
빨간 점이 찍힌 TL(도구) Run을 선택합니다
출력 아래 오류 영역의 메시지를 확인합니다
입력에서 전달된 파라미터를 검증합니다
토큰 사용량 분석
상세 화면 상단의 총 토큰으로 트레이스 전체 사용량을 확인합니다
토큰 보기로 전환하거나 LM Run별 토큰 사용량(입력/출력/합계)을 비교합니다
Phase 1(에이전트 실행)과 Phase 2(final_answer)의 토큰 비율을 확인합니다
불필요하게 큰 프롬프트나 반복 호출이 있는지 식별합니다
FAQ
추적은 자동으로 기록되나요?
네, 메시지 추적이 활성화되어 있으면 (기본값: 활성) 모든 AI 요청이 자동으로 기록됩니다. 별도 설정이 필요 없습니다.
트레이스 데이터는 얼마나 보존되나요?
기본적으로 트레이스는 자동 삭제되지 않고 계속 보존됩니다. 자동 정리가 기본 꺼짐이고, 데이터 유형별 보존 일수의 기본값이 모두 0(영구 보존)이기 때문입니다. 오래된 트레이스를 정리하려면 **관리자 › 설정 › 데이터 보존**에서 ‘트레이스’ 보존 일수를 1 이상으로 지정하고 자동 정리를 켜거나, 지금 정리 실행으로 즉시 삭제하세요.
추적이 응답 속도에 영향을 주나요?
트레이스는 각 단계가 시작·완료될 때 요청 처리 흐름 안에서 함께 기록됩니다. 단계마다 짧은 저장 작업이 추가되지만 LLM 호출 시간에 비하면 미미해, 체감 응답 속도에는 거의 영향을 주지 않습니다.
분석 보고서도 토큰을 소비하나요?
네, 트레이스 분석은 별도의 LLM 호출이며 사용량이 trace_analysis로 별도 추적됩니다. 분석은 수동으로 트리거할 때만 실행됩니다.
관련 페이지
가드레일 로그
가드레일 탐지 이벤트 전용 로그
자동 평가
에이전트 응답 품질 자동 평가 결과
사용량
토큰 사용량 및 비용 분석
이 페이지가 도움이 되었나요?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Cloosphere Guide","colors":{"primary":"#5f22d0","light":"#7c3aed","dark":"#4c1d95"},"logo":{"light":"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/logo.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=93fb26230c58b4ba9411c3e97e20b439","dark":"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/logo.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=93fb26230c58b4ba9411c3e97e20b439","href":"/ko/index"},"favicon":"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/favicon.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=0e41ff0755aa623d52e26f279f285f71","appearance":{"default":"system","strict":false},"interaction":{"drilldown":true},"styling":{"latex":false},"navigation":{"languages":[{"language":"ko","default":true,"href":"ko"},{"language":"en","href":"en"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cloocus","hasAudioNarration":false,"actualSubdomain":"cloocus","customDomains":["docs.cloosphere.ai"],"gitSource":{"type":"github","owner":"ais-cloocus","repo":"cloosphere-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6a954066df6b735599399868","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"en","tag":"Admin","count":30},{"language":"ko","tag":"관리자","count":30},{"language":"en","tag":"Settings","count":24},{"language":"ko","tag":"설정","count":24},{"language":"en","tag":"Monitoring","count":21},{"language":"ko","tag":"모니터링","count":21},{"language":"en","tag":"Workspace","count":16},{"language":"ko","tag":"워크스페이스","count":16},{"language":"en","tag":"Chat","count":11},{"language":"ko","tag":"채팅","count":11},{"language":"en","tag":"Getting Started","count":10},{"language":"ko","tag":"시작하기","count":10},{"language":"en","tag":"Collaboration","count":8},{"language":"ko","tag":"협업","count":8},{"language":"en","tag":"Data \u0026 Operations","count":6},{"language":"ko","tag":"운영 · 지원","count":6},{"language":"ko","tag":"데이터 및 운영 보안","count":6},{"language":"en","tag":"AI Features \u0026 Safety","count":5},{"language":"en","tag":"UI \u0026 Channels","count":5},{"language":"ko","tag":"AI 기능 및 안전","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"styles.css","content":"/* latin-ext */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu6-K6h9Q.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu0-K4.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* latin-ext */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu6-K6h9Q.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu0-K4.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* latin-ext */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu6-K6h9Q.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu0-K4.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb54C-s0.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb94C-s0.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPbF4Cw.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb54C-s0.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb94C-s0.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPbF4Cw.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb54C-s0.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb94C-s0.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPbF4Cw.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n:root{--brand-primary: #5f22d0;--brand-light: #7c3aed;--brand-dark: #4c1d95;--brand-subtle: #ede9fe;--brand-glow: rgba(95, 34, 208, 0.15);--page-text: #0f172a;--page-muted: #6b7280}body{font-family:\"DM Sans\", sans-serif;color:var(--page-text);font-size:17px}.prose h1,.prose h2,.prose h3,.prose h4{font-family:\"Space Grotesk\", \"DM Sans\", sans-serif;letter-spacing:-0.015em}.prose h1{font-size:44px}.prose h2{font-size:28px;margin-top:36px;margin-bottom:10px}.prose h3{font-size:22px;margin-top:28px;margin-bottom:8px}.prose p,.prose li{color:var(--page-text);line-height:1.75;font-size:1rem}.prose hr{border:0;height:1px;background:linear-gradient(90deg, rgba(148, 163, 184, 0.4), rgba(148, 163, 184, 0.05));margin:28px 0}.dark body{color:#e2e8f0}.dark .prose p,.dark .prose li{color:#e2e8f0}.dark .prose hr{background:linear-gradient(90deg, rgba(148, 163, 184, 0.3), rgba(148, 163, 184, 0.05))}[class*=\"Card\"] svg,.card svg,a[href] svg{color:var(--brand-primary)!important}.card [data-component-part=\"card-icon\"]{margin-bottom:8px}.card [data-component-part=\"card-title\"]{margin-top:12px!important}[class*=\"Card\"],.card{border-radius:16px!important;border-color:rgba(148, 163, 184, 0.25)!important;transition:border-color 0.2s ease, box-shadow 0.2s ease, transform 0.2s ease}[class*=\"Card\"]:hover,.card:hover{transform:translateY(-2px);border-color:var(--brand-light)!important;box-shadow:0 4px 20px var(--brand-glow)!important}a:not([class*=\"Card\"]):hover{color:var(--brand-primary)!important}.stable-scrollbar-gutter.overflow-auto{width:220px!important;min-width:220px!important}.stable-scrollbar-gutter.overflow-auto+div,.stable-scrollbar-gutter.overflow-auto~main{flex:1!important}.flex.flex-row-reverse.gap-12{gap:32px!important}.xl\\:flex.self-start.sticky{max-width:15rem!important}.xl\\:flex.box-border.max-h-full.pl-10{width:14rem!important;padding-left:24px!important}.text-sm.leading-6.w-\\[16\\.5rem\\]{width:100%!important;font-size:13px!important;line-height:1.6!important}#table-of-contents-content a{padding:5px 0!important;display:block}#table-of-contents-content,#table-of-contents-content ul{list-style:none!important;padding-left:0!important;margin-left:0!important}#table-of-contents-content li::marker{content:\"\"!important}#table-of-contents-content>li{border-left:2px solid rgba(148, 163, 184, 0.1);padding-left:12px;transition:border-color 0.15s ease}.dark #table-of-contents-content>li{border-left-color:rgba(148, 163, 184, 0.08)}#table-of-contents-content a{color:var(--page-muted)!important;font-weight:400!important;transition:color 0.15s ease}.dark #table-of-contents-content a{color:#94a3b8!important}#table-of-contents-content>li>a{color:var(--page-text)!important;font-weight:500!important}.dark #table-of-contents-content>li>a{color:#e2e8f0!important}#table-of-contents-content>li>ul{padding-left:12px!important}#table-of-contents-content a:hover{color:var(--brand-dark)!important}.dark #table-of-contents-content a:hover{color:#e2e8f0!important}#table-of-contents-content a.text-primary,#table-of-contents-content a.font-semibold,#table-of-contents-content>li.is-active-item>a{color:var(--brand-primary)!important;font-weight:600!important}.dark #table-of-contents-content a.text-primary,.dark #table-of-contents-content a.font-semibold,.dark #table-of-contents-content a[class*=\"dark:text-primary\"],.dark #table-of-contents-content>li.is-active-item>a{color:var(--brand-light)!important;font-weight:600!important}#table-of-contents-content>li.is-active-item{border-left-color:var(--brand-primary)!important}.dark #table-of-contents-content>li.is-active-item{border-left-color:var(--brand-light)!important}#table-of-contents-content>li:has(>a.border-primary),#table-of-contents-content>li:has(>a.text-primary){border-left-color:var(--brand-primary)!important}.dark #table-of-contents-content>li:has(>a.border-primary),.dark #table-of-contents-content>li:has(>a.text-primary),.dark #table-of-contents-content>li:has(>a[class*=\"dark:text-primary\"]),.dark #table-of-contents-content>li:has(>a[class*=\"dark:border-primary\"]){border-left-color:var(--brand-light)!important}.landing-hero{text-align:center;padding:72px 32px 24px;max-width:860px;margin:0 auto}.landing-hero h1{font-family:\"Space Grotesk\", \"DM Sans\", sans-serif;font-size:52px;font-weight:700;letter-spacing:-0.03em;margin:0 0 20px;background:linear-gradient(135deg, var(--brand-dark), var(--brand-primary), var(--brand-light));-webkit-background-clip:text;-webkit-text-fill-color:transparent;background-clip:text}.dark .landing-hero h1{background:linear-gradient(135deg, var(--brand-light), #a78bfa, #c4b5fd);-webkit-background-clip:text;background-clip:text}.landing-hero p{font-size:19px;line-height:1.7;color:var(--page-muted);margin:0}.dark .landing-hero p{color:#94a3b8}.landing-section{max-width:1280px;margin:0 auto;padding:0 40px 56px}.landing-section h2{font-family:\"Space Grotesk\", \"DM Sans\", sans-serif;font-size:26px;font-weight:600;letter-spacing:-0.015em;margin:0 0 6px;color:var(--page-text)}.dark .landing-section h2{color:#e2e8f0}.landing-section>p{color:var(--page-muted);font-size:16px;margin:0 0 24px}.dark .landing-section>p{color:#94a3b8}.landing-cta{max-width:1280px;margin:0 auto;padding:0 40px 48px}.landing-divider{max-width:1280px;margin:0 auto 48px;padding:0 40px}.landing-divider hr{border:0;height:1px;background:linear-gradient(90deg, transparent, rgba(148, 163, 184, 0.3), transparent);margin:0}.dark .landing-divider hr{background:linear-gradient(90deg, transparent, rgba(148, 163, 184, 0.15), transparent)}.landing-section [role=\"tablist\"]{margin-bottom:12px}.landing-section [role=\"tabpanel\"]>p:first-child{color:var(--page-muted);font-size:15px;margin-bottom:20px}.dark .landing-section [role=\"tabpanel\"]>p:first-child{color:#94a3b8}.group:has(>.mermaid){background:linear-gradient(135deg, #faf8ff 0%, #f3f0ff 100%);border:1px solid rgba(95, 34, 208, 0.08);border-radius:12px;padding:28px 24px;margin:24px 0}.dark .group:has(>.mermaid){background:linear-gradient(135deg, rgba(95, 34, 208, 0.06) 0%, rgba(95, 34, 208, 0.03) 100%);border-color:rgba(124, 58, 237, 0.12)}.mermaid svg .node rect,.mermaid svg .node circle,.mermaid svg .node ellipse,.mermaid svg .node polygon,.mermaid svg .node path{fill:#ede9fe!important;stroke:#7c3aed!important;stroke-width:1.5px!important;rx:8px}.dark .mermaid svg .node rect,.dark .mermaid svg .node circle,.dark .mermaid svg .node ellipse,.dark .mermaid svg .node polygon,.dark .mermaid svg .node path{fill:rgba(124, 58, 237, 0.15)!important;stroke:#a78bfa!important}.mermaid svg .node.rhombus rect,.mermaid svg .node polygon[points]{fill:#ddd6fe!important;stroke:#6d28d9!important}.dark .mermaid svg .node.rhombus rect,.dark .mermaid svg .node polygon[points]{fill:rgba(109, 40, 217, 0.2)!important;stroke:#a78bfa!important}.mermaid svg .cluster rect{fill:rgba(237, 233, 254, 0.4)!important;stroke:rgba(124, 58, 237, 0.25)!important;stroke-width:1.5px!important;rx:10px!important}.dark .mermaid svg .cluster rect{fill:rgba(124, 58, 237, 0.08)!important;stroke:rgba(167, 139, 250, 0.2)!important}.mermaid svg .cluster-label .nodeLabel,.mermaid svg .cluster span{fill:var(--brand-dark)!important;color:var(--brand-dark)!important;font-weight:600!important}.dark .mermaid svg .cluster-label .nodeLabel,.dark .mermaid svg .cluster span{fill:#c4b5fd!important;color:#c4b5fd!important}.mermaid svg .edgePath path.path{stroke:#8b5cf6!important;stroke-width:1.5px!important}.dark .mermaid svg .edgePath path.path{stroke:#a78bfa!important}.mermaid svg .marker{fill:#8b5cf6!important;stroke:#8b5cf6!important}.dark .mermaid svg .marker{fill:#a78bfa!important;stroke:#a78bfa!important}.mermaid svg .label,.mermaid svg .nodeLabel,.mermaid svg .label text,.mermaid svg span{fill:#1e1b4b!important;color:#1e1b4b!important;font-family:\"DM Sans\", sans-serif!important}.dark .mermaid svg .label,.dark .mermaid svg .nodeLabel,.dark .mermaid svg .label text,.dark .mermaid svg span{fill:#e2e8f0!important;color:#e2e8f0!important}.mermaid svg .edgeLabel{background-color:#faf8ff!important}.dark .mermaid svg .edgeLabel{background-color:transparent!important}.mermaid svg .edgeLabel span{fill:#6d28d9!important;color:#6d28d9!important;font-size:13px!important}.dark .mermaid svg .edgeLabel span{fill:#c4b5fd!important;color:#c4b5fd!important}.mermaid svg{background:transparent!important}#localization-select-trigger>div:first-child{display:none!important}[data-relocated-lang]{gap:0!important}::selection{background:var(--brand-subtle);color:var(--brand-dark)}.dark ::selection{background:var(--brand-dark);color:#ffffff}*:focus-visible{outline-color:var(--brand-primary)!important}::-webkit-scrollbar-thumb{background:var(--brand-light);border-radius:4px}::-webkit-scrollbar-thumb:hover{background:var(--brand-primary)}.cloo-badge{display:inline-block;font-family:\"DM Sans\", sans-serif;font-size:12px;font-weight:600;line-height:1.5;padding:0 8px;border-radius:6px;letter-spacing:-0.01em;vertical-align:middle;white-space:nowrap;margin-right:2px}.cloo-badge--required{background:#fef2f2;color:#b91c1c}.cloo-badge--multiworker{background:#fff7ed;color:#c2410c}.cloo-badge--recommended{background:#eff6ff;color:#1d4ed8}.cloo-badge--optional{background:#f1f5f9;color:#475569}.dark .cloo-badge--required{background:rgba(185, 28, 28, 0.2);color:#fca5a5}.dark .cloo-badge--multiworker{background:rgba(194, 65, 12, 0.2);color:#fdba74}.dark .cloo-badge--recommended{background:rgba(29, 78, 216, 0.22);color:#93c5fd}.dark .cloo-badge--optional{background:rgba(71, 85, 105, 0.28);color:#cbd5e1}"}]}
{"page":{"pagePath":"ko/monitoring/tracing","slug":"/ko/monitoring/tracing","pageMetadata":{"title":"추적","description":"LLM 요청 처리 과정을 단계별로 추적 — 입출력 확인, 지연 시간 분석, LLM 기반 보고서 생성","href":"/ko/monitoring/tracing"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"LLM 요청 처리 과정을 단계별로 추적 — 입출력 확인, 지연 시간 분석, LLM 기반 보고서 생성\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,blockquote:`blockquote`,code:`code`,hr:`hr`,li:`li`,ol:`ol`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,Card,Columns,Frame,Heading,Info,Mermaid,Note,OptimizedImage,Step,Steps,Tab,Table,Tabs,Tip,Warning}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!Card)_missingMdxReference(`Card`,true);if(!Columns)_missingMdxReference(`Columns`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Mermaid)_missingMdxReference(`Mermaid`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Info,{children:`관리자 › 평가 › 추적`}),`\n`,_jsxs(_components.p,{children:[`추적(Tracing)은 AI 요청이 처리되는 `,_jsx(_components.strong,{children:`전 과정을 단계별로 기록`}),`합니다.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`어떤 문서를 검색했는지, 어떤 도구를 호출했는지, LLM에 어떤 프롬프트가 전달됐는지 — 모든 단계를 투명하게 확인할 수 있습니다.`}),`\n`]}),`\n`,_jsx(Frame,{caption:`관리자 > 평가 > 추적 — Chat ID 또는 Message ID로 트레이스를 검색합니다`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/Nim6rqpdwJuim_F0/images/monitoring/tracing-main.png?fit=max\u0026auto=format\u0026n=Nim6rqpdwJuim_F0\u0026q=85\u0026s=9e1577f200fc98e4bc563626ccc7f711`,alt:`추적 추적 검색 화면`,\"data-og-width\":`2880`,width:`2880`,\"data-og-height\":`1800`,height:`1800`,\"data-path\":`images/monitoring/tracing-main.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/Nim6rqpdwJuim_F0/images/monitoring/tracing-main.png?w=280\u0026fit=max\u0026auto=format\u0026n=Nim6rqpdwJuim_F0\u0026q=85\u0026s=97aa80980ed1f7d22e070f73b87fda4d 280w, https://mintcdn.com/cloocus/Nim6rqpdwJuim_F0/images/monitoring/tracing-main.png?w=560\u0026fit=max\u0026auto=format\u0026n=Nim6rqpdwJuim_F0\u0026q=85\u0026s=e3a51ccc80cac2c1a21928528f274528 560w, https://mintcdn.com/cloocus/Nim6rqpdwJuim_F0/images/monitoring/tracing-main.png?w=840\u0026fit=max\u0026auto=format\u0026n=Nim6rqpdwJuim_F0\u0026q=85\u0026s=37bca96eb61ceab6a45f731621b02230 840w, https://mintcdn.com/cloocus/Nim6rqpdwJuim_F0/images/monitoring/tracing-main.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Nim6rqpdwJuim_F0\u0026q=85\u0026s=69a356089ac86a5011f4596559f558f0 1100w, https://mintcdn.com/cloocus/Nim6rqpdwJuim_F0/images/monitoring/tracing-main.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Nim6rqpdwJuim_F0\u0026q=85\u0026s=92bbcbd0604848605a899c0f7e0bef2d 1650w, https://mintcdn.com/cloocus/Nim6rqpdwJuim_F0/images/monitoring/tracing-main.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Nim6rqpdwJuim_F0\u0026q=85\u0026s=0bf5b1260ca18dbce64b6fa826a40ad7 2500w`})}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`예시 — 추적이 없을 때 vs 있을 때`})}),`\n`,_jsxs(_components.blockquote,{children:[`\n`,_jsx(_components.p,{children:`에이전트가 “해당 정보를 찾을 수 없습니다”라고 답변함`}),`\n`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`상태`}),_jsx(_components.th,{children:`할 수 있는 것`}),_jsx(_components.th,{children:`결과`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`추적 없음`}),_jsx(_components.td,{children:`추측만 가능`}),_jsx(_components.td,{children:`원인 파악 불가`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`추적 활용`}),_jsx(_components.td,{children:`Run 트리에서 검색 결과 0건 확인`}),_jsx(_components.td,{children:`KB 문서 누락이 원인 → 문서 추가로 해결`})]})]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`추적은 라이선스 기능입니다. `,_jsx(_components.code,{children:`trace`}),` 피처가 활성화된 라이선스가 필요합니다.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`추적-개념`,children:`추적 개념`}),`\n`,_jsx(_components.p,{children:`사용자 메시지 하나가 처리되는 과정에는 여러 단계가 포함됩니다.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`추적은 이 모든 단계를 `,_jsx(_components.strong,{children:`Trace > Run`}),` 계층 구조로 기록합니다.`]}),`\n`]}),`\n`,_jsx(Mermaid,{chart:`flowchart TB\n A[사용자 메시지] --> B[Trace 시작]\n B --> C[Response Chain]\n C --> D[가드레일 체크]\n C --> E[RAG 검색]\n C --> F[LLM 호출]\n C --> G[도구 실행]\n F --> H[응답 생성]\n H --> L[Trace 완료]\n\n A -.-> BG[background_tasks 트레이스]\n BG --> I[제목 생성]\n BG --> J[태그 생성]\n BG --> K[검색 쿼리 생성]`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`개념`}),_jsx(_components.th,{children:`설명`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Trace`})}),_jsx(_components.td,{children:`하나의 메시지에 대한 전체 처리 과정`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Run`})}),_jsx(_components.td,{children:`Trace 내의 개별 처리 단계`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Run 트리`})}),_jsx(_components.td,{children:`부모-자식 관계로 구성된 Run 계층 구조`})]})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`추적-진입-방법`,children:`추적 진입 방법`}),`\n`,_jsxs(_components.p,{children:[`세 경로 모두 `,_jsx(_components.strong,{children:`평가 › 추적`}),` 화면으로 이어집니다 — ①·② 버튼은 누르면 자동 이동, ③은 ID로 직접 검색입니다.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`방법`}),_jsx(_components.th,{children:`적합한 상황`}),_jsx(_components.th,{children:`진입 경로`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`① 대화 로그에서`})}),_jsx(_components.td,{children:`관리자가 운영 중 특정 대화를 조사 (정석)`}),_jsxs(_components.td,{children:[`모니터링 › 대화 로그 › 대화 선택 › `,_jsx(_components.strong,{children:`추적`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`② 채팅에서 바로`})}),_jsx(_components.td,{children:`대화 중 방금 받은 응답을 즉시 확인`}),_jsxs(_components.td,{children:[`채팅 응답 액션바 › 링크 아이콘(툴팁 `,_jsx(_components.strong,{children:`추적 보기`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`③ ID로 검색`})}),_jsx(_components.td,{children:`전달받은 ID로 특정 트레이스를 조사`}),_jsx(_components.td,{children:`평가 › 추적 › Chat ID·Message ID 검색`})]})]})]}),`\n`,_jsxs(Tabs,{children:[_jsxs(Tab,{title:`① 대화 로그에서 (관리자)`,id:`%E2%91%A0-%EB%8C%80%ED%99%94-%EB%A1%9C%EA%B7%B8%EC%97%90%EC%84%9C-%EA%B4%80%EB%A6%AC%EC%9E%90`,children:[_jsx(_components.p,{children:`관리자가 운영 화면에서 특정 대화를 골라 추적으로 진입하는 정석 경로입니다.`}),_jsxs(Steps,{children:[_jsx(Step,{title:`대화 로그 열기`,children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`모니터링 › 대화 로그`}),`로 이동합니다.`]})}),_jsxs(Step,{title:`대화 선택`,children:[_jsx(_components.p,{children:`조사할 대화(요청) 행을 클릭해 상세를 엽니다.`}),_jsx(Frame,{caption:`대화를 펼치면 우측에 '추적' 버튼이 표시됩니다`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/N40ovjDOvSugfNqc/images/monitoring/tracing-entry-conversation-logs.png?fit=max\u0026auto=format\u0026n=N40ovjDOvSugfNqc\u0026q=85\u0026s=0cd6cf8fc6a8312f880277eabc4ef6f1`,alt:`대화 로그에서 추적 버튼으로 진입`,\"data-og-width\":`2880`,width:`2880`,\"data-og-height\":`1800`,height:`1800`,\"data-path\":`images/monitoring/tracing-entry-conversation-logs.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/N40ovjDOvSugfNqc/images/monitoring/tracing-entry-conversation-logs.png?w=280\u0026fit=max\u0026auto=format\u0026n=N40ovjDOvSugfNqc\u0026q=85\u0026s=ed8418168a8f7d87821f4893b06da01a 280w, https://mintcdn.com/cloocus/N40ovjDOvSugfNqc/images/monitoring/tracing-entry-conversation-logs.png?w=560\u0026fit=max\u0026auto=format\u0026n=N40ovjDOvSugfNqc\u0026q=85\u0026s=b5687651ed675f7cc320b0627b0b0dc3 560w, https://mintcdn.com/cloocus/N40ovjDOvSugfNqc/images/monitoring/tracing-entry-conversation-logs.png?w=840\u0026fit=max\u0026auto=format\u0026n=N40ovjDOvSugfNqc\u0026q=85\u0026s=fd5696f67b11803dc43f2c5a44eebdb7 840w, https://mintcdn.com/cloocus/N40ovjDOvSugfNqc/images/monitoring/tracing-entry-conversation-logs.png?w=1100\u0026fit=max\u0026auto=format\u0026n=N40ovjDOvSugfNqc\u0026q=85\u0026s=e41f4c7ffe61c6cd0e54880559fe3e4c 1100w, https://mintcdn.com/cloocus/N40ovjDOvSugfNqc/images/monitoring/tracing-entry-conversation-logs.png?w=1650\u0026fit=max\u0026auto=format\u0026n=N40ovjDOvSugfNqc\u0026q=85\u0026s=f4874d4da46fadd1d0b77c90af426989 1650w, https://mintcdn.com/cloocus/N40ovjDOvSugfNqc/images/monitoring/tracing-entry-conversation-logs.png?w=2500\u0026fit=max\u0026auto=format\u0026n=N40ovjDOvSugfNqc\u0026q=85\u0026s=49d8a9d8842c149faef278ec82822408 2500w`})})]}),_jsx(Step,{icon:`location-dot`,title:`평가 › 추적 도착`,children:_jsxs(_components.p,{children:[`상세에서 `,_jsx(_components.strong,{children:`추적`}),` 버튼을 클릭하면 자동으로 `,_jsx(_components.a,{href:`#eval-trace-arrival`,children:_jsx(_components.strong,{children:`평가 › 추적`})}),` 화면이 열립니다.`]})})]})]}),_jsxs(Tab,{title:`② 채팅에서 바로`,id:`%E2%91%A1-%EC%B1%84%ED%8C%85%EC%97%90%EC%84%9C-%EB%B0%94%EB%A1%9C`,children:[_jsx(_components.p,{children:`채팅에서 방금 받은 응답을 그 자리에서 바로 추적하는 경로입니다.`}),_jsxs(Steps,{children:[_jsxs(Step,{title:`응답에서 '추적 보기' 클릭`,children:[_jsxs(_components.p,{children:[`추적하려는 응답 메시지 하단 액션바의 링크 아이콘(툴팁 `,_jsx(_components.strong,{children:`추적 보기`}),`)을 누릅니다. `,_jsx(_components.strong,{children:`새 탭`}),`에서 평가 › 추적이 열리며 `,_jsx(_components.strong,{children:`그 채팅의 모든 메시지 트레이스 카드`}),`가 표시되므로, 방금 그 응답만 보려면 시각·메시지 내용으로 카드를 고르세요. 특정 메시지 하나를 바로 열려면 ① 대화 로그 › 추적을 쓰세요(메시지 ID로 조회됩니다).`]}),_jsx(Frame,{caption:`응답 하단 액션바의 링크 아이콘(툴팁 '추적 보기')`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/ZXRqlJ18bFKKL0k-/images/monitoring/tracing-entry-chat.png?fit=max\u0026auto=format\u0026n=ZXRqlJ18bFKKL0k-\u0026q=85\u0026s=b0801a7b188b23ebe8edf230fb3cd9f5`,alt:`채팅 응답의 추적 보기 아이콘`,\"data-og-width\":`1369`,width:`1369`,\"data-og-height\":`983`,height:`983`,\"data-path\":`images/monitoring/tracing-entry-chat.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/ZXRqlJ18bFKKL0k-/images/monitoring/tracing-entry-chat.png?w=280\u0026fit=max\u0026auto=format\u0026n=ZXRqlJ18bFKKL0k-\u0026q=85\u0026s=6745eedb56dab94e57c2c2ec8263e0ac 280w, https://mintcdn.com/cloocus/ZXRqlJ18bFKKL0k-/images/monitoring/tracing-entry-chat.png?w=560\u0026fit=max\u0026auto=format\u0026n=ZXRqlJ18bFKKL0k-\u0026q=85\u0026s=52f9d92b341adc0e3b4c7c16fe89f1d0 560w, https://mintcdn.com/cloocus/ZXRqlJ18bFKKL0k-/images/monitoring/tracing-entry-chat.png?w=840\u0026fit=max\u0026auto=format\u0026n=ZXRqlJ18bFKKL0k-\u0026q=85\u0026s=ec289b98b5971e6b9aa37265bdff13c1 840w, https://mintcdn.com/cloocus/ZXRqlJ18bFKKL0k-/images/monitoring/tracing-entry-chat.png?w=1100\u0026fit=max\u0026auto=format\u0026n=ZXRqlJ18bFKKL0k-\u0026q=85\u0026s=7125ca68e1320ce7bbd4416a0a576485 1100w, https://mintcdn.com/cloocus/ZXRqlJ18bFKKL0k-/images/monitoring/tracing-entry-chat.png?w=1650\u0026fit=max\u0026auto=format\u0026n=ZXRqlJ18bFKKL0k-\u0026q=85\u0026s=788389eb34b7c77e2c14ad72a05f80eb 1650w, https://mintcdn.com/cloocus/ZXRqlJ18bFKKL0k-/images/monitoring/tracing-entry-chat.png?w=2500\u0026fit=max\u0026auto=format\u0026n=ZXRqlJ18bFKKL0k-\u0026q=85\u0026s=ed9f45d997065ad7a03d0ac136bfcd52 2500w`})}),_jsx(_components.p,{children:`표시되는 버튼은 권한에 따라 다릅니다.`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`권한`}),_jsx(_components.th,{children:`표시되는 버튼`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`관리자 또는 평가 읽기/쓰기 권한`}),_jsxs(_components.td,{children:[`툴팁 `,_jsx(_components.strong,{children:`추적 보기`}),` → 새 탭으로 평가 › 추적 열기`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`그 외 사용자`}),_jsxs(_components.td,{children:[`툴팁 `,_jsx(_components.strong,{children:`메시지 ID 복사`}),` → 누르면 Chat ID와 Message ID 두 줄이 클립보드에 복사됩니다. 관리자에게 전달해 조사를 요청하세요`]})]})]})]})]}),_jsx(Step,{icon:`location-dot`,title:`평가 › 추적 도착`,children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`추적 보기`}),`를 누르면 자동으로 `,_jsx(_components.a,{href:`#eval-trace-arrival`,children:_jsx(_components.strong,{children:`평가 › 추적`})}),` 화면이 열립니다.`]})})]})]}),_jsxs(Tab,{title:`③ ID로 검색`,id:`%E2%91%A2-id%EB%A1%9C-%EA%B2%80%EC%83%89`,children:[_jsx(_components.p,{children:`Chat ID 또는 Message ID를 직접 입력해 트레이스를 찾습니다. 일반 사용자가 복사해 전달한 ID를 관리자가 조사할 때 주로 씁니다.`}),_jsxs(Steps,{children:[_jsxs(Step,{title:`Chat ID 확보`,children:[_jsxs(_components.p,{children:[`채팅 URL은 `,_jsx(_components.code,{children:`https://\u003c도메인>/c/{Chat ID}`}),` 형태입니다. 주소창에서 `,_jsx(_components.code,{children:`/c/`}),` 다음 UUID(아래 파란 선택 영역)가 그 채팅의 Chat ID입니다 — 이 값을 복사합니다. (또는 사용자가 전달한 Message ID를 확보)`]}),_jsx(Frame,{caption:`채팅 URL 주소창 — /c/ 다음의 파란 선택 영역이 Chat ID입니다`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/Jjr6o_i720oXQtQO/images/monitoring/tracing-entry-id-search.png?fit=max\u0026auto=format\u0026n=Jjr6o_i720oXQtQO\u0026q=85\u0026s=c246d44f78a60cc392d53f0f4edd2a71`,alt:`채팅 URL 주소창에서 Chat ID가 파란색으로 선택된 화면`,\"data-og-width\":`952`,width:`952`,\"data-og-height\":`680`,height:`680`,\"data-path\":`images/monitoring/tracing-entry-id-search.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/Jjr6o_i720oXQtQO/images/monitoring/tracing-entry-id-search.png?w=280\u0026fit=max\u0026auto=format\u0026n=Jjr6o_i720oXQtQO\u0026q=85\u0026s=37aa763fb4dc6b2a502604b416a1850c 280w, https://mintcdn.com/cloocus/Jjr6o_i720oXQtQO/images/monitoring/tracing-entry-id-search.png?w=560\u0026fit=max\u0026auto=format\u0026n=Jjr6o_i720oXQtQO\u0026q=85\u0026s=28caa7496c762f372ef0373db654528c 560w, https://mintcdn.com/cloocus/Jjr6o_i720oXQtQO/images/monitoring/tracing-entry-id-search.png?w=840\u0026fit=max\u0026auto=format\u0026n=Jjr6o_i720oXQtQO\u0026q=85\u0026s=298e0c5e9d073ddaa152c62ac59c2cd4 840w, https://mintcdn.com/cloocus/Jjr6o_i720oXQtQO/images/monitoring/tracing-entry-id-search.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Jjr6o_i720oXQtQO\u0026q=85\u0026s=990c9ef0cc0297bbb0c5f55c8aef8910 1100w, https://mintcdn.com/cloocus/Jjr6o_i720oXQtQO/images/monitoring/tracing-entry-id-search.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Jjr6o_i720oXQtQO\u0026q=85\u0026s=5464bc896c7784923a9920c37825d69a 1650w, https://mintcdn.com/cloocus/Jjr6o_i720oXQtQO/images/monitoring/tracing-entry-id-search.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Jjr6o_i720oXQtQO\u0026q=85\u0026s=8ee73bc9d36c07cb03ee572f3efbbd36 2500w`})})]}),_jsx(Step,{icon:`location-dot`,title:`평가 › 추적에서 조회`,children:_jsxs(_components.p,{children:[`관리자 패널 › `,_jsx(_components.a,{href:`#eval-trace-arrival`,children:_jsx(_components.strong,{children:`평가 › 추적`})}),` 검색창에 붙여넣어 조회합니다.`]})})]}),_jsx(Note,{children:_jsxs(_components.p,{children:[`채팅 URL의 Chat ID는 채널 소유자·사용자가 보유합니다. 관리자는 사용자에게 URL(또는 `,_jsx(_components.strong,{children:`메시지 ID 복사`}),`)을 요청해 전달받은 뒤 조사하세요.`]})})]})]}),`\n`,_jsx(`div`,{id:`eval-trace-arrival`}),`\n`,_jsxs(Card,{title:`종착지 · 평가 › 추적`,icon:`location-dot`,children:[_jsxs(_components.p,{children:[`세 경로 어디로 진입하든, 도착지는 아래 `,_jsx(_components.strong,{children:`평가 › 추적`}),` 화면 하나입니다.`]}),_jsx(Frame,{caption:`평가 › 추적 도착 화면 — 검색 목록(메시지 카드)`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/ZXRqlJ18bFKKL0k-/images/monitoring/tracing-arrival-search.png?fit=max\u0026auto=format\u0026n=ZXRqlJ18bFKKL0k-\u0026q=85\u0026s=d42aa6b9b654766cbb9c7b853b524f58`,alt:`평가 › 추적 — 메시지 카드 목록`,\"data-og-width\":`1125`,width:`1125`,\"data-og-height\":`980`,height:`980`,\"data-path\":`images/monitoring/tracing-arrival-search.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/ZXRqlJ18bFKKL0k-/images/monitoring/tracing-arrival-search.png?w=280\u0026fit=max\u0026auto=format\u0026n=ZXRqlJ18bFKKL0k-\u0026q=85\u0026s=4fd60d4348a42fb0fcccb66483d87d8a 280w, https://mintcdn.com/cloocus/ZXRqlJ18bFKKL0k-/images/monitoring/tracing-arrival-search.png?w=560\u0026fit=max\u0026auto=format\u0026n=ZXRqlJ18bFKKL0k-\u0026q=85\u0026s=1a71d5d97123727b5f5027cbab3d6a2d 560w, https://mintcdn.com/cloocus/ZXRqlJ18bFKKL0k-/images/monitoring/tracing-arrival-search.png?w=840\u0026fit=max\u0026auto=format\u0026n=ZXRqlJ18bFKKL0k-\u0026q=85\u0026s=147f5ea641963c29680cf103405849e1 840w, https://mintcdn.com/cloocus/ZXRqlJ18bFKKL0k-/images/monitoring/tracing-arrival-search.png?w=1100\u0026fit=max\u0026auto=format\u0026n=ZXRqlJ18bFKKL0k-\u0026q=85\u0026s=979a549e14b7ae6e63d4d6e7eee83da2 1100w, https://mintcdn.com/cloocus/ZXRqlJ18bFKKL0k-/images/monitoring/tracing-arrival-search.png?w=1650\u0026fit=max\u0026auto=format\u0026n=ZXRqlJ18bFKKL0k-\u0026q=85\u0026s=b5b6536208c005abc78cb53f06a38a60 1650w, https://mintcdn.com/cloocus/ZXRqlJ18bFKKL0k-/images/monitoring/tracing-arrival-search.png?w=2500\u0026fit=max\u0026auto=format\u0026n=ZXRqlJ18bFKKL0k-\u0026q=85\u0026s=4b66da66e3b948e755f77c3d75796196 2500w`})})]}),`\n`,_jsxs(_components.p,{children:[`도착하면 `,_jsx(_components.a,{href:`#%ED%8A%B8%EB%A0%88%EC%9D%B4%EC%8A%A4-%EA%B2%80%EC%83%89`,children:`검색 목록(메시지 카드)`}),`에서 트레이스를 골라 `,_jsx(_components.a,{href:`#%ED%8A%B8%EB%A0%88%EC%9D%B4%EC%8A%A4-%EC%83%81%EC%84%B8-%ED%99%94%EB%A9%B4-%EC%9D%BD%EB%8A%94-%EB%B2%95`,children:`상세 화면`}),`을 엽니다.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`트레이스-검색`,children:`트레이스 검색`}),`\n`,_jsxs(_components.p,{children:[`평가 › 추적 화면에서 `,_jsx(_components.strong,{children:`Chat ID 또는 Message ID로 검색`}),`하면, 위 화면처럼 `,_jsx(_components.strong,{children:`메시지 카드 목록`}),`이 나옵니다.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`카드 하나가 사용자 메시지 하나의 트레이스 요약이고, `,_jsxs(_components.strong,{children:[`카드를 클릭하면 `,_jsx(_components.a,{href:`#%ED%8A%B8%EB%A0%88%EC%9D%B4%EC%8A%A4-%EC%83%81%EC%84%B8-%ED%99%94%EB%A9%B4-%EC%9D%BD%EB%8A%94-%EB%B2%95`,children:`상세 화면`}),`이 열립니다.`]})]}),`\n`]}),`\n`,_jsx(_components.p,{children:`검색 기준과 카드 항목 표는 아래에 접어 두었습니다.`}),`\n`,_jsxs(AccordionGroup,{children:[_jsxs(Accordion,{title:`검색 기준 — Chat ID vs Message ID`,icon:`magnifying-glass`,id:`chat-id-vs-message-id`,children:[_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`검색 기준`}),_jsx(_components.th,{children:`찾는 범위`}),_jsx(_components.th,{children:`값을 얻는 곳`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Chat ID`})}),_jsx(_components.td,{children:`그 채팅의 모든 메시지 트레이스`}),_jsxs(_components.td,{children:[`채팅 URL의 `,_jsx(_components.code,{children:`/c/`}),` 다음 부분`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Message ID`})}),_jsx(_components.td,{children:`특정 메시지 하나의 트레이스`}),_jsxs(_components.td,{children:[`사용자가 메시지 옵션에서 `,_jsx(_components.strong,{children:`메시지 ID 복사`})]})]})]})]}),_jsx(Note,{children:_jsxs(_components.p,{children:[`검색은 입력한 ID에 해당하는 모든 트레이스를 기간 제한 없이 가져옵니다. (날짜·상태 같은 별도 필터는 없습니다.) 목록은 `,_jsx(_components.strong,{children:`20건 단위`}),`로 나뉘어 표시되므로, 결과가 많으면 하단 페이지 버튼으로 이동하세요.`]})})]}),_jsx(Accordion,{title:`메시지 카드 항목`,icon:`address-card`,id:`%EC%B9%B4%EB%93%9C-%ED%95%AD%EB%AA%A9-%EC%84%A4%EB%AA%85-%EC%82%AC%EC%9A%A9%EC%9E%90-%EB%A9%94%EC%8B%9C%EC%A7%80-%EC%9B%90%EB%B3%B8-%EC%9E%85%EB%A0%A5-(%EC%B9%B4%EB%93%9C%EC%97%90%EB%8A%94-2%EC%A4%84%EA%B9%8C%EC%A7%80-%ED%91%9C%EC%8B%9C)-%ED%8A%B8%EB%A0%88%EC%9D%B4%EC%8A%A4-id-%EC%8B%9D%EB%B3%84%EC%9E%90-%EC%B6%95%EC%95%BD-%ED%91%9C%EC%8B%9C-(%EC%98%88%3A-3fb13ae9%E2%80%A6)-%EC%8B%9C%EA%B0%81-%EC%9A%94%EC%B2%AD-%EC%8B%9C%EA%B0%81-(mm%2Fdd-hh%3Amm%3Ass)-%EC%A7%80%EC%97%B0-%EC%8B%9C%EA%B0%84-%EC%B5%9C%EC%83%81%EC%9C%84-%EB%8B%A8%EA%B3%84-%EC%86%8C%EC%9A%94%EC%9D%98-%ED%95%A9%EA%B3%84-(2.39s%C2%B71m-22s%EC%B2%98%EB%9F%BC-%EB%8B%A8%EC%9C%84%EA%B0%80-%EC%9E%90%EB%8F%99%EC%9C%BC%EB%A1%9C-%EB%B0%94%EB%80%9D%EB%8B%88%EB%8B%A4)-%EC%A2%85%EB%A5%98-%EB%B0%B0%EC%A7%80-%EA%B7%B8-%ED%8A%B8%EB%A0%88%EC%9D%B4%EC%8A%A4%EC%9D%98-%EC%B5%9C%EC%83%81%EC%9C%84-%EB%8B%A8%EA%B3%84-%EC%A2%85%EB%A5%98-%E2%80%94-%EC%97%90%EC%9D%B4%EC%A0%84%ED%8A%B8-%C2%B7-llm-%C2%B7-%EC%9E%84%EB%B2%A0%EB%94%A9-%EB%93%B1-run-%EC%88%98-%EC%B5%9C%EC%83%81%EC%9C%84-%EB%8B%A8%EA%B3%84-%EA%B0%9C%EC%88%98-(%EC%98%88%3A-4-runs).-%EC%97%90%EC%9D%B4%EC%A0%84%ED%8A%B8-%EC%95%88%EC%97%90-%EC%A4%91%EC%B2%A9%EB%90%9C-%EB%8B%A8%EA%B3%84%EB%8A%94-%ED%8F%AC%ED%95%A8%EB%90%98%EC%A7%80-%EC%95%8A%EC%9C%BC%EB%A9%B0%2C-%EC%A0%84%EC%B2%B4-%EB%8B%A8%EA%B3%84%EB%8A%94-%EC%B9%B4%EB%93%9C%EB%A5%BC-%EB%88%8C%EB%9F%AC-%EC%83%81%EC%84%B8%EC%97%90%EC%84%9C-%ED%99%95%EC%9D%B8%ED%95%A9%EB%8B%88%EB%8B%A4`,children:_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`카드 항목`}),_jsx(_components.th,{children:`설명`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`사용자 메시지`})}),_jsx(_components.td,{children:`원본 입력 (카드에는 2줄까지 표시)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`트레이스 ID`})}),_jsxs(_components.td,{children:[`식별자 축약 표시 (예: `,_jsx(_components.code,{children:`3fb13ae9…`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`시각`})}),_jsxs(_components.td,{children:[`요청 시각 (`,_jsx(_components.code,{children:`MM/DD HH:MM:SS`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`지연 시간`})}),_jsxs(_components.td,{children:[`최상위 단계 소요의 합계 (`,_jsx(_components.code,{children:`2.39s`}),`·`,_jsx(_components.code,{children:`1m 22s`}),`처럼 단위가 자동으로 바뀝니다)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`종류 배지`})}),_jsxs(_components.td,{children:[`그 트레이스의 `,_jsx(_components.strong,{children:`최상위 단계`}),` 종류 — 에이전트 · LLM · 임베딩 등`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Run 수`})}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`최상위 단계 개수`}),` (예: `,_jsx(_components.code,{children:`4 runs`}),`). 에이전트 안에 중첩된 단계는 포함되지 않으며, 전체 단계는 카드를 눌러 상세에서 확인합니다`]})]})]})]})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`트레이스-상세-화면-읽는-법`,children:`트레이스 상세 화면 읽는 법`}),`\n`,_jsx(_components.p,{children:`여기가 추적의 핵심입니다.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`한 메시지가 `,_jsx(_components.strong,{children:`어떤 단계를 거쳐 처리됐는지`}),`, 각 단계에 `,_jsx(_components.strong,{children:`무엇이 들어가고 나왔는지`}),`를 모두 여기서 봅니다.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`(배지·기호 같은 세부 표기는 각 탭 안에 접어 두었습니다 — 처음 보는 표시를 만났을 때 펼쳐 보세요.)`}),`\n`,_jsx(Frame,{caption:`트레이스 상세 — 좌측 Run 트리에서 단계를 고르면 우측에 그 단계의 입·출력이 표시됩니다`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/KEDVv5ut_6sqAaDJ/images/monitoring/tracing-detail-modal.png?fit=max\u0026auto=format\u0026n=KEDVv5ut_6sqAaDJ\u0026q=85\u0026s=57c9aa30cebf2ddeb95b076c8a9bfe9b`,alt:`트레이스 상세 모달 — 좌측 Run 트리, 우측 상세 패널`,\"data-og-width\":`2832`,width:`2832`,\"data-og-height\":`1748`,height:`1748`,\"data-path\":`images/monitoring/tracing-detail-modal.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/KEDVv5ut_6sqAaDJ/images/monitoring/tracing-detail-modal.png?w=280\u0026fit=max\u0026auto=format\u0026n=KEDVv5ut_6sqAaDJ\u0026q=85\u0026s=deb8cb3166fb08bde57210636f78ea92 280w, https://mintcdn.com/cloocus/KEDVv5ut_6sqAaDJ/images/monitoring/tracing-detail-modal.png?w=560\u0026fit=max\u0026auto=format\u0026n=KEDVv5ut_6sqAaDJ\u0026q=85\u0026s=37f58da2115de150ae408fd7d41f6d48 560w, https://mintcdn.com/cloocus/KEDVv5ut_6sqAaDJ/images/monitoring/tracing-detail-modal.png?w=840\u0026fit=max\u0026auto=format\u0026n=KEDVv5ut_6sqAaDJ\u0026q=85\u0026s=59cb9ac9642c378e3a873b74456d6884 840w, https://mintcdn.com/cloocus/KEDVv5ut_6sqAaDJ/images/monitoring/tracing-detail-modal.png?w=1100\u0026fit=max\u0026auto=format\u0026n=KEDVv5ut_6sqAaDJ\u0026q=85\u0026s=699434e4710fe1f583461412805131ed 1100w, https://mintcdn.com/cloocus/KEDVv5ut_6sqAaDJ/images/monitoring/tracing-detail-modal.png?w=1650\u0026fit=max\u0026auto=format\u0026n=KEDVv5ut_6sqAaDJ\u0026q=85\u0026s=1d657acf0bb84c403751943e34efc103 1650w, https://mintcdn.com/cloocus/KEDVv5ut_6sqAaDJ/images/monitoring/tracing-detail-modal.png?w=2500\u0026fit=max\u0026auto=format\u0026n=KEDVv5ut_6sqAaDJ\u0026q=85\u0026s=96663dd40f07c47c5b5605d80c969378 2500w`})}),`\n`,_jsxs(_components.p,{children:[`화면은 `,_jsx(_components.strong,{children:`좌측 Run 트리`}),`(처리 단계를 순서·계층대로 나열, 상단에 전체 지연·총 토큰)와 `,_jsx(_components.strong,{children:`우측 상세 패널`}),`(고른 단계의 입·출력·토큰)로 나뉩니다. 좌측 패널 헤더에서 `,_jsx(_components.strong,{children:`트리 · 타임라인 · 토큰`}),` 세 가지 보기로 전환할 수 있습니다.`]}),`\n`,_jsxs(_components.p,{children:[`한 메시지는 보통 — 에이전트(`,_jsx(_components.code,{children:`CH`}),`)가 `,_jsx(_components.code,{children:`LM`}),` 추론과 도구 호출을 반복해 데이터를 모으고, 마지막에 `,_jsx(_components.code,{children:`final_answer`}),`(`,_jsx(_components.code,{children:`LM`}),`)가 답을 씁니다.`]}),`\n`,_jsxs(Tabs,{children:[_jsxs(Tab,{title:`좌측 — Run 트리`,id:`%EC%A2%8C%EC%B8%A1-%E2%80%94-run-%ED%8A%B8%EB%A6%AC`,children:[_jsxs(_components.p,{children:[`각 줄(Run)은 `,_jsx(_components.strong,{children:`색 배지 + 이름 + ● 상태 + 지연 시간`}),`으로 표시됩니다. 자주 보이는 배지만 알면 트리를 읽을 수 있습니다. (색 포함 전체 종류는 아래 범례를 펼쳐 보세요.)`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`center`},children:`배지`}),_jsx(_components.th,{children:`하는 일`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.strong,{children:`CH`})}),_jsx(_components.td,{children:`에이전트 실행 — 메시지 처리 전체를 감싸는 단계 (이름은 에이전트 이름입니다)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.strong,{children:`LM`})}),_jsxs(_components.td,{children:[`LLM 호출 — 추론하거나 최종 답 작성(`,_jsx(_components.code,{children:`final_answer`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.strong,{children:`TL`})}),_jsxs(_components.td,{children:[`도구 실행 — SQL 조회·함수 호출(`,_jsx(_components.code,{children:`run_sql_read`}),` 등)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.strong,{children:`EM`})}),_jsx(_components.td,{children:`임베딩 — 검색용 벡터 생성`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.strong,{children:`ACT`})}),_jsx(_components.td,{children:`작업 그룹 — 도구 + 하위 단계 묶음 (화살표로 펼침)`})]})]})]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`● 상태`}),` — 초록이면 정상, 빨강이면 그 단계에서 오류.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`옆 시간`}),` — 그 단계의 지연. 단, 상위 단계(CH·ACT)의 시간에는 하위 단계 시간이 `,_jsx(_components.strong,{children:`포함`}),`되므로 단순 최댓값을 병목으로 보면 안 됩니다. 제품이 계산한 병목 단계는 지연 시간이 `,_jsx(_components.strong,{children:`붉게 강조`}),`되어 표시됩니다.`]}),`\n`]}),_jsx(_components.p,{children:`좌측 패널 헤더의 보기 토글로 같은 단계 목록을 세 가지 방식으로 볼 수 있습니다.`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`보기`}),_jsx(_components.th,{children:`보여주는 것`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`트리`})}),_jsx(_components.td,{children:`단계를 부모-자식 계층으로 나열 (기본)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`타임라인`})}),_jsxs(_components.td,{children:[`단계별 소요 구간을 가로 막대로 배치하고, 하단에 시간 눈금과 `,_jsx(_components.code,{children:`가장 느린 추출 단계: \u003c이름> · 시간 (n%)`}),` 요약을 표시`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`토큰`})}),_jsx(_components.td,{children:`트레이스 전체 토큰 구성(입력·캐시·출력) 막대와 프롬프트 캐시 적중률·실효 토큰, 단계별 토큰 막대 (막대를 누르면 우측 상세가 그 단계로 전환)`})]})]})]}),_jsx(Note,{children:_jsxs(_components.p,{children:[`제목·태그·검색 쿼리 자동 생성 같은 보조 작업은 응답과 별개로 `,_jsx(_components.code,{children:`background_tasks`}),` 트레이스에 따로 기록됩니다.`]})}),_jsxs(AccordionGroup,{children:[_jsxs(Accordion,{title:`Run 종류 전체 (색상 범례)`,icon:`table-cells`,id:`run`,children:[_jsx(_components.p,{children:`상세 트리는 단계 종류를 색 배지로 구분합니다. (검색 결과 카드에서는 에이전트 · LLM · 임베딩 같은 라벨로 묶여 표시됩니다.)`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`center`},children:`배지`}),_jsx(_components.th,{children:`종류`}),_jsx(_components.th,{style:{textAlign:`center`},children:`색`}),_jsx(_components.th,{children:`설명`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.strong,{children:`CH`})}),_jsx(_components.td,{children:`Chain`}),_jsx(_components.td,{style:{textAlign:`center`},children:`보라`}),_jsx(_components.td,{children:`복합 작업 — 메시지 처리 전체/에이전트 실행`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.strong,{children:`LM`})}),_jsx(_components.td,{children:`LLM`}),_jsx(_components.td,{style:{textAlign:`center`},children:`파랑`}),_jsx(_components.td,{children:`LLM 호출 (추론·최종 답변)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.strong,{children:`TL`})}),_jsx(_components.td,{children:`Tool`}),_jsx(_components.td,{style:{textAlign:`center`},children:`초록`}),_jsx(_components.td,{children:`도구 실행 (SQL·함수 등)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.strong,{children:`RG`})}),_jsx(_components.td,{children:`Retrieval`}),_jsx(_components.td,{style:{textAlign:`center`},children:`주황`}),_jsx(_components.td,{children:`지식 기반 문서 검색`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.strong,{children:`WB`})}),_jsx(_components.td,{children:`Web Search`}),_jsx(_components.td,{style:{textAlign:`center`},children:`시안`}),_jsx(_components.td,{children:`웹 검색`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.strong,{children:`GD`})}),_jsx(_components.td,{children:`Guardrail`}),_jsx(_components.td,{style:{textAlign:`center`},children:`빨강`}),_jsx(_components.td,{children:`가드레일 점검`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.strong,{children:`EM`})}),_jsx(_components.td,{children:`Embedding`}),_jsx(_components.td,{style:{textAlign:`center`},children:`노랑`}),_jsx(_components.td,{children:`임베딩(벡터) 생성`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.strong,{children:`FL`})}),_jsx(_components.td,{children:`Filter`}),_jsx(_components.td,{style:{textAlign:`center`},children:`분홍`}),_jsx(_components.td,{children:`필터 함수 실행`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.strong,{children:`PP`})}),_jsx(_components.td,{children:`Pipeline`}),_jsx(_components.td,{style:{textAlign:`center`},children:`남색`}),_jsx(_components.td,{children:`파이프라인 처리`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.strong,{children:`TK`})}),_jsx(_components.td,{children:`Task`}),_jsx(_components.td,{style:{textAlign:`center`},children:`회색`}),_jsx(_components.td,{children:`백그라운드 태스크`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.strong,{children:`IM`})}),_jsx(_components.td,{children:`Image`}),_jsx(_components.td,{style:{textAlign:`center`},children:`회색`}),_jsx(_components.td,{children:`이미지 생성 (전용 색 없이 회색으로 표시)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.strong,{children:`ACT`})}),_jsx(_components.td,{children:`Action`}),_jsx(_components.td,{style:{textAlign:`center`},children:`보라`}),_jsx(_components.td,{children:`도구 + 하위 단계 그룹 (펼치기 가능, 합성 배지)`})]})]})]}),_jsx(_components.p,{children:`환경·버전에 따라 나타나지 않는 종류도 있습니다 — 실제 트레이스에는 주로 CH·LM·TL·RG·GD·EM·TK가 기록됩니다.`})]}),_jsxs(Accordion,{title:`상태 표시 (● 색)`,icon:`circle-dot`,id:`-1`,children:[_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`상태`}),_jsx(_components.th,{children:`표시`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Success`})}),_jsx(_components.td,{children:`초록 점`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Error`})}),_jsx(_components.td,{children:`빨강 점`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Running`})}),_jsx(_components.td,{children:`주황 점 (깜박이는 펄스 애니메이션)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Pending`})}),_jsx(_components.td,{children:`회색 점`})]})]})]}),_jsxs(_components.p,{children:[`네 상태 모두 같은 모양의 점이며 `,_jsx(_components.strong,{children:`색으로만`}),` 구분합니다.`]}),_jsx(Note,{children:_jsxs(_components.p,{children:[`트레이스 전체 상태는 포함된 Run 중 `,_jsx(_components.strong,{children:`하나라도 Error면 Error`}),`, Error가 없고 Running이 있으면 Running으로 표시됩니다.`]})})]})]})]}),_jsxs(Tab,{title:`우측 — 상세 패널`,id:`%EC%9A%B0%EC%B8%A1-%E2%80%94-%EC%83%81%EC%84%B8-%ED%8C%A8%EB%84%90`,children:[_jsx(_components.p,{children:`트리에서 단계를 클릭하면 우측에 그 단계의 상세가 표시됩니다.`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`섹션`}),_jsx(_components.th,{children:`내용`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`상단 요약`})}),_jsx(_components.td,{children:`상태 · 지연 시간 · 사용 모델 (답변 양식이 지정된 단계에는 ‘답변 양식’ 배지가 함께 표시됩니다)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`입력`})}),_jsx(_components.td,{children:`그 단계에 들어간 값 (시스템 프롬프트, 정규화된 질문 등)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`출력`})}),_jsxs(_components.td,{children:[`그 단계가 내놓은 값 (응답, 출처 묶음 수 `,_jsx(_components.code,{children:`sources_count`}),`·`,_jsx(_components.code,{children:`source_names`}),` 등)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`오류`})}),_jsxs(_components.td,{children:[`그 단계가 실패한 경우에만 `,_jsx(_components.strong,{children:`출력 아래`}),`에 빨간 영역으로 표시 — 도구 실패 진단은 여기부터 봅니다`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`토큰 사용량`})}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`입력 · 출력 · 합계`}),` 토큰. 프롬프트 캐시가 적중하면 `,_jsx(_components.strong,{children:`프롬프트 캐시`}),` 줄에 `,_jsx(_components.code,{children:`입력 N 중 캐시 적중 M (x%)`}),`와 `,_jsx(_components.code,{children:`캐시 생성`}),` 값이 덧붙습니다`]})]})]})]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`트리 · JSON · 텍스트`}),` 토글로 입·출력을 트리/원본 JSON/평문으로 전환합니다.`]}),`\n`,_jsxs(_components.li,{children:[`출력의 `,_jsx(_components.code,{children:`Search...`}),` 칸으로 긴 출력에서 텍스트를 찾을 수 있습니다.`]}),`\n`,_jsxs(_components.li,{children:[`트레이스에 기록되는 사용자 메시지는 `,_jsx(_components.strong,{children:`500자까지`}),`입니다. 입력 끝의 `,_jsx(_components.code,{children:`...`}),`은 기록 한도 때문이며, 모델에 전달된 내용이 잘린 것은 아닙니다. (시스템 프롬프트도 경로에 따라 길이가 제한될 수 있습니다.)`]}),`\n`]}),_jsxs(Accordion,{title:`입·출력 보기 모드 · 텍스트 검색`,icon:`code`,id:`-2`,children:[_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`보기 모드`}),_jsx(_components.th,{children:`설명`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`트리`})}),_jsx(_components.td,{children:`계층적 트리 (기본)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`JSON`})}),_jsx(_components.td,{children:`원본 JSON`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`텍스트`})}),_jsx(_components.td,{children:`평문 텍스트`})]})]})]}),_jsxs(_components.p,{children:[`출력 영역에서는 텍스트 검색이 됩니다. 검색어를 입력하면 하이라이트되고, `,_jsx(_components.strong,{children:`Enter`}),`로 다음·`,_jsx(_components.strong,{children:`Shift+Enter`}),`로 이전 매치로 이동하며, 검색창 옆에 `,_jsx(_components.code,{children:`1/5`}),`처럼 매치 수가 표시됩니다.`]})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`두-단계-phase-로-읽기`,children:`두 단계(Phase)로 읽기`}),`\n`,_jsxs(_components.p,{children:[`에이전트 응답은 `,_jsx(_components.strong,{children:`두 단계`}),`로 나눠 읽으면 원인을 빨리 찾을 수 있습니다.`]}),`\n`,_jsx(Mermaid,{chart:`flowchart TD\n A[\"CH 에이전트 실행 — Phase 1: 데이터 수집\"] --> B[\"LM 추론 — 어떤 도구를 쓸지 판단\"]\n B --> C[\"TL run_sql_read — DB 조회\"]\n B --> D[\"TL get_table_details — 스키마 확인\"]\n B --> E[\"LM 추론 — 다음 단계 판단\"]\n A --> F[\"LM final_answer — Phase 2: 최종 답변 작성\"]`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`center`},children:`단계`}),_jsx(_components.th,{children:`무엇을`}),_jsx(_components.th,{children:`여기서 보는 것`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.strong,{children:`Phase 1`})}),_jsxs(_components.td,{children:[`에이전트(`,_jsx(_components.code,{children:`CH`}),`)가 `,_jsx(_components.code,{children:`LM`}),` 추론으로 도구(`,_jsx(_components.code,{children:`TL`}),`)를 호출하며 데이터를 모음`]}),_jsx(_components.td,{children:`어떤 도구를 썼나, 결과가 비지 않았나`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(_components.strong,{children:`Phase 2`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`final_answer`}),`(`,_jsx(_components.code,{children:`LM`}),`)가 모은 데이터로 답을 작성`]}),_jsx(_components.td,{children:`모은 데이터가 답에 제대로 반영됐나`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`좌측 패널 헤더에는 이 두 구간을 자동 계산한 막대가 함께 표시되므로 단계별 시간을 직접 더할 필요가 없습니다 — `,_jsx(_components.strong,{children:`추출`}),`(트레이스 시작 ~ 최종 답변 시작) 소요와 비율, `,_jsx(_components.strong,{children:`첫 토큰 (전체)`}),`(추출 + 답변 첫 토큰까지 = 사용자가 실제로 기다린 시간), `,_jsx(_components.strong,{children:`첫 토큰 (답변 기준)`}),`(최종 답변 시작 후 첫 토큰까지). 최종 답변 단계가 없는 트레이스(백그라운드 작업 등)에서는 표시되지 않습니다.`]}),`\n`,_jsx(Heading,{level:`3`,id:`디버깅-포인트`,children:`디버깅 포인트`}),`\n`,_jsxs(AccordionGroup,{children:[_jsxs(Accordion,{title:`에이전트가 도구(지식 기반·DB)를 쓰지 않았다면?`,icon:`magnifying-glass`,id:`db`,children:[_jsxs(_components.p,{children:[`Phase 1의 `,_jsx(_components.strong,{children:`첫 LM 추론 Run`}),`의 입력에서 `,_jsx(_components.code,{children:`tool_descriptions`}),`(그 실행에 연결된 도구 이름과 설명)를 확인하세요. 트레이스 용량을 줄이기 위해 이 항목은 `,_jsx(_components.strong,{children:`첫 LLM 호출 1회에만`}),` 기록되므로, 중간 LM Run에는 없을 수 있습니다.`]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`tool_descriptions`}),`에 원하는 도구가 없음`]}),` → 에이전트에 해당 기능(지식 기반·DB 등)이 연결되지 않음`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`도구가 있는데 호출 안 함`}),` → 모델이 질문과 도구의 관련성을 낮게 판단. 도구·기능 설명을 더 구체적으로 수정`]}),`\n`]}),_jsxs(_components.p,{children:[_jsx(_components.code,{children:`active_capabilities`}),`(그 시점에 켜져 있던 기능 묶음)는 Phase 2 `,_jsx(_components.code,{children:`final_answer`}),` Run의 입력에서 볼 수 있습니다.`]})]}),_jsxs(Accordion,{title:`검색은 됐는데 답변이 부정확하다면?`,icon:`file-circle-question`,id:`-3`,children:[_jsxs(_components.p,{children:[`지식 기반 검색은 `,_jsx(_components.strong,{children:`RG(Retrieval) Run`}),`(`,_jsx(_components.code,{children:`knowledge_search`}),`, 청크를 다시 가져올 때는 `,_jsx(_components.code,{children:`knowledge_fetch_chunks`}),`)으로 따로 기록됩니다. 검색 건수·점수·리랭크 여부는 이 Run의 출력에서 `,_jsx(_components.code,{children:`total_results`}),`·`,_jsx(_components.code,{children:`top_scores`}),`·`,_jsx(_components.code,{children:`reranked`}),`·`,_jsx(_components.code,{children:`sources`}),`로 확인하세요.`]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`RG Run이 아예 없음`}),` → 검색을 실행하지 않음. 에이전트에 지식 기반이 연결됐는지 확인`]}),`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`total_results`}),`가 0`]}),` → 검색 0건. 지식 기반 문서 누락 또는 검색 설정(Top K·Reranker 등) 점검 필요`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`출처는 있는데 답이 엉뚱`}),` → `,_jsx(_components.code,{children:`final_answer`}),`(`,_jsx(_components.strong,{children:`LM`}),`) Run의 입력에서 전달된 내용을 확인하고 답변 프롬프트를 조정`]}),`\n`]}),_jsxs(_components.p,{children:[_jsx(_components.code,{children:`final_answer`}),` 출력의 `,_jsx(_components.code,{children:`sources_count`}),`·`,_jsx(_components.code,{children:`source_names`}),`는 답변 프롬프트에 실린 출처 묶음 수라 검색 건수와 다를 수 있습니다.`]})]}),_jsx(Accordion,{title:`도구 실행이 실패했다면?`,icon:`circle-exclamation`,id:`-4`,children:_jsxs(_components.p,{children:[`빨간 점이 찍힌 `,_jsx(_components.strong,{children:`TL(도구) Run`}),`을 클릭해 출력 아래 `,_jsx(_components.strong,{children:`오류`}),` 영역의 메시지를 먼저 확인하고, 입력으로 전달된 파라미터를 함께 검증하세요.`]})}),_jsxs(Accordion,{title:`응답이 너무 느리다면?`,icon:`clock`,id:`-5`,children:[_jsxs(_components.p,{children:[`Run 트리에서 지연 시간이 `,_jsx(_components.strong,{children:`붉게 강조된 단계`}),`가 제품이 계산한 병목입니다. `,_jsx(_components.strong,{children:`타임라인`}),` 보기로 바꾸면 하단에 `,_jsx(_components.code,{children:`가장 느린 추출 단계: \u003c이름> · 시간 (n%)`}),` 요약이 함께 표시됩니다. 최종 답변 작성 단계와 그 이후 후처리는 답변이 전달된 뒤의 시간이라 병목 계산에서 제외됩니다.`]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`LM`}),`이 느림 → 더 빠른 모델로 변경 고려`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`TL/EM`}),`이 느림 → 도구·검색 설정 또는 외부 서비스 확인`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`GD`}),`(가드레일)가 느림 → LLM 판정 비활성화 또는 빠른 모델로 변경`]}),`\n`]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`트레이스-분석-보고서`,children:`트레이스 분석 보고서`}),`\n`,_jsxs(_components.p,{children:[`트레이스 데이터를 LLM으로 분석하여 `,_jsx(_components.strong,{children:`문제의 근본 원인을 자동으로 파악`}),`하는 기능입니다.`]}),`\n`,_jsxs(_components.p,{children:[`상세 모달 상단에는 `,_jsx(_components.strong,{children:`트레이스 복사`}),`와 `,_jsx(_components.strong,{children:`트레이스 분석`}),` 버튼이 있습니다(이전 분석 결과가 있으면 `,_jsx(_components.strong,{children:`보고서 보기`}),`도 함께). `,_jsx(_components.strong,{children:`트레이스 복사`}),`는 트레이스 요약(트레이스 ID·Chat ID·상태·총 지연·총 토큰)과 들여쓴 단계 목록(성공/실패, 단계 종류, 이름, 지연, 토큰, 모델, 입·출력 앞부분 미리보기)을 텍스트로 클립보드에 담습니다 — 이슈 공유나 문의 첨부에 사용하세요.`]}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`분석 시작`,children:[_jsxs(_components.p,{children:[`트레이스 상세 모달 상단의 `,_jsx(_components.strong,{children:`트레이스 분석`}),` 버튼을 클릭합니다.`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`입력 항목`}),_jsx(_components.th,{children:`설명`}),_jsx(_components.th,{children:`필수`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`분석 모델`})}),_jsx(_components.td,{children:`분석에 사용할 LLM 모델`}),_jsx(_components.td,{children:`필수`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`설명`})}),_jsx(_components.td,{children:`관찰된 문제 상황 (입력란에 예시 안내 문구가 표시됩니다)`}),_jsx(_components.td,{children:`선택`})]})]})]}),_jsx(Note,{children:_jsxs(_components.p,{children:[`분석 모델 목록에는 `,_jsx(_components.strong,{children:`기본 모델`}),`만 표시됩니다. 다른 모델을 상속해 만든 커스텀 모델, 프리셋 모델, 아레나 모델은 선택할 수 없습니다.`]})})]}),_jsxs(Step,{title:`분석 결과 확인`,children:[_jsx(_components.p,{children:`LLM이 트레이스 데이터 + 에이전트 설정 + 대화 이력 + KB/DB/가드레일 설정 + 용어집 설정 + 자동 평가 결과를 종합 분석하여 구조화된 보고서를 생성합니다.`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`보고서 섹션`}),_jsx(_components.th,{children:`내용`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`요약`})}),_jsx(_components.td,{children:`분석 결과 2~3문장 핵심 요약`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`트레이스 개요`})}),_jsx(_components.td,{children:`ID, 상태, 지연시간, 토큰, Run 수, 오류 수`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`근본 원인 분석`})}),_jsx(_components.td,{children:`주요 원인 + 기여 요인`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Phase 1 분석`})}),_jsx(_components.td,{children:`도구 선택이 적절했는지, 사용 가능한 도구 vs 실제 호출 비교`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Phase 2 분석`})}),_jsx(_components.td,{children:`수집된 데이터 대비 최종 답변의 적절성`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`프롬프트/설정 이슈`})}),_jsx(_components.td,{children:`시스템 프롬프트, 모델 선택 문제`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`KB/RAG 이슈`})}),_jsx(_components.td,{children:`검색 설정, 문서 품질, 필터 문제`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`DB/SQL 이슈`})}),_jsx(_components.td,{children:`NL-to-SQL 변환, 스키마 문제`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`가드레일 이슈`})}),_jsx(_components.td,{children:`과도한 차단, 오탐`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`용어집 커버리지 이슈`})}),_jsx(_components.td,{children:`질문에 쓰인 용어를 용어집이 덮지 못한 부분`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`오류 분석`})}),_jsx(_components.td,{children:`Error Run 상세 진단`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`개선 권장사항`})}),_jsx(_components.td,{children:`즉시 조치, 설정 변경, 데이터 개선, 아키텍처 제안(중장기 개선)`})]})]})]}),_jsx(_components.p,{children:`관련 발견이 없는 섹션은 생략되므로, 모든 섹션이 항상 나오지는 않습니다.`}),_jsxs(Tip,{children:[_jsx(_components.p,{children:`설명을 입력하면 해당 맥락에 집중한 분석이 가능합니다. 예: “KB에서 문서를 찾았는데 답변에 반영되지 않음”`}),_jsxs(_components.p,{children:[`보고서는 `,_jsx(_components.strong,{children:`설명에 사용한 언어와 같은 언어로 작성`}),`됩니다. 한국어 보고서가 필요하면 설명을 한국어로 적으세요 — 비워 두면 영어로 작성될 수 있습니다.`]})]})]}),_jsxs(Step,{title:`보고서 저장/공유`,children:[_jsx(_components.p,{children:`분석 보고서 모달 안의 버튼입니다.`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`기능`}),_jsx(_components.th,{children:`설명`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`복사`})}),_jsx(_components.td,{children:`클립보드에 전체 텍스트 복사`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`다운로드`})}),_jsx(_components.td,{children:`마크다운 파일(.md)로 다운로드`})]})]})]})]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`이전에 분석한 결과가 있으면 `,_jsx(_components.strong,{children:`보고서 보기`}),` 버튼으로 재분석 없이 트레이스 분석 보고서를 바로 확인할 수 있습니다.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`트레이스-관리`,children:`트레이스 관리`}),`\n`,_jsx(Heading,{level:`3`,id:`권한`,children:`권한`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`역할`}),_jsx(_components.th,{children:`권한`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`일반 사용자`})}),_jsx(_components.td,{children:`자신의 트레이스만 조회 가능`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`관리자`})}),_jsx(_components.td,{children:`모든 사용자의 트레이스 조회 및 관리`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`추적 화면에 들어가려면 관리자이거나 `,_jsx(_components.strong,{children:`평가 읽기 이상 권한`}),`이 필요합니다. 권한이 없는 사용자는 자신의 트레이스라도 화면으로 열 수 없고, 추적 라이선스가 없으면 버튼 자체가 표시되지 않습니다.`]}),`\n`,_jsx(Heading,{level:`3`,id:`데이터-정리`,children:`데이터 정리`}),`\n`,_jsx(_components.p,{children:`오래된 트레이스는 두 가지 방법으로 정리합니다.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[`관리자 › 설정 › `,_jsx(_components.a,{href:`/ko/admin/settings/data-retention`,children:`데이터 보존`})]}),` — ‘트레이스’ 보존 일수를 지정해 자동으로 정리하거나, `,_jsx(_components.strong,{children:`지금 정리 실행`}),`으로 즉시 삭제합니다. (권장)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`개발자용 API`}),` — `,_jsx(_components.code,{children:`DELETE /api/v1/traces/cleanup?before_timestamp_ms=\u003c타임스탬프>`}),`. 밀리초 단위 타임스탬프 이전의 트레이스를 일괄 삭제하며, 모니터링 쓰기 권한이 필요합니다.`]}),`\n`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`트레이스 삭제는 복구할 수 없습니다. 삭제 전 필요한 분석 보고서를 먼저 다운로드하세요.`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`활용-사례`,children:`활용 사례`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`응답 품질 디버깅`,icon:`magnifying-glass-chart`,id:`-6`,children:_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`채팅 메시지의 `,_jsx(_components.strong,{children:`추적 보기`}),` 버튼을 클릭합니다`]}),`\n`,_jsxs(_components.li,{children:[`좌측 Run 트리에서 `,_jsx(_components.code,{children:`final_answer`}),`(`,_jsx(_components.strong,{children:`LM`}),`) 단계를 선택합니다`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`출력`}),`에서 `,_jsx(_components.code,{children:`sources_count`}),`·`,_jsx(_components.code,{children:`source_names`}),`로 검색 결과 반영 여부를 확인합니다`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`입력`}),`에서 모델에 전달된 내용을 확인합니다`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`트레이스 분석 보고서`}),`를 생성하여 근본 원인을 자동 파악합니다`]}),`\n`]})}),_jsx(Accordion,{title:`지연 시간 분석`,icon:`clock`,id:`-7`,children:_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`느린 응답의 트레이스를 엽니다`}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`타임라인`}),` 보기로 전환해 단계별 소요 구간을 비교합니다`]}),`\n`,_jsx(_components.li,{children:`붉게 강조된 병목 단계를 확인합니다 (상위 단계 시간에는 하위 단계 시간이 포함되므로 단순 최댓값으로 판단하지 않습니다)`}),`\n`,_jsx(_components.li,{children:`해당 단계를 최적화합니다 (검색 설정 조정, 모델 변경 등)`}),`\n`]})}),_jsx(Accordion,{title:`도구 실행 오류 추적`,icon:`circle-exclamation`,id:`-8`,children:_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`문제가 의심되는 트레이스를 엽니다`}),`\n`,_jsxs(_components.li,{children:[`빨간 점이 찍힌 `,_jsx(_components.strong,{children:`TL(도구) Run`}),`을 선택합니다`]}),`\n`,_jsxs(_components.li,{children:[`출력 아래 `,_jsx(_components.strong,{children:`오류`}),` 영역의 메시지를 확인합니다`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`입력`}),`에서 전달된 파라미터를 검증합니다`]}),`\n`]})}),_jsx(Accordion,{title:`토큰 사용량 분석`,icon:`coins`,id:`-9`,children:_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`상세 화면 상단의 `,_jsx(_components.strong,{children:`총 토큰`}),`으로 트레이스 전체 사용량을 확인합니다`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`토큰`}),` 보기로 전환하거나 LM Run별 `,_jsx(_components.strong,{children:`토큰 사용량`}),`(입력/출력/합계)을 비교합니다`]}),`\n`,_jsxs(_components.li,{children:[`Phase 1(에이전트 실행)과 Phase 2(`,_jsx(_components.code,{children:`final_answer`}),`)의 토큰 비율을 확인합니다`]}),`\n`,_jsx(_components.li,{children:`불필요하게 큰 프롬프트나 반복 호출이 있는지 식별합니다`}),`\n`]})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`faq`,children:`FAQ`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`추적은 자동으로 기록되나요?`,icon:`circle-question`,id:`-10`,children:_jsx(_components.p,{children:`네, 메시지 추적이 활성화되어 있으면 (기본값: 활성) 모든 AI 요청이 자동으로 기록됩니다. 별도 설정이 필요 없습니다.`})}),_jsx(Accordion,{title:`트레이스 데이터는 얼마나 보존되나요?`,icon:`circle-question`,id:`-11`,children:_jsxs(_components.p,{children:[`기본적으로 트레이스는 자동 삭제되지 않고 계속 보존됩니다. 자동 정리가 기본 꺼짐이고, 데이터 유형별 보존 일수의 기본값이 모두 `,_jsx(_components.code,{children:`0`}),`(영구 보존)이기 때문입니다. 오래된 트레이스를 정리하려면 **관리자 › 설정 › `,_jsx(_components.a,{href:`/ko/admin/settings/data-retention`,children:`데이터 보존`}),`**에서 ‘트레이스’ 보존 일수를 1 이상으로 지정하고 자동 정리를 켜거나, `,_jsx(_components.strong,{children:`지금 정리 실행`}),`으로 즉시 삭제하세요.`]})}),_jsx(Accordion,{title:`추적이 응답 속도에 영향을 주나요?`,icon:`circle-question`,id:`-12`,children:_jsx(_components.p,{children:`트레이스는 각 단계가 시작·완료될 때 요청 처리 흐름 안에서 함께 기록됩니다. 단계마다 짧은 저장 작업이 추가되지만 LLM 호출 시간에 비하면 미미해, 체감 응답 속도에는 거의 영향을 주지 않습니다.`})}),_jsx(Accordion,{title:`분석 보고서도 토큰을 소비하나요?`,icon:`circle-question`,id:`-13`,children:_jsxs(_components.p,{children:[`네, 트레이스 분석은 별도의 LLM 호출이며 사용량이 `,_jsx(_components.code,{children:`trace_analysis`}),`로 별도 추적됩니다. 분석은 수동으로 트리거할 때만 실행됩니다.`]})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`관련-페이지`,children:`관련 페이지`}),`\n`,_jsxs(Columns,{cols:3,children:[_jsx(Card,{title:`가드레일 로그`,icon:`shield-check`,href:`/ko/monitoring/guardrail-logs`,children:_jsx(_components.p,{children:`가드레일 탐지 이벤트 전용 로그`})}),_jsx(Card,{title:`자동 평가`,icon:`chart-line`,href:`/ko/monitoring/auto-evaluations`,children:_jsx(_components.p,{children:`에이전트 응답 품질 자동 평가 결과`})}),_jsx(Card,{title:`사용량`,icon:`coins`,href:`/ko/monitoring/usage`,children:_jsx(_components.p,{children:`토큰 사용량 및 비용 분석`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"추적","description":"LLM 요청 처리 과정을 단계별로 추적 — 입출력 확인, 지연 시간 분석, LLM 기반 보고서 생성","href":"/ko/monitoring/tracing"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"추적 개념","slug":"추적-개념","depth":2,"children":[]},{"title":"추적 진입 방법","slug":"추적-진입-방법","depth":2,"children":[]},{"title":"트레이스 검색","slug":"트레이스-검색","depth":2,"children":[]},{"title":"트레이스 상세 화면 읽는 법","slug":"트레이스-상세-화면-읽는-법","depth":2,"children":[{"title":"두 단계(Phase)로 읽기","slug":"두-단계-phase-로-읽기","depth":3,"children":[]},{"title":"디버깅 포인트","slug":"디버깅-포인트","depth":3,"children":[]}]},{"title":"트레이스 분석 보고서","slug":"트레이스-분석-보고서","depth":2,"children":[]},{"title":"트레이스 관리","slug":"트레이스-관리","depth":2,"children":[{"title":"권한","slug":"권한","depth":3,"children":[]},{"title":"데이터 정리","slug":"데이터-정리","depth":3,"children":[]}]},{"title":"활용 사례","slug":"활용-사례","depth":2,"children":[]},{"title":"FAQ","slug":"faq","depth":2,"children":[]},{"title":"관련 페이지","slug":"관련-페이지","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/cloocus/45db6ee3c57396cb/toc.js","/_mintlify/custom/cloocus/9670a2c81dc38d5e/tools/playwright-video-mcp/index.js","/_mintlify/custom/cloocus/4540e1c308555295/lang-toggle.js"],"subdomain":"cloocus","siteName":"Cloosphere Guide","title":"추적 - Cloosphere Guide","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"ko":{"href":"/ko/monitoring/tracing","matchLevel":0},"en":{"href":"/en/monitoring/tracing","matchLevel":1}}},"lastModified":"2026-08-28T05:31:20.792Z","originalFileLocation":"ko/monitoring/tracing.mdx","locale":"ko"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"LLM 요청 처리 과정을 단계별로 추적 — 입출력 확인, 지연 시간 분석, LLM 기반 보고서 생성\">\u003cmeta data-mint-head name=\"application-name\" content=\"Cloosphere Guide\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"추적 - Cloosphere Guide\">\u003cmeta data-mint-head property=\"og:description\" content=\"LLM 요청 처리 과정을 단계별로 추적 — 입출력 확인, 지연 시간 분석, LLM 기반 보고서 생성\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Cloosphere Guide\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.cloosphere.ai/ko/monitoring/tracing\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cloocus.mintlify.site/_mintlify/api/og/v2?division=%ED%8F%89%EA%B0%80\u0026amp;title=%EC%B6%94%EC%A0%81\u0026amp;description=LLM+%EC%9A%94%EC%B2%AD+%EC%B2%98%EB%A6%AC+%EA%B3%BC%EC%A0%95%EC%9D%84+%EB%8B%A8%EA%B3%84%EB%B3%84%EB%A1%9C+%EC%B6%94%EC%A0%81+%E2%80%94+%EC%9E%85%EC%B6%9C%EB%A0%A5+%ED%99%95%EC%9D%B8%2C+%EC%A7%80%EC%97%B0+%EC%8B%9C%EA%B0%84+%EB%B6%84%EC%84%9D%2C+LLM+%EA%B8%B0%EB%B0%98+%EB%B3%B4%EA%B3%A0%EC%84%9C+%EC%83%9D%EC%84%B1\u0026amp;theme=97296152c031fdcf5b54d0af\u0026amp;signature=08427cd359e115806f7f11acb400028152a3ef26bfbd4fda59c88022c070c23f\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"추적 - Cloosphere Guide\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"LLM 요청 처리 과정을 단계별로 추적 — 입출력 확인, 지연 시간 분석, LLM 기반 보고서 생성\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cloocus.mintlify.site/_mintlify/api/og/v2?division=%ED%8F%89%EA%B0%80\u0026amp;title=%EC%B6%94%EC%A0%81\u0026amp;description=LLM+%EC%9A%94%EC%B2%AD+%EC%B2%98%EB%A6%AC+%EA%B3%BC%EC%A0%95%EC%9D%84+%EB%8B%A8%EA%B3%84%EB%B3%84%EB%A1%9C+%EC%B6%94%EC%A0%81+%E2%80%94+%EC%9E%85%EC%B6%9C%EB%A0%A5+%ED%99%95%EC%9D%B8%2C+%EC%A7%80%EC%97%B0+%EC%8B%9C%EA%B0%84+%EB%B6%84%EC%84%9D%2C+LLM+%EA%B8%B0%EB%B0%98+%EB%B3%B4%EA%B3%A0%EC%84%9C+%EC%83%9D%EC%84%B1\u0026amp;theme=97296152c031fdcf5b54d0af\u0026amp;signature=08427cd359e115806f7f11acb400028152a3ef26bfbd4fda59c88022c070c23f\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Cloosphere Guide\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5f22d0\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.cloosphere.ai/ko/monitoring/tracing\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/ko/monitoring/tracing.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docs.cloosphere.ai/ko/monitoring/tracing\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.cloosphere.ai/en/monitoring/tracing\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.cloosphere.ai/ko/monitoring/tracing\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.cloosphere.ai/#organization\",\"name\":\"Cloosphere Guide\",\"url\":\"https://docs.cloosphere.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/logo.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=93fb26230c58b4ba9411c3e97e20b439\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.cloosphere.ai#website\",\"name\":\"Cloosphere Guide\",\"url\":\"https://docs.cloosphere.ai\",\"publisher\":{\"@id\":\"https://docs.cloosphere.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.cloosphere.ai/ko/monitoring/tracing#webpage\",\"url\":\"https://docs.cloosphere.ai/ko/monitoring/tracing\",\"name\":\"추적\",\"description\":\"LLM 요청 처리 과정을 단계별로 추적 — 입출력 확인, 지연 시간 분석, LLM 기반 보고서 생성\",\"dateModified\":\"2026-08-28T05:31:20.792Z\",\"isPartOf\":{\"@id\":\"https://docs.cloosphere.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.cloosphere.ai/ko/monitoring/tracing#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.cloosphere.ai/ko/monitoring/tracing#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"평가\",\"item\":\"https://docs.cloosphere.ai/ko/monitoring/evaluations\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"추적\",\"item\":\"https://docs.cloosphere.ai/ko/monitoring/tracing\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.cloosphere.ai/ko/monitoring/tracing#article\",\"headline\":\"추적\",\"name\":\"추적\",\"description\":\"LLM 요청 처리 과정을 단계별로 추적 — 입출력 확인, 지연 시간 분석, LLM 기반 보고서 생성\",\"url\":\"https://docs.cloosphere.ai/ko/monitoring/tracing\",\"mainEntityOfPage\":{\"@id\":\"https://docs.cloosphere.ai/ko/monitoring/tracing#webpage\"},\"dateModified\":\"2026-08-28T05:31:20.792Z\",\"publisher\":{\"@id\":\"https://docs.cloosphere.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.cloosphere.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Cloosphere Guide\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Cloosphere Guide\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/ko/monitoring/tracing.md","siteName":"Cloosphere Guide","nav":{"global":null,"languages":[{"language":"ko","default":true,"tabs":[{"tab":"시작하기","icon":"rocket","pages":[{"title":"시작하기","href":"/ko"}]},{"tab":"채팅","icon":"comments","pages":[{"title":"채팅","href":"/ko/chat/overview"}]},{"tab":"워크스페이스","icon":"briefcase","pages":[{"title":"워크스페이스","href":"/ko/workspace/overview"}]},{"tab":"협업","icon":"users","pages":[{"title":"협업","href":"/ko/collaboration/overview"}]},{"tab":"자동화","icon":"clock","pages":[{"title":"자동화","href":"/ko/automation/overview"}]},{"tab":"관리자","icon":"gear","pages":[{"title":"관리자","href":"/ko/admin/overview"}]},{"tab":"모니터링","icon":"chart-line","groups":[{"group":"모니터링","pages":[{"title":"모니터링 개요","href":"/ko/monitoring/overview"},{"title":"감사 로그","href":"/ko/monitoring/audit-logs"},{"title":"KMS 감사","href":"/ko/monitoring/kms-audit"},{"title":"가드레일 로그","href":"/ko/monitoring/guardrail-logs"},{"title":"대화 로그","href":"/ko/monitoring/conversation-logs"},{"title":"파일 로그","href":"/ko/monitoring/file-logs"},{"title":"사용량","href":"/ko/monitoring/usage"},{"title":"대시보드","href":"/ko/monitoring/dashboard"}]},{"group":"평가","pages":[{"title":"평가 개요","href":"/ko/monitoring/evaluations"},{"title":"아레나 · 리더보드","href":"/ko/monitoring/arena-leaderboard"},{"title":"피드백","href":"/ko/monitoring/feedback"},{"title":"자동 평가","description":"에이전트 응답을 심판 LLM이 비동기로 채점 — 검색 품질·충실도·응답 품질 평가, 켜기·결과·통계·내보내기","href":"/ko/monitoring/auto-evaluations"},{"title":"추적","href":"/ko/monitoring/tracing"}]}]},{"tab":"운영 · 지원","icon":"screwdriver-wrench","pages":[{"title":"운영 · 지원","href":"/ko/admin/deployment-checklist"}]}]},{"language":"en","pages":[{"title":"en","href":"/en/monitoring/tracing"}]}]},"basePath":"","title":"추적 - Cloosphere Guide","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["07c022d89b","a74be98ba7","a9bb46feb3"],"chunks":["Frame-D0FT0qQs.js","DynamicMarkdown-CQM9Bhbv.js","zoom-image-lightbox-BQ4tbj_9.js","lightbox-handle-r17bVUz3.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}