Skip to content
ace19-devPublic

About

Agentic AI that parses natural-language grocery requests and finds the optimal shopping cart across multiple e-commerce malls (Phase 1: purchase links)

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

ย 

History

24 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

SmartCart Agent ๐Ÿ›’๐Ÿค–

๐Ÿ‡บ๐Ÿ‡ธ English version

AI ๊ธฐ๋ฐ˜ ์ง€๋Šฅํ˜• ์žฅ๋ณด๊ธฐ ๋Œ€ํ–‰ ์—์ด์ „ํŠธ ์ž์—ฐ์–ด ์žฅ๋ณด๊ธฐ ๋ฆฌ์ŠคํŠธ๋ฅผ ์ž…๋ ฅํ•˜๋ฉด ์ตœ์ €๊ฐ€ ยท ์ตœ๊ณ  ํ‰์  ยท ํฌ๋ง ๋ฐฐ์†ก ์‹œ๊ฐ„์„ ๋ชจ๋‘ ๋งŒ์กฑํ•˜๋Š” ์ตœ์ ์˜ ๊ตฌ๋งค ์กฐํ•ฉ์„ ์ฐพ์•„์ฃผ๊ณ , ๊ฒฐ์ œ ์ง์ „๊นŒ์ง€ ์—ฌ์ •์„ ๋‹จ์ถ•ํ•ด์ฃผ๋Š” ์—์ด์ „ํŠธ ์„œ๋น„์Šค์ž…๋‹ˆ๋‹ค.


1. ๊ฐœ์š”

์‚ฌ์šฉ์ž๊ฐ€ "์‚ผ๊ฒน์‚ด 1kg, ์Œˆ์žฅ, ์ƒ์ถ” ํ•œ ๋ด‰์ง€, ๋‚ด์ผ ์•„์นจ 7์‹œ ์ „ ๋„์ฐฉ, ์˜ˆ์‚ฐ 4๋งŒ์› ์ดํ•˜"์ฒ˜๋Ÿผ ๊ตฌ์–ด์ฒด๋กœ ์ž…๋ ฅํ•œ ์žฅ๋ณด๊ธฐ ๋ฆฌ์ŠคํŠธ๋ฅผ ๋ถ„์„ํ•˜์—ฌ,

  1. ํ•ญ๋ชฉ์„ ์ •ํ˜•ํ™”ํ•˜๊ณ  (๋ธŒ๋žœ๋“œ/์šฉ๋Ÿ‰/์ˆ˜๋Ÿ‰ ์ถ”๋ก , ๋ชจํ˜ธํ•˜๋ฉด ํ™•์ธ ์งˆ๋ฌธ)
  2. ์—ฌ๋Ÿฌ ์ด์ปค๋จธ์Šค(GSํ”„๋ ˆ์‹œ๋ชฐ, ์ด๋งˆํŠธ๋ชฐ, ์ปฌ๋ฆฌ, ๋„ค์ด๋ฒ„ ์‡ผํ•‘ ๋“ฑ)์—์„œ ์‹ค์‹œ๊ฐ„ ๊ฐ€๊ฒฉยทํ‰์ ยท๋ฆฌ๋ทฐ ์ˆ˜/ํŒ๋งค๋Ÿ‰(์ธ๊ธฐ๋„)ยท๋ฐฐ์†ก ๊ฐ€๋Šฅ ์‹œ๊ฐ„์„ ์กฐํšŒํ•˜๊ณ 
  3. ๋ฐฐ์†ก๋น„๋ฅผ ํฌํ•จํ•œ **์ตœ์  ์žฅ๋ฐ”๊ตฌ๋‹ˆ ์กฐํ•ฉ(Optimization Pack)**์„ ๊ณ„์‚ฐํ•˜๊ณ , ์˜ˆ์‚ฐ(๊ทผ์‚ฌ์น˜ ํฌํ•จ)/๋ฐฐ์†ก ์ œ์•ฝ์„ ์Šค์Šค๋กœ ๊ฒ€์ฆํ•˜์—ฌ ๋ฏธ์ถฉ์กฑ ์‹œ ๋งค ๋ผ์šด๋“œ ์‚ฌ์šฉ์ž์—๊ฒŒ ์„ ํƒ์ง€๋ฅผ ๋ฌป๊ณ  ์‘๋‹ต์— ๋”ฐ๋ผ ์žฌ๊ณ„ํšํ•˜๋ฉฐ(HITL)
  4. ์‚ฌ์šฉ์ž์—๊ฒŒ ์ œ์•ˆ + ๋Œ€์ฒดํ’ˆ ์˜ต์…˜์„ ์ œ๊ณตํ•˜๊ณ 
  5. [Phase 1] ๊ฐ ์‡ผํ•‘๋ชฐ์˜ ๋”ฅ๋งํฌ/์žฅ๋ฐ”๊ตฌ๋‹ˆ ๋งํฌ๋ฅผ ์ œ๊ณตํ•˜์—ฌ ์‚ฌ์šฉ์ž๊ฐ€ ์ง์ ‘ ๊ฒฐ์ œํ•˜๊ฑฐ๋‚˜, [Phase 2] ์‚ฌ์šฉ์ž ์Šน์ธ์„ ๊ฑฐ์ณ ์ž๋™์œผ๋กœ ๊ฒฐ์ œ๊นŒ์ง€ ์ˆ˜ํ–‰ํ•ฉ๋‹ˆ๋‹ค.

1.1 ์˜ˆ์‹œ ์‹œ๋‚˜๋ฆฌ์˜ค

์‚ฌ์šฉ์ž ์ž…๋ ฅ "์‚ฌ๊ณผ, ๋ฐฐ ๊ณผ์ผ, ์šฐ์œ  2L ์ด์ƒ 1๊ฐœ, ์‹๋นต 2๊ฐœ, ์–ด๋ฆฐ์ด ์š”๊ตฌ๋ฅดํŠธ ์ฐพ์•„์ค˜. ๊ตฌ๋งคํ‰์ด๋‚˜ ๊ตฌ๋งค๊ฐ€ ๋งŽ์€ ๊ณณ์œผ๋กœ ์šฐ์„ ์ ์œผ๋กœ ์ฐพ๊ณ , ์˜ˆ์‚ฐ์€ 4๋งŒ์› ์ •๋„ ์‚ฌ์šฉํ•˜๊ณ , ์ง‘์œผ๋กœ ๋‚ด์ผ ๋ฐ›์•„๋ดค์œผ๋ฉด ์ข‹๊ฒ ์–ด."

์ด ์ž…๋ ฅ์€ ๋‹ค์Œ๊ณผ ๊ฐ™์ด ์ฒ˜๋ฆฌ๋ฉ๋‹ˆ๋‹ค.

  1. Parser โ€” 5๊ฐœ ํ’ˆ๋ชฉ(์‚ฌ๊ณผ, ๋ฐฐ, ์šฐ์œ โ‰ฅ2Lร—1, ์‹๋นตร—2, ์–ด๋ฆฐ์ด ์š”๊ตฌ๋ฅดํŠธ)์„ ์ •ํ˜•ํ™”ํ•˜๊ณ , ์ •๋ ฌ ์šฐ์„ ์ˆœ์œ„๋ฅผ popularity(๋ฆฌ๋ทฐ ์ˆ˜/ํŒ๋งค๋Ÿ‰)๋กœ, ์˜ˆ์‚ฐ์„ **๊ทผ์‚ฌ์น˜(soft budget, โ‰ˆ40,000์›)**๋กœ, ๋ฐฐ์†ก ์กฐ๊ฑด์„ "๋‚ด์ผ ์ง‘ ์ฃผ์†Œ๋กœ ๋„์ฐฉ"(์‹œ๊ฐ„ ๋ฏธ์ง€์ •)์œผ๋กœ ์ถ”์ถœ
  2. Search Agent โ€” ๊ฐ ํ’ˆ๋ชฉ๋ณ„๋กœ ํ›„๋ณด ์ƒํ’ˆ์„ ์กฐํšŒํ•˜๊ณ  ๋ฆฌ๋ทฐ ์ˆ˜ยทํŒ๋งค๋Ÿ‰(๋ฒ ์ŠคํŠธ ์ˆœ์œ„) ๊ธฐ์ค€์œผ๋กœ 1์ฐจ ์ •๋ ฌ
  3. Optimizer โ€” ๋ฐฐ์†ก๋น„ ํฌํ•จ ์ด์•ก์ด ์˜ˆ์‚ฐ ๊ทผ์‚ฌ์น˜(ยฑํ—ˆ์šฉ์˜ค์ฐจ) ๋‚ด์—์„œ, ์ธ๊ธฐ๋„ ์šฐ์„  + ํ‰์ /๊ฐ€๊ฒฉ์„ ๋ณด์กฐ ๊ธฐ์ค€์œผ๋กœ ์ตœ์  ์กฐํ•ฉ ์‚ฐ์ถœ
  4. Reflection โ€” ์˜ˆ์‚ฐ ์ดˆ๊ณผ/๋ฐฐ์†ก ๋ถˆ๊ฐ€/ํ’ˆ์ ˆ ํ•ญ๋ชฉ์ด ์žˆ์œผ๋ฉด, ๊ฒ€์ฆ๋œ ์„ ํƒ์ง€(์šฉ๋Ÿ‰ ๋ฌถ์Œ๊ตฌ๋งคยท์กฐ๊ฑด์™„ํ™”ยทํ’ˆ๋ชฉ์ œ์™ธ โ€” ์ฝ”๋“œ๊ฐ€ ๊ณ„์‚ฐ)์™€ LLM์ด ์ œ์•ˆํ•œ ์„ ํƒ์ง€(์˜ˆ์‚ฐ/๋ฐฐ์†ก์ผ ์กฐ์ •ยท๋ชฐ ์ œ์™ธ)๋ฅผ ํ•จ๊ป˜ ์‚ฌ์šฉ์ž์—๊ฒŒ ์ œ์‹œ(HITL)ํ•˜๊ณ , ์„ ํƒ์— ๋”ฐ๋ผ ์žฌ๊ฒ€์ƒ‰ โ€” ๋งŒ์กฑํ•  ๋•Œ๊นŒ์ง€ ๋˜๋Š” ์ตœ๋Œ€ max_replan_attemptsํšŒ๊นŒ์ง€ ๋ผ์šด๋“œ ๋ฐ˜๋ณต
  5. ์ถœ๋ ฅ (Phase 1) โ€” ํ’ˆ๋ชฉ๋ณ„ ์ถ”์ฒœ ์ƒํ’ˆ + ๊ตฌ๋งค ๋งํฌ(๋”ฅ๋งํฌ) ๋ฆฌ์ŠคํŠธ, ์ด์•ก/์˜ˆ์‚ฐ ์ถฉ์กฑ ์—ฌ๋ถ€, ๊ทธ๋ฆฌ๊ณ  **์‚ฌ์šฉ์ž๊ฐ€ ๊ฐ ๋ผ์šด๋“œ์—์„œ ์„ ํƒํ•œ ์กฐ์ • ๋‚ด์—ญ(์›๋ž˜ ์กฐ๊ฑด, ์„ ํƒํ•œ ๋Œ€์•ˆ, ์‚ฌ์œ )**์„ ํ•จ๊ป˜ ์ œ์‹œ
  6. ์ถœ๋ ฅ (Phase 2, ํ–ฅํ›„) โ€” ์‚ฌ์šฉ์ž๊ฐ€ "์ด๋Œ€๋กœ ๊ตฌ๋งคํ•ด์ค˜"๋ผ๊ณ  ํ™•์ธํ•˜๋ฉด, Purchase Execution Agent๊ฐ€ ๊ฐ ์‡ผํ•‘๋ชฐ ์žฅ๋ฐ”๊ตฌ๋‹ˆ์— ๋‹ด๊ณ  ๊ฒฐ์ œ๋ฅผ ๋Œ€ํ–‰ ์ˆ˜ํ–‰

2. ํ•ต์‹ฌ ๊ธฐ๋Šฅ

