20

테스트 & 디버깅 가이드

Day 5: 설비 조회 Agent 프로젝트

학습 목표

10가지 테스트 시나리오를 체계적으로 실행한다 결과를 기록하고 문제점을 식별한다 프롬프트 반복 개선 방법을 익힌다

테스트 전략

테스트 매트릭스

#질문 유형기대 Tool기대 결과
1단순 상태equipment_status x1설비 상태 정보
2설비 목록equipment_list x1라인 설비 목록
3재고 확인check_inventory x1재고 수량 + 상태
4알람 분석equipment_status + manual원인 + 조치
5부품 연쇄equipment + manual + inventory원인 + 부품 + 재고
6라인 점검list + status + manual + inventory종합 보고서
7생산 + 설비production + equipment실적 + 문제설비
8없는 설비equipment_status에러 안내
9SOP 검색search_manual절차 안내
10재고 없음check_inventory긴급 발주 안내

테스트 결과 기록 양식

에디터 로딩 중...

흔한 문제와 해결

문제원인해결
엉뚱한 Tool 호출description 불분명description 상세화
정상 설비도 조회프롬프트 규칙 미비"정상은 건너뛸 것" 추가
무한 반복종료 조건 미비max_iterations 설정
한국어 깨짐인코딩 문제ensure_ascii=False
느린 응답Tool 과다 호출캐싱 + 프롬프트 최적화
문맥 미처리대화 이력 미유지conversation_history 추가

프롬프트 반복 개선 (A/B 테스트)

에디터 로딩 중...

핵심: 프롬프트 개선은 테스트 결과에 기반해야 한다. 감으로 바꾸지 말고, 데이터를 보고 바꾸자.