debug-bundle

Debug Bundle은 특정 쿼리에 대해 retriever의 top-k, reranker 전후 점수, 사용된 프롬프트 스냅샷, 반환된 답변과 실패 분류 등 실행 상태를 JSON으로 캡처한 아티팩트이다. 번들 간 diff를 통해 점수 델타, 문서의 등장·소멸, 설정 변경 등을 정밀 비교할 수 있어 재현성과 원인 추적에 유용하다. 이러한 번들은 문제 발생 전후를 비교해 구성 변경이나 데이터 이상을 식별하는 데 중요하다.