๐Ÿ”น 1๋‹จ๊ณ„ โ€” ์ง€๋Šฅํ˜• ์•„์ดํ…œ ๋งค์นญ ๋ฐ ์ตœ์ ํ™”

  • ์ž์—ฐ์–ด ํŒŒ์‹ฑ: "๋Œ€ํŒจ์‚ผ๊ฒน์‚ด ๋Œ€์šฉ๋Ÿ‰, ํํ" โ†’ ๋ธŒ๋žœ๋“œ/์šฉ๋Ÿ‰/์ˆ˜๋Ÿ‰์„ ์ถ”๋ก ํ•ด ์ •ํ˜• ๋ฐ์ดํ„ฐ๋กœ ๋ณ€ํ™˜
  • ๋ชจํ˜ธ์„ฑ ํ•ด์†Œ: ํŒŒ์‹ฑ ์‹ ๋ขฐ๋„๊ฐ€ ๋‚ฎ์€ ํ•ญ๋ชฉ(์˜ˆ: "ํํ" โ†’ ์„ธ์ œ ๋ธŒ๋žœ๋“œ/์šฉ๋Ÿ‰ ๋‹ค์ˆ˜ ์กด์žฌ)์€ ์‚ฌ์šฉ์ž์—๊ฒŒ ์งง์€ ํ™•์ธ ์งˆ๋ฌธ์„ ๋˜์ง€๊ฑฐ๋‚˜, ๊ฐ€์žฅ ๊ฐ€๋Šฅ์„ฑ ๋†’์€ ํ›„๋ณด + ๊ทผ๊ฑฐ๋ฅผ ํ•จ๊ป˜ ์ œ์‹œ
  • ๋‹ค์ค‘ ์กฐ๊ฑด ๊ฒ€์ƒ‰: ๊ฐ€๊ฒฉ + ํ‰์ (์˜ˆ: 4.5/5.0 ์ด์ƒ) + ๋ฆฌ๋ทฐ ์ˆ˜/ํŒ๋งค๋Ÿ‰(์ธ๊ธฐ๋„) ๊ธฐ์ค€์œผ๋กœ ์—ฌ๋Ÿฌ ์‡ผํ•‘๋ชฐ ๋น„๊ต
  • ์ •๋ ฌ ์šฐ์„ ์ˆœ์œ„ ์ปค์Šคํ„ฐ๋งˆ์ด์ฆˆ: "๊ตฌ๋งคํ‰์ด๋‚˜ ๊ตฌ๋งค๊ฐ€ ๋งŽ์€ ๊ณณ" ๊ฐ™์€ ์š”์ฒญ์€ popularity(๋ฆฌ๋ทฐ ์ˆ˜ยทํŒ๋งค๋Ÿ‰ยท๋ฒ ์ŠคํŠธ ์ˆœ์œ„)๋ฅผ 1์ˆœ์œ„ ์ •๋ ฌ ๊ธฐ์ค€์œผ๋กœ ์‚ฌ์šฉํ•˜๊ณ , ๋™์ผ ์ธ๊ธฐ๋„์ผ ๊ฒฝ์šฐ ํ‰์ ยท๊ฐ€๊ฒฉ์„ ๋ณด์กฐ ๊ธฐ์ค€์œผ๋กœ ์‚ฌ์šฉ
  • ์ตœ์  ์กฐํ•ฉ ์ƒ์„ฑ: ๋ฐฐ์†ก๋น„๋ฅผ ํฌํ•จํ•œ ์ด์•ก์ด (๊ทผ์‚ฌ) ์˜ˆ์‚ฐ ๋‚ด์—์„œ ์ •๋ ฌ ์šฐ์„ ์ˆœ์œ„(์ธ๊ธฐ๋„/ํ‰์ /๊ฐ€๊ฒฉ)๋ฅผ ๋งŒ์กฑํ•˜๋Š” ์‡ผํ•‘๋ชฐ ์กฐํ•ฉ + ์ง์ ‘ ๊ตฌ๋งค ๋งํฌ ์ œ๊ณต

๐Ÿ”น 2๋‹จ๊ณ„ โ€” ์œ ์—ฐํ•œ ๋Œ€์ฒดํ’ˆ ์ถ”์ฒœ (Alternative Engine)

  • ์›ํด๋ฆญ ๊ต์ฒด: ์ถ”์ฒœ ์ƒํ’ˆ์ด ๋งˆ์Œ์— ๋“ค์ง€ ์•Š์œผ๋ฉด ์ฐจ์ˆœ์œ„ ์ตœ์ €๊ฐ€/ํƒ€ ๋ธŒ๋žœ๋“œ ๋™์ผ ์นดํ…Œ๊ณ ๋ฆฌ ์ƒํ’ˆ ์ฆ‰์‹œ ์ถ”์ฒœ
  • ์กฐ๊ฑด๋ณ„ ํ•„ํ„ฐ: '๋” ์ €๋ ดํ•œ ์ƒํ’ˆ', 'ํ‰์  ๋” ๋†’์€ ์ƒํ’ˆ', '์œ ๊ธฐ๋†/์นœํ™˜๊ฒฝ' ๋“ฑ ์„ ํ˜ธ๋„ ๊ธฐ๋ฐ˜ ์ •๋ ฌ
  • ํ’ˆ์ ˆ/๋ฏธ์กด์žฌ ์ƒํ’ˆ ์ž๋™ ๋Œ€์‘: ์š”์ฒญํ•œ ์ƒํ’ˆ์ด ๊ฒ€์ƒ‰ ๊ฒฐ๊ณผ์— ์—†๊ฑฐ๋‚˜ ํ’ˆ์ ˆ์ธ ๊ฒฝ์šฐ, ์‚ฌ์šฉ์ž์—๊ฒŒ ์•Œ๋ฆฌ๋Š” ๋™์‹œ์—
    • ๋™์ผ ์นดํ…Œ๊ณ ๋ฆฌ ๋‚ด ์œ ์‚ฌ ์ƒํ’ˆ(๋ธŒ๋žœ๋“œ/์šฉ๋Ÿ‰ ์ฐจ์ด)์„ ์ž๋™์œผ๋กœ ์žฌ๊ฒ€์ƒ‰
    • ๋‹ค๋ฅธ ์‡ผํ•‘๋ชฐ์—์„œ์˜ ์žฌ๊ณ  ์—ฌ๋ถ€๋ฅผ ํ•จ๊ป˜ ์กฐํšŒ
    • "์š”์ฒญํ•˜์‹  OOO์€(๋Š”) ํ˜„์žฌ ํ’ˆ์ ˆ์ž…๋‹ˆ๋‹ค. ๋Œ€์‹  โ–ณโ–ณโ–ณ(๋ธŒ๋žœ๋“œ/์šฉ๋Ÿ‰ ์ฐจ์ด)์„(๋ฅผ) ์ถ”์ฒœ๋“œ๋ฆฝ๋‹ˆ๋‹ค" ํ˜•ํƒœ๋กœ ๋Œ€์ฒดํ’ˆ์„ ์ œ์•ˆ

๐Ÿ”น 3๋‹จ๊ณ„ โ€” ์˜ˆ์‚ฐ ๋ฐ ๋ฐฐ์†ก ์‹œ๊ฐ„ ๋™์‹œ ๋งŒ์กฑ (Budget & Delivery Routing)

  • ์˜ˆ์‚ฐ ๊ฐ€๋“œ๋ ˆ์ผ: ์„ค์ •๋œ ์˜ˆ์‚ฐ์„ ์ดˆ๊ณผํ•˜์ง€ ์•Š๋„๋ก ์šฉ๋Ÿ‰ ์กฐ์ ˆ ๋˜๋Š” ๊ฐ€์„ฑ๋น„ ๋ธŒ๋žœ๋“œ๋กœ ์ž๋™ ์ „ํ™˜ ์ œ์•ˆ
  • ๊ทผ์‚ฌ ์˜ˆ์‚ฐ(Soft Budget) ์ฒ˜๋ฆฌ: "4๋งŒ์› ์ •๋„"์ฒ˜๋Ÿผ ๋ช…ํ™•ํ•œ ์ƒํ•œ์ด ์•„๋‹Œ ๊ฒฝ์šฐ, ๊ธฐ์ค€ ์˜ˆ์‚ฐ์˜ ยฑ10% ํ—ˆ์šฉ ์˜ค์ฐจ ๋‚ด์—์„œ ์ธ๊ธฐ๋„/ํ‰์  ์šฐ์„ ์ˆœ์œ„๋ฅผ ์šฐ์„  ๋งŒ์กฑํ•˜๋Š” ์กฐํ•ฉ์„ ํƒ์ƒ‰ํ•˜๊ณ , ํ—ˆ์šฉ ์˜ค์ฐจ๋ฅผ ๋ฒ—์–ด๋‚˜๋ฉด ์‚ฌ์šฉ์ž์—๊ฒŒ ์ดˆ๊ณผ๋ถ„๊ณผ ์‚ฌ์œ ๋ฅผ ํ•จ๊ป˜ ์•ˆ๋‚ด
  • ๋ฐฐ์†ก ํƒ€์ž„๋ผ์ธ ๋งค์นญ: ํฌ๋ง ๋„์ฐฉ ์‹œ๊ฐ„(์˜ˆ: "๋‚ด์ผ ์•„์นจ 7์‹œ ์ „") ๋˜๋Š” "๋‚ด์ผ๊นŒ์ง€ ์ง‘์œผ๋กœ"์ฒ˜๋Ÿผ ๋‚ ์งœ ๋‹จ์œ„ ์กฐ๊ฑด์„ ๋งŒ์กฑํ•˜๋Š” ์‡ผํ•‘๋ชฐ(GSํ”„๋ ˆ์‹œ, ์“ฑ๋ฐฐ์†ก, ์ปฌ๋ฆฌ ๋“ฑ)๋งŒ ํ•„ํ„ฐ๋ง

๐Ÿ”น 4๋‹จ๊ณ„ โ€” ๊ตฌ๋งค ๋งํฌ ์ œ๊ณต ๋ฐ ์ž๋™ ๊ตฌ๋งค (Output & Checkout)

  • [Phase 1] ๊ตฌ๋งค ๋งํฌ ์ œ๊ณต: ์ตœ์  ์กฐํ•ฉ์ด ํ™•์ •๋˜๋ฉด ํ’ˆ๋ชฉ๋ณ„ ์‡ผํ•‘๋ชฐ ๋”ฅ๋งํฌ/์žฅ๋ฐ”๊ตฌ๋‹ˆ URL์„ ์ •๋ฆฌํ•ด ์‚ฌ์šฉ์ž์—๊ฒŒ ์ „๋‹ฌ. ์‚ฌ์šฉ์ž๊ฐ€ ์ง์ ‘ ํด๋ฆญํ•˜์—ฌ ๊ฒฐ์ œ
  • [Phase 2] ์ž๋™ ๊ตฌ๋งค ์‹คํ–‰: ์‚ฌ์šฉ์ž๊ฐ€ ์ตœ์ข… ์Šน์ธํ•˜๋ฉด Purchase Execution Agent๊ฐ€ ๊ฐ ์‡ผํ•‘๋ชฐ์— ๋กœ๊ทธ์ธ๋œ ์„ธ์…˜์œผ๋กœ ์žฅ๋ฐ”๊ตฌ๋‹ˆ์— ๋‹ด๊ณ  ๊ฒฐ์ œ๊นŒ์ง€ ๋Œ€ํ–‰. ๊ฒฐ์ œ ์ง์ „ ๋‹จ๊ณ„๋Š” ํ•ญ์ƒ Human-in-the-loop ์Šน์ธ์„ ๊ฑฐ์น˜๋ฉฐ, ์ „์ฒด ๊ณผ์ •์€ ๊ฐ์‚ฌ ๋กœ๊ทธ(Audit Log)๋กœ ๊ธฐ๋ก

3. ์‹œ์Šคํ…œ ์•„ํ‚คํ…์ฒ˜

3.0 ํ•œ๋ˆˆ์— ๋ณด๋Š” ์•„ํ‚คํ…์ฒ˜ (Simple View)

์•„๋ž˜๋Š” ๋น„๊ฐœ๋ฐœ์ž๋„ ์‰ฝ๊ฒŒ ์ดํ•ดํ•  ์ˆ˜ ์žˆ๋„๋ก ํ•ต์‹ฌ ํ๋ฆ„๋งŒ ๋‹จ์ˆœํ™”ํ•œ ๊ทธ๋ฆผ์ž…๋‹ˆ๋‹ค. ์ƒ์„ธํ•œ ๋ชจ๋“ˆ/์—ฐ๊ฒฐ ๊ตฌ์กฐ๋Š” 3.1~3.2์˜ ๋‹ค์ด์–ด๊ทธ๋žจ์„ ์ฐธ๊ณ ํ•˜์„ธ์š”.

