๐บ๐ธ English version
AI ๊ธฐ๋ฐ ์ง๋ฅํ ์ฅ๋ณด๊ธฐ ๋ํ ์์ด์ ํธ ์์ฐ์ด ์ฅ๋ณด๊ธฐ ๋ฆฌ์คํธ๋ฅผ ์ ๋ ฅํ๋ฉด ์ต์ ๊ฐ ยท ์ต๊ณ ํ์ ยท ํฌ๋ง ๋ฐฐ์ก ์๊ฐ์ ๋ชจ๋ ๋ง์กฑํ๋ ์ต์ ์ ๊ตฌ๋งค ์กฐํฉ์ ์ฐพ์์ฃผ๊ณ , ๊ฒฐ์ ์ง์ ๊น์ง ์ฌ์ ์ ๋จ์ถํด์ฃผ๋ ์์ด์ ํธ ์๋น์ค์ ๋๋ค.
์ฌ์ฉ์๊ฐ "์ผ๊ฒน์ด 1kg, ์์ฅ, ์์ถ ํ ๋ด์ง, ๋ด์ผ ์์นจ 7์ ์ ๋์ฐฉ, ์์ฐ 4๋ง์ ์ดํ"์ฒ๋ผ ๊ตฌ์ด์ฒด๋ก ์ ๋ ฅํ ์ฅ๋ณด๊ธฐ ๋ฆฌ์คํธ๋ฅผ ๋ถ์ํ์ฌ,
- ํญ๋ชฉ์ ์ ํํํ๊ณ (๋ธ๋๋/์ฉ๋/์๋ ์ถ๋ก , ๋ชจํธํ๋ฉด ํ์ธ ์ง๋ฌธ)
- ์ฌ๋ฌ ์ด์ปค๋จธ์ค(GSํ๋ ์๋ชฐ, ์ด๋งํธ๋ชฐ, ์ปฌ๋ฆฌ, ๋ค์ด๋ฒ ์ผํ ๋ฑ)์์ ์ค์๊ฐ ๊ฐ๊ฒฉยทํ์ ยท๋ฆฌ๋ทฐ ์/ํ๋งค๋(์ธ๊ธฐ๋)ยท๋ฐฐ์ก ๊ฐ๋ฅ ์๊ฐ์ ์กฐํํ๊ณ
- ๋ฐฐ์ก๋น๋ฅผ ํฌํจํ **์ต์ ์ฅ๋ฐ๊ตฌ๋ ์กฐํฉ(Optimization Pack)**์ ๊ณ์ฐํ๊ณ , ์์ฐ(๊ทผ์ฌ์น ํฌํจ)/๋ฐฐ์ก ์ ์ฝ์ ์ค์ค๋ก ๊ฒ์ฆํ์ฌ ๋ฏธ์ถฉ์กฑ ์ ๋งค ๋ผ์ด๋ ์ฌ์ฉ์์๊ฒ ์ ํ์ง๋ฅผ ๋ฌป๊ณ ์๋ต์ ๋ฐ๋ผ ์ฌ๊ณํํ๋ฉฐ(HITL)
- ์ฌ์ฉ์์๊ฒ ์ ์ + ๋์ฒดํ ์ต์ ์ ์ ๊ณตํ๊ณ
- [Phase 1] ๊ฐ ์ผํ๋ชฐ์ ๋ฅ๋งํฌ/์ฅ๋ฐ๊ตฌ๋ ๋งํฌ๋ฅผ ์ ๊ณตํ์ฌ ์ฌ์ฉ์๊ฐ ์ง์ ๊ฒฐ์ ํ๊ฑฐ๋, [Phase 2] ์ฌ์ฉ์ ์น์ธ์ ๊ฑฐ์ณ ์๋์ผ๋ก ๊ฒฐ์ ๊น์ง ์ํํฉ๋๋ค.
์ฌ์ฉ์ ์ ๋ ฅ "์ฌ๊ณผ, ๋ฐฐ ๊ณผ์ผ, ์ฐ์ 2L ์ด์ 1๊ฐ, ์๋นต 2๊ฐ, ์ด๋ฆฐ์ด ์๊ตฌ๋ฅดํธ ์ฐพ์์ค. ๊ตฌ๋งคํ์ด๋ ๊ตฌ๋งค๊ฐ ๋ง์ ๊ณณ์ผ๋ก ์ฐ์ ์ ์ผ๋ก ์ฐพ๊ณ , ์์ฐ์ 4๋ง์ ์ ๋ ์ฌ์ฉํ๊ณ , ์ง์ผ๋ก ๋ด์ผ ๋ฐ์๋ดค์ผ๋ฉด ์ข๊ฒ ์ด."
์ด ์ ๋ ฅ์ ๋ค์๊ณผ ๊ฐ์ด ์ฒ๋ฆฌ๋ฉ๋๋ค.
- Parser โ 5๊ฐ ํ๋ชฉ(์ฌ๊ณผ, ๋ฐฐ, ์ฐ์ โฅ2Lร1, ์๋นตร2, ์ด๋ฆฐ์ด ์๊ตฌ๋ฅดํธ)์ ์ ํํํ๊ณ ,
์ ๋ ฌ ์ฐ์ ์์๋ฅผ
popularity(๋ฆฌ๋ทฐ ์/ํ๋งค๋)๋ก, ์์ฐ์ **๊ทผ์ฌ์น(soft budget, โ40,000์)**๋ก, ๋ฐฐ์ก ์กฐ๊ฑด์ "๋ด์ผ ์ง ์ฃผ์๋ก ๋์ฐฉ"(์๊ฐ ๋ฏธ์ง์ )์ผ๋ก ์ถ์ถ - Search Agent โ ๊ฐ ํ๋ชฉ๋ณ๋ก ํ๋ณด ์ํ์ ์กฐํํ๊ณ ๋ฆฌ๋ทฐ ์ยทํ๋งค๋(๋ฒ ์คํธ ์์) ๊ธฐ์ค์ผ๋ก 1์ฐจ ์ ๋ ฌ
- Optimizer โ ๋ฐฐ์ก๋น ํฌํจ ์ด์ก์ด ์์ฐ ๊ทผ์ฌ์น(ยฑํ์ฉ์ค์ฐจ) ๋ด์์, ์ธ๊ธฐ๋ ์ฐ์ + ํ์ /๊ฐ๊ฒฉ์ ๋ณด์กฐ ๊ธฐ์ค์ผ๋ก ์ต์ ์กฐํฉ ์ฐ์ถ
- Reflection โ ์์ฐ ์ด๊ณผ/๋ฐฐ์ก ๋ถ๊ฐ/ํ์ ํญ๋ชฉ์ด ์์ผ๋ฉด, ๊ฒ์ฆ๋ ์ ํ์ง(์ฉ๋ ๋ฌถ์๊ตฌ๋งคยท์กฐ๊ฑด์ํยทํ๋ชฉ์ ์ธ โ ์ฝ๋๊ฐ ๊ณ์ฐ)์ LLM์ด ์ ์ํ ์ ํ์ง(์์ฐ/๋ฐฐ์ก์ผ ์กฐ์ ยท๋ชฐ ์ ์ธ)๋ฅผ ํจ๊ป ์ฌ์ฉ์์๊ฒ ์ ์(HITL)ํ๊ณ , ์ ํ์ ๋ฐ๋ผ ์ฌ๊ฒ์ โ ๋ง์กฑํ ๋๊น์ง ๋๋ ์ต๋
max_replan_attemptsํ๊น์ง ๋ผ์ด๋ ๋ฐ๋ณต - ์ถ๋ ฅ (Phase 1) โ ํ๋ชฉ๋ณ ์ถ์ฒ ์ํ + ๊ตฌ๋งค ๋งํฌ(๋ฅ๋งํฌ) ๋ฆฌ์คํธ, ์ด์ก/์์ฐ ์ถฉ์กฑ ์ฌ๋ถ, ๊ทธ๋ฆฌ๊ณ **์ฌ์ฉ์๊ฐ ๊ฐ ๋ผ์ด๋์์ ์ ํํ ์กฐ์ ๋ด์ญ(์๋ ์กฐ๊ฑด, ์ ํํ ๋์, ์ฌ์ )**์ ํจ๊ป ์ ์
- ์ถ๋ ฅ (Phase 2, ํฅํ) โ ์ฌ์ฉ์๊ฐ "์ด๋๋ก ๊ตฌ๋งคํด์ค"๋ผ๊ณ ํ์ธํ๋ฉด, Purchase Execution Agent๊ฐ ๊ฐ ์ผํ๋ชฐ ์ฅ๋ฐ๊ตฌ๋์ ๋ด๊ณ ๊ฒฐ์ ๋ฅผ ๋ํ ์ํ
- ์์ฐ์ด ํ์ฑ: "๋ํจ์ผ๊ฒน์ด ๋์ฉ๋, ํํ" โ ๋ธ๋๋/์ฉ๋/์๋์ ์ถ๋ก ํด ์ ํ ๋ฐ์ดํฐ๋ก ๋ณํ
- ๋ชจํธ์ฑ ํด์: ํ์ฑ ์ ๋ขฐ๋๊ฐ ๋ฎ์ ํญ๋ชฉ(์: "ํํ" โ ์ธ์ ๋ธ๋๋/์ฉ๋ ๋ค์ ์กด์ฌ)์ ์ฌ์ฉ์์๊ฒ ์งง์ ํ์ธ ์ง๋ฌธ์ ๋์ง๊ฑฐ๋, ๊ฐ์ฅ ๊ฐ๋ฅ์ฑ ๋์ ํ๋ณด + ๊ทผ๊ฑฐ๋ฅผ ํจ๊ป ์ ์
- ๋ค์ค ์กฐ๊ฑด ๊ฒ์: ๊ฐ๊ฒฉ + ํ์ (์: 4.5/5.0 ์ด์) + ๋ฆฌ๋ทฐ ์/ํ๋งค๋(์ธ๊ธฐ๋) ๊ธฐ์ค์ผ๋ก ์ฌ๋ฌ ์ผํ๋ชฐ ๋น๊ต
- ์ ๋ ฌ ์ฐ์ ์์ ์ปค์คํฐ๋ง์ด์ฆ: "๊ตฌ๋งคํ์ด๋ ๊ตฌ๋งค๊ฐ ๋ง์ ๊ณณ" ๊ฐ์ ์์ฒญ์
popularity(๋ฆฌ๋ทฐ ์ยทํ๋งค๋ยท๋ฒ ์คํธ ์์)๋ฅผ 1์์ ์ ๋ ฌ ๊ธฐ์ค์ผ๋ก ์ฌ์ฉํ๊ณ , ๋์ผ ์ธ๊ธฐ๋์ผ ๊ฒฝ์ฐ ํ์ ยท๊ฐ๊ฒฉ์ ๋ณด์กฐ ๊ธฐ์ค์ผ๋ก ์ฌ์ฉ - ์ต์ ์กฐํฉ ์์ฑ: ๋ฐฐ์ก๋น๋ฅผ ํฌํจํ ์ด์ก์ด (๊ทผ์ฌ) ์์ฐ ๋ด์์ ์ ๋ ฌ ์ฐ์ ์์(์ธ๊ธฐ๋/ํ์ /๊ฐ๊ฒฉ)๋ฅผ ๋ง์กฑํ๋ ์ผํ๋ชฐ ์กฐํฉ + ์ง์ ๊ตฌ๋งค ๋งํฌ ์ ๊ณต
- ์ํด๋ฆญ ๊ต์ฒด: ์ถ์ฒ ์ํ์ด ๋ง์์ ๋ค์ง ์์ผ๋ฉด ์ฐจ์์ ์ต์ ๊ฐ/ํ ๋ธ๋๋ ๋์ผ ์นดํ ๊ณ ๋ฆฌ ์ํ ์ฆ์ ์ถ์ฒ
- ์กฐ๊ฑด๋ณ ํํฐ: '๋ ์ ๋ ดํ ์ํ', 'ํ์ ๋ ๋์ ์ํ', '์ ๊ธฐ๋/์นํ๊ฒฝ' ๋ฑ ์ ํธ๋ ๊ธฐ๋ฐ ์ ๋ ฌ
- ํ์ /๋ฏธ์กด์ฌ ์ํ ์๋ ๋์: ์์ฒญํ ์ํ์ด ๊ฒ์ ๊ฒฐ๊ณผ์ ์๊ฑฐ๋ ํ์ ์ธ ๊ฒฝ์ฐ, ์ฌ์ฉ์์๊ฒ ์๋ฆฌ๋ ๋์์
- ๋์ผ ์นดํ ๊ณ ๋ฆฌ ๋ด ์ ์ฌ ์ํ(๋ธ๋๋/์ฉ๋ ์ฐจ์ด)์ ์๋์ผ๋ก ์ฌ๊ฒ์
- ๋ค๋ฅธ ์ผํ๋ชฐ์์์ ์ฌ๊ณ ์ฌ๋ถ๋ฅผ ํจ๊ป ์กฐํ
- "์์ฒญํ์ OOO์(๋) ํ์ฌ ํ์ ์ ๋๋ค. ๋์ โณโณโณ(๋ธ๋๋/์ฉ๋ ์ฐจ์ด)์(๋ฅผ) ์ถ์ฒ๋๋ฆฝ๋๋ค" ํํ๋ก ๋์ฒดํ์ ์ ์
- ์์ฐ ๊ฐ๋๋ ์ผ: ์ค์ ๋ ์์ฐ์ ์ด๊ณผํ์ง ์๋๋ก ์ฉ๋ ์กฐ์ ๋๋ ๊ฐ์ฑ๋น ๋ธ๋๋๋ก ์๋ ์ ํ ์ ์
- ๊ทผ์ฌ ์์ฐ(Soft Budget) ์ฒ๋ฆฌ: "4๋ง์ ์ ๋"์ฒ๋ผ ๋ช ํํ ์ํ์ด ์๋ ๊ฒฝ์ฐ, ๊ธฐ์ค ์์ฐ์ ยฑ10% ํ์ฉ ์ค์ฐจ ๋ด์์ ์ธ๊ธฐ๋/ํ์ ์ฐ์ ์์๋ฅผ ์ฐ์ ๋ง์กฑํ๋ ์กฐํฉ์ ํ์ํ๊ณ , ํ์ฉ ์ค์ฐจ๋ฅผ ๋ฒ์ด๋๋ฉด ์ฌ์ฉ์์๊ฒ ์ด๊ณผ๋ถ๊ณผ ์ฌ์ ๋ฅผ ํจ๊ป ์๋ด
- ๋ฐฐ์ก ํ์๋ผ์ธ ๋งค์นญ: ํฌ๋ง ๋์ฐฉ ์๊ฐ(์: "๋ด์ผ ์์นจ 7์ ์ ") ๋๋ "๋ด์ผ๊น์ง ์ง์ผ๋ก"์ฒ๋ผ ๋ ์ง ๋จ์ ์กฐ๊ฑด์ ๋ง์กฑํ๋ ์ผํ๋ชฐ(GSํ๋ ์, ์ฑ๋ฐฐ์ก, ์ปฌ๋ฆฌ ๋ฑ)๋ง ํํฐ๋ง
- [Phase 1] ๊ตฌ๋งค ๋งํฌ ์ ๊ณต: ์ต์ ์กฐํฉ์ด ํ์ ๋๋ฉด ํ๋ชฉ๋ณ ์ผํ๋ชฐ ๋ฅ๋งํฌ/์ฅ๋ฐ๊ตฌ๋ URL์ ์ ๋ฆฌํด ์ฌ์ฉ์์๊ฒ ์ ๋ฌ. ์ฌ์ฉ์๊ฐ ์ง์ ํด๋ฆญํ์ฌ ๊ฒฐ์
- [Phase 2] ์๋ ๊ตฌ๋งค ์คํ: ์ฌ์ฉ์๊ฐ ์ต์ข ์น์ธํ๋ฉด Purchase Execution Agent๊ฐ ๊ฐ ์ผํ๋ชฐ์ ๋ก๊ทธ์ธ๋ ์ธ์ ์ผ๋ก ์ฅ๋ฐ๊ตฌ๋์ ๋ด๊ณ ๊ฒฐ์ ๊น์ง ๋ํ. ๊ฒฐ์ ์ง์ ๋จ๊ณ๋ ํญ์ Human-in-the-loop ์น์ธ์ ๊ฑฐ์น๋ฉฐ, ์ ์ฒด ๊ณผ์ ์ ๊ฐ์ฌ ๋ก๊ทธ(Audit Log)๋ก ๊ธฐ๋ก
์๋๋ ๋น๊ฐ๋ฐ์๋ ์ฝ๊ฒ ์ดํดํ ์ ์๋๋ก ํต์ฌ ํ๋ฆ๋ง ๋จ์ํํ ๊ทธ๋ฆผ์ ๋๋ค. ์์ธํ ๋ชจ๋/์ฐ๊ฒฐ ๊ตฌ์กฐ๋ 3.1~3.2์ ๋ค์ด์ด๊ทธ๋จ์ ์ฐธ๊ณ ํ์ธ์.
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
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["โ
๊ตฌ๋งค ์๋ฃ + ์์์ฆ ์๋ด"]
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
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
| ๋ชจ๋ | ์ฑ ์ | ์ฃผ์ ๊ธฐ์ | ๊ตฌ๋ถ |
|---|---|---|---|
| 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 |
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๊ฐ ์ด์ ์์ฑ)
- Optimization Engine:
-
โช 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๋ก ํธ์ถํ๋ ๊ตฌ์กฐ๋ฅผ ๊ถ์ฅํฉ๋๋ค.
| ์๊ฑด | ์ค๊ณ ๋ฐ์ ๋ด์ฉ |
|---|---|
| ์์จ์ฑ (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์ ๊ธฐ๋ก๋์ด ์ถ์ ยทํ๋ถ ๋์ ๊ฐ๋ฅ |
{
"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๋ก ๋ถ๋ฅ
{
"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.mdStep 10) โsubstitutions/alternatives๋ ํญ์ ๋น ๋ฐฐ์ด์ด๋ฉฐ, ๋ชจ๋ธ ํ๋ ์์ฒด๋ ๊ทธ๋๋ก ์ ์ง๋ฉ๋๋ค.
| ์์ญ | ํ๋ณด ๊ธฐ์ |
|---|---|
| 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) |
- 1๋จ๊ณ: ์์ฐ์ด ํ์ + ๋จ์ผ ์ผํ๋ชฐ(GSํ๋ ์๋ชฐ) ์ฐ๋ PoC
- 2๋จ๊ณ: ๋ค์ค ์ผํ๋ชฐ ๋น๊ต ๋ฐ ๋ฐฐ์ก๋น ํฌํจ ์ต์ ํ ์๊ณ ๋ฆฌ์ฆ
- 3๋จ๊ณ: ์ธ๊ธฐ๋(๋ฆฌ๋ทฐ ์/ํ๋งค๋) ๊ธฐ๋ฐ ์ ๋ ฌ ์ฐ์ ์์ + ๋์ฒดํ ์ถ์ฒ ์์ง
- 4๋จ๊ณ: ๊ทผ์ฌ ์์ฐ(Soft Budget) ์ฒ๋ฆฌ + ๋ฐฐ์ก ๋ ์ง/์๊ฐ ํํฐ
- 5๋จ๊ณ: ํ๋ชฉ๋ณ ๋ฅ๋งํฌ ์ ๊ณต ๋ฐ ์ฌ์ฉ์ ํผ๋๋ฐฑ ๋ฃจํ
- 6๋จ๊ณ: Secrets Vault ์ฐ๋ (์ผํ๋ชฐ ๋ก๊ทธ์ธ/๊ฒฐ์ ์๋จ ๋ณด๊ด)
- 7๋จ๊ณ: Purchase Execution Agent (์ฅ๋ฐ๊ตฌ๋ ๋ด๊ธฐ โ ๊ฒฐ์ ์๋ํ, Playwright ๊ธฐ๋ฐ)
- 8๋จ๊ณ: ๊ฒฐ์ ์ง์ Human-in-the-loop ์น์ธ ํ๋ก์ฐ
- 9๋จ๊ณ: ์ฃผ๋ฌธ/๊ฒฐ์ Audit Log + ์ฃผ๋ฌธ ๊ฒฐ๊ณผ(์์์ฆ/์ก์ฅ) ํ์ ๋ฐ ์ฌ์ฉ์ ํต์ง
์ด ํ๋ก์ ํธ๋ LICENSE ํ์ผ์ ๋ฐ๋ฆ ๋๋ค.



