Skip to main content
트레이스는 Agent 실행 하나의 기록입니다. 모든 모델 호출, 모든 도구 실행, 모든 리트리벌, 모든 메모리 작업을 입력, 출력, 타이밍, 비용과 함께 담습니다. 트레이스는 프로덕션에서 Agent가 실제로 무엇을 했는지 알아보는 방법입니다. 표본이 아니라 모든 실행을 담습니다.
트레이스 목록 화면 — 전체·대기·실행 중·완료·오류 탭, 플로우와 판정 필터, 기간 선택이 있고 아래로 실행이 한 줄씩 쌓여 있다

언제 트레이스를 보나

  • 사용자가 나쁜 답변을 알려 왔을 때.
  • 비용이 뛰어서 왜 그런지 알고 싶을 때.
  • 지연이 튀어 느린 스텝을 찾을 때.
  • 새 버전을 확인하며 실행을 훑어볼 때.
  • 실제 프로덕션 동작으로 데이터셋을 만들 때.

트레이스 안에 있는 것

실행 들여다보기

메인 뷰. 일어난 모든 일의 타임라인.

도구 호출

도구가 무엇으로 불렸고 무엇을 돌려줬는지.

그라운딩

답변의 어느 부분이 가져온 증거로 뒷받침되는지.

비용·지연

스텝마다 비용과 시간.

피드백

트레이스에서 바로 교정과 thumbs를 남깁니다.

검색·필터

어떤 기준으로든 실행을 찾습니다.

보존

트레이스는 Flow 설정에 따라 보관됩니다(기본 90일). 집계 지표는 더 오래 남습니다. 페이로드(프롬프트, 도구 인자)는 컴플라이언스 워크로드에 대해 트레이스 자체보다 먼저 지울 수 있습니다.

접근

기본으로 워크스페이스 멤버는 모두 트레이스를 볼 수 있습니다. Flow 접근 설정으로 제한합니다. 집계 통계는 필요하지만 원본 내용은 볼 필요가 없는 팀원에게는, “페이로드 보기” 없이 “트레이스 메타데이터 보기” 만 허용할 수 있습니다.

트레이스 공유

트레이스마다 퍼머링크가 있습니다. 팀원과 공유하면 같은 화면을 봅니다. 바깥 공유(공개 링크)는 기본으로 꺼져 있고 Owner만 켤 수 있습니다.