์ „์ฒด ๊ตฌ์กฐ (Simple)

์ „์ฒด ๊ตฌ์กฐ (Simple)

Mermaid ์†Œ์Šค ๋ณด๊ธฐ (์ˆ˜์ • ์‹œ docs/diagrams/src/01-overview-simple.mmd๋„ ํ•จ๊ป˜ ์ˆ˜์ • ํ›„ ์ด๋ฏธ์ง€ ์žฌ์ƒ์„ฑ)
flowchart LR
    User(("๐Ÿ™‹ ์‚ฌ์šฉ์ž"))
    Agent["๐Ÿค– SmartCart Agent<br/>(๋ถ„์„ โ†’ ๊ฒ€์ƒ‰ โ†’ ์ตœ์ ํ™” โ†’ ๊ฒ€์ฆ)"]
    Malls[("๐Ÿฌ ์‡ผํ•‘๋ชฐ๋“ค<br/>GSํ”„๋ ˆ์‹œ๋ชฐ ยท ์ด๋งˆํŠธ ยท ์ปฌ๋ฆฌ ยท ๋„ค์ด๋ฒ„")]
    Result["๐Ÿ”— ๊ฒฐ๊ณผ<br/>ํ’ˆ๋ชฉ๋ณ„ ๊ตฌ๋งค ๋งํฌ + ๊ฐ€๊ฒฉ/์‚ฌ์œ  ์•ˆ๋‚ด"]
    Checkout(["๐Ÿ’ณ (Phase 2) ์ž๋™ ๊ตฌ๋งค<br/>์‚ฌ์šฉ์ž ์Šน์ธ ํ›„ ์‹คํ–‰"])

    User -- "์ž์—ฐ์–ด ์žฅ๋ณด๊ธฐ ์š”์ฒญ" --> Agent
    Agent -- "๊ฐ€๊ฒฉ/ํ‰์ /๋ฆฌ๋ทฐ์ˆ˜/๋ฐฐ์†ก ์กฐํšŒ" --> Malls
    Malls -- "ํ›„๋ณด ์ƒํ’ˆ" --> Agent
    Agent -- "์ตœ์  ์žฅ๋ฐ”๊ตฌ๋‹ˆ + ๋Œ€์ฒด ์‚ฌ์œ " --> Result
    Result -- "์‚ฌ์šฉ์ž ํ™•์ธ" --> User
    User -. "๊ตฌ๋งค ์Šน์ธ (์„ ํƒ)" .-> Checkout
    Checkout -. "์žฅ๋ฐ”๊ตฌ๋‹ˆ ๋‹ด๊ธฐ + ๊ฒฐ์ œ" .-> Malls
Loading

์ฒ˜๋ฆฌ ํ๋ฆ„ (Simple)

์ฒ˜๋ฆฌ ํ๋ฆ„ (Simple)

Mermaid ์†Œ์Šค ๋ณด๊ธฐ (์ˆ˜์ • ์‹œ docs/diagrams/src/02-pipeline-simple.mmd๋„ ํ•จ๊ป˜ ์ˆ˜์ • ํ›„ ์ด๋ฏธ์ง€ ์žฌ์ƒ์„ฑ)
flowchart TD
    A["1๏ธโƒฃ ์š”์ฒญ ์ž…๋ ฅ<br/>(ํ’ˆ๋ชฉ, ์ •๋ ฌ ์šฐ์„ ์ˆœ์œ„, ์˜ˆ์‚ฐ, ๋ฐฐ์†ก์กฐ๊ฑด)"] --> B["2๏ธโƒฃ ํ•ญ๋ชฉ ์ •ํ˜•ํ™”<br/>(๋ธŒ๋žœ๋“œ/์šฉ๋Ÿ‰/์ˆ˜๋Ÿ‰ ์ถ”๋ก )"]
    B --> C["3๏ธโƒฃ ์‡ผํ•‘๋ชฐ ๊ฒ€์ƒ‰<br/>(๊ฐ€๊ฒฉยทํ‰์ ยท๋ฆฌ๋ทฐ์ˆ˜ยท๋ฐฐ์†ก)"]
    C --> D["4๏ธโƒฃ ์ตœ์  ์กฐํ•ฉ ๊ณ„์‚ฐ<br/>(์ดˆ๊ธฐ ์ •๋ ฌ: ์ธ๊ธฐ๋„ โ†’ ํ‰์  โ†’ ๊ฐ€๊ฒฉ)"]
    D --> E{"5๏ธโƒฃ ์˜ˆ์‚ฐ/๋ฐฐ์†ก<br/>์กฐ๊ฑด ์ถฉ์กฑ?"}
    E -- "์•„๋‹ˆ์˜ค โ†’ ์‚ฌ์šฉ์ž์—๊ฒŒ ์˜ต์…˜ ์งˆ๋ฌธ<br/>(HITL, ๋งค ๋ผ์šด๋“œ)" --> C
    E -- "์˜ˆ" --> F["6๏ธโƒฃ ๊ฒฐ๊ณผ ์ œ์‹œ<br/>๊ตฌ๋งค ๋งํฌ + ๋Œ€์ฒด ์‚ฌ์œ  ์•ˆ๋‚ด"]
    F --> G{"7๏ธโƒฃ ์‚ฌ์šฉ์ž ์Šน์ธ<br/>(Phase 2)"}
    G -- "์ง์ ‘ ๊ฒฐ์ œ" --> H["โœ… Phase 1 ์™„๋ฃŒ"]
    G -- "์ž๋™ ๊ตฌ๋งค ์š”์ฒญ" --> I["๐Ÿค– ์ž๋™ ๊ตฌ๋งค ์‹คํ–‰<br/>(์žฅ๋ฐ”๊ตฌ๋‹ˆ ๋‹ด๊ธฐ โ†’ ๊ฒฐ์ œ)"]
    I --> J["โœ… ๊ตฌ๋งค ์™„๋ฃŒ + ์˜์ˆ˜์ฆ ์•ˆ๋‚ด"]
Loading

3.1 ์ „์ฒด ๊ตฌ์กฐ๋„ (์ƒ์„ธ)

์ „์ฒด ๊ตฌ์กฐ๋„ (์ƒ์„ธ)

Mermaid ์†Œ์Šค ๋ณด๊ธฐ (์ˆ˜์ • ์‹œ docs/diagrams/src/03-architecture-detail.mmd๋„ ํ•จ๊ป˜ ์ˆ˜์ • ํ›„ ์ด๋ฏธ์ง€ ์žฌ์ƒ์„ฑ)
flowchart TB
    subgraph Client["ํด๋ผ์ด์–ธํŠธ (Web / App)"]
        UI[์ฑ„ํŒ…ํ˜• UI<br/>์žฅ๋ฐ”๊ตฌ๋‹ˆ ๊ฒฐ๊ณผ ํ™”๋ฉด]
    end

    subgraph Gateway["API Gateway"]
        GW[FastAPI / BFF]
    end

    subgraph Agent["SmartCart Agent Core"]
        Parser[1. ์š”๊ตฌ์‚ฌํ•ญ ๋ถ„์„<br/>LLM Parser]
        Orchestrator{{"Orchestrator / Planner<br/>(ReAct Loop)"}}
        Search[2. ์‹ค์‹œ๊ฐ„ ์ƒํ’ˆ ๊ฒ€์ƒ‰/ํ•„ํ„ฐ๋ง<br/>๊ฐ€๊ฒฉยทํ‰์ ยท์ธ๊ธฐ๋„]
        Optimizer[3. ์žฅ๋ฐ”๊ตฌ๋‹ˆ ์ตœ์ ํ™” ์—”์ง„<br/>Optimization]
        Reflect{4. ์ œ์•ฝ์กฐ๊ฑด ์ถฉ์กฑ?<br/>Reflection}
        Feedback[5. ํ”ผ๋“œ๋ฐฑ & ๋Œ€์ฒดํ’ˆ ์ฒ˜๋ฆฌ]
        Router[6. ๊ฒฐ์ œ ๋ผ์šฐํŒ…<br/>Deep Link Generator]
        Purchase["7. ์ž๋™ ๊ตฌ๋งค ์‹คํ–‰<br/>Purchase Execution Agent<br/>(Phase 2)"]
        Onboarding["8. Mall Onboarding Agent<br/>(๋ฐ˜์ž๋™ ์–ด๋Œ‘ํ„ฐ ์ƒ์„ฑ, HITL ๋ฆฌ๋ทฐ)"]
    end

    subgraph Tools["Common Tools<br/>(MCP Server)"]
        MallConnector["์‡ผํ•‘๋ชฐ ์ปค๋„ฅํ„ฐ MCP Server<br/>(๋‹จ์ผ ์„œ๋ฒ„ + ๋ชฐ๋ณ„ ์–ด๋Œ‘ํ„ฐ)<br/>GSํ”„๋ ˆ์‹œ๋ชฐ ยท ์ด๋งˆํŠธ ยท ์ปฌ๋ฆฌ ยท ๋„ค์ด๋ฒ„"]
    end

    subgraph Checkout["๊ฒฐ์ œ ์‹คํ–‰ ๊ณ„์ธต (Phase 2)"]
        HITL{{"์‚ฌ์šฉ์ž ์ตœ์ข… ์Šน์ธ<br/>(Human-in-the-loop)"}}
        Vault[(์ž๊ฒฉ์ฆ๋ช…/๊ฒฐ์ œ์ˆ˜๋‹จ<br/>Secrets Vault)]
        AuditLog[(์ฃผ๋ฌธ/๊ฒฐ์ œ ๊ฐ์‚ฌ ๋กœ๊ทธ)]
    end

    subgraph Data["๋ฐ์ดํ„ฐ ๊ณ„์ธต"]
        Cache[(์ƒํ’ˆ/๊ฐ€๊ฒฉ ์บ์‹œ<br/>Redis)]
        DB[(์„ธ์…˜/์žฅ๋ฐ”๊ตฌ๋‹ˆ DB<br/>PostgreSQL)]
        Memory[(์žฅ๊ธฐ ์„ ํ˜ธ๋„ ๋ฉ”๋ชจ๋ฆฌ<br/>์„ ํ˜ธ ๋ธŒ๋žœ๋“œ/์•Œ๋Ÿฌ์ง€/๊ตฌ๋งค์ด๋ ฅ)]
    end

    UI <--> GW
    GW <--> Parser
    Parser --> Orchestrator
    Orchestrator --> Search
    Search -- "MCP Client" --> Tools
    Tools --> Cache
    Search --> Optimizer
    Optimizer --> Reflect
    Reflect -- "๋ฏธ์ถฉ์กฑ โ†’ ์‚ฌ์šฉ์ž์—๊ฒŒ ์˜ต์…˜ ์งˆ๋ฌธ<br/>(HITL, ๋งค ๋ผ์šด๋“œ)" --> Orchestrator
    Reflect -- "์ถฉ์กฑ" --> Feedback
    Feedback <--> GW
    Feedback --> Router
    Router --> GW
    Router -. "Phase 2: ์ž๋™ ๊ตฌ๋งค ์š”์ฒญ" .-> HITL
    HITL -- "์Šน์ธ" --> Purchase
    HITL -- "๊ฑฐ๋ถ€/์ˆ˜์ •" --> Feedback
    Purchase -- "MCP Client" --> Tools
    Purchase <-.์กฐํšŒ.-> Vault
    Purchase --> AuditLog
    Purchase --> GW
    GW --> DB
    Optimizer -.read/write.-> DB
    Orchestrator <-.์กฐํšŒ/๊ฐฑ์‹ .-> Memory
    Onboarding -. "์–ด๋Œ‘ํ„ฐ ์ดˆ์•ˆ<br/>(HITL ๋ฆฌ๋ทฐ ํ›„ ๋จธ์ง€)" .-> Tools
Loading

3.2 ์ฒ˜๋ฆฌ ํŒŒ์ดํ”„๋ผ์ธ (์ƒ์„ธ Sequence)

์ฒ˜๋ฆฌ ํŒŒ์ดํ”„๋ผ์ธ (์ƒ์„ธ Sequence)

