ux-research-agent-slackbot / docs /program_introduction.md
debug-log
Claude Opus 4.6
feat: Insight Repository โ€” GitLab ์ดˆ๊ธฐํ™” + HF ์ž๋™ ๋ฐฐํฌ
501bc8c
|
Raw History Blame Contribute Delete
26.4 kB
# Insight Repository
> **Version:** 2.2 | **Last Updated:** 2026-02-15 | **Owner:** UX Research Team
>
> **HuggingFace Space:** [https://huggingface.co/spaces/YGCXLab/ux-research-agent-slackbot](https://huggingface.co/spaces/YGCXLab/ux-research-agent-slackbot)
---
# 1. ๊ฐœ์š”
> โ„น๏ธ **Insight Repository**๋Š” ์—ฌ๊ธฐ์–ด๋•Œ UX ๋ฆฌ์„œ์น˜ํŒ€์˜ ๋ฆฌ์„œ์น˜ ์ž์‚ฐ์„ ์Šฌ๋ž™์—์„œ ์ฆ‰์‹œ ๊ฒ€์ƒ‰ํ•˜๊ณ , ์ „๋žต์  ์ธ์‚ฌ์ดํŠธ๋ฅผ ์ œ๊ณตํ•˜๋Š” AI ์—์ด์ „ํŠธ์ž…๋‹ˆ๋‹ค.
์œ ์ €๊ฐ€ ์Šฌ๋ž™์—์„œ ์งˆ๋ฌธํ•˜๋ฉด, ์‚ฌ๋‚ด ๋ฆฌ์„œ์น˜ ๋ณด๊ณ ์„œ ยท Baymard ์ด์ปค๋จธ์Šค ๊ฐ€์ด๋“œ๋ผ์ธ ยท NN/g ๋ฆฌ์„œ์น˜ ์•„ํ‹ฐํด์„ ๋™์‹œ์— ๊ฒ€์ƒ‰ํ•˜์—ฌ **๊ต์ฐจ ๋ถ„์„๋œ ๋‹ต๋ณ€**์„ ์ƒ์„ฑํ•ฉ๋‹ˆ๋‹ค. ๋‹จ์ˆœ ๋ฌธ์„œ ๊ฒ€์ƒ‰์„ ๋„˜์–ด, ๋ฆฌ์„œ์น˜ ์„ค๊ณ„ ์ œ์•ˆ ยท ๊ฐ€์„ค ๊ฒ€์ฆ ยท ์ „๋žต์  ์กฐ์–ธ๊นŒ์ง€ ๊ฐ€๋Šฅํ•œ **UX ๋ฆฌ์„œ์น˜ ์ปจ์„คํ„ดํŠธ** ์—ญํ• ์„ ์ˆ˜ํ–‰ํ•ฉ๋‹ˆ๋‹ค.
## 1.1 ํ•ต์‹ฌ ๊ฐ€์น˜
| ๊ธฐ๋Šฅ | ์„ค๋ช… |
| --- | --- |
| โญ **3-Source ํ†ตํ•ฉ ๊ฒ€์ƒ‰** | ์‚ฌ๋‚ด ๋ฆฌ์„œ์น˜ 145๊ฑด + Baymard 520๊ฑด + NN/g 420๊ฑด์„ ๋™์‹œ ๊ฒ€์ƒ‰ |
| โญ **๊ต์ฐจ ๋ถ„์„** | "์‚ฌ๋‚ด์—์„œ๋Š” A, ๊ธ€๋กœ๋ฒŒ ํ‘œ์ค€์—์„œ๋Š” B" โ€” ์ž๋™์œผ๋กœ ์†Œ์Šค ๊ฐ„ ๋Œ€์กฐ ์ธ์‚ฌ์ดํŠธ ์ œ๊ณต |
| โญ **์ „๋žต์  ์ž๋ฌธ** | ๋ฆฌ์„œ์น˜ ์„ค๊ณ„, ๊ฐ€์„ค ๊ฒ€์ฆ, ๋ฐฉ๋ฒ•๋ก  ์ถ”์ฒœ ๋“ฑ ์ปจ์„คํ„ดํŠธ ์ˆ˜์ค€์˜ ์กฐ์–ธ |
| โญ **๋ฉ€ํ‹ฐ๋ชจ๋‹ฌ ๋ถ„์„** | UI ์Šคํฌ๋ฆฐ์ƒท/์˜์ƒ ์—…๋กœ๋“œ ์‹œ UX ๊ด€์  ๋ถ„์„ + ๊ด€๋ จ ๊ฐ€์ด๋“œ๋ผ์ธ ์ธ์šฉ |
| โญ **ํ›„์† ํƒ์ƒ‰ ๊ฐ€์ด๋“œ** | ๋งค ๋‹ต๋ณ€๋งˆ๋‹ค ๋งฅ๋ฝ์— ๋งž๋Š” ํ›„์† ์งˆ๋ฌธ 2-3๊ฐœ ์ถ”์ฒœ |
| โญ **๊ฒ€์ƒ‰ ์ „๋žต ํ™•์ธ** | ๋‹ต๋ณ€ ์ „ ๋ถ„์„ ๊ฒฐ๊ณผ๋ฅผ ๋ณด์—ฌ์ฃผ๊ณ , ์œ ์ €๊ฐ€ ๊ฒ€์ƒ‰ ๋ฐฉ์‹์„ ์„ ํƒํ•  ์ˆ˜ ์žˆ๋Š” Confirmation UX |
| โญ **์‹ค์‹œ๊ฐ„ ์ŠคํŠธ๋ฆฌ๋ฐ** | ๋‹ต๋ณ€ ์ƒ์„ฑ ๊ณผ์ •์„ ์‹ค์‹œ๊ฐ„์œผ๋กœ ํ™•์ธ โ€” ์ฒด๊ฐ ๋Œ€๊ธฐ ์‹œ๊ฐ„ ๋Œ€ํญ ๋‹จ์ถ• |
| โญ **๋ณ‘๋ ฌ ๊ฒ€์ƒ‰** | 3๊ฐœ ๋ฐ์ดํ„ฐ ์†Œ์Šค๋ฅผ ๋™์‹œ ๊ฒ€์ƒ‰ํ•˜์—ฌ ์‘๋‹ต ์†๋„ 3๋ฐฐ ํ–ฅ์ƒ |
---
# 2. ์‹œ์Šคํ…œ ์•„ํ‚คํ…์ฒ˜
## 2.1 ์ „์ฒด ํŒŒ์ดํ”„๋ผ์ธ
```
์œ ์ € ์งˆ๋ฌธ (Slack)
โ”‚
โ–ผ
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚ 1. Intent Router (LLM) โ”‚
โ”‚ 6๊ฐœ ์ธํ…ํŠธ ๋ถ„๋ฅ˜ + confidence ์ ์ˆ˜ โ”‚
โ”‚ + secondary_intent (๋ธ”๋ Œ๋”ฉ ์ง€์›) โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
โ”‚
โ–ผ
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚ 2. Query Expansion (LLM) โ”‚
โ”‚ ํ‚ค์›Œ๋“œ โ†’ ๋ฒˆ์—ญ + ๋™์˜์–ด + ์•ฝ์–ด ํ™•์žฅ โ”‚
โ”‚ ์˜ˆ: "CVR" โ†’ ["CVR","์ „ํ™˜์œจ", โ”‚
โ”‚ "conversion rate"] โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
โ”‚
โ–ผ
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚ 2.5 Confirmation UX (v2.1) โ”‚
โ”‚ ๋ถ„์„ ๊ฒฐ๊ณผ ์š”์•ฝ + ๊ฒ€์ƒ‰ ์ „๋žต ๋ฒ„ํŠผ ์ œ์‹œ โ”‚
โ”‚ [๊ฐ„๋‹จ ๊ฒ€์ƒ‰] [์‹ฌ์ธต ๋ถ„์„] [โœ… ์ „๋žต ์ž๋ฌธ] โ”‚
โ”‚ 2๋ถ„ ํƒ€์ž„์•„์›ƒ โ†’ ์ถ”์ฒœ ๋ฐฉ์‹ ์ž๋™ ์ง„ํ–‰ โ”‚
โ”‚ โ€ป CHAT/MULTIMODAL/SPECIFIC์€ ์Šคํ‚ต โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
โ”‚
โ–ผ
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚ 3. Hybrid Search (Fuzzy + Vector) โ”‚
โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚
โ”‚ โ”‚ ์‚ฌ๋‚ด 145 โ”‚ Baymard โ”‚ NN/g 420 โ”‚ โ”‚
โ”‚ โ”‚ ๊ฑด โ”‚ 520๊ฑด โ”‚ ๊ฑด โ”‚ โ”‚
โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ”‚
โ”‚ โšก ๋ณ‘๋ ฌ ๊ฒ€์ƒ‰ (ThreadPoolExecutor) โ”‚
โ”‚ 3-Tier Ranking + Fallback โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
โ”‚
โ–ผ
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚ 4. Answer Generation (LLM Streaming) โ”‚
โ”‚ ์ธํ…ํŠธ๋ณ„ ์ „๋ฌธ ํ”„๋กฌํ”„ํŠธ ์ฒด์ธ โ”‚
โ”‚ chain.stream() โ†’ ์‹ค์‹œ๊ฐ„ ์ฒญํฌ ์ „์†ก โ”‚
โ”‚ + ๊ต์ฐจ ๋ถ„์„ + ํ†ค ์ ์‘ โ”‚
โ”‚ + ํ›„์† ์งˆ๋ฌธ ์ƒ์„ฑ โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
โ”‚
โ–ผ
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚ 4.5 Streaming UX (v2.2) โ”‚
โ”‚ โณ placeholder โ†’ โœ๏ธ ์‹ค์‹œ๊ฐ„ ๋ฏธ๋ฆฌ๋ณด๊ธฐ โ”‚
โ”‚ โ†’ Block Kit ์ตœ์ข… ๋ Œ๋”๋ง โ”‚
โ”‚ 1์ดˆ ๊ฐ„๊ฒฉ throttle (Slack rate limit) โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
โ”‚
โ–ผ
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚ 5. Slack Block Kit ๋ Œ๋”๋ง โ”‚
โ”‚ ๋‹ต๋ณ€ + ์†Œ์Šค ์„น์…˜ + ํ›„์† ์งˆ๋ฌธ ์นด๋“œ โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
```
## 2.2 ๊ธฐ์ˆ  ์Šคํƒ
| ๊ตฌ์„ฑ ์š”์†Œ | ๊ธฐ์ˆ  | ์šฉ๋„ |
| --- | --- | --- |
| **LLM** | Google Gemini 3 Flash | ์ธํ…ํŠธ ๋ถ„๋ฅ˜, ์ฟผ๋ฆฌ ํ™•์žฅ, ๋‹ต๋ณ€ ์ƒ์„ฑ |
| **ํ”„๋ ˆ์ž„์›Œํฌ** | LangChain + LangGraph + LangChain-Google-GenAI | LLM ์ฒด์ธ ์˜ค์ผ€์ŠคํŠธ๋ ˆ์ด์…˜ + Agentic RAG |
| **Fuzzy Matching** | thefuzz + python-Levenshtein | ๋ฉ”ํƒ€๋ฐ์ดํ„ฐ ๊ธฐ๋ฐ˜ ์œ ์‚ฌ ๋ฌธ์ž์—ด ๋งค์นญ |
| **Slack** | slack-bolt (Socket Mode) | ์Šฌ๋ž™ ์ด๋ฒคํŠธ ์ˆ˜์‹  ๋ฐ ์‘๋‹ต |
| **Web UI** | Streamlit | ์›น ์ธํ„ฐํŽ˜์ด์Šค (ํ…Œ์ŠคํŠธ์šฉ) |
| **Logging** | Supabase | ์‚ฌ์šฉ ๋กœ๊ทธ ๊ธฐ๋ก (์งˆ๋ฌธ/๋‹ต๋ณ€/์ธํ…ํŠธ) |
| **๋ฐฐํฌ** | HuggingFace Spaces (Docker) | Python 3.10, ํฌํŠธ 7860 |
---
# 3. ์งˆ๋ฌธ ์œ ํ˜• ๋ฐ ๋‹ต๋ณ€ ๋ฐฉ์‹
## 3.1 ์ธํ…ํŠธ ๋ถ„๋ฅ˜ ์ฒด๊ณ„ (6๊ฐ€์ง€)
### SIMPLE_SEARCH โ€” ๋‹จ์ˆœ ๊ฒ€์ƒ‰
**์„ค๋ช…:** ๋น ๋ฅธ ์‚ฌ์‹ค ํ™•์ธ, ์ •์˜, ์ž๋ฃŒ ๋ชฉ๋ก ์š”์ฒญ
**์˜ˆ์‹œ ์งˆ๋ฌธ:**
- "๋ฆฌ๋ทฐ ๊ด€๋ จ ์‚ฌ๋‚ด ๋ฆฌ์„œ์น˜ ์žˆ์–ด?"
- "NPS๊ฐ€ ๋ญ์•ผ?"
- "ํ•ด์™ธ์ˆ™์†Œ ๋ฆฌ์„œ์น˜ ์ž๋ฃŒ"
**์‘๋‹ต ํ˜•ํƒœ:** ์†Œ์Šค๋ณ„ ๊ทธ๋ฃนํ•‘๋œ ๋ฌธ์„œ ๋ชฉ๋ก (์ œ๋ชฉ + ์š”์•ฝ + ๋งํฌ) + ๊ต์ฐจ ๋ถ„์„ 1-2์ค„
---
### DEEP_RESEARCH โ€” ์‹ฌ์ธต ๋ถ„์„
**์„ค๋ช…:** ์—ฌ๋Ÿฌ ์†Œ์Šค๋ฅผ ์ข…ํ•ฉํ•œ ๊นŠ์ด ์žˆ๋Š” ๋ถ„์„/๋น„๊ต/ํŠธ๋ Œ๋“œ ๋ฆฌํฌํŠธ
**์˜ˆ์‹œ ์งˆ๋ฌธ:**
- "๊ฒฐ์ œ ํ”„๋กœ์„ธ์Šค ์ดํƒˆ์œจ ์ค„์ด๋Š” ๋ฐฉ๋ฒ• ์ข…ํ•ฉ์ ์œผ๋กœ ๋ถ„์„ํ•ด์ค˜"
- "๋ชจ๋ฐ”์ผ ์ฒดํฌ์•„์›ƒ UX ํŠธ๋ Œ๋“œ๋Š”?"
**์‘๋‹ต ํ˜•ํƒœ:** ๊ฐœ์š” โ†’ ํ•ต์‹ฌ ๋ฐœ๊ฒฌ (ํ…Œ๋งˆ๋ณ„, ์†Œ์Šค ๊ต์ฐจ) โ†’ ๐Ÿ” ๊ต์ฐจ ๋ถ„์„ โ†’ ๊ถŒ์žฅ ์‚ฌํ•ญ + ํ›„์† ์งˆ๋ฌธ
---
### ADVISORY โ€” ์ „๋žต์  ์ž๋ฌธ (v2.0 ์‹ ๊ทœ)
**์„ค๋ช…:** ๋ฆฌ์„œ์น˜ ์„ค๊ณ„, ๊ฐ€์„ค ๊ฒ€์ฆ, ๋ฐฉ๋ฒ•๋ก  ์ถ”์ฒœ, ์ „๋žต ์ œ์•ˆ ๋“ฑ ์ปจ์„คํ„ดํŠธํ˜• ์กฐ์–ธ
**์˜ˆ์‹œ ์งˆ๋ฌธ:**
- "UT ์„ค๊ณ„๋ฅผ ๋„์™€์ค˜"
- "์ดํƒˆ ์‚ฌ์šฉ์ž๋ฅผ ์žก๊ธฐ ์œ„ํ•œ ์ „๋žต์€?"
- "์ด ๊ฐ€์„ค์ด ๋งž๋Š”์ง€ ๊ฒ€์ฆํ•ด์ค˜"
- "๊ฒฐ์ œ ๊ด€๋ จ ๋ฆฌ์„œ์น˜ ์ฐพ์•„์ฃผ๊ณ , ๊ฐœ์„  ๋ฐฉํ–ฅ๋„ ์ œ์•ˆํ•ด์ค˜" (๋ธ”๋ Œ๋”ฉ: SEARCH + ADVISORY)
**์‘๋‹ต ํ˜•ํƒœ:** ์ƒํ™ฉ ๋ถ„์„ โ†’ ํ•ต์‹ฌ ์ œ์•ˆ โ†’ ๊ทผ๊ฑฐ ์ž๋ฃŒ (๊ต์ฐจ ๋Œ€์กฐ) โ†’ ์‹คํ–‰ ๊ฐ€์ด๋“œ + ํ›„์† ์งˆ๋ฌธ
> ๐Ÿ“ ADVISORY๋Š” ๋‹จ์ˆœ ๊ฒ€์ƒ‰๊ณผ ๋‹ค๋ฅด๊ฒŒ **๋ช…ํ™•ํ•œ ์ž…์žฅ**์„ ์ทจํ•ฉ๋‹ˆ๋‹ค. ์˜ต์…˜์„ ๋‚˜์—ดํ•˜๋Š” ๊ฒƒ์ด ์•„๋‹ˆ๋ผ ์ตœ์„ ์˜ ๋ฐฉ๋ฒ•์„ ์ถ”์ฒœํ•˜๊ณ  ๊ทธ ์ด์œ ๋ฅผ ์„ค๋ช…ํ•ฉ๋‹ˆ๋‹ค.
---
### SPECIFIC_ITEM_ANALYSIS โ€” ํŠน์ • ๋ฌธ์„œ ๋ถ„์„
**์„ค๋ช…:** ํŠน์ • ๋ฆฌ์„œ์น˜ ๋ณด๊ณ ์„œ 1๊ฑด์„ ์ง€์ •ํ•˜์—ฌ ์ƒ์„ธ ๋ถ„์„
**์˜ˆ์‹œ ์งˆ๋ฌธ:**
- "[IDI] Hotel Partner Journey์— ๋Œ€ํ•ด ์•Œ๋ ค์ค˜"
- "[UT] ์ˆ™์†Œ ์ƒ์„ธํŽ˜์ด์ง€ ์‚ฌ์šฉ์„ฑ ์กฐ์‚ฌ ๋‚ด์šฉ์€?"
**์‘๋‹ต ํ˜•ํƒœ:** ํ•ด๋‹น ๋ฌธ์„œ์˜ 5-10์ค„ ์š”์•ฝ + ํ•ต์‹ฌ ๋ฐœ๊ฒฌ์  + ๋งํฌ
---
### MULTIMODAL_ANALYSIS โ€” ์ด๋ฏธ์ง€/์˜์ƒ ๋ถ„์„
**์„ค๋ช…:** UI ์Šคํฌ๋ฆฐ์ƒท์ด๋‚˜ ์˜์ƒ์„ ์—…๋กœ๋“œํ•˜๋ฉด UX ๊ด€์ ์—์„œ ๋ถ„์„
**์ง€์› ํŒŒ์ผ:** PNG, JPG, JPEG, MP4, MOV, PDF, DOCX
**์˜ˆ์‹œ ์งˆ๋ฌธ:**
- (์ฒดํฌ์•„์›ƒ ํ™”๋ฉด ์บก์ฒ˜ ์ฒจ๋ถ€) "์ด ํ™”๋ฉด์˜ ๋ฌธ์ œ์ ์ด ๋ญ์•ผ?"
- (๋‚ ์งœ ์„ ํƒ UI ์ฒจ๋ถ€) "์ด๋Ÿฐ UI์™€ ๊ด€๋ จ๋œ ๊ฐ€์ด๋“œ๋ผ์ธ ์ฐพ์•„์ค˜"
**์‘๋‹ต ํ˜•ํƒœ:** ์‹œ๊ฐ์  ๋ถ„์„ + ๊ด€๋ จ Baymard/์‚ฌ๋‚ด ๊ฐ€์ด๋“œ๋ผ์ธ ์ธ์šฉ + ํ›„์† ์งˆ๋ฌธ
---
### CHAT โ€” ์ผ์ƒ ๋Œ€ํ™”
**์„ค๋ช…:** ์ธ์‚ฌ, ์žก๋‹ด, ๋ด‡ ๊ธฐ๋Šฅ ์งˆ๋ฌธ ๋“ฑ ๊ฒ€์ƒ‰์ด ํ•„์š” ์—†๋Š” ๋Œ€ํ™”
**์˜ˆ์‹œ ์งˆ๋ฌธ:** "์•ˆ๋…•!", "๋ญ˜ ๋„์™€์ค„ ์ˆ˜ ์žˆ์–ด?", "๊ณ ๋งˆ์›Œ!"
**์‘๋‹ต ํ˜•ํƒœ:** ์ž์—ฐ์Šค๋Ÿฌ์šด ๋Œ€ํ™” + ํƒ์ƒ‰ ์‹œ์ž‘์„ ์œ„ํ•œ ๊ฐ€์ด๋“œ
---
## 3.2 ์ธํ…ํŠธ ๋ธ”๋ Œ๋”ฉ
ํ•˜๋‚˜์˜ ์งˆ๋ฌธ์ด ์—ฌ๋Ÿฌ ์ธํ…ํŠธ์— ๊ฑธ์น  ๋•Œ, ์‹œ์Šคํ…œ์€ **primary_intent**์™€ **secondary_intent**๋ฅผ ๋™์‹œ์— ํŒ๋‹จํ•ฉ๋‹ˆ๋‹ค.
| ์งˆ๋ฌธ ์˜ˆ์‹œ | Primary | Secondary | Confidence | ์ฒ˜๋ฆฌ ๋ฐฉ์‹ |
| --- | --- | --- | --- | --- |
| "์‚ฌ๋‚ด ๋ฆฌ์„œ์น˜ ์ž๋ฃŒ ์ฐพ์•„์ค˜" | SIMPLE_SEARCH | โ€” | 0.95 | ๋‹จ์ˆœ ๊ฒ€์ƒ‰ |
| "๋ชจ๋ฐ”์ผ ์ดํƒˆ์œจ ์ค„์ด๋Š” ๋ฐฉ๋ฒ•" | DEEP_RESEARCH | ADVISORY | 0.6 | ๋ธ”๋ Œ๋”ฉ โ†’ ์ž๋ฌธ ๋ชจ๋“œ |
| "๊ฒฐ์ œ ๋ฆฌ์„œ์น˜ ์ฐพ์•„์ฃผ๊ณ  ๊ฐœ์„  ๋ฐฉํ–ฅ๋„ ์ œ์•ˆํ•ด์ค˜" | ADVISORY | SIMPLE_SEARCH | 0.7 | ์ž๋ฌธ (๊ฒ€์ƒ‰ ๊ทผ๊ฑฐ ํฌํ•จ) |
> โ„น๏ธ confidence๊ฐ€ 0.7 ๋ฏธ๋งŒ์ด๊ณ  secondary_intent๊ฐ€ ADVISORY์ธ ๊ฒฝ์šฐ, ์‹œ์Šคํ…œ์€ ์ž๋™์œผ๋กœ ์ž๋ฌธ ๋ชจ๋“œ๋กœ ์ „ํ™˜ํ•˜์—ฌ ๊ฒ€์ƒ‰ ๊ฒฐ๊ณผ + ์ „๋žต์  ์ œ์•ˆ์„ ํ•จ๊ป˜ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค.
---
# 4. ๋ฐ์ดํ„ฐ ์†Œ์Šค
| ์†Œ์Šค | ๊ฑด์ˆ˜ | ๋‚ด์šฉ | ๊ฒ€์ƒ‰ ๋ฐฉ์‹ |
| --- | --- | --- | --- |
| **๐Ÿ“‚ ์‚ฌ๋‚ด ๋ฆฌ์„œ์น˜** | 145๊ฑด | ์—ฌ๊ธฐ์–ด๋•Œ ๋‚ด๋ถ€ UX ๋ฆฌ์„œ์น˜ ๋ณด๊ณ ์„œ (IDI, UT, Survey, FGI, Diary Study ๋“ฑ) | Fuzzy(๋ฉ”ํƒ€๋ฐ์ดํ„ฐ) + Vector(์‹œ๋งจํ‹ฑ) ํ•˜์ด๋ธŒ๋ฆฌ๋“œ |
| **๐Ÿ“– Baymard Guidelines** | 520๊ฑด | ์ด์ปค๋จธ์Šค UX ๋ฒ ์ŠคํŠธ ํ”„๋ž™ํ‹ฐ์Šค (๊ฒฐ์ œ, ๋„ค๋น„๊ฒŒ์ด์…˜, ์นดํŠธ, ํผ ๋“ฑ) | Fuzzy + Vector ํ•˜์ด๋ธŒ๋ฆฌ๋“œ |
| **๐ŸŒ NN/g Articles** | 420๊ฑด | Nielsen Norman Group ๋ฆฌ์„œ์น˜ ์•„ํ‹ฐํด (UX ์›์น™, ์‚ฌ์šฉ์„ฑ, ์ •๋ณด ์„ค๊ณ„ ๋“ฑ) | Fuzzy + Vector ํ•˜์ด๋ธŒ๋ฆฌ๋“œ |
## 4.1 ๊ฒ€์ƒ‰ ๋žญํ‚น ์‹œ์Šคํ…œ
3๋‹จ๊ณ„ ํ‹ฐ์–ด ๊ธฐ๋ฐ˜ ํ•˜์ด๋ธŒ๋ฆฌ๋“œ ๋žญํ‚น:
| ํ‹ฐ์–ด | ๋งค์นญ ๋ฐฉ์‹ | ์ ์ˆ˜ ๋ฒ”์œ„ | ์šฐ์„ ์ˆœ์œ„ |
| --- | --- | --- | --- |
| **Tier 1** | Fuzzy ๊ณ ์‹ ๋ขฐ ๋งค์นญ (์ œ๋ชฉ/๋ฆฌ์„œ์ฒ˜/๋ฐฉ๋ฒ•๋ก ) | 90+ | ์ตœ์šฐ์„  |
| **Tier 2** | Vector ์‹œ๋งจํ‹ฑ ๋งค์นญ (์˜๋ฏธ ์œ ์‚ฌ๋„) | ์ž„๋ฒ ๋”ฉ ๊ฑฐ๋ฆฌ ๊ธฐ๋ฐ˜ | ์ค‘๊ฐ„ |
| **Tier 3** | Fuzzy ์ค‘์‹ ๋ขฐ ๋งค์นญ | 80-89 | ๋ณด์กฐ |
> ๐Ÿ“ **Fallback ๋ฉ”์ปค๋‹ˆ์ฆ˜:** ๊ฒ€์ƒ‰ ๊ฒฐ๊ณผ๊ฐ€ 3๊ฑด ๋ฏธ๋งŒ์ผ ๊ฒฝ์šฐ, ์ž„๊ณ„๊ฐ’์„ 80 โ†’ 60์œผ๋กœ ๋‚ฎ์ถ”๊ณ  ํ‚ค์›Œ๋“œ๋ฅผ ํ™•์žฅํ•˜์—ฌ ์žฌ๊ฒ€์ƒ‰ํ•ฉ๋‹ˆ๋‹ค.
## 4.2 LLM ๊ธฐ๋ฐ˜ ์ฟผ๋ฆฌ ํ™•์žฅ
์œ ์ €์˜ ๊ฒ€์ƒ‰์–ด๋ฅผ LLM์ด ์ž๋™์œผ๋กœ ํ™•์žฅํ•ฉ๋‹ˆ๋‹ค:
```
์œ ์ € ์ž…๋ ฅ: "CVR ๊ฐœ์„  ๋ฐฉ๋ฒ•"
โ†“ LLM Query Expansion
ํ™•์žฅ๋œ ๊ฒ€์ƒ‰์–ด: ["CVR", "์ „ํ™˜์œจ", "conversion rate", "์ „ํ™˜๋ฅ ",
"๊ฐœ์„ ", "improvement", "optimization", "์ตœ์ ํ™”"]
```
ํ•œโ†”์˜ ๋ฒˆ์—ญ, ๋™์˜์–ด, ์•ฝ์–ด ํ™•์žฅ์ด ์ž๋™์œผ๋กœ ์ˆ˜ํ–‰๋˜์–ด ์ˆ˜๋™ ์‹œ๋…ธ๋‹˜ ๊ด€๋ฆฌ๊ฐ€ ๋ถˆํ•„์š”ํ•ฉ๋‹ˆ๋‹ค.
---
# 5. ํ•ต์‹ฌ ๊ธฐ๋Šฅ ์ƒ์„ธ
## 5.1 ๊ต์ฐจ ๋ถ„์„ (Proactive Cross-Reference)
๋ชจ๋“  ๋‹ต๋ณ€์—์„œ ์‚ฌ๋‚ด ๋ฆฌ์„œ์น˜์™€ ๊ธ€๋กœ๋ฒŒ ํ‘œ์ค€์„ ์ž๋™์œผ๋กœ ๋Œ€์กฐํ•ฉ๋‹ˆ๋‹ค:
> **๐Ÿ” ๊ต์ฐจ ๋ถ„์„:**
>
> - **์ผ์น˜:** ์‚ฌ๋‚ด '์ดํƒˆ ์›์ธ ์กฐ์‚ฌ'์—์„œ ๊ฒฐ์ œ ๋‹จ๊ณ„ ์ถ”๊ฐ€ ๋น„์šฉ์ด 1์œ„ ์ดํƒˆ ์›์ธ์œผ๋กœ ๋‚˜ํƒ€๋‚ฌ์œผ๋ฉฐ, Baymard 'Cart Abandonment' ๊ฐ€์ด๋“œ๋ผ์ธ์—์„œ๋„ ๋™์ผํ•œ ํŒจํ„ด์„ ๋ณด๊ณ ํ•˜๊ณ  ์žˆ์Šต๋‹ˆ๋‹ค.
> - **์ฐจ์ด:** ์‚ฌ๋‚ด ๋ฆฌ์„œ์น˜์—์„œ๋Š” ๋ฐฐ์†ก ์ •๋ณด ์ž…๋ ฅ์ด ์ฃผ์š” ๋ถˆํŽธ ์‚ฌํ•ญ์ด์—ˆ์œผ๋‚˜, Baymard์—์„œ๋Š” ๊ณ„์ • ์ƒ์„ฑ ๊ฐ•์ œ๋ฅผ ๋” ์‹ฌ๊ฐํ•œ ์ด์Šˆ๋กœ ์ง€์ ํ•ฉ๋‹ˆ๋‹ค.
> - **๊ณต๋ฐฑ:** ์ด ์ฃผ์ œ์— ๋Œ€ํ•œ ์‚ฌ๋‚ด ๋ฆฌ์„œ์น˜๋Š” ์—†์ง€๋งŒ, NN/g์— ๋”ฐ๋ฅด๋ฉด progressive disclosure๊ฐ€ ํšจ๊ณผ์ ์ž…๋‹ˆ๋‹ค.
## 5.2 ํ†ค ์ ์‘ (Conversational UX)
์œ ์ €์˜ ์งˆ๋ฌธ ์Šคํƒ€์ผ์— ๋งž์ถฐ ๋‹ต๋ณ€ ํ†ค์ด ์ž๋™ ์กฐ์ ˆ๋ฉ๋‹ˆ๋‹ค:
| ์œ ์ € ํ†ค | ์งˆ๋ฌธ ์˜ˆ์‹œ | ๋‹ต๋ณ€ ํ†ค |
| --- | --- | --- |
| ์บ์ฃผ์–ผ | "๋ฆฌ๋ทฐ ๊ด€๋ จ ์ž๋ฃŒ ์žˆ์–ด?" | "๋ฆฌ๋ทฐ ๊ด€๋ จ ์ž๋ฃŒ ์ฐพ์•˜์–ด์š”!" |
| ํฌ๋ฉ€ | "๋ฆฌ๋ทฐ์— ๊ด€ํ•œ ๋ฆฌ์„œ์น˜ ์ž๋ฃŒ๋ฅผ ์š”์ฒญ๋“œ๋ฆฝ๋‹ˆ๋‹ค" | "๋ฆฌ๋ทฐ ๊ด€๋ จ ์‚ฌ๋‚ด ๋ฆฌ์„œ์น˜ ์ž๋ฃŒ๋ฅผ ์ •๋ฆฌํ•ด ๋“œ๋ฆฌ๊ฒ ์Šต๋‹ˆ๋‹ค." |
## 5.3 ํ›„์† ์งˆ๋ฌธ ์ถ”์ฒœ
๋งค ๋‹ต๋ณ€ ๋์— ๋งฅ๋ฝ ๊ธฐ๋ฐ˜ ํ›„์† ์งˆ๋ฌธ 2-3๊ฐœ๋ฅผ ์ถ”์ฒœํ•ฉ๋‹ˆ๋‹ค:
> **๐Ÿ’ก ์ด๋Ÿฐ ๊ฒƒ๋„ ๋ฌผ์–ด๋ณด์„ธ์š”:**
>
> 1. ์ดํƒˆ ์›์ธ์— ๋Œ€ํ•œ ์‚ฌ๋‚ด UT ๊ฒฐ๊ณผ๋ฅผ ๋” ์ž์„ธํžˆ ๋ณผ๊นŒ์š”?
> 2. Baymard์˜ ๊ฒฐ์ œ ํ”„๋กœ์„ธ์Šค ์ตœ์ ํ™” ๊ฐ€์ด๋“œ๋ผ์ธ๋„ ํ™•์ธํ•ด ๋ณผ๊นŒ์š”?
> 3. ์ดํƒˆ์œจ ๊ฐœ์„ ์„ ์œ„ํ•œ ์ „๋žต์„ ์ œ์•ˆํ•ด ๋“œ๋ฆด๊นŒ์š”?
ํ›„์† ์งˆ๋ฌธ์€ ๋‹จ์ˆœ ํ•„ํ„ฐ๋ง์ด ์•„๋‹ˆ๋ผ, ํ˜„์žฌ ๋‹ต๋ณ€์˜ ๋งฅ๋ฝ์—์„œ **๋‹ค์Œ ํƒ์ƒ‰ ๊ฒฝ๋กœ**๋ฅผ ์ œ์•ˆํ•ฉ๋‹ˆ๋‹ค.
## 5.4 ๊ฒ€์ƒ‰ ์ „๋žต ํ™•์ธ โ€” Confirmation UX (v2.1 ์‹ ๊ทœ)
๊ฒ€์ƒ‰ํ˜• ์งˆ๋ฌธ(SIMPLE_SEARCH, DEEP_RESEARCH, ADVISORY)์˜ ๊ฒฝ์šฐ, ๋‹ต๋ณ€ ์ƒ์„ฑ ์ „์— ๋ถ„์„ ๊ฒฐ๊ณผ๋ฅผ ๋จผ์ € ๋ณด์—ฌ์ฃผ๊ณ  ์œ ์ €๊ฐ€ ๊ฒ€์ƒ‰ ๋ฐฉ์‹์„ ์„ ํƒํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
```
๐Ÿ” ์งˆ๋ฌธ์„ ๋ถ„์„ํ–ˆ์–ด์š”:
> "๊ฒฐ์ œ ์ดํƒˆ๋ฅ  ๊ฐœ์„  ๋ฐฉ์•ˆ์„ ์ œ์•ˆํ•ด์ค˜"
๐Ÿ“‹ ๊ฒ€์ƒ‰ ํ‚ค์›Œ๋“œ: ๊ฒฐ์ œ, ์ดํƒˆ๋ฅ , checkout, abandonment rate...
๐Ÿ’ก ์ถ”์ฒœ ๊ฒ€์ƒ‰ ๋ฐฉ์‹: ์ „๋žต ์ž๋ฌธ
[๊ฐ„๋‹จ ๊ฒ€์ƒ‰] [์‹ฌ์ธต ๋ถ„์„] [โœ… ์ „๋žต ์ž๋ฌธ]
โฑ๏ธ 2๋ถ„ ๋‚ด ์„ ํƒ์ด ์—†์œผ๋ฉด ์ถ”์ฒœ ๋ฐฉ์‹์œผ๋กœ ์ž๋™ ์ง„ํ–‰ํ•ฉ๋‹ˆ๋‹ค.
```
### ๋™์ž‘ ๋ฐฉ์‹
| ๋‹จ๊ณ„ | ์„ค๋ช… |
| --- | --- |
| **1. ๋ผ์šฐํŒ…** | Intent Router + Query Expansion๊นŒ์ง€๋งŒ ์ˆ˜ํ–‰ (๊ฒ€์ƒ‰/LLM ๋‹ต๋ณ€ ์ƒ์„ฑ ์—†์Œ) |
| **2. ํ™•์ธ ๋ฉ”์‹œ์ง€** | ๋ถ„์„๋œ ์ธํ…ํŠธ, ํ™•์žฅ๋œ ํ‚ค์›Œ๋“œ, ์ถ”์ฒœ ์ „๋žต์„ Slack ๋ฒ„ํŠผ๊ณผ ํ•จ๊ป˜ ํ‘œ์‹œ |
| **3. ์œ ์ € ์„ ํƒ** | ๋ฒ„ํŠผ ํด๋ฆญ ์‹œ ์„ ํƒํ•œ ์ „๋žต์œผ๋กœ ์‹คํ–‰ / 2๋ถ„ ํƒ€์ž„์•„์›ƒ ์‹œ ์ถ”์ฒœ ์ „๋žต์œผ๋กœ ์ž๋™ ์ง„ํ–‰ |
### ์Šคํ‚ต๋˜๋Š” ์ธํ…ํŠธ
CHAT, MULTIMODAL_ANALYSIS, SPECIFIC_ITEM_ANALYSIS์€ ์ „๋žต ์„ ํƒ์ด ๋ถˆํ•„์š”ํ•˜๋ฏ€๋กœ ํ™•์ธ ๋‹จ๊ณ„ ์—†์ด ์ฆ‰์‹œ ์‹คํ–‰๋ฉ๋‹ˆ๋‹ค.
### ์œ ์ € Preference
์œ ์ €๋ณ„๋กœ ํ™•์ธ ๋‹จ๊ณ„๋ฅผ ๋„๊ฑฐ๋‚˜ ์ผค ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค:
| ๋ช…๋ น์–ด | ๋™์ž‘ |
| --- | --- |
| "๋ฐ”๋กœ ๋‹ต๋ณ€ํ•ด์ค˜", "ํ™•์ธ ์—†์ด", "์Šคํ‚ตํ•ด์ค˜" | ํ™•์ธ ๋‹จ๊ณ„ OFF (์ฆ‰์‹œ ๋‹ต๋ณ€) |
| "ํ™•์ธ ์ ˆ์ฐจ ์ผœ์ค˜", "ํ™•์ธํ•˜๊ณ  ๋‹ต๋ณ€ํ•ด์ค˜" | ํ™•์ธ ๋‹จ๊ณ„ ON (๊ธฐ๋ณธ๊ฐ’) |
์„ค์ •์€ Supabase `user_preferences` ํ…Œ์ด๋ธ”์— ์ €์žฅ๋˜์–ด ์œ ์ €๋ณ„๋กœ ์œ ์ง€๋ฉ๋‹ˆ๋‹ค.
## 5.5 ์‹ค์‹œ๊ฐ„ ์ŠคํŠธ๋ฆฌ๋ฐ ์‘๋‹ต (v2.2 ์‹ ๊ทœ)
๋‹ต๋ณ€ ์ƒ์„ฑ ์ค‘ ์œ ์ €์—๊ฒŒ ์‹ค์‹œ๊ฐ„ ์ง„ํ–‰ ์ƒํ™ฉ์„ ๋ณด์—ฌ์ค๋‹ˆ๋‹ค:
```
1. โณ "๋‹ต๋ณ€์„ ์ƒ์„ฑํ•˜๊ณ  ์žˆ์–ด์š”..." โ† placeholder ๋ฉ”์‹œ์ง€ ์ฆ‰์‹œ ์ „์†ก
2. โœ๏ธ "๋‹ต๋ณ€ ์ž‘์„ฑ ์ค‘..." โ† 1์ดˆ ๊ฐ„๊ฒฉ์œผ๋กœ ๋ฏธ๋ฆฌ๋ณด๊ธฐ ์—…๋ฐ์ดํŠธ
> ๋ฆฌ๋ทฐ ๊ด€๋ จ ์ž๋ฃŒ๋ฅผ ์ฐพ์•˜์–ด์š”!...
3. [์ตœ์ข… Block Kit ์‘๋‹ต] โ† JSON ํŒŒ์‹ฑ โ†’ ๊ตฌ์กฐํ™”๋œ ๋‹ต๋ณ€์œผ๋กœ ๊ต์ฒด
```
### ๋™์ž‘ ๋ฐฉ์‹
| ๋‹จ๊ณ„ | ์„ค๋ช… |
| --- | --- |
| **1. Placeholder** | `chat_postMessage`๋กœ "โณ ๋‹ต๋ณ€์„ ์ƒ์„ฑํ•˜๊ณ  ์žˆ์–ด์š”..." ์ฆ‰์‹œ ์ „์†ก |
| **2. Streaming** | `chain.stream()`์œผ๋กœ LLM ์ถœ๋ ฅ์„ ์ฒญํฌ ๋‹จ์œ„๋กœ ์ˆ˜์‹ , `chat_update`๋กœ ์‹ค์‹œ๊ฐ„ ์—…๋ฐ์ดํŠธ |
| **3. Final Render** | ์ „์ฒด ์‘๋‹ต ์™„๋ฃŒ ํ›„ JSON ํŒŒ์‹ฑ โ†’ Block Kit ๋ณ€ํ™˜ โ†’ `chat_update`๋กœ ์ตœ์ข… ๊ต์ฒด |
### ์ธํ…ํŠธ๋ณ„ ์ŠคํŠธ๋ฆฌ๋ฐ ์ง€์›
| ์ธํ…ํŠธ | ์ŠคํŠธ๋ฆฌ๋ฐ | ๋ฏธ๋ฆฌ๋ณด๊ธฐ ํ˜•์‹ |
| --- | --- | --- |
| SIMPLE_SEARCH | โœ… | "โœ๏ธ ๋‹ต๋ณ€ ์ž‘์„ฑ ์ค‘..." + ํ…์ŠคํŠธ ๋ฏธ๋ฆฌ๋ณด๊ธฐ |
| DEEP_RESEARCH | โœ… | "โœ๏ธ ๋‹ต๋ณ€ ์ž‘์„ฑ ์ค‘..." + ํ…์ŠคํŠธ ๋ฏธ๋ฆฌ๋ณด๊ธฐ |
| ADVISORY | โœ… | "โœ๏ธ ๋‹ต๋ณ€ ์ž‘์„ฑ ์ค‘..." + ํ…์ŠคํŠธ ๋ฏธ๋ฆฌ๋ณด๊ธฐ |
| CHAT | โœ… | ์‹ค์ œ ํ…์ŠคํŠธ ์‹ค์‹œ๊ฐ„ ํ‘œ์‹œ |
| MULTIMODAL_ANALYSIS | โŒ | invoke ํ›„ ๋‹จ์ผ ์‘๋‹ต |
| SPECIFIC_ITEM_ANALYSIS | โŒ | invoke ํ›„ ๋‹จ์ผ ์‘๋‹ต |
### Throttle ์„ค์ •
- `STREAM_UPDATE_INTERVAL = 1.0์ดˆ` โ€” Slack API rate limit (~3req/s) ๋Œ€๋น„ ์•ˆ์ „ ๋งˆ์ง„
- `STREAM_MIN_CHARS = 20์ž` โ€” ์ตœ์†Œ ๊ธ€์ž ์ˆ˜ ์ดํ›„ ์ฒซ ์—…๋ฐ์ดํŠธ ์‹œ์ž‘
## 5.6 ๋ณ‘๋ ฌ ๊ฒ€์ƒ‰ (v2.2 ์‹ ๊ทœ)
3๊ฐœ ๋ฐ์ดํ„ฐ ์†Œ์Šค(์‚ฌ๋‚ด ๋ฆฌ์„œ์น˜, Baymard, NN/g)๋ฅผ `ThreadPoolExecutor`๋กœ ๋™์‹œ์— ๊ฒ€์ƒ‰ํ•ฉ๋‹ˆ๋‹ค:
```
๊ธฐ์กด (v2.1): ์‚ฌ๋‚ด โ†’ Baymard โ†’ NN/g (์ˆœ์ฐจ, ~1.5s)
๊ฐœ์„  (v2.2): ์‚ฌ๋‚ด โ”ฌ Baymard โ”ฌ NN/g (๋ณ‘๋ ฌ, ~0.5s)
๋™์‹œ ์‹คํ–‰ (ThreadPoolExecutor)
```
Fallback ๊ฒ€์ƒ‰(์ž„๊ณ„๊ฐ’ ํ•˜ํ–ฅ ์žฌ๊ฒ€์ƒ‰) ์‹œ์—๋„ ๋™์ผํ•˜๊ฒŒ ๋ณ‘๋ ฌ ์‹คํ–‰๋ฉ๋‹ˆ๋‹ค.
## 5.7 Structured Output (v2.2 ์‹ ๊ทœ)
์œ ํ‹ธ๋ฆฌํ‹ฐ ์ฒด์ธ(Query Expansion, Confirmation Interpret)์— Pydantic ๋ชจ๋ธ + `with_structured_output()`์„ ์ ์šฉํ•˜์—ฌ LLM ์‘๋‹ต์„ ๊ตฌ์กฐํ™”ํ•ฉ๋‹ˆ๋‹ค:
```python
# Before (v2.1): JSON ํ…์ŠคํŠธ โ†’ 4๋‹จ๊ณ„ ํŒŒ์‹ฑ ์‹œ๋„ (์‹คํŒจ ๊ฐ€๋Šฅ)
result_str = chain.invoke(input)
parsed = _parse_llm_json(result_str) # direct โ†’ fence โ†’ brace โ†’ quote fix
# After (v2.2): Pydantic ๊ฐ์ฒด ์ง์ ‘ ๋ฐ˜ํ™˜ (์‹คํŒจ ๋ถˆ๊ฐ€)
result = chain.invoke(input)
keywords = result.expanded_keywords # ํƒ€์ž… ์•ˆ์ „ ์ ‘๊ทผ
```
๋ฉ”์ธ ๋‹ต๋ณ€ ์ฒด์ธ(simple_search, deep_research ๋“ฑ)์€ ์ŠคํŠธ๋ฆฌ๋ฐ ํ˜ธํ™˜์„ ์œ„ํ•ด ๊ธฐ์กด `StrOutputParser()` ์œ ์ง€.
## 5.8 ํ•„ํ„ฐ๋ง ๊ธฐ๋Šฅ
๋Œ€ํ™” ์ค‘ ์ž์—ฐ์–ด๋กœ ๊ฒฐ๊ณผ๋ฅผ ์ขํž ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค:
| ํ•„ํ„ฐ ์œ ํ˜• | ์งˆ๋ฌธ ์˜ˆ์‹œ |
| --- | --- |
| ์†Œ์Šค๋ณ„ | "์‚ฌ๋‚ด ๋ฆฌ์„œ์น˜๋งŒ ๋ณด์—ฌ์ค˜", "Baymard ๊ฐ€์ด๋“œ๋ผ์ธ๋งŒ" |
| ๋‹ด๋‹น์ž๋ณ„ | "Shane์ด ์ง„ํ–‰ํ•œ ์—ฐ๊ตฌ", "์š˜๋‘ ๋ฆฌ์„œ์น˜" |
| ๋ฐฉ๋ฒ•๋ก ๋ณ„ | "UT ๊ด€๋ จ ์ž๋ฃŒ", "์„œ๋ฒ ์ด ๊ฒฐ๊ณผ" |
| ๋„๋ฉ”์ธ๋ณ„ | "๊ฒฐ์ œ ๊ด€๋ จ", "ํ•ด์™ธ์ˆ™์†Œ ๋ฆฌ์„œ์น˜" |
| ๊ธฐ๊ฐ„๋ณ„ | "2024๋…„ ์ž๋ฃŒ", "์ตœ๊ทผ ์—ฐ๊ตฌ" |
| ๋งฅ๋ฝ ๊ธฐ๋ฐ˜ | "๊ทธ ์ค‘์—์„œ ์‚ฌ๋‚ด ๋ฆฌ์„œ์น˜๋งŒ ๋ณด์—ฌ์ค˜" (์ด์ „ ๋Œ€ํ™” ๊ธฐ์–ต) |
---
# 6. ์Šฌ๋ž™ ์‚ฌ์šฉ ๋ฐฉ๋ฒ•
## 6.1 ์ฑ„๋„์—์„œ ์‚ฌ์šฉ
๋ด‡์„ ๋ฉ˜์…˜ํ•˜์—ฌ ์งˆ๋ฌธํ•ฉ๋‹ˆ๋‹ค:
```
@Insight Repository ๊ฒฐ์ œ ์ดํƒˆ ๊ด€๋ จ ์‚ฌ๋‚ด ๋ฆฌ์„œ์น˜ ์žˆ์–ด?
```
## 6.2 DM์œผ๋กœ ์‚ฌ์šฉ
๋ด‡์—๊ฒŒ ์ง์ ‘ ๋ฉ”์‹œ์ง€๋ฅผ ๋ณด๋ƒ…๋‹ˆ๋‹ค (๋ฉ˜์…˜ ๋ถˆํ•„์š”):
```
๊ฒฐ์ œ ์ดํƒˆ ๊ด€๋ จ ์‚ฌ๋‚ด ๋ฆฌ์„œ์น˜ ์žˆ์–ด?
```
## 6.3 ์ด๋ฏธ์ง€/ํŒŒ์ผ ๋ถ„์„
ํŒŒ์ผ์„ ์ฒจ๋ถ€ํ•˜๊ณ  ์งˆ๋ฌธ์„ ํ•จ๊ป˜ ์ž…๋ ฅํ•ฉ๋‹ˆ๋‹ค:
```
[checkout_screen.png ์ฒจ๋ถ€]
์ด ๊ฒฐ์ œ ํ™”๋ฉด์—์„œ UX ๋ฌธ์ œ์ ์„ ๋ถ„์„ํ•ด์ค˜
```
**์ง€์› ํŒŒ์ผ:** PNG, JPG, JPEG, MP4, MOV, PDF, DOCX
## 6.4 ์Šค๋ ˆ๋“œ ๋Œ€ํ™”
์Šค๋ ˆ๋“œ ๋‚ด์—์„œ ํ›„์† ์งˆ๋ฌธ์„ ์ด์–ด๊ฐˆ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ๋ด‡์€ ์ตœ๊ทผ 6๊ฐœ ๋ฉ”์‹œ์ง€๋ฅผ ๊ธฐ์–ตํ•ฉ๋‹ˆ๋‹ค:
```
์œ ์ €: ์ดํƒˆ ๊ด€๋ จ ๋ฆฌ์„œ์น˜ ์ฐพ์•„์ค˜
๋ด‡: [๊ฒ€์ƒ‰ ๊ฒฐ๊ณผ + ๊ต์ฐจ ๋ถ„์„]
์œ ์ €: ๊ทธ ์ค‘์—์„œ Baymard ๊ฐ€์ด๋“œ๋ผ์ธ๋งŒ ๋ณด์—ฌ์ค˜ โ† ๋งฅ๋ฝ ์œ ์ง€
๋ด‡: [Baymard ๊ฒฐ๊ณผ๋งŒ ํ•„ํ„ฐ๋ง]
์œ ์ €: ์ด๊ฑธ ๋ฐ”ํƒ•์œผ๋กœ ๊ฐœ์„  ์ „๋žต ์ œ์•ˆํ•ด์ค˜ โ† ADVISORY๋กœ ์ „ํ™˜
๋ด‡: [์ „๋žต์  ์ž๋ฌธ ์‘๋‹ต]
```
---
# 7. ์‘๋‹ต ๊ตฌ์กฐ
## 7.1 Confirmation ๋ฉ”์‹œ์ง€ (๊ฒ€์ƒ‰ํ˜• ์งˆ๋ฌธ)
๊ฒ€์ƒ‰ํ˜• ์ธํ…ํŠธ(SIMPLE_SEARCH, DEEP_RESEARCH, ADVISORY)์˜ ๊ฒฝ์šฐ, ๋จผ์ € ํ™•์ธ ๋ฉ”์‹œ์ง€๊ฐ€ ํ‘œ์‹œ๋ฉ๋‹ˆ๋‹ค:
```
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚ ๐Ÿ” ์งˆ๋ฌธ์„ ๋ถ„์„ํ–ˆ์–ด์š”: โ”‚
โ”‚ > ๋ถ„์„ ์ด์œ  (reason) โ”‚
โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
โ”‚ ๐Ÿ“‹ ๊ฒ€์ƒ‰ ํ‚ค์›Œ๋“œ: keyword1, keyword2... โ”‚
โ”‚ ๐Ÿ’ก ์ถ”์ฒœ ๊ฒ€์ƒ‰ ๋ฐฉ์‹: ์ „๋žต ์ž๋ฌธ โ”‚
โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
โ”‚ [๊ฐ„๋‹จ ๊ฒ€์ƒ‰] [์‹ฌ์ธต ๋ถ„์„] [โœ… ์ „๋žต ์ž๋ฌธ] โ”‚
โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
โ”‚ โฑ๏ธ 2๋ถ„ ๋‚ด ์„ ํƒ์ด ์—†์œผ๋ฉด ์ถ”์ฒœ ๋ฐฉ์‹์œผ๋กœ โ”‚
โ”‚ ์ž๋™ ์ง„ํ–‰ํ•ฉ๋‹ˆ๋‹ค. โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
```
## 7.2 ๋‹ต๋ณ€ ๋ฉ”์‹œ์ง€
์œ ์ €๊ฐ€ ์ „๋žต์„ ์„ ํƒํ•˜๋ฉด (๋˜๋Š” ํƒ€์ž„์•„์›ƒ ์‹œ), ์Šฌ๋ž™ ์‘๋‹ต์€ ๋‹ค์Œ๊ณผ ๊ฐ™์€ ๊ตฌ์กฐ๋กœ ์ œ๊ณต๋ฉ๋‹ˆ๋‹ค:
```
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚ ๐Ÿ“ ๋‹ต๋ณ€ (ํ†ค ์ ์‘) โ”‚
โ”‚ ํ•ต์‹ฌ ์ธ์‚ฌ์ดํŠธ ์š”์•ฝ โ”‚
โ”‚ ... โ”‚
โ”‚ ๐Ÿ” ๊ต์ฐจ ๋ถ„์„: ์‚ฌ๋‚ด vs ๊ธ€๋กœ๋ฒŒ ํ‘œ์ค€ ๋น„๊ต โ”‚
โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
โ”‚ ๐Ÿ“‚ ์‚ฌ๋‚ด ๋ฆฌ์„œ์น˜ ๊ฒฐ๊ณผ โ”‚
โ”‚ *์ œ๋ชฉ* (๋‚ ์งœ) โ”‚
โ”‚ โ€ข ์š”์•ฝ: ... โ”‚
โ”‚ โ€ข ๋งํฌ: ์ž์„ธํžˆ ๋ณด๊ธฐ โ”‚
โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
โ”‚ ๐Ÿ“– Baymard ๊ฐ€์ด๋“œ๋ผ์ธ โ”‚
โ”‚ *์ œ๋ชฉ* โ”‚
โ”‚ โ€ข ์š”์•ฝ: ... โ”‚
โ”‚ โ€ข ๋งํฌ: ์ž์„ธํžˆ ๋ณด๊ธฐ โ”‚
โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
โ”‚ ๐ŸŒ NN/g ์•„ํ‹ฐํด โ”‚
โ”‚ *์ œ๋ชฉ* (๋‚ ์งœ) โ”‚
โ”‚ โ€ข ์š”์•ฝ: ... โ”‚
โ”‚ โ€ข ๋งํฌ: ์ž์„ธํžˆ ๋ณด๊ธฐ โ”‚
โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค
โ”‚ ๐Ÿ’ก ์ด๋Ÿฐ ๊ฒƒ๋„ ๋ฌผ์–ด๋ณด์„ธ์š”: โ”‚
โ”‚ 1. ํ›„์† ์งˆ๋ฌธ A โ”‚
โ”‚ 2. ํ›„์† ์งˆ๋ฌธ B โ”‚
โ”‚ 3. ํ›„์† ์งˆ๋ฌธ C โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
```
---
# 8. ์‹œ์Šคํ…œ ์‚ฌ์–‘
| ํ•ญ๋ชฉ | ์ˆ˜์น˜ |
| --- | --- |
| ์ธํ…ํŠธ ์ˆ˜ | 6๊ฐœ (SIMPLE_SEARCH, DEEP_RESEARCH, ADVISORY, SPECIFIC_ITEM_ANALYSIS, MULTIMODAL_ANALYSIS, CHAT) |
| LLM ์ฒด์ธ | 8๊ฐœ (simple_search, deep_research, advisory, specific_analysis, chat, query_expansion, confirmation_ask, confirmation_interpret) |
| ํ”„๋กฌํ”„ํŠธ ํ…œํ”Œ๋ฆฟ | 10๊ฐœ |
| ๋ฐ์ดํ„ฐ ์†Œ์Šค | 3๊ฐœ (์‚ฌ๋‚ด 145 + Baymard 520 + NN/g 420 = ์ด 1,085๊ฑด) |
| ์‚ฌ๋‚ด ๊ณ ์œ  ์‹œ๋…ธ๋‹˜ | 10๊ฐœ (๋ฆฌ์„œ์ฒ˜ 6 + ์„œ๋น„์Šค ์•ฝ์–ด 4) |
| ๋Œ€ํ™” ์ปจํ…์ŠคํŠธ | ์ตœ๊ทผ 6๊ฐœ ๋ฉ”์‹œ์ง€ (์Šค๋ ˆ๋“œ ๊ธฐ๋ฐ˜) |
| Slack ๋ธ”๋ก ์ œํ•œ | ์ตœ๋Œ€ 50 ๋ธ”๋ก/๋ฉ”์‹œ์ง€ |
| ๊ธด ๋ฉ”์‹œ์ง€ ์ฒ˜๋ฆฌ | 3,000์ž ๋‹จ์œ„ ์ž๋™ ๋ถ„ํ•  |
| Confirmation ํƒ€์ž„์•„์›ƒ | 2๋ถ„ (์ž๋™ ์ถ”์ฒœ ์ „๋žต ์‹คํ–‰) |
| ์œ ์ € Preference ์ €์žฅ | Supabase `user_preferences` ํ…Œ์ด๋ธ” |
| ๋ณ‘๋ ฌ ๊ฒ€์ƒ‰ | ThreadPoolExecutor (max_workers=3) |
| Structured Output | Pydantic ๋ชจ๋ธ 2๊ฐœ (QueryExpansionResponse, ConfirmationInterpretResponse) |
| ์ŠคํŠธ๋ฆฌ๋ฐ ์—…๋ฐ์ดํŠธ ๊ฐ„๊ฒฉ | 1.0์ดˆ (STREAM_UPDATE_INTERVAL) |
| ์ŠคํŠธ๋ฆฌ๋ฐ ์ตœ์†Œ ๊ธ€์ž | 20์ž (STREAM_MIN_CHARS) |
---
# 9. ํ”„๋กœ์ ํŠธ ๊ตฌ์กฐ
```
insight-repository/
โ”œโ”€โ”€ slack_bot.py # Slack ์ด๋ฒคํŠธ ํ•ธ๋“ค๋Ÿฌ (์ง„์ž…์ )
โ”œโ”€โ”€ app.py # Streamlit ์›น ์ธํ„ฐํŽ˜์ด์Šค
โ”œโ”€โ”€ run_app.sh # Docker ์‹คํ–‰ ์Šคํฌ๋ฆฝํŠธ
โ”œโ”€โ”€ Dockerfile # HF Spaces ๋ฐฐํฌ ์„ค์ •
โ”œโ”€โ”€ requirements.txt # Python ์˜์กด์„ฑ
โ”‚
โ”œโ”€โ”€ src/engine/
โ”‚ โ”œโ”€โ”€ search_engine.py # ๋ฉ”์ธ ์˜ค์ผ€์ŠคํŠธ๋ ˆ์ดํ„ฐ (8 ์ฒด์ธ + 6 ํ•ธ๋“ค๋Ÿฌ + Confirmation UX + Streaming)
โ”‚ โ”œโ”€โ”€ router.py # ์ธํ…ํŠธ ๋ถ„๋ฅ˜ (6๊ฐœ ์ธํ…ํŠธ + ๋ธ”๋ Œ๋”ฉ)
โ”‚ โ”œโ”€โ”€ retriever.py # Fuzzy ๊ฒ€์ƒ‰ + Agentic Retriever ๋„๊ตฌ
โ”‚ โ”œโ”€โ”€ prompt_manager.py # ํ”„๋กฌํ”„ํŠธ ๋กœ๋” (10๊ฐœ ํ…œํ”Œ๋ฆฟ)
โ”‚ โ”œโ”€โ”€ document_processor.py # ํŒŒ์ผ ์ฒ˜๋ฆฌ (์ด๋ฏธ์ง€/PDF/DOCX)
โ”‚ โ”œโ”€โ”€ data_loader.py # ๋ฐ์ดํ„ฐ ์†Œ์Šค ๋กœ๋”
โ”‚ โ”‚
โ”‚ โ””โ”€โ”€ prompts/
โ”‚ โ”œโ”€โ”€ intent_router.md # ์ธํ…ํŠธ ๋ถ„๋ฅ˜ ๊ทœ์น™
โ”‚ โ”œโ”€โ”€ query_expansion.md # LLM ์ฟผ๋ฆฌ ํ™•์žฅ
โ”‚ โ”œโ”€โ”€ simple_search.md # ๋‹จ์ˆœ ๊ฒ€์ƒ‰ ๋‹ต๋ณ€
โ”‚ โ”œโ”€โ”€ deep_research.md # ์‹ฌ์ธต ๋ถ„์„ ๋‹ต๋ณ€
โ”‚ โ”œโ”€โ”€ advisory.md # ์ „๋žต์  ์ž๋ฌธ ๋‹ต๋ณ€
โ”‚ โ”œโ”€โ”€ specific_analysis.md # ํŠน์ • ๋ฌธ์„œ ๋ถ„์„
โ”‚ โ”œโ”€โ”€ multimodal_analysis.md # ์ด๋ฏธ์ง€/์˜์ƒ ๋ถ„์„
โ”‚ โ”œโ”€โ”€ chat.md # ์ผ์ƒ ๋Œ€ํ™”
โ”‚ โ”œโ”€โ”€ formatting_slack.md # Slack JSON ์Šคํ‚ค๋งˆ
โ”‚ โ””โ”€โ”€ formatting_web.md # Web ๋งˆํฌ๋‹ค์šด ๊ทœ์น™
โ”‚
โ””โ”€โ”€ data/
โ”œโ”€โ”€ research_report.json # ์‚ฌ๋‚ด ๋ฆฌ์„œ์น˜ ๋ฉ”ํƒ€๋ฐ์ดํ„ฐ (145๊ฑด)
โ”œโ”€โ”€ baymard_unified_database_v2.json # Baymard ๊ฐ€์ด๋“œ๋ผ์ธ (520๊ฑด)
โ”œโ”€โ”€ nng_articles.json # NN/g ์•„ํ‹ฐํด (420๊ฑด)
โ”œโ”€โ”€ research_pages/ # ์‚ฌ๋‚ด ๋ฆฌ์„œ์น˜ ๋ณธ๋ฌธ (๋งˆํฌ๋‹ค์šด 191๊ฐœ)
โ”œโ”€โ”€ pdfs/ # Baymard PDF
โ””โ”€โ”€ nngroup_pdf/ # NN/g PDF
```
---
# 10. ๋ฒ„์ „ ํžˆ์Šคํ† ๋ฆฌ
| ๋ฒ„์ „ | ๋‚ ์งœ | ์ฃผ์š” ๋ณ€๊ฒฝ |
| --- | --- | --- |
| **v2.2** | 2026-02-15 | LangChain ์ตœ์ ํ™” โ€” ๋ณ‘๋ ฌ 3์†Œ์Šค ๊ฒ€์ƒ‰ (ThreadPoolExecutor, ~1.5sโ†’~0.5s) ยท Structured Output (Pydantic ๋ชจ๋ธ, ์œ ํ‹ธ๋ฆฌํ‹ฐ ์ฒด์ธ JSON ํŒŒ์‹ฑ ์ œ๊ฑฐ) ยท ์‹ค์‹œ๊ฐ„ ์ŠคํŠธ๋ฆฌ๋ฐ ์‘๋‹ต (placeholderโ†’๋ฏธ๋ฆฌ๋ณด๊ธฐโ†’Block Kit) |
| **v2.1** | 2026-02-15 | Confirmation UX ๋„์ž… โ€” ๊ฒ€์ƒ‰ ์ „ ์ „๋žต ํ™•์ธ ๋‹จ๊ณ„ (๊ฐ„๋‹จ ๊ฒ€์ƒ‰/์‹ฌ์ธต ๋ถ„์„/์ „๋žต ์ž๋ฌธ ์„ ํƒ) ยท 2๋ถ„ ํƒ€์ž„์•„์›ƒ ์ž๋™ ์ง„ํ–‰ ยท ์œ ์ €๋ณ„ Preference ์ €์žฅ (Supabase `user_preferences`) ยท `routing_only()` ๋ถ„๋ฆฌ๋กœ ๋ผ์šฐํŒ…-์‹คํ–‰ 2๋‹จ๊ณ„ ์•„ํ‚คํ…์ฒ˜ |
| **v2.0** | 2026-02-14 | ADVISORY ์ธํ…ํŠธ ์ถ”๊ฐ€ (์ „๋žต์  ์ž๋ฌธ) ยท ์ธํ…ํŠธ ๋ธ”๋ Œ๋”ฉ (confidence + secondary_intent) ยท ๊ต์ฐจ ๋ถ„์„ (Proactive Cross-Reference) ๋„์ž… ยท LLM ๊ธฐ๋ฐ˜ ์ฟผ๋ฆฌ ํ™•์žฅ (ํ•˜๋“œ์ฝ”๋”ฉ ์‹œ๋…ธ๋‹˜ ๋Œ€์ฒด) ยท ํ†ค ์ ์‘ (Conversational UX) ยท ํ›„์† ์งˆ๋ฌธ ์ถ”์ฒœ ๊ธฐ๋Šฅ ยท ์†Œ์Šค๋ณ„ ๊ตฌ์กฐํ™”๋œ ์ปจํ…์ŠคํŠธ ์ „๋‹ฌ |
| **v1.0** | 2026-01-30 | ์ดˆ๊ธฐ ๋ฆด๋ฆฌ์ฆˆ โ€” 5๊ฐœ ์ธํ…ํŠธ, 3-Source ํ•˜์ด๋ธŒ๋ฆฌ๋“œ ๊ฒ€์ƒ‰, Slack/Web ์ง€์› |