agent-devtools

Agent DevTools 라이브러리는 로컬 우선, 인과관계 기반 AI 에이전트 디버거입니다. 핵심 목적은 전체 실행 추적을 깊게 조사함으로써 "왜 내 에이전트가 이렇게 동작했는가?"라는 질문에 답하는 것입니다. 이 도구는 완전한 인과 경로를 캡처합니다: 어떤 메모리 항목이 최종 답변에 영향을 미쳤는지, 어떤 검색 후보가 선택되었는지 그리고 그 이유, 그리고 프롬프트에 주입된 컨텍스트를 추적합니다. 그런 다음 양호한 실행과 불량한 실행을 비교해 stale memory value나 잘못 선택된 검색 후보와 같은 원인을plain language로-highlight합니다. 주요 기능에는 단계별 실행 검토를 위한 Replay 탭, 입력부터 검색, 메모리, 프롬프트 구성, LLM 추론, 도구 호출까지의 흐름을 보여주는 Graph 뷰, 그리고 실행 간 정확한 차이를 나타내는 전용 Diff 탭이 포함됩니다. 로컬 SQLite 스토어를 통해 모든 데이터는 비공개 상태로 유지되며 세션 간에도 영구적으로 보존됩니다. LangChain 통합은 원활합니다. 개발자는 trace.run() 컨텍스트 매니저를 사용해 최소한의 노력으로 에이전트 코드에 계측 기능을 추가할 수 있으며, 모든 입력, 검색 단계, 메모리 작업, 프롬프트 조립, 도구 호출이 자동으로 로그에 기록됩니다. 대시보드는 메모리 변화부터 도구 호출 결과까지 추적의 모든 측면을 깊게 살펴볼 수 있는 종합적인 UI로 제공되며, 수동 로그 파싱 없이도 문제를 빠르게 진단하는 데 도움이 됩니다.