Mermaid ์†Œ์Šค ๋ณด๊ธฐ (์ˆ˜์ • ์‹œ docs/diagrams/src/04-sequence-detail.mmd๋„ ํ•จ๊ป˜ ์ˆ˜์ • ํ›„ ์ด๋ฏธ์ง€ ์žฌ์ƒ์„ฑ)
sequenceDiagram
    actor User
    participant UI as ์ฑ„ํŒ… UI
    participant Parser as LLM Parser
    participant Search as ์ƒํ’ˆ ๊ฒ€์ƒ‰ Agent
    participant Optimizer as ์ตœ์ ํ™” ์—”์ง„
    participant Mall as ์‡ผํ•‘๋ชฐ MCP Server<br/>(Common Tools)
    participant Router as ๊ฒฐ์ œ ๋ผ์šฐํ„ฐ
    participant Purchase as ์ž๋™๊ตฌ๋งค Agent (Phase 2)

    User->>UI: "์‚ฌ๊ณผ, ๋ฐฐ, ์šฐ์œ  2L ์ด์ƒ 1๊ฐœ, ์‹๋นต 2๊ฐœ, ์–ด๋ฆฐ์ด ์š”๊ตฌ๋ฅดํŠธ<br/>๊ตฌ๋งคํ‰/ํŒ๋งค๋Ÿ‰ ๋งŽ์€ ๊ณณ ์šฐ์„ , ์˜ˆ์‚ฐ 4๋งŒ์› ์ •๋„,<br/>๋‚ด์ผ ์ง‘์œผ๋กœ ๋„์ฐฉ"
    UI->>Parser: ์ž์œ  ํ…์ŠคํŠธ ์ž…๋ ฅ
    Parser->>Parser: JSON ๊ตฌ์กฐํ™”<br/>{items[], ranking_priority: "popularity",<br/>budget: 40000(soft, ยฑ10%), delivery_date: tomorrow, address: home}
    Parser->>Search: ๊ตฌ์กฐํ™”๋œ ์š”์ฒญ ์ „๋‹ฌ
    Search->>Mall: [MCP Client] search_products()<br/>ํ’ˆ๋ชฉ๋ณ„ ์ƒํ’ˆ ๊ฒ€์ƒ‰ (๊ฐ€๊ฒฉ/ํ‰์ /๋ฆฌ๋ทฐ์ˆ˜ยทํŒ๋งค๋Ÿ‰/๋ฐฐ์†ก์ •๋ณด)
    Mall-->>Search: ํ›„๋ณด ์ƒํ’ˆ ๋ฆฌ์ŠคํŠธ

    alt ์š”์ฒญ ์ƒํ’ˆ์ด ๊ฒ€์ƒ‰ ๊ฒฐ๊ณผ์— ์—†์Œ/ํ’ˆ์ ˆ
        Search->>Search: ๋™์ผ ์นดํ…Œ๊ณ ๋ฆฌ ์œ ์‚ฌ ์ƒํ’ˆ ์žฌ๊ฒ€์ƒ‰<br/>(ํƒ€ ๋ธŒ๋žœ๋“œ/์šฉ๋Ÿ‰/ํƒ€ ์‡ผํ•‘๋ชฐ)
        Search-->>UI: "OOO ํ’ˆ์ ˆ - ๋Œ€์ฒดํ’ˆ โ–ณโ–ณโ–ณ ์ œ์•ˆ"
    end

    Search->>Search: ๋ฐฐ์†ก์กฐ๊ฑด(๋‚ด์ผ ๋„์ฐฉ) 1์ฐจ ํ•„ํ„ฐ<br/>โ†’ ์ธ๊ธฐ๋„(๋ฆฌ๋ทฐ์ˆ˜/ํŒ๋งค๋Ÿ‰) ์šฐ์„  ์ •๋ ฌ<br/>โ†’ ํ‰์ /๊ฐ€๊ฒฉ ๋ณด์กฐ ์ •๋ ฌ
    Search->>Optimizer: ํ›„๋ณด๊ตฐ ์ „๋‹ฌ
    Optimizer->>Optimizer: ๋ฐฐ์†ก๋น„ ํฌํ•จ ์กฐํ•ฉ ๋น„๊ต<br/>(๋‹จ์ผ๋ชฐ vs ๋ถ„ํ• ๊ตฌ๋งค)<br/>+ ์ธ๊ธฐ๋„ ์šฐ์„ ์ˆœ์œ„ ๋ฐ˜์˜

    loop ์ตœ๋Œ€ max_replan_attempts(๊ธฐ๋ณธ 3ํšŒ) ์งˆ๋ฌธ ๋ผ์šด๋“œ๊นŒ์ง€
        Optimizer->>Optimizer: ์˜ˆ์‚ฐ ํ—ˆ์šฉ์˜ค์ฐจ(ยฑ10%) ์ดˆ๊ณผ ๋˜๋Š”<br/>๋ฐฐ์†ก ๋ฏธ์ถฉ์กฑ ์—ฌ๋ถ€ ํŒ๋‹จ
        alt ์ถฉ์กฑ ๋˜๋Š” ์งˆ๋ฌธ ๋ผ์šด๋“œ ํ•œ๋„ ๋„๋‹ฌ
            Optimizer->>Optimizer: ๋ฃจํ”„ ์ข…๋ฃŒ<br/>(ํ•œ๋„ ๋„๋‹ฌ ์‹œ best-effort ์กฐํ•ฉ + ๋ฏธ์ถฉ์กฑ ์‚ฌ์œ  ๊ธฐ๋ก)
        else ๋ฏธ์ถฉ์กฑ & ํ•œ๋„ ๋ฏธ๋„๋‹ฌ โ†’ ๋งค ๋ผ์šด๋“œ ์‚ฌ์šฉ์ž์—๊ฒŒ ์งˆ๋ฌธ(HITL)
            Optimizer-->>UI: ์„ ํƒ์ง€ ์ œ์‹œ(interrupt)<br/>ยท ์šฉ๋Ÿ‰ ๋ฌถ์Œ๊ตฌ๋งค/์กฐ๊ฑด์™„ํ™”/ํ’ˆ๋ชฉ์ œ์™ธ(๊ฒ€์ฆ๋œ ๊ฐ’, ์ฝ”๋“œ๊ฐ€ ๊ณ„์‚ฐ)<br/>ยท ์˜ˆ์‚ฐ/๋ฐฐ์†ก์ผ/์ œ์™ธ๋ชฐ ์กฐ์ •(LLM์ด ์ œ์•ˆ)<br/>ยท "์ง€๊ธˆ๊นŒ์ง€ ๊ฒฐ๊ณผ๋กœ ์ง„ํ–‰"(ํ•ญ์ƒ ํฌํ•จ)
            UI-->>User: ์งˆ๋ฌธ + ์„ ํƒ์ง€ ํ‘œ์‹œ
            User->>UI: ์„ ํƒ ์‘๋‹ต(๋ฒˆํ˜ธ ๋˜๋Š” ์ž์œ  ํ…์ŠคํŠธ)
            alt "์ง€๊ธˆ๊นŒ์ง€ ๊ฒฐ๊ณผ๋กœ ์ง„ํ–‰" ์„ ํƒ
                UI->>Optimizer: best-effort๋กœ ์ข…๋ฃŒ
            else ๊ทธ ์™ธ ์„ ํƒ
                UI->>Search: ์„ ํƒ ๋ฐ˜์˜ํ•ด ์žฌ๊ฒ€์ƒ‰ ์š”์ฒญ<br/>(ํ’ˆ๋ชฉ ์ˆ˜๋Ÿ‰/์กฐ๊ฑด ๋ณ€๊ฒฝ, ๊ฐ€๊ฒฉ์ƒํ•œ/์ œ์™ธ๋ชฐ/์˜ˆ์‚ฐ/๋ฐฐ์†ก์ผ ์กฐ์ • ๋“ฑ)
                Search->>Mall: [MCP Client] search_products()<br/>์กฐ์ •๋œ ์กฐ๊ฑด์œผ๋กœ ์žฌ๊ฒ€์ƒ‰
                Mall-->>Search: ํ›„๋ณด ์ƒํ’ˆ ๋ฆฌ์ŠคํŠธ(๊ฐฑ์‹ )
                Search->>Optimizer: ํ›„๋ณด๊ตฐ ์žฌ์ „๋‹ฌ
            end
        end
    end

    Optimizer-->>UI: ํ’ˆ๋ชฉ๋ณ„ ์ถ”์ฒœ ์ƒํ’ˆ + ๊ตฌ๋งค ๋งํฌ(์˜ˆ: GSํ”„๋ ˆ์‹œ๋ชฐ, ๋งˆ์ผ“์ปฌ๋ฆฌ ๋“ฑ) + ์ด์•ก/์˜ˆ์‚ฐ ์ถฉ์กฑ ์—ฌ๋ถ€<br/>(ํ•œ๋„ ๋„๋‹ฌ ์‹œ best-effort)<br/>+ ๋Œ€์ฒด/๋ฏธ์ถฉ์กฑ ํ•ญ๋ชฉ์˜ ์‚ฌ์œ (์˜ˆ์‚ฐ ์ดˆ๊ณผ/๋ฐฐ์†ก ๋ถˆ๊ฐ€/ํ’ˆ์ ˆ)
    UI-->>User: ๊ฒฐ๊ณผ ์นด๋“œ(๋งํฌ ๋ฆฌ์ŠคํŠธ + ๋Œ€์ฒด ์‚ฌ์œ  ์•ˆ๋‚ด) ํ‘œ์‹œ

    opt ์‚ฌ์šฉ์ž ๋Œ€์ฒดํ’ˆ ์š”์ฒญ
        User->>UI: "์šฐ์œ  ๋Œ€์ฒดํ’ˆ ๋ณด์—ฌ์ค˜"
        UI->>Search: ๋Œ€์ฒดํ’ˆ ํ›„๋ณด ์žฌ์กฐํšŒ
        Search->>Optimizer: ์žฌ๊ณ„์‚ฐ ์š”์ฒญ
        Optimizer-->>UI: ๊ฐฑ์‹ ๋œ ์žฅ๋ฐ”๊ตฌ๋‹ˆ + ๋งํฌ
    end

    User->>UI: ์ตœ์ข… ํ™•์ธ
    UI->>Router: ํ™•์ •๋œ ์žฅ๋ฐ”๊ตฌ๋‹ˆ ์ „๋‹ฌ
    Router-->>UI: ์‡ผํ•‘๋ชฐ๋ณ„ ๋”ฅ๋งํฌ/์žฅ๋ฐ”๊ตฌ๋‹ˆ URL
    UI-->>User: [Phase 1] ๊ตฌ๋งค ๋งํฌ ์ œ๊ณต โ†’ ์‚ฌ์šฉ์ž๊ฐ€ ์ง์ ‘ ๊ฒฐ์ œ

    opt [Phase 2] "์ด๋Œ€๋กœ ๊ตฌ๋งคํ•ด์ค˜" (์ž๋™ ๊ตฌ๋งค)
        User->>UI: ์ž๋™ ๊ตฌ๋งค ์Šน์ธ
        UI->>Purchase: ํ™•์ • ์žฅ๋ฐ”๊ตฌ๋‹ˆ + ์Šน์ธ ์‹ ํ˜ธ
        Purchase->>Mall: [MCP Client] add_to_cart() โ†’ place_order()<br/>์žฅ๋ฐ”๊ตฌ๋‹ˆ ๋‹ด๊ธฐ โ†’ ๊ฒฐ์ œ ์ง„ํ–‰
        Mall-->>Purchase: ์ฃผ๋ฌธ ์™„๋ฃŒ/์‹คํŒจ ๊ฒฐ๊ณผ
        Purchase-->>UI: ์ฃผ๋ฌธ ๋‚ด์—ญ(์˜์ˆ˜์ฆ/์†ก์žฅ) ์ „๋‹ฌ
        UI-->>User: ๊ตฌ๋งค ์™„๋ฃŒ ์•ˆ๋‚ด
    end
Loading

3.3 ๋ชจ๋“ˆ ๊ตฌ์„ฑ

