정상 응답 코드만으로 AI 품질을 알 수 없습니다
LangSmith의 관측성 문서는 개별 실행 기록부터 운영 지표까지 연결하고, 실패를 디버깅하거나 평가 데이터를 만드는 활용을 설명합니다. 모델 API가 정상 응답해도 답변의 근거가 틀리거나 업무가 완료되지 않을 수 있습니다. 서비스가 해결하려는 문제에 맞는 성공 신호를 추가로 기록해야 합니다.
가상의 사내 검색 서비스에서 사용자가 답변을 받은 뒤 같은 질문을 반복했다면 자료가 부족했거나 이해하기 어려웠을 수 있습니다. 반복 질문만으로 실패를 확정할 수는 없지만 검토할 후보가 됩니다. 검색 근거와 응답, 사용자 피드백을 한 요청에서 함께 볼 수 있으면 원인 분석이 쉬워집니다.
업무 요청을 기준으로 실행을 연결합니다
| 영역 | 기록할 신호 | 판단에 활용할 내용 |
|---|---|---|
| 검색 | 후보 문서·버전·검색 시간 | 근거 누락과 오래된 문서 |
| 모델 | 모델·프롬프트 버전·사용량 | 변경 이후 품질·비용 차이 |
| 도구 | 도구 이름·오류 종류·재시도 | 연동 장애와 잘못된 호출 |
| 업무 | 완료·검토 대기·중단 상태 | 실제 자동화 성공률 |
| 사용자 | 수정·재질문·피드백 | 우선 조사할 사례 |
평균 뒤에 가려지는 느린 요청을 확인합니다
평균 지연만 보면 일부 요청의 긴 대기 시간을 놓칠 수 있습니다. 전체 시간과 함께 검색, 첫 응답, 도구 실행과 재시도에 걸린 시간을 나누세요. 상위 지연 구간의 요청을 살펴보면 긴 입력 때문인지 외부 API 때문인지 구분할 수 있습니다. 스트리밍에서는 첫 토큰이 빠른 것과 전체 업무가 빨리 끝나는 것을 나누어 봅니다.
비용도 모델 호출마다 기록하되 업무 ID로 합산합니다. 실패한 호출과 상위 모델 전환이 빠지면 비용을 과소평가하기 쉽습니다. 사용자나 조직별로 요청량과 자원 사용을 관찰하면 갑작스러운 증가의 원인을 찾고 필요한 제한을 적용할 수 있습니다.
관측을 위해 모든 원문을 저장할 필요는 없습니다
오류 분석에 필요한 메타데이터와 민감한 원문을 구분하세요. 입력과 도구 응답을 무조건 저장하면 접근 가능한 정보가 늘어납니다. 마스킹, 보관 기간, 조회 권한과 표본 수집 기준을 정하고, 원문이 없어도 버전과 추적 ID로 관련 처리 결과를 찾을 수 있게 구성합니다.
운영 실패를 다음 배포의 검수 기준으로 바꿉니다
반복되는 실패를 발견하면 필요한 입력과 기대 결과를 정리해 회귀 평가에 추가하세요. 모델이나 프롬프트 변경 이후 일부 사용자부터 적용하고 이전 결과와 비교할 수 있습니다. 문제가 생기면 어떤 버전으로 되돌릴지, 이미 실행된 업무는 어떻게 확인할지까지 운영 절차로 남깁니다.
- 한 업무의 검색·모델·도구 실행을 연결할 수 있는가
- 실패 유형과 처리 상태를 구분해 집계하는가
- 지연이 큰 요청과 비용 급증을 조사할 수 있는가
- 기록할 원문·마스킹·보관 기간이 정해졌는가
- 운영에서 발견한 오류가 재발 방지 평가에 반영되는가
참고 자료
자료 확인일: 2026.10.07 · 본문의 적용 예시와 체크리스트는 참고 자료를 바탕으로 정리한 실무 제안입니다.
기술 동작은 아래 공식 문서를 참고했습니다. 적용 조건과 지원 버전은 프로젝트 환경에 맞게 확인하세요.
작성팀 소개
TOPPING 기술팀 · 개발 · 아키텍처 · QA
웹·앱·백엔드·IoT·데이터 연동을 수행하는 TOPPING의 개발·아키텍처 담당 팀입니다. 시스템 구조 설계, 기술 검수, 인수인계와 운영 안정화를 담당합니다.



