File size: 26,434 Bytes
501bc8c
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
# 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 ์ง€์› |