๋ชจ๋“ˆ ์ฑ…์ž„ ์ฃผ์š” ๊ธฐ์ˆ  ๊ตฌ๋ถ„
Request Parser ์ž์œ  ํ˜•์‹ ์ž…๋ ฅ โ†’ ๊ตฌ์กฐํ™” JSON ๋ณ€ํ™˜ (ํ’ˆ๋ชฉ, ์ˆ˜๋Ÿ‰/์ŠคํŽ™, ์ •๋ ฌ ์šฐ์„ ์ˆœ์œ„, ์˜ˆ์‚ฐ(hard/soft), ๋ฐฐ์†ก ๊ธฐํ•œยท์ฃผ์†Œ). ์‹ ๋ขฐ๋„๊ฐ€ ๋‚ฎ์œผ๋ฉด ๋ช…ํ™•ํ™” ์งˆ๋ฌธ ์ƒ์„ฑ LLM (Function Calling / Structured Output) ๐ŸŸข Agent
Orchestrator (Planner) ์ „์ฒด ์ž‘์—…์„ ํ•˜์œ„ ๋‹จ๊ณ„๋กœ ๋ถ„ํ•ดํ•˜๊ณ , Searchโ†’Optimizeโ†’Reflect ๋ฃจํ”„๋ฅผ ์ œ์–ด. Reflection ๊ฒฐ๊ณผ์— ๋”ฐ๋ผ ์žฌ๊ณ„ํš(Replan) ์ง€์‹œ LLM Agent Loop (ReAct / Plan-Execute) ๐ŸŸข Agent
Product Search Agent ์‡ผํ•‘๋ชฐ๋ณ„ ๊ฒ€์ƒ‰ ๋„๊ตฌ ํ˜ธ์ถœ, ๋ฐฐ์†ก์กฐ๊ฑด/๊ฐ€๊ฒฉ/ํ‰์ /๋ฆฌ๋ทฐ ์ˆ˜ยทํŒ๋งค๋Ÿ‰(์ธ๊ธฐ๋„) 1์ฐจ ํ•„ํ„ฐ๋งยท์ •๋ ฌ LLM Tool-use (MCP Client) โ†’ ์‡ผํ•‘๋ชฐ๋ณ„ MCP Server ๐ŸŸข Agent
Optimization Engine ๋ฐฐ์†ก๋น„ ํฌํ•จ ์ด์•ก์ด (๊ทผ์‚ฌ) ์˜ˆ์‚ฐ ๋‚ด์—์„œ ์ •๋ ฌ ์šฐ์„ ์ˆœ์œ„(์ธ๊ธฐ๋„/ํ‰์ /๊ฐ€๊ฒฉ)๋ฅผ ๋งŒ์กฑํ•˜๋Š” ์กฐํ•ฉ ๊ณ„์‚ฐ (๋‹จ์ผ๋ชฐ vs ๋ถ„ํ• ๊ตฌ๋งค) ์กฐํ•ฉ ์ตœ์ ํ™” ์•Œ๊ณ ๋ฆฌ์ฆ˜ (Knapsack/Greedy + ์ œ์•ฝ์กฐ๊ฑด) ๐Ÿ”ง Tool (Orchestrator/Reflection์ด ํ˜ธ์ถœ)
Reflection Module ์‚ฐ์ถœ๋œ ์กฐํ•ฉ์ด ์˜ˆ์‚ฐ(ํ—ˆ์šฉ ์˜ค์ฐจ ํฌํ•จ)/๋ฐฐ์†ก ์ œ์•ฝ์„ ๋งŒ์กฑํ•˜๋Š”์ง€ ์ž์ฒด ๊ฒ€์ฆ. ๋ฏธ์ถฉ์กฑ ์‹œ ์‚ฌ์šฉ์ž์—๊ฒŒ ์„ ํƒ์ง€๋ฅผ ์ œ์‹œ(HITL) โ€” out_of_stock(์šฉ๋Ÿ‰ ๋“ฑ)์€ ์ฝ”๋“œ๊ฐ€ ํ›„๋ณด ๋ฐ์ดํ„ฐ๋กœ ๊ฒ€์ฆ๋œ ์˜ต์…˜(๋ฌถ์Œ๊ตฌ๋งค/์กฐ๊ฑด์™„ํ™”/ํ’ˆ๋ชฉ์ œ์™ธ)์„ ๊ณ„์‚ฐํ•˜๊ณ , budget_exceeded/delivery_unavailable์€ LLM์ด ์กฐ์ • ๋ฐฉํ–ฅ(์˜ˆ์‚ฐ/๋ฐฐ์†ก์ผ/์ œ์™ธ๋ชฐ ๋“ฑ)์„ ์ œ์•ˆ. ์‚ฌ์šฉ์ž์˜ ์„ ํƒ์„ ๋ฐ˜์˜ํ•ด ์žฌ๊ฒ€์ƒ‰ํ•˜๊ณ , ๋งŒ์กฑ ๋˜๋Š” ์ตœ๋Œ€ max_replan_attempts(๊ธฐ๋ณธ 3ํšŒ) ์งˆ๋ฌธ ๋ผ์šด๋“œ๊นŒ์ง€ ๋ฐ˜๋ณต. ํ•œ๋„ ๋„๋‹ฌ ๋˜๋Š” ์‚ฌ์šฉ์ž๊ฐ€ "์ง€๊ธˆ๊นŒ์ง€ ๊ฒฐ๊ณผ๋กœ ์ง„ํ–‰"์„ ์„ ํƒํ•˜๋ฉด ์ตœ์„ ์˜ ์กฐํ•ฉ(best-effort)๊ณผ ๋ฏธ์ถฉ์กฑ ์‚ฌ์œ ๋ฅผ ํ•จ๊ป˜ ์ œ์‹œ ๊ทœ์น™ ๊ธฐ๋ฐ˜ ๊ฒ€์ฆ + LLM ์ œ์•ˆ + HITL ๐ŸŸข Agent
Alternative Engine ๋Œ€์ฒดํ’ˆ ํ›„๋ณด ์ •๋ ฌ(๊ฐ€๊ฒฉ/ํ‰์ /์ธ๊ธฐ๋„/์นœํ™˜๊ฒฝ ๋“ฑ) ๋ฐ ํ’ˆ์ ˆ/๋ฏธ์กด์žฌ ์ƒํ’ˆ ๋ฐœ์ƒ ์‹œ ๋™์ผ ์นดํ…Œ๊ณ ๋ฆฌ ์œ ์‚ฌ ์ƒํ’ˆ ์ž๋™ ํƒ์ƒ‰ยท์ œ์•ˆ ๊ทœ์น™ ๊ธฐ๋ฐ˜ + ๊ฒ€์ƒ‰ ์žฌํ˜ธ์ถœ ๐Ÿ”ง Tool (Search/Reflection์ด ํ˜ธ์ถœ)
Deep Link Router ์ตœ์ข… ์žฅ๋ฐ”๊ตฌ๋‹ˆ โ†’ ์‡ผํ•‘๋ชฐ๋ณ„ ์ƒํ’ˆ/์žฅ๋ฐ”๊ตฌ๋‹ˆ URL ์ƒ์„ฑ (Phase 1 ๊ธฐ๋ณธ ์ถœ๋ ฅ) ์‡ผํ•‘๋ชฐ๋ณ„ URL ์Šคํ‚ด ๋งคํ•‘ ๐Ÿ”ง Tool (Orchestrator๊ฐ€ ํ˜ธ์ถœ)
์‡ผํ•‘๋ชฐ ์ปค๋„ฅํ„ฐ (MCP Server) ์‡ผํ•‘๋ชฐ๋ณ„ ์ƒํ’ˆ ๊ฒ€์ƒ‰/์ƒ์„ธ์กฐํšŒ/์žฅ๋ฐ”๊ตฌ๋‹ˆ/์ฃผ๋ฌธ ๊ธฐ๋Šฅ์„ ํ‘œ์ค€ MCP Tool(search_products, get_product_detail, add_to_cart, place_order ๋“ฑ)๋กœ ๋…ธ์ถœ. ๋‹จ์ผ MCP ์„œ๋ฒ„๊ฐ€ ๋ชฐ๋ณ„ ์–ด๋Œ‘ํ„ฐ(adapter)๋ฅผ ํ”Œ๋Ÿฌ๊ทธ์ธ ํ˜•ํƒœ๋กœ ๋“ฑ๋กํ•ด ํ˜ธ์ถœ์„ ๋ผ์šฐํŒ…(์˜ˆ: malls/gsfresh.py, malls/emart.py) โ€” ์‹ ๊ทœ ๋ชฐ ์ถ”๊ฐ€ ์‹œ ์„œ๋ฒ„ ์‹ ์„ค ์—†์ด ์–ด๋Œ‘ํ„ฐ๋งŒ ์ถ”๊ฐ€. API ์šฐ์„ , ๋น„๊ณต์‹ ์ฑ„๋„์€ ํฌ๋กค๋Ÿฌ๋กœ ๊ตฌํ˜„ MCP Server (๋‹จ์ผ ์„œ๋ฒ„ + ๋ชฐ๋ณ„ ์–ด๋Œ‘ํ„ฐ: GSํ”„๋ ˆ์‹œ๋ชฐ/์ด๋งˆํŠธ/์ปฌ๋ฆฌ/๋„ค์ด๋ฒ„ ๋“ฑ) ๐Ÿ”ง Tool (Search/Purchase Agent๊ฐ€ MCP Client๋กœ ํ˜ธ์ถœ)
Mall Onboarding Agent (๋ฐ˜์ž๋™) ์‹ ๊ทœ ์‡ผํ•‘๋ชฐ์˜ API ๋ฌธ์„œ/์ƒ˜ํ”Œ ํŽ˜์ด์ง€๋ฅผ ๋ถ„์„ํ•ด ์–ด๋Œ‘ํ„ฐ ์ฝ”๋“œ ์Šค์ผˆ๋ ˆํ†ค(search_products/add_to_cart/place_order ๋งคํ•‘, ์…€๋ ‰ํ„ฐ/URL ์Šคํ‚ด)๊ณผ ๊ฒ€์ฆ์šฉ ํ…Œ์ŠคํŠธ ์ผ€์ด์Šค๋ฅผ ์ƒ์„ฑ. ์‚ฌ๋žŒ์ด ๋ฆฌ๋ทฐ/ํ…Œ์ŠคํŠธ ํ›„ ๋จธ์ง€(HITL) โ€” ์ƒ์„ฑ๋œ ์–ด๋Œ‘ํ„ฐ๋Š” ๊ฒ€์ฆ ์—†์ด ์ž๋™ ๋ฐ˜์˜๋˜์ง€ ์•Š์Œ LLM ์ฝ”๋“œ ์ƒ์„ฑ + ์ƒ˜ํ”Œ ๋ฐ์ดํ„ฐ ๊ธฐ๋ฐ˜ ํ…Œ์ŠคํŠธ ๐ŸŸข Agent (HITL ํ•„์ˆ˜)
Purchase Execution Agent (Phase 2) ์‚ฌ์šฉ์ž ์ตœ์ข… ์Šน์ธ ํ›„ ์‡ผํ•‘๋ชฐ๋ณ„ ์žฅ๋ฐ”๊ตฌ๋‹ˆ ๋‹ด๊ธฐ โ†’ ๊ฒฐ์ œ ์ž๋™ ์ˆ˜ํ–‰, ์ฃผ๋ฌธ ๊ฒฐ๊ณผ(์˜์ˆ˜์ฆ/์†ก์žฅ) ํšŒ์ˆ˜ LLM Tool-use (MCP Client) โ†’ ์‡ผํ•‘๋ชฐ๋ณ„ MCP Server (์žฅ๋ฐ”๊ตฌ๋‹ˆ/์ฃผ๋ฌธ Tool), Browser Automation (Playwright) ๐ŸŸข Agent
Session Store (๋‹จ๊ธฐ ๋ฉ”๋ชจ๋ฆฌ) ํ˜„ ์š”์ฒญ์˜ ํŒŒ์‹ฑ ๊ฒฐ๊ณผยท๊ฒ€์ƒ‰ ํ›„๋ณดยท์žฌ๊ณ„ํš ์‹œ๋„ ์ด๋ ฅ ๋“ฑ ์„ธ์…˜ ๋‚ด ์ƒํƒœ ๊ด€๋ฆฌ. Reflection์ด ์žฌ๊ณ„ํš ์‹œ ์ด์ „ ์‹œ๋„๋ฅผ ์ฐธ๊ณ ํ•ด ๋™์ผํ•œ ์žฌ๊ณ„ํš์„ ๋ฐ˜๋ณตํ•˜์ง€ ์•Š๋„๋ก ํ•จ Memory MCP (agentic-ai-common-tools, SQLite backend, namespace="session:{session_id}", TTL ์ ์šฉ) โšช Infra
Preference Memory (์žฅ๊ธฐ ๋ฉ”๋ชจ๋ฆฌ) ์„ธ์…˜์„ ๋„˜์–ด์„  ์žฅ๊ธฐ ์‚ฌ์šฉ์ž ์„ ํ˜ธ๋„(์„ ํ˜ธ ๋ธŒ๋žœ๋“œ, ์•Œ๋Ÿฌ์ง€/์ œ์™ธ ์‹ํ’ˆ, ์ •๋ ฌ ์šฐ์„ ์ˆœ์œ„, ์ž์ฃผ ๊ตฌ๋งคํ•˜๋Š” ํ’ˆ๋ชฉ, ๊ณผ๊ฑฐ ๋Œ€์ฒด ์ˆ˜๋ฝ/๊ฑฐ์ ˆ ์ด๋ ฅ) ์ €์žฅ. Parser/Orchestrator๊ฐ€ ๋‹ค์Œ ์š”์ฒญ ์ฒ˜๋ฆฌ ์‹œ ์กฐํšŒยท๋ฐ˜์˜ Memory MCP (agentic-ai-common-tools, namespace="user:{user_id}", TTL ์—†์Œ; PoC๋Š” SQLite backend, ์šด์˜ ์‹œ Postgres/Redis backend๋กœ ํ™•์žฅ) โšช Infra
Mall Knowledge Base (RAG) ์‡ผํ•‘๋ชฐ๋ณ„ ๋ฐฐ์†ก ๋งˆ๊ฐ์‹œ๊ฐ„, ํ’ˆ์ ˆ/๋Œ€์ฒด ํŒจํ„ด, ์นดํ…Œ๊ณ ๋ฆฌ๋ณ„ ๋Œ€์ฒด ๊ทœ์น™ ๋“ฑ ๋น„์ •ํ˜• ์ง€์‹ ์ƒ‰์ธ. Reflection/Orchestrator๊ฐ€ ์žฌ๊ณ„ํš ์กฐ๊ฑด ํŒ๋‹จ ์‹œ ๊ฒ€์ƒ‰ํ•ด ์ฐธ๊ณ ํ•˜๋Š” ๋ณด์กฐ ์ง€์‹ ์†Œ์Šค(์˜ˆ์‚ฐ/๋ฐฐ์†ก ๋“ฑ ํ•ต์‹ฌ ์ œ์•ฝ์€ ๊ตฌ์กฐํ™” ํ•„๋“œ๋กœ ๋ณ„๋„ ์ถ”์ ) Retrieval MCP (agentic-ai-common-tools, bm25_sqlite/vector backend) โšช Infra
Secrets Vault (Phase 2) ์‡ผํ•‘๋ชฐ ๋กœ๊ทธ์ธ/๊ฒฐ์ œ์ˆ˜๋‹จ ์ž๊ฒฉ์ฆ๋ช…์„ ์•”ํ˜ธํ™” ๋ณด๊ด€, Purchase Agent๊ฐ€ ์‹คํ–‰ ์‹œ์ ์—๋งŒ ์กฐํšŒ Vault / KMS ๊ธฐ๋ฐ˜ ์•”ํ˜ธํ™” ์ €์žฅ์†Œ โšช Infra
Audit Log (Phase 2) ์ž๋™ ๊ตฌ๋งค ์š”์ฒญยท์Šน์ธยท์ฃผ๋ฌธ ๊ฒฐ๊ณผ๋ฅผ ๋ชจ๋‘ ๊ธฐ๋กํ•˜์—ฌ ์ถ”์ /๋กค๋ฐฑ ๊ทผ๊ฑฐ ํ™•๋ณด append-only ๋กœ๊ทธ (PostgreSQL/S3) โšช Infra

