From 74ffcb18f03252e732026320f70c13c454227812 Mon Sep 17 00:00:00 2001 From: Claude-51124 Date: Thu, 23 Oct 2025 11:00:02 +0900 Subject: [PATCH] =?UTF-8?q?docs(troubleshooting):=20rb8001=20=EC=BD=9C?= =?UTF-8?q?=EB=93=9C=EB=A9=94=EC=9D=BC=20=EB=B0=B8=EB=A5=98=EC=97=90?= =?UTF-8?q?=EC=9D=B4=EC=85=98=20HOLD=20=ED=91=9C=EC=8B=9C=20=EB=B0=8F=20UN?= =?UTF-8?q?KNOWN=20=EB=9D=BC=EC=9A=B0=ED=8C=85=20=EA=B0=9C=EC=84=A0?= =?UTF-8?q?=EC=95=88=20=EA=B8=B0=EB=A1=9D=20(251023)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...“œλ©”일_λ°Έλ₯˜μ—μ΄μ…˜_UNKNOWN_μ˜λ„.md | 50 +++++++++++++++++++ 1 file changed, 50 insertions(+) create mode 100644 troubleshooting/251023_admin_rb8001_μ½œλ“œλ©”μΌ_λ°Έλ₯˜μ—μ΄μ…˜_UNKNOWN_μ˜λ„.md diff --git a/troubleshooting/251023_admin_rb8001_μ½œλ“œλ©”μΌ_λ°Έλ₯˜μ—μ΄μ…˜_UNKNOWN_μ˜λ„.md b/troubleshooting/251023_admin_rb8001_μ½œλ“œλ©”μΌ_λ°Έλ₯˜μ—μ΄μ…˜_UNKNOWN_μ˜λ„.md new file mode 100644 index 0000000..2b43598 --- /dev/null +++ b/troubleshooting/251023_admin_rb8001_μ½œλ“œλ©”μΌ_λ°Έλ₯˜μ—μ΄μ…˜_UNKNOWN_μ˜λ„.md @@ -0,0 +1,50 @@ +# rb8001 μ½œλ“œλ©”μΌ μš”μ•½: λ°Έλ₯˜μ—μ΄μ…˜ κ³ μ • ν‘œκΈ° 및 UNKNOWN λΌμš°νŒ… κ°œμ„  + +**λ‚ μ§œ**: 2025-10-23 +**μž‘μ„±μž**: admin +**κ΄€λ ¨ 파일**: `rb8001/app/services/startup_valuation.py:433-456`, `rb8001/app/services/workflows/coldmail_workflow.py:124-127`, `rb8001/app/services/coldmail_processor.py:444-452`, `rb8001/app/brain/decision_engine.py:105-120` + +--- + +## 문제 상황 +- μ½œλ“œλ©”μΌ μš”μ•½ λ©”μ‹œμ§€μ— β€œIR자료: 30.0얡원 (신뒰도 60%)β€λ‘œ ν‘œκΈ°λ˜μ–΄ λ°Έλ₯˜μ—μ΄μ…˜μ΄ β€˜κ³ μ •β€™μ²˜λŸΌ 인지됨. + - 증거: `rb8001/logs/rb8001.log:66827-66830` β€” seed prior(30)만으둜 Posterior μ‚°μΆœ, IR μ§€ν‘œ μ—†μŒ β†’ `Insufficient IR metrics; ... HOLD` 둜 기둝. + - 원인: `startup_valuation.py:433-456` β€” 증거 0개면 DB μ €μž₯을 보λ₯˜(HOLD)ν•˜λ˜ κ²°κ³Ό 수치 μžμ²΄λŠ” prior 기반으둜 λ‚¨μŒ. μš”μ•½ λ©”μ‹œμ§€(`workflows/coldmail_workflow.py:124-127`)λŠ” HOLD/κ·Όκ±° λΆ€μž¬λ₯Ό ν‘œμ‹œν•˜μ§€ μ•ŠμŒ. + +- μŠ€λ ˆλ“œ 후속 질문(β€œμ§€μ—ν”„ μ†”λ£¨μ…˜ … μ„€λͺ…ν•΄μ€˜β€, β€œ30μ–΅ κ³ μ • μ΄μœ β€)이 UNKNOWN μ˜λ„λ‘œ μ²˜λ¦¬λ˜μ–΄ 일반 λ‹΅λ³€μœΌλ‘œ ν•˜ν–₯. + - 증거: `rb8001/logs/rb8001.log:66861, 66916, 66920` β€” DecisionEngine UNKNOWN. + - 원인: `decision_engine.py:114-120` β€” 웹검색/μ„€λͺ… νŒ¨ν„΄μ— `.*λŒ€ν•΄μ„œ.*μ„€λͺ…`은 μžˆμœΌλ‚˜ β€œμ— λŒ€ν•΄ μ„€λͺ…ν•΄μ€˜β€/β€œμ„€λͺ…ν•΄μ€˜β€/β€œμ΄μœ β€/β€œκΈ°μ—…κ°€μΉ˜|λ°Έλ₯˜μ—μ΄μ…˜|30얡” 쑰합이 λΆ€μž¬. + +--- + +## ν•΄κ²° λ°©μ•ˆ +1) ν‘œμ‹œ κ°œμ„ (μ˜€ν•΄ 방지) + - `coldmail_processor.py:444-452`: λ°˜ν™˜ dict에 `valuation_result.metadata`의 핡심 ν‚€λ₯Ό ν¬ν•¨ν•˜λ„λ‘ ν™•μž₯: `status`(hold), `missing_fields`, `prior_components.stage_prior.median` λ“±. + - `workflows/coldmail_workflow.py:124-127`: HOLD이면 β€œμ΄ˆμ•ˆ(HOLD·사전값 seed 30)β€λ‘œ λΌλ²¨λ§ν•˜κ³  λ²”μœ„(ν•˜ν•œ~μƒν•œ)와 λˆ„λ½μ§€ν‘œλ₯Ό ν•¨κ»˜ ν‘œκΈ°. 예) `- μ§€μ—ν”„μ†”λ£¨μ…˜: μ΄ˆμ•ˆ(HOLDΒ·seed 30) [ν•„μš”: revenue, growth_rate, team_size]`. + +2) λΌμš°νŒ… 보강(μ˜λ„ 인식 ν–₯상) + - `decision_engine.py:114-120`(WEB_SEARCH) 및/λ˜λŠ” `decision_engine.py:105-109`(DOCUMENT_ANALYSIS) νŒ¨ν„΄μ— λ‹€μŒ μΆ”κ°€: + - `.*에 λŒ€ν•΄.*μ„€λͺ…ν•΄μ€˜`, `μ„€λͺ…ν•΄μ€˜`, `이유`, `(κΈ°μ—…κ°€μΉ˜|λ°Έλ₯˜μ—μ΄μ…˜|valuation|30μ–΅)` + - 선택: 별도 Intent(예: `valuation_explain`)λ₯Ό λ„μž…ν•΄ 졜근 평가 메타데이터λ₯Ό 근거둜 β€œμ™œ 30얡인가(HOLDΒ·seed prior)”λ₯Ό μ„€λͺ…ν•˜λ„λ‘ μ—°κ²°. + +3) 데이터 μˆ˜μ§‘ 루프(정확도 κ°œμ„ ) + - HOLD μ‹œ λˆ„λ½ μ§€ν‘œ(revenue, growth_rate, team_size, tech_advantage)λ₯Ό μ•ˆλ‚΄ν•˜κ³  μž…λ ₯(λ˜λŠ” 파일 보강) ν›„ μž¬ν‰κ°€λ₯Ό 트리거. Slack λ²„νŠΌ/λͺ¨λ‹¬μ€ ν–₯ν›„ μž‘μ—…μœΌλ‘œ 뢄리 λ¬Έμ„œν™”. + +--- + +## μž¬ν˜„/검증 절차 +- HOLD 확인: `rb8001/logs/rb8001.log`μ—μ„œ `Insufficient IR metrics` 검색. + - 예: `rg -n "Insufficient IR metrics" rb8001/logs/rb8001.log` +- UNKNOWN 확인: 동일 λ‘œκ·Έμ—μ„œ `μ˜λ„ 맀칭 μ‹€νŒ¨ - UNKNOWN` 검색. + - 예: `rg -n "μ˜λ„ 맀칭 μ‹€νŒ¨ - UNKNOWN" rb8001/logs/rb8001.log` +- μ½”λ“œ κΈ°μ€€μ„ : + - HOLD 라벨 λ―Έν‘œμ‹œ: `workflows/coldmail_workflow.py:124-127` + - μ„€λͺ…/이유 νŒ¨ν„΄ λΆ€μž¬: `decision_engine.py:114-120` + +--- + +## κ΅ν›ˆ +- μ§€ν‘œ λΆ€μž¬(HOLD) μƒνƒœμ˜ 수치 ν‘œκΈ°λŠ” β€˜μ΄ˆμ•ˆβ€™/β€˜μ‚¬μ „κ°’β€™/β€˜κ·Όκ±°β€™μ™€ ν•¨κ»˜ λͺ…μ‹œν•΄ μ˜€ν•΄λ₯Ό 방지해야 ν•œλ‹€. +- μ‚¬μš©μž ν‘œν˜„(β€œμ„€λͺ…ν•΄μ€˜/이유/30μ–΅/λ°Έλ₯˜μ—μ΄μ…˜β€)을 νŒ¨ν„΄μ— λ°˜μ˜ν•˜μ§€ μ•ŠμœΌλ©΄ μ˜λ„ 인식 μ‹€νŒ¨λ‘œ ν’ˆμ§ˆμ΄ ν•˜λ½ν•œλ‹€. +- 둜그 κ·Όκ±°(KST, 파일/라인)와 μ½”λ“œ 기쀀선을 ν•¨κ»˜ μ •λ¦¬ν•˜λ©΄ μž¬ν˜„/μˆ˜μ •/검증 사이클이 빨라진닀. +