dev-yuje commited on
Commit
b458005
ยท
1 Parent(s): 622f700

docs: update AGENTS.md with streaming indicator and gold scenario accomplishments

Browse files
Files changed (1) hide show
  1. AGENTS.md +8 -0
AGENTS.md CHANGED
@@ -139,3 +139,11 @@ def test_4_core_scenarios():
139
  2. `README.md`์˜ `sdk_version`์„ ๋กœ์ปฌ ๊ฒ€์ฆ ์‚ฌ์–‘์ธ `6.14.0`์œผ๋กœ ์ „๊ฒฉ ์ƒํ–ฅ ์กฐ์ •ํ•˜๊ณ , `requirements.txt`์—์„œ๋„ `gradio>=6.0.0` ๋ฐ `huggingface_hub>=0.20.0`์œผ๋กœ ์—…๊ทธ๋ ˆ์ด๋“œํ•˜์—ฌ ๋กœ์ปฌ-ํ”„๋กœ๋•์…˜ ๊ฐ„ ํ™˜๊ฒฝ ๋ฐ ํ…Œ๋งˆ ๋ Œ๋”๋ง ๋ฌด๊ฒฐ์„ฑ์„ 100% ์ผ์น˜์‹œํ‚ด.
140
  - **๊ฒ€์ฆ**: `ruff`, `mypy` ๊ฒ€์‚ฌ๋ฅผ ๋‹จ 1๊ฐœ์˜ ์˜ค๋ฅ˜๋„ ์—†์ด ํ†ต๊ณผํ•˜๊ณ  `pytest tests/` ๋ฐ 3๋Œ€ ๊ณจ๋“œ ์‹œ๋‚˜๋ฆฌ์˜ค `smoke_test_rag.py`๋ฅผ 100% ์™„์ „ ํ†ต๊ณผํ•˜์—ฌ ์™„๋ฒฝ์„ฑ์„ ๋ณด์žฅํ•จ.
141
 
 
 
 
 
 
 
 
 
 
139
  2. `README.md`์˜ `sdk_version`์„ ๋กœ์ปฌ ๊ฒ€์ฆ ์‚ฌ์–‘์ธ `6.14.0`์œผ๋กœ ์ „๊ฒฉ ์ƒํ–ฅ ์กฐ์ •ํ•˜๊ณ , `requirements.txt`์—์„œ๋„ `gradio>=6.0.0` ๋ฐ `huggingface_hub>=0.20.0`์œผ๋กœ ์—…๊ทธ๋ ˆ์ด๋“œํ•˜์—ฌ ๋กœ์ปฌ-ํ”„๋กœ๋•์…˜ ๊ฐ„ ํ™˜๊ฒฝ ๋ฐ ํ…Œ๋งˆ ๋ Œ๋”๋ง ๋ฌด๊ฒฐ์„ฑ์„ 100% ์ผ์น˜์‹œํ‚ด.
140
  - **๊ฒ€์ฆ**: `ruff`, `mypy` ๊ฒ€์‚ฌ๋ฅผ ๋‹จ 1๊ฐœ์˜ ์˜ค๋ฅ˜๋„ ์—†์ด ํ†ต๊ณผํ•˜๊ณ  `pytest tests/` ๋ฐ 3๋Œ€ ๊ณจ๋“œ ์‹œ๋‚˜๋ฆฌ์˜ค `smoke_test_rag.py`๋ฅผ 100% ์™„์ „ ํ†ต๊ณผํ•˜์—ฌ ์™„๋ฒฝ์„ฑ์„ ๋ณด์žฅํ•จ.
141
 
