RAG6_AgenticAI / README.md
jeongsoo's picture
RAG ๋ฆฌํŠธ๋ฆฌ๋ฒ„ ์ดˆ๊ธฐํ™” ์‹คํŒจ ๋ฌธ์ œ ํ•ด๊ฒฐ
2a02f66
---
title: RAG6 AgenticAI
emoji: ๐Ÿ‘
colorFrom: green
colorTo: green
sdk: gradio
sdk_version: 5.27.0
app_file: app.py
pinned: false
license: mit
---
# RAG6 AgenticAI - ๊ฐœ์„ ๋œ RAG ๊ฒ€์ƒ‰ ์ฑ—๋ด‡
RAG(Retrieval-Augmented Generation) ๊ธฐ๋ฐ˜์˜ ๋ฌธ์„œ ๊ฒ€์ƒ‰ ๋ฐ ์งˆ์˜์‘๋‹ต ์ฑ—๋ด‡ ์‹œ์Šคํ…œ์ž…๋‹ˆ๋‹ค.
## ์ฃผ์š” ๊ธฐ๋Šฅ
- ํ…์ŠคํŠธ ๊ธฐ๋ฐ˜ ์ฑ—๋ด‡ (RAG)
- ์Œ์„ฑ ์ธ์‹ ๊ธฐ๋ฐ˜ ๋Œ€ํ™”
- ๋ฌธ์„œ ํŒŒ์ผ ์—…๋กœ๋“œ ๋ฐ ์ธ๋ฑ์‹ฑ
- ๋‹ค์–‘ํ•œ LLM ๋ชจ๋ธ ์ง€์›
- ๊ด€๋ฆฌ์ž ์ธ์ฆ ๊ธฐ๋Šฅ
## ์‹œ์Šคํ…œ ์•„ํ‚คํ…์ฒ˜
์ด ์‹œ์Šคํ…œ์€ ๋‹ค์Œ๊ณผ ๊ฐ™์€ ์ฃผ์š” ๊ตฌ์„ฑ ์š”์†Œ๋กœ ์ด๋ฃจ์–ด์ ธ ์žˆ์Šต๋‹ˆ๋‹ค:
1. **Flask ์›น ์„œ๋ฒ„**: ํ”„๋ก ํŠธ์—”๋“œ ๋ฐ API ์ œ๊ณต
2. **VectorRetriever**: ๋ฌธ์„œ ์ธ๋ฑ์‹ฑ ๋ฐ ๋ฒกํ„ฐ ๊ฒ€์ƒ‰
3. **ReRanker**: ๊ฒ€์ƒ‰ ๊ฒฐ๊ณผ ์žฌ์ˆœ์œ„ํ™”
4. **LLM ์ธํ„ฐํŽ˜์ด์Šค**: ๋‹ค์–‘ํ•œ LLM API ์—ฐ๊ฒฐ
5. **STT(Speech-to-Text)**: ์Œ์„ฑ ์ธ์‹ ์ง€์›
## ๊ฐœ์„ ๋œ ๊ธฐ๋Šฅ
์ด๋ฒˆ ๋ฒ„์ „์—์„œ๋Š” ๋‹ค์Œ๊ณผ ๊ฐ™์€ ๊ฐœ์„  ์‚ฌํ•ญ์ด ์ ์šฉ๋˜์—ˆ์Šต๋‹ˆ๋‹ค:
- **์•ˆ์ •์„ฑ ํ–ฅ์ƒ**: ๋ฆฌํŠธ๋ฆฌ๋ฒ„ ์ดˆ๊ธฐํ™” ์‹คํŒจ ๋ฌธ์ œ ํ•ด๊ฒฐ
- **์˜ค๋ฅ˜ ์ฒ˜๋ฆฌ ๊ฐ•ํ™”**: ์ดˆ๊ธฐํ™” ์‹คํŒจ ์›์ธ ์ถ”์  ๋ฐ ๋ช…ํ™•ํ•œ ํ”ผ๋“œ๋ฐฑ ์ œ๊ณต
- **๋ชจ๋“ˆํ™” ๊ฐœ์„ **: ์ฝ”๋“œ ๋ถ„ํ•  ๋ฐ ๊ธฐ๋Šฅ๋ณ„ ๋ชจ๋“ˆํ™”๋กœ ์œ ์ง€๋ณด์ˆ˜์„ฑ ํ–ฅ์ƒ
- **์ƒํƒœ ๊ด€๋ฆฌ**: ์•ฑ ์ค€๋น„ ์ƒํƒœ์™€ ์ดˆ๊ธฐํ™” ์„ฑ๊ณต ์—ฌ๋ถ€ ๋ถ„๋ฆฌ ๊ด€๋ฆฌ
- **์‚ฌ์šฉ์ž ๊ฒฝํ—˜**: ์˜ค๋ฅ˜ ๋ฐœ์ƒ ์‹œ์—๋„ ์•ฑ ์ ‘๊ทผ์„ฑ ์œ ์ง€์™€ ๋ช…ํ™•ํ•œ ํ”ผ๋“œ๋ฐฑ
## ์„ค์น˜ ๋ฐ ์‹คํ–‰
```bash
# ๊ฐ€์ƒํ™˜๊ฒฝ ์ƒ์„ฑ ๋ฐ ํ™œ์„ฑํ™”
python -m venv venv
source venv/bin/activate # ๋˜๋Š” Windows: venv\Scripts\activate
# ์˜์กด์„ฑ ์„ค์น˜
pip install -r requirements.txt
# ์•ฑ ์‹คํ–‰
python app.py
```
## ํ™˜๊ฒฝ ๋ณ€์ˆ˜
ํ•„์š”ํ•œ ํ™˜๊ฒฝ ๋ณ€์ˆ˜๋Š” ๋‹ค์Œ๊ณผ ๊ฐ™์Šต๋‹ˆ๋‹ค:
- `ADMIN_USERNAME`: ๊ด€๋ฆฌ์ž ์‚ฌ์šฉ์ž๋ช… (๊ธฐ๋ณธ๊ฐ’: "admin")
- `ADMIN_PASSWORD`: ๊ด€๋ฆฌ์ž ๋น„๋ฐ€๋ฒˆํ˜ธ (๊ธฐ๋ณธ๊ฐ’: "rag12345")
- `FLASK_SECRET_KEY`: Flask ์„ธ์…˜ ์•”ํ˜ธํ™” ํ‚ค
- `PORT`: ์„œ๋ฒ„ ํฌํŠธ (๊ธฐ๋ณธ๊ฐ’: 7860)
## ๋ผ์ด์„ผ์Šค
MIT License
Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference