BBoilerplate

큐레이션

TraceRoot

AI 에이전트의 실행 기록을 관측하고 실패 원인을 코드·GitHub 이력과 연결해 찾는 오픈소스 디버깅 플랫폼

Python / TypeScript680+
TraceRoot 대표 이미지

요약

TraceRoot는 AI 에이전트의 호출·도구 사용·실행 결과를 추적하고, 이상 징후를 찾아 실제 코드와 GitHub 변경 이력까지 연결해 디버깅하는 오픈소스 관측 플랫폼입니다.

도구 소개

LLM 호출과 에이전트 동작을 OpenTelemetry 호환 방식으로 기록하고, 환각·도구 실패·논리 오류·안전 위반·의도 이탈을 감지합니다. 문제가 생기면 소스 코드가 실행되는 샌드박스와 커밋·PR·이슈를 함께 살펴 실패 원인을 좁힙니다. OpenAI, Anthropic, Gemini, xAI 등 여러 모델 공급자와 BYOK 구성을 지원합니다.

사용 포인트

  • LangChain, CrewAI, OpenAI Agents SDK 같은 에이전트 흐름의 실패 구간을 찾을 때
  • 운영 중인 에이전트의 환각·도구 호출 오류를 자동 감시할 때
  • 모델이나 프롬프트 변경 뒤 회귀 문제를 GitHub 이력과 비교할 때
  • AI 에이전트 관측·평가·자가복구 실습 환경을 구성할 때

설치와 시작

빠른 실습은 공식 클라우드에 가입해 시작할 수 있습니다. 로컬 검증은 공식 README에 따라 실행합니다.

git clone https://github.com/traceroot-ai/traceroot.git
cd traceroot
make prod

Python SDK를 붙일 때는 pip install traceroot openai 후 공식 예제처럼 traceroot.initialize와 @observe를 사용합니다.

선정 사유

GitHub API에서 680 stars와 2026-07-27 당일 업데이트를 확인했습니다. 단순 로그 수집이 아니라 에이전트 실행 기록·소스 코드·GitHub 변경을 한 흐름으로 연결해, AI 자동화 운영과 교육 실습에 오래 사용할 수 있는 후보로 선정했습니다.

참고