ReAct Agent 디버깅 가이드

TAO 루프 로깅

ReAct 패턴의 핵심인 Thought-Action-Observation을 로깅하면 문제의 원인을 빠르게 찾을 수 있다.

---

흔한 문제 진단표

증상	원인	해결
같은 Tool 반복 호출	종료 조건 없음, 프롬프트 미비	max_iterations 설정, 프롬프트에 "중복 금지" 추가
엉뚱한 Tool 선택	Tool description 불명확	description에 "언제 사용하는지" 명시
Observation 무시	프롬프트 지시 불충분	"이전 Observation을 반드시 활용" 추가
존재 않는 설비 코드 추측	Tool 에러 처리 미비	Tool에서 에러를 친절한 메시지로 반환
답변 생성 지연	Tool 과다 호출	캐싱 + 프롬프트 최적화

---

단계별 검증 체크리스트

실무 팁: 배포 전 10가지 시나리오 테스트를 완료하고 trace를 저장해두면 이후 문제 발생 시 빠르게 비교할 수 있다.