[Hotfix] 연관분석 AI 프롬프트 말투 변경

[yjhss]

🔗 관련 이슈

관련된 이슈 번호를 적어주세요.

closes #

📌 작업 내용

이번 PR에서 작업한 내용을 간략히 설명해주세요.

PM님 요청으로 연관분석 AI 말투 변경 (~했습니다 -> ~해요)

🧪 테스트 결과

Postman 스크린샷, 테스트 통과 여부 등을 첨부해주세요.

📸 스크린샷 (선택)

필요시 스크린샷을 첨부해주세요.

📎 참고 사항 (선택)

리뷰어에게 전달할 내용이 있다면 작성해주세요.

Summary by CodeRabbit

• 개선사항
  • AI 분석 결과의 톤을 개선했습니다. 친근하고 이웃다운 대화체로 변경되어 사용자와의 상호작용이 더욱 자연스러워졌습니다. 존댓글 사용과 다양한 문장 종결, 일상적인 표현을 통해 보다 편안한 커뮤니케이션 경험을 제공합니다.

[coderabbitai]

개요

AI 분석 프롬프트 생성기의 음성 지침을 수정했습니다. 기존 한 줄의 친화적 톤 지침을 더 상세한 가이드라인으로 교체하여, 대화체 톤과 한국어 정중한 어미(요/해요/네요) 사용, 다양한 문장 종결, 구어체 표현을 강조합니다.

변경 사항

Cohort / File(s)	Summary
AI 분석 프롬프트 톤 가이드라인 src/main/java/com/umc/finly/domain/analysis/association/infra/AiAnalysisPromptBuilder.java	음성 지침을 1줄에서 7줄로 확장하여 대화체, 이웃처럼 부드러운 톤을 정의하고, 한국어 정중한 어미(요/해요/네요) 사용, 다양한 문장 종결, 구어체 표현 선호를 명시적으로 안내합니다. 변경 전후 예시 섹션을 추가하여 새로운 스타일을 강화합니다.

관련 PR

• [Hotfix] 연관분석 AI 프롬프트 수정 #223: 동일한 AiAnalysisPromptBuilder 파일의 프롬프트 내용을 수정하는 PR로, 한국어 톤/형식 및 감정-매핑 규칙 변경과 관련이 있습니다.

제안된 검토자

• dosp74
• wonee1
• ye-zin

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Title check	✅ Passed	PR 제목이 변경 사항의 핵심을 명확하게 반영하고 있습니다. 연관분석 AI 프롬프트의 말투 변경이라는 주요 변경 내용을 정확하게 설명하고 있습니다.
Description check	✅ Passed	PR 설명이 필수 섹션들을 포함하고 있으며, 작업 내용과 테스트 결과가 명확하게 기재되어 있습니다. 관련 이슈 번호는 미기재되었으나 주요 정보는 충분합니다.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch feat/analysis-155-ai

Tip

Issue Planner is now in beta. Read the docs and try it out! Share your feedback on Discord.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 1

🧹 Nitpick comments (1)

src/main/java/com/umc/finly/domain/analysis/association/infra/AiAnalysisPromptBuilder.java (1)

47-53: 페르소나 정의를 프롬프트 앞부분으로 이동 권장

Line 47의 역할 정의("당신은 친근하고 다정한 금융 상담가입니다.")가 모든 요구사항(Lines 34–46) 이후에 위치하고 있습니다. LLM 프롬프트 설계에서는 역할/페르소나를 프롬프트 맨 앞에 배치해야 이후 지시사항 전체에 걸쳐 일관된 톤이 적용됩니다. 현재 구조에서는 요구사항 파싱 후 역할이 오버라이드되는 형태라 효과가 약할 수 있습니다.

또한 Line 51의 "## 말투 가이드라인 (예시):" 마크다운 헤더(##)는 나머지 프롬프트가 순수 평문(plain text)으로 구성된 것과 형식이 불일치합니다. 모델이 ##를 리터럴 텍스트로 인식할 수 있으므로 일반 텍스트 헤더로 통일하는 것이 좋습니다.

♻️ 구조 개선 제안 (페르소나 선행 배치 + 마크다운 헤더 제거)

         sb.append("[분석 데이터]\n");
+        // 역할 정의를 프롬프트 최상단에 배치
+        sb.append("당신은 친근하고 다정한 금융 상담가입니다.\n");
         sb.append("- 공포지수: ").append(...).append("\n");
         // ... (기존 데이터 및 요구사항 라인 유지)
         sb.append("'사용자', '투자자' 지칭 금지, 반드시 존댓말을 사용하세요.\n");
-        sb.append("당신은 친근하고 다정한 금융 상담가입니다.\n");
         sb.append("딱딱한 '~습니다' 체 대신, 이웃과 대화하듯 자연스럽고 부드러운 '~요', '~해요', '~네요' 체를 사용하세요.\n");
         sb.append("문장 끝이 너무 반복되지 않도록 '~인 것 같아요', '~이 좋겠네요' 처럼 다양한 종결 어미를 섞어주세요.\n");
         sb.append("군더더기 없는 문어체보다는 대화하듯 매끄러운 구어체를 지향하세요.\n");
-        sb.append("## 말투 가이드라인 (예시):\n");
+        sb.append("말투 가이드라인 (예시):\n");
         sb.append("변경 전: ...\n");
         sb.append("변경 후: ...\n");

[coderabbitai]

⚠️ Potential issue | 🟡 Minor

"학신이" → "확신이" 오타 수정 필요

"변경 후" 예시 문장에 오타가 있습니다. "탐욕과 학신이 느껴지네요" → "탐욕과 확신이 느껴지네요". 이 예시는 LLM에게 직접 전달되는 프롬프트 문자열이며, 프롬프트 내 다른 곳에서 CONFIDENCE → '확신'으로 명시적으로 매핑하도록 지시한 것과 불일치하여 모델 출력 품질에 영향을 줄 수 있습니다.

🐛 수정 제안

-        sb.append("변경 후: 현재 공포지수가 낮고 매수확신도가 높아 탐욕과 학신이 느껴지네요. ...\n");
+        sb.append("변경 후: 현재 공포지수가 낮고 매수확신도가 높아 탐욕과 확신이 느껴지네요. ...\n");

📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change

	sb.append("변경 후: 현재 공포지수가 낮고 매수확신도가 높아 탐욕과 학신이 느껴지네요. 이러한 긍정적인 감정은 매수 활동을 촉진할 수 있지만, 지나친 탐욕은 위험을 초래할 수 있어요. 안정성을 위해 과도한 감정에 휘둘리지 않고 신중한 결정을 내리는 것이 좋아요.\n");
	sb.append("변경 후: 현재 공포지수가 낮고 매수확신도가 높아 탐욕과 확신이 느껴지네요. 이러한 긍정적인 감정은 매수 활동을 촉진할 수 있지만, 지나친 탐욕은 위험을 초래할 수 있어요. 안정성을 위해 과도한 감정에 휘둘리지 않고 신중한 결정을 내리는 것이 좋아요.\n");