|
Download docs/program_introduction.md from YGCXLab/ux-research-agent-slackbot: direct link, hf CLI and curl.
- Browser
- Download file 26.4 kB
-
https://huggingface.co/spaces/YGCXLab/ux-research-agent-slackbot/resolve/main/docs/program_introduction.md
- Command line
-
hf download hf://spaces/YGCXLab/ux-research-agent-slackbot/docs/program_introduction.md
-
curl -L -o program_introduction.md https://huggingface.co/spaces/YGCXLab/ux-research-agent-slackbot/resolve/main/docs/program_introduction.md
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 ์ง์ | | |