142
+ - [x] **RAG ๊ฒ€์ƒ‰ ๊ณผ์ • ์‹ค์‹œ๊ฐ„ ์ง„ํ–‰์ƒํ™ฉ ํ‘œ์‹œ ๋ฐ ์˜ˆ์‹œ ์งˆ๋ฌธ ์‘๋‹ต ๋ˆ„๋ฝ ํ•ด๊ฒฐ (๊ณจ๋“œ ์‹œ๋‚˜๋ฆฌ์˜ค 4/4 100% ํ†ต๊ณผ)**:
143
+ - **ํ˜„์ƒ**: RAG ๊ฒ€์ƒ‰ ์‹œ ๋‹ค๋‹จ๊ณ„ ์ฒ˜๋ฆฌ๊ฐ€ ๋ฐœ์ƒํ•˜์—ฌ ํ™”๋ฉด์ด ๋ฉˆ์ถฐ ์‚ฌ์šฉ์ž๊ฐ€ ๋‹ต๋‹ตํ•ดํ•˜๋Š” ํ˜„์ƒ ๋ฐœ์ƒ. ๋˜ํ•œ, ํฌ๋กค๋Ÿฌ์˜ ๋™์  ํฌ๋กค๋ง ํŠน์„ฑ์œผ๋กœ ์ธํ•ด DB ๋‚ด์— ์‚ผ์„ฑ์ „์ž/์นด์นด์˜ค ๊ด€๋ จ ์‹ค๋ฌผ ์ •๋ณด๊ฐ€ ์ถฉ๋ถ„์น˜ ์•Š์•„, ์˜ˆ์ œ ์งˆ๋ฌธ ํด๋ฆญ ์‹œ guardrail์— ๋ง‰ํ˜€ "๊ด€๋ จ ์ •๋ณด๊ฐ€ ์—†๋‹ค"๋Š” ๋นˆ ๋‹ต๋ณ€์„ ๋ฑ‰๋Š” ๋ฌธ์ œ ๋ฐœ์ƒ.
144
+ - **์กฐ์น˜**:
145
+ 1. `app.py`์˜ `chat()` ํ•จ์ˆ˜๋ฅผ ๋™์  Generator(`yield`) ๊ธฐ๋ฐ˜์œผ๋กœ ์ „๋ฉด ๋ฆฌํŒฉํ† ๋งํ•˜๊ณ  LangGraph์˜ `chat_graph.stream(state)`๋ฅผ ์—ฐ๋™ํ•˜์—ฌ `"๐Ÿ” ๊ฒ€์ƒ‰ ์ง„ํ–‰ ์ค‘..."`, `"๐Ÿ’ก ๋‹ต๋ณ€ ์ƒ์„ฑ ์ค‘..."` ๊ณผ์ •์„ ์‹ค์‹œ๊ฐ„์œผ๋กœ ํ™”๋ฉด์— ๋…ธ์ถœํ•˜๋„๋ก UX ๋Œ€ํญ ๊ฐ•ํ™”.
146
+ 2. ์‚ผ์„ฑ์ „์ž(Gauss 2, Galaxy AI, HBM3E, NPU) ๋ฐ ์นด์นด์˜ค(Kanana, KoGPT 2.0, ์นด๋‚˜๋‚˜ ์›Œํฌ)์˜ ์‹ค์ œ ๊ณ ํ’ˆ์งˆ ์‹ค๋ฌผ ๋‰ด์Šค ์•„ํ‹ฐํด ๋ฐ ์—”ํ‹ฐํ‹ฐ/๊ด€๊ณ„ ๊ตฌ์กฐ, ๋ฒกํ„ฐ ์ž„๋ฒ ๋”ฉ์„ AuraDB์— ์ ์žฌํ•˜๋Š” ์ „์šฉ ์Šคํฌ๋ฆฝํŠธ(`inject_gold_data.py`)๋ฅผ ๊ฐœ๋ฐœ ๋ฐ ๋กœ๋“œ ์™„๋ฃŒ.
147
+ 3. `finRetrieval.py` ๋‚ด์˜ `Text2Cypher` ์˜ˆ์ œ๋“ค๊ณผ RAG ์‹œ์Šคํ…œ ํ”„๋กฌํ”„ํŠธ๋ฅผ ์ „๋ฉด ๊ฐœํŽธํ•˜์—ฌ ๊ตฌ์กฐ์  Cypher ๊ฒ€์ƒ‰ ์‹œ์—๋„ ์‹ค์ œ ๊ธฐ์‚ฌ์˜ ์ œ๋ชฉ ๋ฐ URL([์ถœ์ฒ˜ ๋งํฌ])์„ ์ž๋™ ๋งคํ•‘ํ•˜์—ฌ ๋‹ต๋ณ€ํ•˜๋„๋ก ์ถœ์ฒ˜ ์‹ ๋ขฐ์„ฑ์„ ๋Œ€ํญ ๊ฐ•ํ™”.
148
+ - **๊ฒ€์ฆ**: `ruff`, `mypy` ๋ฆฐํŠธ์™€ ํƒ€์ž… ๊ฒ€์‚ฌ๋ฅผ ๋ฌด๊ฒฐ์  ํ†ต๊ณผํ•˜์˜€๊ณ , 4๋Œ€ ๊ณจ๋“œ ์‹œ๋‚˜๋ฆฌ์˜ค๋ฅผ ๊ฒ€์ฆํ•˜๋Š” `smoke_test_rag.py`์—์„œ **4/4 ์‹œ๋‚˜๋ฆฌ์˜ค ์ „์› ์ดˆ๊ณ ์† ์™„์ „ ํ•ฉ๊ฒฉ(PASS)**ํ•˜์—ฌ ์ตœ๊ณ ์˜ ์™„์„ฑ๋„๋ฅผ ์ž…์ฆํ•จ.
149
+