Agentica๋ฅผ ํ์ฉํ ์ง๋ฅํ ์์ ์ถ์ฒ ํ๋ซํผ
WRTN Dish๋ ๋ ์จ ๋ฐ์ดํฐ, ์ฌ์ฉ์ ํ์คํ ๋ฆฌ, ์์น ๊ธฐ๋ฐ ๋ ์คํ ๋ ์ ๋ณด๋ฅผ ํตํฉํ์ฌ ์ค์๊ฐ์ผ๋ก ์ต์ ์ ์์์ ์ถ์ฒํ๋ AI ์์ด์ ํธ ์์คํ ์ ๋๋ค. Agentica RPC ํ๋ ์์ํฌ๋ฅผ ๊ธฐ๋ฐ์ผ๋ก ๊ตฌ์ถ๋์ด OpenAI GPT-4o-mini๋ฅผ ํ์ฉํ ์ง๋ฅํ ๋ํํ ์ถ์ฒ ์๋น์ค๋ฅผ ์ ๊ณตํฉ๋๋ค.
- AI ์์ด์ ํธ ๊ธฐ๋ฐ ์ถ์ฒ: Agentica RPC๋ฅผ ํ์ฉํ ๋ฉํฐ ์์ด์ ํธ ์ค์ผ์คํธ๋ ์ด์
- ๋ ์จ ์ฐ๋ ์ถ์ฒ: ์ค์๊ฐ ๋ ์จ ์ ๋ณด๋ฅผ ๋ฐ์ํ ์์ ์นดํ ๊ณ ๋ฆฌ ์ ์
- ์์น ๊ธฐ๋ฐ ๊ฒ์: Naver Local Search API๋ฅผ ํตํ ์ฃผ๋ณ ๋ง์ง ์ ๋ณด ์ ๊ณต
- ์ค์๊ฐ ์ฑํ : WebSocket ๊ธฐ๋ฐ ์คํธ๋ฆฌ๋ฐ ์๋ต์ผ๋ก ์์ฐ์ค๋ฌ์ด ๋ํ ๊ฒฝํ
- ํ์ ์์ ์ฑ: Typia ๊ธฐ๋ฐ ๋ฐํ์ ํ์ ๊ฒ์ฆ ๋ฐ Nestia SDK ์๋ ์์ฑ
- ๊ฐ์ธํ ์ถ์ฒ: ์ฌ์ฉ์์ ์์ฌ ํ์คํ ๋ฆฌ ๋ฐ ์ ํธ๋ ๋ถ์
- ํ๋ ์์ํฌ: NestJS 10.x + Nestia (ํ์ ์์ REST/WebSocket)
- AI ์ค์ผ์คํธ๋ ์ด์ : Agentica RPC 0.31.x
- ๋ฐํ์ ๊ฒ์ฆ: Typia 9.x
- AI ๋ชจ๋ธ: OpenAI GPT-4o-mini
- ์ธ๋ถ API: ๊ธฐ์์ฒญ API, Naver Local Search
- ํต์ : TGrid (ํ์ ์์ WebSocket RPC)
- ํ๋ ์์ํฌ: React 19.x + Vite 7.x
- ์คํ์ผ๋ง: Tailwind CSS 4.x
- ๋งํฌ๋ค์ด ๋ ๋๋ง: React Markdown + Syntax Highlighting (Prism, Highlight.js)
- AI ํต์ : Agentica RPC Client
- ๋ฐํ์: Bun ๋๋ Node.js
- ์ธ์ด: TypeScript 5.9.x
- ์ฝ๋ ํ์ง: ESLint, Prettier
ChatController (WebSocket ์ง์
์ )
โ
โโโ OrchestratorAgentController (์ค๋งํธ ์ค์ผ์คํธ๋ ์ดํฐ)
โโโ ์๋ ๋ถ์ (Intent Analysis)
โโโ ๋ํ ์ํ ๊ด๋ฆฌ (Conversation State)
โ
โโโ WeatherAgentController (๋ ์จ ์ ๋ฌธ ์์ด์ ํธ)
โ โโโ WeatherService (๋ ์จ ์ ๋ณด ์์ง)
โ
โโโ IntegratedFoodAgentController (ํตํฉ ์์ ์ถ์ฒ)
โ โโโ WeatherService (๋ ์จ ์ ๋ณด ์์ง)
โ โโโ FoodService (์์ ์นดํ
๊ณ ๋ฆฌ ๊ด๋ฆฌ)
โ โโโ UserHistoryService (์ฌ์ฉ์ ์ ํธ๋ ๋ถ์)
โ โโโ IntegratedScoringService (ํตํฉ ์ ์ ๊ณ์ฐ)
โ
โโโ RestaurantController (๋ง์ง ๊ฒ์)
์ค๋งํธ ์ค์ผ์คํธ๋ ์ดํฐ ํจํด:
- ๋จ์ผ ์ง์ ์ : 21๊ฐ ํจ์ โ 1๊ฐ ์ค์ผ์คํธ๋ ์ดํฐ๋ก ๋จ์ํ
- ์๋ ๋ถ์: ์ฌ์ฉ์ ๋ฉ์์ง๋ฅผ ๋ถ์ํ์ฌ ์ ์ ํ ์๋น์ค ์๋ ์ ํ
- ์ปจํ ์คํธ ๊ด๋ฆฌ: ๋ํ ์ํ๋ฅผ ์ถ์ ํ์ฌ ์ค๋ณต ์ ๋ณด ์ ๊ณต ๋ฐฉ์ง
- ๋ฉํ ์ง๋ฌธ ์ฒ๋ฆฌ: "๋ ๋ญํ ์ ์์ด?" ๊ฐ์ ์์คํ ์ง๋ฌธ ์ง์
Function Calling Flow:
- ์ฌ์ฉ์ ๋ฉ์์ง โ WebSocket ์์
- OrchestratorAgentController๊ฐ ์๋ ๋ถ์
- ์ ์ ํ ์์ด์ ํธ๋ก ๋ผ์ฐํ (๋ ์จ, ์์, ๋ง์ง)
- ๋ํ ์ปจํ ์คํธ ์ ๋ฐ์ดํธ
- ํตํฉ ๊ฒฐ๊ณผ ์์ฑ โ ์คํธ๋ฆฌ๋ฐ ์๋ต
- Bun 1.0 ์ด์ (๊ถ์ฅ)
- Node.js 18 ์ด์ (๋๋ Bun ๋์ ์ฌ์ฉ)
- ์ธ๋ถ API ํค:
- OpenRouter API Key
- ๊ธฐ์์ฒญ API Key (๊ธฐ์์ฒญ API Hub ํ์๊ฐ์ ํ์)
- Naver Open API (Client ID & Secret)
git clone https://github.com/wrtn/wrtn-dish.git
cd wrtn-dishBun ์ฌ์ฉ (๊ถ์ฅ):
cd server
# ์์กด์ฑ ์ค์น
bun install
# ํ๊ฒฝ๋ณ์ ์ค์
cp .env.example .env # ์๋ ํ๊ฒฝ๋ณ์ ์์ ์ฐธ๊ณ
# TypeScript ํธ๋์คํฌ๋จธ ์ค์น (ํ์)
bun run prepare
# ํ๋ก์ ํธ ๋น๋ (SDK + Main + Test)
bun run build
# ๊ฐ๋ฐ ์๋ฒ ์คํ
bun run devnpm ์ฌ์ฉ:
cd server
# ์์กด์ฑ ์ค์น
npm install
# ํ๊ฒฝ๋ณ์ ์ค์
cp .env.example .env # ์๋ ํ๊ฒฝ๋ณ์ ์์ ์ฐธ๊ณ
# TypeScript ํธ๋์คํฌ๋จธ ์ค์น (ํ์)
npm run prepare
# ํ๋ก์ ํธ ๋น๋ (SDK + Main + Test)
npm run build
# ๊ฐ๋ฐ ์๋ฒ ์คํ
npm run devํ๊ฒฝ๋ณ์ (.env ์์):
# Server Configuration
API_PORT=37001
# OpenRouter API Configuration
# Get your API key from: https://openrouter.ai/settings/keys
OPENROUTER_API_KEY=sk-or-your_openrouter_api_key_here
# ๊ธฐ์์ฒญ(KMA) API Configuration
# Get your API key from: https://apihub.kma.go.kr/ (ํ์๊ฐ์
ํ์)
WEATHER_API_KEY=your_kma_api_key_here
# Naver Open API Configuration
# Get your credentials from: https://developers.naver.com/main/
NAVER_CLIENT_ID=your_naver_client_id_here
NAVER_CLIENT_SECRET=your_naver_client_secret_hereBun ์ฌ์ฉ (๊ถ์ฅ):
cd client
# ์์กด์ฑ ์ค์น
bun install
# ํ๊ฒฝ๋ณ์ ์ค์ (์ ํ์ฌํญ)
# .env ํ์ผ์ ์๋ ๋ด์ฉ ์ถ๊ฐ
# VITE_AGENTICA_WS_URL=ws://localhost:37001/chat
# ๊ฐ๋ฐ ์๋ฒ ์คํ
bun run devnpm ์ฌ์ฉ:
cd client
# ์์กด์ฑ ์ค์น
npm install
# ๊ฐ๋ฐ ์๋ฒ ์คํ
npm run dev- ํ๋ก ํธ์๋: http://localhost:5173
- ๋ฐฑ์๋ API: http://localhost:37001
- Swagger Editor: http://localhost:37001/editor
wrtn-dish/
โโโ server/ # NestJS ๋ฐฑ์๋
โ โโโ src/
โ โ โโโ controllers/ # WebSocket & REST ์ปจํธ๋กค๋ฌ
โ โ โ โโโ chat/ # AI ์ฑํ
์ปจํธ๋กค๋ฌ (Agentica Agents)
โ โ โ โ โโโ ChatController.ts # WebSocket ์ง์
์
โ โ โ โ โโโ OrchestratorAgentController.ts # ์ค๋งํธ ์ค์ผ์คํธ๋ ์ดํฐ
โ โ โ โ โโโ IntegratedFoodAgentController.ts # ํตํฉ ์์ ์ถ์ฒ
โ โ โ โ โโโ WeatherAgentController.ts # ๋ ์จ ์ ๋ฌธ ์์ด์ ํธ
โ โ โ โโโ food/ # ์์ ์ถ์ฒ REST ์๋ํฌ์ธํธ
โ โ โ โโโ weather/ # ๋ ์จ REST ์๋ํฌ์ธํธ
โ โ โ โโโ restaurant/ # ๋ ์คํ ๋ ๊ฒ์ ์๋ํฌ์ธํธ
โ โ โโโ services/ # ๋น์ฆ๋์ค ๋ก์ง ์๋น์ค
โ โ โ โโโ IntegratedScoringService.ts # ํตํฉ ์ ์ ๊ณ์ฐ
โ โ โ โโโ WeatherService.ts # ๋ ์จ ์ ๋ณด ์์ง
โ โ โ โโโ FoodService.ts # ์์ ์นดํ
๊ณ ๋ฆฌ ๊ด๋ฆฌ
โ โ โ โโโ UserHistoryService.ts # ์ฌ์ฉ์ ์ ํธ๋ ๋ถ์
โ โ โ โโโ ...
โ โ โโโ providers/ # ์ธ๋ถ API ํ๋ก๋ฐ์ด๋
โ โ โ โโโ restaurant/RestaurantProvider.ts
โ โ โโโ api/ # Nestia ์๋์์ฑ API ๊ตฌ์กฐ์ฒด & SDK
โ โ โ โโโ structures/ # API ํ์
์ ์
โ โ โ โโโ functional/ # ์๋์์ฑ SDK ํด๋ผ์ด์ธํธ
โ โ โโโ data/ # ์ ์ ๋ฐ์ดํฐ (์์ ์นดํ
๊ณ ๋ฆฌ, ๋์ ์ขํ)
โ โ โโโ utils/ # ์ ํธ๋ฆฌํฐ ํจ์ (์ขํ ๋ณํ, ์๋ฌ ์ฒ๋ฆฌ ๋ฑ)
โ โ โโโ modules/ # NestJS ๋ชจ๋
โ โ โโโ executable/ # ์คํ ์ง์
์ (server, swagger)
โ โโโ test/ # E2E ํ
์คํธ
โ โโโ packages/api/ # ๋ฐฐํฌ ๊ฐ๋ฅํ API SDK ํจํค์ง
โ โโโ lib/ # ์ปดํ์ผ๋ ์ฝ๋
โ
โโโ client/ # React ํ๋ก ํธ์๋
โ โโโ src/
โ โ โโโ components/ # React ์ปดํฌ๋ํธ
โ โ โโโ hooks/ # ์ปค์คํ
ํ
โ โ โโโ provider/ # Context ํ๋ก๋ฐ์ด๋
โ โ โโโ App.tsx # ๋ฉ์ธ ์ฑ
โ โโโ dist/ # ๋น๋ ๊ฒฐ๊ณผ๋ฌผ
โ
โโโ README.md # ์ด ๋ฌธ์
cd server
# ํ
์คํธ ๋น๋ ๋ฐ ์ ์ฒด ํ
์คํธ ์คํ
npm run build:test
npm test # ๋๋ bun test
# ๊ฐ๋ณ ํ
์คํธ ํ์ผ ์คํ
node bin/test/features/api/<test-file>.js
# Bun ์ ์ฉ ํ
์คํธ ์คํฌ๋ฆฝํธ
bun run bun:test # ๋ชจ๋ ์ ๋ ํ
์คํธ
bun run bun:test:unit # ์ ๋ ํ
์คํธ๋ง
bun run bun:test:integration # ํตํฉ ํ
์คํธ๋ง
bun run bun:test:all # ์ ์ฒด ํ
์คํธ (์ ๋ + ํตํฉ)
# Webpack ๋น๋ ํ
์คํธ
npm run test:webpack์ปจํธ๋กค๋ฌ ์ธํฐํ์ด์ค ์์ ํ ๋ฐ๋์ SDK๋ฅผ ์ฌ์์ฑํด์ผ ํฉ๋๋ค:
cd server
npm run build:sdk # ๋๋ bun run build:sdkcd server
# Linting
npm run eslint # ๋๋ bun run eslint
npm run eslint:fix # ๋๋ bun run eslint:fix
# Formatting
npm run prettier # ๋๋ bun run prettier์๋ฒ ์คํ ํ http://localhost:37001/editor ์์ API ๋ฌธ์ ํ์ธ ๊ฐ๋ฅ
์ด ํ๋ก์ ํธ๋ MIT License๋ก ๋ฐฐํฌ๋ฉ๋๋ค.
Copyright (c) 2025 WiSoft
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction...
์์ธํ ๋ด์ฉ์ LICENSE ํ์ผ์ ์ฐธ์กฐํ์ธ์.
์ด ํ๋ก์ ํธ๋ ๋ค์ํ ์คํ์์ค ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ฅผ ์ฌ์ฉํฉ๋๋ค:
- server/NOTICE: ๋ฐฑ์๋ ์ข ์์ฑ ๋ผ์ด์ ์ค ๋ชฉ๋ก
- client/NOTICE: ํ๋ก ํธ์๋ ์ข ์์ฑ ๋ผ์ด์ ์ค ๋ชฉ๋ก
์ข ์์ฑ ๋ผ์ด์ ์ค ํ์ธ:
cd server && npx license-checker --summary # ๋๋ bunx license-checker --summary
cd client && npx license-checker --summary # ๋๋ bunx license-checker --summary๋ณธ ํ๋ก์ ํธ๋ Agentica ํ๋ ์์ํฌ ํ์ฉ ๋ํ๋ฅผ ์ํด ๊ฐ๋ฐ๋์์ต๋๋ค.
- Agentica RPC ํ์ฉ: ๋ฉํฐ ์์ด์ ํธ ์ค์ผ์คํธ๋ ์ด์ ์ผ๋ก ๋ณต์กํ ์ถ์ฒ ๋ก์ง ๊ตฌํ
- ์ค์๊ฐ Function Calling: OpenAI Function Calling๊ณผ ์์ด์ ํธ ํตํฉ
- ํ์ ์์ ์ฑ: TypeScript + Typia + Nestia๋ก ์๋ํฌ์๋ ํ์ ์์ ์ฑ ๋ณด์ฅ
- ํ์ฅ ๊ฐ๋ฅํ ์ํคํ ์ฒ: ์๋น์ค ๊ธฐ๋ฐ ์ค๊ณ๋ก ์๋ก์ด ์ถ์ฒ ์์ ์ถ๊ฐ ์ฉ์ด
Team WiSoft
- ํ์ฅ: YuJaeyoung
- ํ์: MoonDongmin
ํ๋ก์ ํธ ๊ด๋ จ ๋ฌธ์์ฌํญ์ GitHub Issues๋ฅผ ํตํด ๋จ๊ฒจ์ฃผ์ธ์.
Built with โค๏ธ using Agentica