3.3.1 ์—์ด์ „ํŠธ(Agent) vs ๋„๊ตฌ(Tool) vs ์ธํ”„๋ผ(Infra) ๊ตฌ๋ถ„

SmartCart Agent Core์˜ ๋ชจ๋“  ๋ชจ๋“ˆ์„ LLM ์—์ด์ „ํŠธ๋กœ ๋งŒ๋“ค ํ•„์š”๋Š” ์—†์Šต๋‹ˆ๋‹ค. ํŒ๋‹จ/๊ณ„ํš์ด ํ•„์š”ํ•œ ๊ณณ๋งŒ ์—์ด์ „ํŠธ๋กœ ๋‘๊ณ , **์ž…์ถœ๋ ฅ์ด ์ •ํ•ด์ง„ ๊ณ„์‚ฐ/๋งคํ•‘์€ ์—์ด์ „ํŠธ๊ฐ€ ํ˜ธ์ถœํ•˜๋Š” ๋„๊ตฌ(Tool)**๋กœ ๊ตฌํ˜„ํ•ฉ๋‹ˆ๋‹ค.

  • ๐ŸŸข Agent (LLM ๊ธฐ๋ฐ˜, 6๊ฐœ) โ€” ์Šค์Šค๋กœ ์ƒํ™ฉ์„ ํŒ๋‹จํ•˜๊ณ  ๋‹ค์Œ ํ–‰๋™์„ ๊ณ„ํšํ•จ

    • Orchestrator: ๋ฉ”์ธ ์—์ด์ „ํŠธ. Searchโ†’Optimizeโ†’Reflect ๋ฃจํ”„๋ฅผ ์ œ์–ดํ•˜๊ณ  ์žฌ๊ณ„ํš ์—ฌ๋ถ€๋ฅผ ๊ฒฐ์ •
    • Request Parser: ์ž์—ฐ์–ด ์š”์ฒญ์„ ๊ตฌ์กฐํ™”ํ•˜๊ณ , ๋ชจํ˜ธํ•œ ํ•ญ๋ชฉ์€ ํ™•์ธ ์งˆ๋ฌธ ์ƒ์„ฑ
    • Product Search Agent: ๊ฒ€์ƒ‰ ๋„๊ตฌ๋ฅผ ํ˜ธ์ถœํ•˜๋ฉฐ ๊ฒฐ๊ณผ๋ฅผ ๋ณด๊ณ  ๋‹ค์Œ ๊ฒ€์ƒ‰ ์ „๋žต์„ ์กฐ์ •
    • Reflection Module: Optimizer ๊ฒฐ๊ณผ๋ฅผ ํ‰๊ฐ€ํ•˜๊ณ , ๋ฏธ์ถฉ์กฑ ์‹œ ์‚ฌ์šฉ์ž์—๊ฒŒ ์ œ์‹œํ•  ์„ ํƒ์ง€๋ฅผ ๋งŒ๋“ฆ(๊ฒ€์ฆ ๊ฐ€๋Šฅํ•œ ๊ฐ’์€ ๊ฒฐ์ •๋ก ์ ์œผ๋กœ ๊ณ„์‚ฐ, ์˜ˆ์‚ฐ/๋ฐฐ์†ก ๋“ฑ ํŒ๋‹จ ์˜์—ญ์€ LLM์ด ์ œ์•ˆ)
    • Purchase Execution Agent (Phase 2): ์ž๋™ ๊ตฌ๋งค ์‹คํ–‰ ๋ฐ ์˜ˆ์™ธ ์ƒํ™ฉ(ํ’ˆ์ ˆ/๊ฒฐ์ œ ์‹คํŒจ ๋“ฑ) ๋Œ€์‘
    • Mall Onboarding Agent (๋ฐ˜์ž๋™): ์‹ ๊ทœ ๋ชฐ์˜ ์–ด๋Œ‘ํ„ฐ ์ฝ”๋“œ/ํ…Œ์ŠคํŠธ ์Šค์ผˆ๋ ˆํ†ค์„ ์ƒ์„ฑํ•ด ์‚ฌ๋žŒ์˜ ๋ฆฌ๋ทฐ ํ›„ ์‡ผํ•‘๋ชฐ ์ปค๋„ฅํ„ฐ MCP Server์— ์ถ”๊ฐ€ (HITL)
  • ๐Ÿ”ง Tool (๊ฒฐ์ •๋ก ์  ํ•จ์ˆ˜/์™ธ๋ถ€ ์—ฐ๋™, 4๊ฐœ) โ€” ์ž…๋ ฅ์ด ๊ฐ™์œผ๋ฉด ํ•ญ์ƒ ๊ฐ™์€ ๊ฒฐ๊ณผ๋ฅผ ๋‚ด๋Š” ๊ณ„์‚ฐ/๋งคํ•‘์ด๊ฑฐ๋‚˜, ํ‘œ์ค€ ์ธํ„ฐํŽ˜์ด์Šค๋กœ ๋…ธ์ถœ๋œ ์™ธ๋ถ€ ์—ฐ๋™. ๋น ๋ฅด๊ณ  ์ €๋ ดํ•˜๋ฉฐ ํ…Œ์ŠคํŠธํ•˜๊ธฐ ์‰ฌ์›€

    • Optimization Engine: optimize_cart() โ€” ์กฐํ•ฉ ์ตœ์ ํ™” ๊ณ„์‚ฐ
    • Alternative Engine: get_alternatives() โ€” ๋Œ€์ฒดํ’ˆ ํ›„๋ณด ์ •๋ ฌ/ํ•„ํ„ฐ๋ง
    • Deep Link Router: build_deep_link() โ€” ์‡ผํ•‘๋ชฐ๋ณ„ URL ์ƒ์„ฑ
    • ์‡ผํ•‘๋ชฐ ์ปค๋„ฅํ„ฐ (MCP Server): ๋‹จ์ผ MCP ์„œ๋ฒ„๊ฐ€ ๋ชฐ๋ณ„ ์–ด๋Œ‘ํ„ฐ(plugin)๋ฅผ ๋“ฑ๋กํ•ด search_products, get_product_detail, add_to_cart, place_order ๊ฐ™์€ MCP Tool๋กœ ํ‘œ์ค€ํ™”. Search/Purchase Agent๋Š” MCP Client๋กœ ๋™์ผํ•œ ๋ฐฉ์‹ ํ˜ธ์ถœ โ†’ ์‹ ๊ทœ ๋ชฐ ์ถ”๊ฐ€ ์‹œ ์„œ๋ฒ„ ์‹ ์„ค ์—†์ด ์–ด๋Œ‘ํ„ฐ๋งŒ ์ถ”๊ฐ€(Mall Onboarding Agent๊ฐ€ ์ดˆ์•ˆ ์ƒ์„ฑ)
  • โšช Infra (๋ฐ์ดํ„ฐ/๋ณด์•ˆ ๊ณ„์ธต, 5๊ฐœ) โ€” ์—์ด์ „ํŠธ๊ฐ€ ์ฝ๊ณ  ์“ฐ๋Š” ์ €์žฅ์†Œ

    • Session Store (๋‹จ๊ธฐ ๋ฉ”๋ชจ๋ฆฌ), Preference Memory (์žฅ๊ธฐ ๋ฉ”๋ชจ๋ฆฌ), Mall Knowledge Base (RAG), Secrets Vault (Phase 2), Audit Log (Phase 2)

์ฆ‰ Optimizer/Alternative Engine/Router๋ฅผ LLM ์—์ด์ „ํŠธ๋กœ ๋งŒ๋“ค๋ฉด ๋น„์šฉยท์ง€์—ฐ์‹œ๊ฐ„์ด ๋Š˜๊ณ  ๊ฒฐ๊ณผ๊ฐ€ ๋น„๊ฒฐ์ •์ ์ด ๋˜์–ด ๋””๋ฒ„๊น…์ด ์–ด๋ ค์›Œ์ง€๋ฏ€๋กœ, ๋„๊ตฌ๋กœ ์œ ์ง€ํ•˜๊ณ  Orchestrator/Reflection ์—์ด์ „ํŠธ๊ฐ€ Tool-use๋กœ ํ˜ธ์ถœํ•˜๋Š” ๊ตฌ์กฐ๋ฅผ ๊ถŒ์žฅํ•ฉ๋‹ˆ๋‹ค.

