DOCS/troubleshooting/251013_coldmail_ir_analyzer_fix.md
happybell80 eacbfd0d05 docs: 콜드메일 IR 분석 문서 축약
- 코드 블록 제거, 파일명:줄번호만 사용
- 116줄 → 105줄로 축약

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-13 23:45:42 +09:00

3.1 KiB

콜드메일 IR 분석 시스템 오류 수정

날짜: 2025-10-13 작성자: happybell80 관련 파일: rb8001/app/services/ir_analyzer.py


문제 상황

테스트 실행

  • 경로: rb8001/tests/test_coldmail_briefing.py --test scheduler
  • 결과: 3가지 에러 발생, Slack 전송 도달 실패

성공한 부분

  1. 콜드메일 필터링: 30개 중 1건 탐지 (굿베이션 투자제안서, 확률 0.7755)
  2. 첨부파일 다운로드: skill-email에서 PDF 다운로드 성공
  3. skill-rag-file 업로드: document_id c9c9a7a8-18d3-475a-b14e-746e14c9e55c, 14 chunks 생성

에러 분석

에러 1: RAG 쿼리 404 (6회 발생)

에러 메시지:

ERROR:app.services.ir_analyzer:RAG query failed: 404

원인:

  • ir_analyzer.py:28 - /api/query 엔드포인트 호출
  • skill-rag-file은 POST /api/search 제공 (search.py:19)
  • 엔드포인트 불일치

수정 필요:

  • ir_analyzer.py:28: /api/query/api/search
  • ir_analyzer.py:29-32: payload 구조 변경 (document_id 제거, team_id 추가)

에러 2: LLM 연결 실패

에러 메시지:

ERROR:app.services.ir_analyzer:Error calling LLM: Cannot connect to host localhost:8080

원인:

  • ir_analyzer.py:15: LLM_API_URL = http://localhost:8080/api/llm
  • rb8001 컨테이너 내부에 localhost:8080 LLM 서비스 없음
  • rb8001은 자체 LLM 서비스 사용 (app/llm/llm_service.py)

수정 필요:

  • ir_analyzer.py:48-74: call_llm() 함수를 rb8001 LLM 서비스 사용으로 변경
  • app/llm/llm_service.py의 LLMService, LLMRequest 사용

에러 3: DB 제약조건 없음

에러 메시지:

asyncpg.exceptions.InvalidColumnReferenceError: there is no unique or exclusion constraint

원인:

  • startup_valuation.py:249: ON CONFLICT 절 사용
  • startup_valuation 테이블에 UNIQUE 제약조건 미설정

수정 필요:

  • 51123 서버 DB: startup_valuation 테이블에 UNIQUE 제약조건 추가

해결 방안

우선순위 1: ir_analyzer.py 수정

query_rag() 함수 (18-45줄):

  • 18줄: 파라미터 document_id → team_id로 변경
  • 28줄: /api/query → /api/search
  • 29-35줄: payload를 query, team_id, limit, threshold로 변경

call_llm() 함수 (48-74줄):

  • rb8001 LLM 서비스(app/llm/llm_service.py) 사용으로 전체 변경
  • LLMService, LLMRequest import 추가

우선순위 2: DB 제약조건 추가

  • 51123 서버: startup_valuation 테이블 UNIQUE 제약조건 추가

우선순위 3: 테스트 재실행

  • git push → Gitea Actions 배포 → 테스트 재실행

교훈

API 엔드포인트 검증 부족

  • 구현 시 skill-rag-file API 스펙 미확인
  • 추측으로 /api/query 사용, 실제는 /api/search
  • 교훈: 스킬 통합 전 API 문서 또는 코드 직접 확인 필수

LLM 서비스 중복 구현

  • ir_analyzer가 독립 LLM 서비스 가정
  • rb8001은 이미 LLM 서비스 내장
  • 교훈: 기존 서비스 재사용 우선, 새 의존성 추가 지양