3.4 Agentic AI ์š”๊ฑด ์ฒดํฌ๋ฆฌ์ŠคํŠธ

์š”๊ฑด ์„ค๊ณ„ ๋ฐ˜์˜ ๋‚ด์šฉ
์ž์œจ์„ฑ (Autonomy) ๊ฒ€์ƒ‰ โ†’ ์ตœ์ ํ™” โ†’ ์ œ์•ฝ์กฐ๊ฑด ๊ฒ€์ฆ๊นŒ์ง€๋Š” ์‚ฌ๋žŒ ๊ฐœ์ž… ์—†์ด ์ž๋™ ์ˆ˜ํ–‰. ์ œ์•ฝ ๋ฏธ์ถฉ์กฑ ์‹œ์—๋Š” ๋งค ๋ผ์šด๋“œ ์‚ฌ์šฉ์ž์—๊ฒŒ ์„ ํƒ์ง€๋ฅผ ๋ฌป๋Š” HITL ๋ฃจํ”„๋กœ ์ „ํ™˜ํ•ด, ์ž„์˜์˜ ๊ฐ€์ •์œผ๋กœ ํ˜ผ์ž ๋Œ€์ฒดํ•˜์ง€ ์•Š์Œ
๊ณ„ํš & ์žฌ๊ณ„ํš (Plan & Replan) Orchestrator๊ฐ€ ๋ชฉํ‘œ(์˜ˆ์‚ฐ/๋ฐฐ์†ก์‹œ๊ฐ„/ํ‰์ )๋ฅผ ํ•˜์œ„ ์ž‘์—…์œผ๋กœ ๋ถ„ํ•ดํ•˜๊ณ , Reflection์—์„œ ์ œ์•ฝ ๋ฏธ์ถฉ์กฑ ์‹œ ์‚ฌ์šฉ์ž์—๊ฒŒ ์„ ํƒ์ง€๋ฅผ ์ œ์‹œ(HITL) โ€” ์šฉ๋Ÿ‰ ์กฐ์ ˆ/์กฐ๊ฑด์™„ํ™”/ํ’ˆ๋ชฉ์ œ์™ธ(๊ฒ€์ฆ๋œ ๊ฐ’)๋‚˜ ์˜ˆ์‚ฐยท๋ฐฐ์†ก์ผยท์ œ์™ธ๋ชฐ ์กฐ์ •(LLM ์ œ์•ˆ) ์ค‘ ์‚ฌ์šฉ์ž๊ฐ€ ๊ณ ๋ฅธ ๋Œ€๋กœ ์žฌ๊ฒ€์ƒ‰. ์žฌ๊ณ„ํš ์ข…๋ฃŒ ์กฐ๊ฑด: ๋งŒ์กฑ ๋˜๋Š” ์ตœ๋Œ€ max_replan_attempts(๊ธฐ๋ณธ 3ํšŒ) ์งˆ๋ฌธ ๋ผ์šด๋“œ ๋„๋‹ฌ ์‹œ ๋ฌดํ•œ ๋ฃจํ”„ ์—†์ด ์ตœ์„ ์˜ ์กฐํ•ฉ(best-effort)์„ ๋ฏธ์ถฉ์กฑ ์‚ฌ์œ ์™€ ํ•จ๊ป˜ ์ œ์‹œ
๋„๊ตฌ ์‚ฌ์šฉ (Tool Use) Search/Purchase Agent๊ฐ€ ์‡ผํ•‘๋ชฐ๋ณ„ **MCP Server(Common Tools)**๋ฅผ ํ†ตํ•ด ๊ฒ€์ƒ‰ยท์žฅ๋ฐ”๊ตฌ๋‹ˆยท์ฃผ๋ฌธ ๊ธฐ๋Šฅ์„ ํ‘œ์ค€ํ™”๋œ Tool๋กœ ํ˜ธ์ถœํ•˜์—ฌ ์‹ค์‹œ๊ฐ„ ๋ฐ์ดํ„ฐ๋ฅผ ํš๋“
๋ฐ˜์„ฑ/์ž๊ธฐ๊ฒ€์ฆ (Reflection) Optimization ๊ฒฐ๊ณผ๋ฅผ Reflection ๋ชจ๋“ˆ์ด ๊ฒ€์ฆํ•˜๊ณ , ์‹คํŒจ ์‹œ ์‚ฌ์šฉ์ž ์„ ํƒ์„ ๋ฐ›์•„ ๋ฃจํ”„๋ฅผ ํ†ตํ•ด ์Šค์Šค๋กœ ๊ฐœ์„ 
ํˆฌ๋ช…์„ฑ (Transparency) ์ œ์•ฝ์„ ๋งŒ์กฑํ•˜์ง€ ๋ชปํ•œ ํ•ญ๋ชฉ์€ **์‚ฌ์šฉ์ž๊ฐ€ ์ง์ ‘ ๊ณ ๋ฅธ ์กฐ์ • ๋‚ด์—ญ(์›๋ž˜ ์กฐ๊ฑด, ์„ ํƒํ•œ ๋Œ€์•ˆ, ์‚ฌ์œ )**์„ ์ตœ์ข… ๊ฒฐ๊ณผ์— ๋ช…์‹œํ•˜์—ฌ ์‚ฌ์šฉ์ž๊ฐ€ ์ด์œ ๋ฅผ ์•Œ ์ˆ˜ ์žˆ๊ฒŒ ํ•จ
๋ฉ”๋ชจ๋ฆฌ (Memory) ๋‹จ๊ธฐ: Session Store(Memory MCP)์— ํ˜„ ์š”์ฒญ์˜ ๊ฒ€์ƒ‰/์žฌ๊ณ„ํš ์‹œ๋„ ์ด๋ ฅ์„ ๋ณด๊ด€ํ•ด Reflection์ด ๋™์ผํ•œ ์„ ํƒ์ง€๋ฅผ ๋ฐ˜๋ณต ์ œ์‹œํ•˜์ง€ ์•Š๊ฒŒ ํ•จ. ์žฅ๊ธฐ: Preference Memory(Memory MCP)๋กœ ์„ธ์…˜ ๊ฐ„ ์‚ฌ์šฉ์ž ์„ ํ˜ธ๋„๋ฅผ ๋‹ค์Œ ์š”์ฒญ์— ๋ฐ˜์˜. ๋ณด์กฐ์ ์œผ๋กœ Mall Knowledge Base(Retrieval MCP, RAG)์—์„œ ์‡ผํ•‘๋ชฐ๋ณ„ ํœด๋ฆฌ์Šคํ‹ฑ์„ ๊ฒ€์ƒ‰ํ•ด ์„ ํƒ์ง€ ์ œ์•ˆ์„ ๋ณด๊ฐ•
๋ชจํ˜ธ์„ฑ ํ•ด์†Œ / Human-in-the-loop Parser ์‹ ๋ขฐ๋„๊ฐ€ ๋‚ฎ์€ ํ•ญ๋ชฉ์€ ์‚ฌ์šฉ์ž์—๊ฒŒ ํ™•์ธ ์งˆ๋ฌธ์„ ๋˜์ง€๊ฑฐ๋‚˜, ์ตœ์„  ์ถ”์ • + ๊ทผ๊ฑฐ๋ฅผ ํ•จ๊ป˜ ์ œ์‹œ. ์ œ์•ฝ(์˜ˆ์‚ฐ/๋ฐฐ์†ก/์žฌ๊ณ ) ๋ฏธ์ถฉ์กฑ ์‹œ์—๋„ ๋งค ๋ผ์šด๋“œ ์„ ํƒ์ง€๋ฅผ ๋ฌป๋Š” ๋™์ผํ•œ HITL ํŒจํ„ด์„ ์ ์šฉ. ์ตœ์ข… ๊ฒฐ์ œ ์ „ ์‚ฌ์šฉ์ž ํ™•์ธ ๋‹จ๊ณ„ ์œ ์ง€
๋ชฉํ‘œ/์ œ์•ฝ ์ถ”์  (Goal Tracking) ์˜ˆ์‚ฐ(hard/soft, ํ—ˆ์šฉ์˜ค์ฐจ)ยท๋ฐฐ์†ก ๊ธฐํ•œ/๋‚ ์งœยท์ •๋ ฌ ์šฐ์„ ์ˆœ์œ„(์ธ๊ธฐ๋„/ํ‰์ /๊ฐ€๊ฒฉ) ๊ธฐ์ค€์ด ํŒŒ์ดํ”„๋ผ์ธ ์ „ ๋‹จ๊ณ„์—์„œ ์ผ๊ด€๋˜๊ฒŒ ์ถ”์ ๋˜๋ฉฐ, ์ตœ์ข… ๊ฒฐ๊ณผ์— ์ถฉ์กฑ ์—ฌ๋ถ€๋ฅผ ๋ช…์‹œ
์•ˆ์ „ํ•œ ์ž์œจ ์‹คํ–‰ (Phase 2 Safety) ์ž๋™ ๊ตฌ๋งค๋Š” ๊ฒฐ์ œ ์ง์ „ **๋ฐ˜๋“œ์‹œ ์‚ฌ์šฉ์ž ์Šน์ธ(HITL)**์„ ์š”๊ตฌํ•˜๋ฉฐ, ์ž๊ฒฉ์ฆ๋ช…์€ Secrets Vault์—์„œ ์‹คํ–‰ ์‹œ์ ์—๋งŒ ์กฐํšŒ, ๋ชจ๋“  ์ฃผ๋ฌธ ํ–‰์œ„๋Š” Audit Log์— ๊ธฐ๋ก๋˜์–ด ์ถ”์ ยทํ™˜๋ถˆ ๋Œ€์‘ ๊ฐ€๋Šฅ

4. ๋ฐ์ดํ„ฐ ๋ชจ๋ธ ์˜ˆ์‹œ

4.1 ๊ตฌ์กฐํ™”๋œ ์š”์ฒญ (Parser ์ถœ๋ ฅ)

{
  "items": [
    { "name": "์‚ฌ๊ณผ", "qty": 1, "unit": "๋ด‰์ง€", "category": "๊ณผ์ผ" },
    { "name": "๋ฐฐ", "qty": 1, "unit": "๋ด‰์ง€", "category": "๊ณผ์ผ" },
    { "name": "์šฐ์œ ", "qty": 1, "unit": "๊ฐœ", "min_volume": "2L", "category": "์œ ์ œํ’ˆ" },
    { "name": "์‹๋นต", "qty": 2, "unit": "๊ฐœ", "category": "๋ฒ ์ด์ปค๋ฆฌ" },
    { "name": "์–ด๋ฆฐ์ด ์š”๊ตฌ๋ฅดํŠธ", "qty": 1, "unit": "๋ฌถ์Œ", "category": "์œ ์ œํ’ˆ" }
  ],
  "ranking_priority": ["popularity", "rating", "price"],
  "budget": { "amount": 40000, "type": "soft", "tolerance_pct": 10 },
  "delivery": { "date": "2026-06-13", "time": null, "address": "home" },
  "preferences": {
    "min_rating": null,
    "organic_preferred": false
  }
}

ranking_priority: "๊ตฌ๋งคํ‰์ด๋‚˜ ๊ตฌ๋งค๊ฐ€ ๋งŽ์€ ๊ณณ"์ฒ˜๋Ÿผ ์ธ๊ธฐ๋„ ๊ธฐ์ค€ ์š”์ฒญ ์‹œ popularity(๋ฆฌ๋ทฐ ์ˆ˜/ํŒ๋งค๋Ÿ‰/๋ฒ ์ŠคํŠธ ์ˆœ์œ„)๋ฅผ 1์ˆœ์œ„๋กœ ์„ค์ • budget.type: "์ •๋„/์•ฝ" ๊ฐ™์€ ํ‘œํ˜„์€ soft๋กœ ๋ถ„๋ฅ˜, "์ดํ•˜/์ด๋‚ด"๋Š” hard๋กœ ๋ถ„๋ฅ˜

4.2 ์ตœ์ ํ™” ๊ฒฐ๊ณผ (Optimization Pack)

{
  "total_price": 38700,
  "budget": { "amount": 40000, "type": "soft", "tolerance_pct": 10 },
  "budget_satisfied": true,
  "delivery": { "date": "2026-06-13", "satisfied": true },
  "ranking_priority": ["popularity", "rating", "price"],
  "cart": [
    {
      "item": "์‚ฌ๊ณผ",
      "mall": "๋งˆ์ผ“์ปฌ๋ฆฌ",
      "product": "์‚ฌ๊ณผ 1.5kg (5~6์ž…)",
      "price": 12900,
      "rating": 4.7,
      "review_count": 18342,
      "delivery_date": "2026-06-13",
      "url": "https://www.kurly.com/goods/..."
    },
    {
      "item": "๋ฐฐ",
      "mall": "GSํ”„๋ ˆ์‹œ๋ชฐ (GSํ”„๋ ˆ์‹œ)",
      "product": "์‹ ๊ณ ๋ฐฐ 3์ž… ํŠน์ƒ",
      "price": 9900,
      "rating": 4.6,
      "review_count": 25110,
      "delivery_date": "2026-06-13",
      "url": "https://www.gsfresh.com/..."
    },
    {
      "item": "์šฐ์œ  2L ์ด์ƒ",
      "mall": "GSํ”„๋ ˆ์‹œ๋ชฐ (GSํ”„๋ ˆ์‹œ)",
      "product": "์„œ์šธ์šฐ์œ  ๋ชฉ์žฅ์˜ ์‹ ์„ ํ•จ 2.3L",
      "price": 4980,
      "rating": 4.8,
      "review_count": 41203,
      "delivery_date": "2026-06-13",
      "url": "https://www.gsfresh.com/..."
    },
    {
      "item": "์‹๋นต x2",
      "mall": "GSํ”„๋ ˆ์‹œ๋ชฐ (GSํ”„๋ ˆ์‹œ)",
      "product": "์‚ผ๋ฆฝ ์‹๋นต 500g",
      "price": 3290,
      "rating": 4.5,
      "review_count": 9870,
      "qty": 2,
      "delivery_date": "2026-06-13",
      "url": "https://www.gsfresh.com/..."
    },
    {
      "item": "์–ด๋ฆฐ์ด ์š”๊ตฌ๋ฅดํŠธ",
      "mall": "์ด๋งˆํŠธ (์“ฑ๋ฐฐ์†ก)",
      "product": "ํ‘ธ๋ฅด๋ฐ€ children's ์š”๊ตฌ๋ฅดํŠธ 100ml x 15์ž…",
      "price": 7600,
      "rating": 4.6,
      "review_count": 6520,
      "delivery_date": "2026-06-13",
      "url": "https://emart.ssg.com/..."
    }
  ],
  "substitutions": [
    {
      "original_item": "์šฐ์œ  2L ์ด์ƒ",
      "original_product": "๋งค์ผ์šฐ์œ  ๊ทธ๋ฆญ์š”๊ฑฐํŠธ 2.3L (ํ”„๋ฆฌ๋ฏธ์—„)",
      "original_price": 8900,
      "reason": "budget_exceeded",
      "reason_detail": "์˜ˆ์‚ฐ ํ—ˆ์šฉ์˜ค์ฐจ(ยฑ10%, ์ตœ๋Œ€ 44,000์›) ์ดˆ๊ณผ๋กœ ๋” ์ €๋ ดํ•œ ๋™์ผ ์นดํ…Œ๊ณ ๋ฆฌ ์ƒํ’ˆ์œผ๋กœ ๋Œ€์ฒด",
      "replacement_product": "์„œ์šธ์šฐ์œ  ๋ชฉ์žฅ์˜ ์‹ ์„ ํ•จ 2.3L",
      "replacement_price": 4980
    }
  ],
  "alternatives": [
    {
      "for_item": "์–ด๋ฆฐ์ด ์š”๊ตฌ๋ฅดํŠธ",
      "suggestion": "๋‚จ์–‘ ์•„์ด๊ผฌ์•ผ ์š”๊ตฌ๋ฅดํŠธ 80ml x 12์ž…",
      "price": 6900,
      "review_count": 15230,
      "reason": "๋ฆฌ๋ทฐ ์ˆ˜/ํŒ๋งค๋Ÿ‰ ๋” ๋†’์Œ"
    }
  ]
}

substitutions: Reflection ๋‹จ๊ณ„์—์„œ ์˜ˆ์‚ฐ/๋ฐฐ์†ก ์ œ์•ฝ ๋ฏธ์ถฉ์กฑ์œผ๋กœ ์‹ค์ œ๋กœ ๋Œ€์ฒด๋œ ํ•ญ๋ชฉ์„ ๊ธฐ๋ก. reason์€ budget_exceeded | delivery_unavailable | out_of_stock ์ค‘ ํ•˜๋‚˜์˜ ์ฝ”๋“œ๋กœ ํ‘œ์ค€ํ™”ํ•˜๊ณ , reason_detail์€ ์‚ฌ์šฉ์ž์—๊ฒŒ ๊ทธ๋Œ€๋กœ ๋…ธ์ถœํ•  ํ•œ๊ตญ์–ด ์„ค๋ช…. (alternatives๋Š” ์‚ฌ์šฉ์ž๊ฐ€ ์„ ํƒ์ ์œผ๋กœ ๋ฐ”๊ฟ”๋ณผ ์ˆ˜ ์žˆ๋Š” ์ถ”์ฒœ ํ›„๋ณด๋กœ, substitutions์™€๋Š” ๋ณ„๊ฐœ)

ํ˜„์žฌ ๊ตฌํ˜„ ๋…ธํŠธ: Phase 1 ๊ตฌํ˜„์—์„œ๋Š” ์œ„ ๋‘ ํ•„๋“œ ๋Œ€์‹ , ์ œ์•ฝ ๋ฏธ์ถฉ์กฑ ์‹œ HITL ๋Œ€ํ™”(์งˆ๋ฌธ/์„ ํƒ์ง€/์‘๋‹ต)๋กœ ๋™์ผํ•œ ์ •๋ณด๋ฅผ ์‚ฌ์šฉ์ž์—๊ฒŒ ์ „๋‹ฌํ•ฉ๋‹ˆ๋‹ค(docs/implementation-plan.md Step 10) โ€” substitutions/alternatives๋Š” ํ•ญ์ƒ ๋นˆ ๋ฐฐ์—ด์ด๋ฉฐ, ๋ชจ๋ธ ํ•„๋“œ ์ž์ฒด๋Š” ๊ทธ๋Œ€๋กœ ์œ ์ง€๋ฉ๋‹ˆ๋‹ค.


5. ๊ธฐ์ˆ  ์Šคํƒ (์ œ์•ˆ)

์˜์—ญ ํ›„๋ณด ๊ธฐ์ˆ 
LLM / ์—์ด์ „ํŠธ ํ”„๋ ˆ์ž„์›Œํฌ Claude (Function Calling / Tool Use), LangGraph or custom orchestration
๋ฐฑ์—”๋“œ API Python (FastAPI)
์ƒํ’ˆ ๋ฐ์ดํ„ฐ ์ˆ˜์ง‘ ๊ณต์‹ Open API ์šฐ์„ , ๋น„๊ณต์‹ ์ฑ„๋„์€ ํฌ๋กค๋Ÿฌ (Playwright/requests)
๋„๊ตฌ ํ†ตํ•ฉ (Common Tools) ์‡ผํ•‘๋ชฐ๋ณ„ ์ปค๋„ฅํ„ฐ(API/ํฌ๋กค๋Ÿฌ)๋ฅผ MCP Server๋กœ ๊ตฌํ˜„ (search_products/get_product_detail/add_to_cart/place_order), SearchยทPurchase Agent๋Š” MCP Client๋กœ ํ˜ธ์ถœ
์บ์‹œ Redis (๊ฐ€๊ฒฉ/์ƒํ’ˆ/์ธ๊ธฐ๋„(๋ฆฌ๋ทฐ์ˆ˜ยทํŒ๋งค๋Ÿ‰) ์บ์‹œ TTL ๊ด€๋ฆฌ)
DB PostgreSQL (์„ธ์…˜, ์žฅ๋ฐ”๊ตฌ๋‹ˆ, ์‚ฌ์šฉ์ž ์„ ํ˜ธ๋„)
ํ”„๋ก ํŠธ์—”๋“œ React / Next.js (์ฑ„ํŒ…ํ˜• UI + ์นด๋“œํ˜• ๊ฒฐ๊ณผ/๋งํฌ ๋ทฐ)
์ž๋™ ๊ตฌ๋งค (Phase 2) Playwright ๊ธฐ๋ฐ˜ ๋ธŒ๋ผ์šฐ์ € ์ž๋™ํ™”, ์‡ผํ•‘๋ชฐ๋ณ„ ๊ฒฐ์ œ ์—ฐ๋™, Secrets Vault (์ž๊ฒฉ์ฆ๋ช…/๊ฒฐ์ œ์ˆ˜๋‹จ)
๋ฐฐํฌ Docker, CI/CD (GitHub Actions)

6. ํ–ฅํ›„ ๋กœ๋“œ๋งต

Phase 1 โ€” ๊ตฌ๋งค ๋งํฌ ์ œ๊ณต (ํ˜„์žฌ ๋ชฉํ‘œ)

  • 1๋‹จ๊ณ„: ์ž์—ฐ์–ด ํŒŒ์„œ + ๋‹จ์ผ ์‡ผํ•‘๋ชฐ(GSํ”„๋ ˆ์‹œ๋ชฐ) ์—ฐ๋™ PoC
  • 2๋‹จ๊ณ„: ๋‹ค์ค‘ ์‡ผํ•‘๋ชฐ ๋น„๊ต ๋ฐ ๋ฐฐ์†ก๋น„ ํฌํ•จ ์ตœ์ ํ™” ์•Œ๊ณ ๋ฆฌ์ฆ˜
  • 3๋‹จ๊ณ„: ์ธ๊ธฐ๋„(๋ฆฌ๋ทฐ ์ˆ˜/ํŒ๋งค๋Ÿ‰) ๊ธฐ๋ฐ˜ ์ •๋ ฌ ์šฐ์„ ์ˆœ์œ„ + ๋Œ€์ฒดํ’ˆ ์ถ”์ฒœ ์—”์ง„
  • 4๋‹จ๊ณ„: ๊ทผ์‚ฌ ์˜ˆ์‚ฐ(Soft Budget) ์ฒ˜๋ฆฌ + ๋ฐฐ์†ก ๋‚ ์งœ/์‹œ๊ฐ„ ํ•„ํ„ฐ
  • 5๋‹จ๊ณ„: ํ’ˆ๋ชฉ๋ณ„ ๋”ฅ๋งํฌ ์ œ๊ณต ๋ฐ ์‚ฌ์šฉ์ž ํ”ผ๋“œ๋ฐฑ ๋ฃจํ”„

Phase 2 โ€” ์ž๋™ ๊ตฌ๋งค ์‹คํ–‰ (ํ–ฅํ›„)

  • 6๋‹จ๊ณ„: Secrets Vault ์—ฐ๋™ (์‡ผํ•‘๋ชฐ ๋กœ๊ทธ์ธ/๊ฒฐ์ œ์ˆ˜๋‹จ ๋ณด๊ด€)
  • 7๋‹จ๊ณ„: Purchase Execution Agent (์žฅ๋ฐ”๊ตฌ๋‹ˆ ๋‹ด๊ธฐ โ†’ ๊ฒฐ์ œ ์ž๋™ํ™”, Playwright ๊ธฐ๋ฐ˜)
  • 8๋‹จ๊ณ„: ๊ฒฐ์ œ ์ง์ „ Human-in-the-loop ์Šน์ธ ํ”Œ๋กœ์šฐ
  • 9๋‹จ๊ณ„: ์ฃผ๋ฌธ/๊ฒฐ์ œ Audit Log + ์ฃผ๋ฌธ ๊ฒฐ๊ณผ(์˜์ˆ˜์ฆ/์†ก์žฅ) ํšŒ์ˆ˜ ๋ฐ ์‚ฌ์šฉ์ž ํ†ต์ง€

7. ๋ผ์ด์„ ์Šค

์ด ํ”„๋กœ์ ํŠธ๋Š” LICENSE ํŒŒ์ผ์„ ๋”ฐ๋ฆ…๋‹ˆ๋‹ค.

About

Agentic AI that parses natural-language grocery requests and finds the optimal shopping cart across multiple e-commerce malls (Phase 1: purchase links)

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages