Gemma-2 RAG Generator ๋ชจ๋ธ README
์๊ฐ
์ด ๋ชจ๋ธ์ RAG(Retrieval-Augmented Generation) ์์คํ
์ Generator ๋ถ๋ถ์ ์ต์ ํํ ํ๊ตญ์ด ๊ธฐ๋ฐ 2B ๋ชจ๋ธ, Gemma-2์
๋๋ค.
Gemma-2๋ ์ธ๋ถ ๊ฒ์์์ ๋ฐํ๋ ์ ๋ณด๋ฅผ ๊ธฐ๋ฐ์ผ๋ก ์์ฐ์ค๋ฌ์ด ๋ต๋ณ์ ์์ฑํ๋ฉฐ, ํ์ํ ๊ฒฝ์ฐ ๊ฐ์ฃผ๋ฅผ ๋ถ์ฌ ์ถ์ฒ๋ฅผ ๋ช
์ํฉ๋๋ค.
ํนํ, ๋ํ ๊ธฐ๋ก, ์ปจํ
์คํธ ์ ๋ณด(๋ฌธ์ ์ ๋ชฉ, ๋ญํฌ, ๋ณธ๋ฌธ ์ฒญํฌ), ๊ทธ๋ฆฌ๊ณ ์ฌ์ฉ์ ์
๋ ฅ์ ์กฐํฉํ์ฌ ๋์ ํ์ง์ ์๋ต์ ์ ๊ณตํฉ๋๋ค.
์ฃผ์ ํน์ง
- RAG Generator ์ต์ ํ: ๊ฒ์ ๊ฒฐ๊ณผ๋ฅผ ๊ธฐ๋ฐ์ผ๋ก ๋ต๋ณ์ ์์ฑํ๋ฉฐ, ์ ๋ณด๋ฅผ ์ ํ์ ์ผ๋ก ํ์ฉํ์ฌ ์ ๋ขฐ์ฑ์ ๋์์ต๋๋ค.
- ๊ฐ์ฃผ ์ฒ๋ฆฌ: ์ ๋ณด์ ์ถ์ฒ๋ฅผ ๋ช ํํ ์ ์ ์๋๋ก ์ปจํ ์คํธ์์ ๊ฐ์ ธ์จ ์ ๋ณด๋ฅผ ๊ฐ์ฃผ ํํ๋ก ํ์ํฉ๋๋ค.
- ํ๊ตญ์ด ์ต์ ํ: ํ๊ตญ์ด ๋ฐ์ดํฐ์ ํนํ๋ ๋ชจ๋ธ๋ก, ํ๊ตญ์ด ์ฌ์ฉ์์๊ฒ ์ต์ ์ ์ฑ๋ฅ์ ์ ๊ณตํฉ๋๋ค.
์ฌ์ฉ๋ฒ
1. ํ๋กฌํํธ ํ ํ๋ฆฟ
Gemma-2 ๋ชจ๋ธ์ ๋ค์๊ณผ ๊ฐ์ ํ๋กฌํํธ ๊ตฌ์กฐ๋ฅผ ์ฌ์ฉํฉ๋๋ค.
### Instruction:
{์์คํ
ํ๋กฌํํธ}
### Conversation:
User: {์ฌ์ฉ์ ๋ํ}
Assistant: {์ด์์คํดํธ ์๋ต}
### Context:
# Index [๋ญํฌ]: {๋ฌธ์ ์ ๋ชฉ}
{๋ฌธ์ ์ฒญํฌ}
# Index [๋ญํฌ]: {๋ฌธ์ ์ ๋ชฉ}
{๋ฌธ์ ์ฒญํฌ}
...
### Input:
{์ฌ์ฉ์ ์
๋ ฅ}
### Response:
{๋ชจ๋ธ ์๋ต}
2. ๊ตฌ์ฑ ์์ ์ค๋ช
- Instruction
- Gemma-2๊ฐ ๋ฐ๋ฅด๋ ์์คํ ์ง์นจ์ ๋๋ค. ๋ชจ๋ธ์ ๋ด์ฅ๋ ๊ธฐ๋ณธ ์์คํ ํ๋กฌํํธ๋ฅผ ์ฌ์ฉํ๋ฉฐ, ํ์์ ๋ฐ๋ผ ์ปค์คํฐ๋ง์ด์ง ๊ฐ๋ฅํฉ๋๋ค.
- ์:
๋น์ ์ ์ธ๋ถ๊ฒ์์ ์ด์ฉํ์ฌ ์ฌ์ฉ์์๊ฒ ๋์์ ์ฃผ๋ ์ธ๊ณต์ง๋ฅ ์กฐ์์ ๋๋ค.
- Conversation
์ฌ์ฉ์์ ์ด์์คํดํธ ๊ฐ์ ๋ํ ๊ธฐ๋ก์ ๋๋ค. ์๋ ํ์์ ๋ฐ๋ฆ ๋๋ค:
- ์ฌ์ฉ์: **
User:
**๋ก ์์ - ์ด์์คํดํธ: **
Assistant:
**๋ก ์์
- ์ฌ์ฉ์: **
์:
User: ์์ธ์ ๋ ์จ๋ ์ด๋์? Assistant: ์ค๋ ์์ธ์ ๋ง๊ณ ํ์ฐฝํฉ๋๋ค.
- Context
์ธ๋ถ ๊ฒ์ ๊ฒฐ๊ณผ์ ๋ญํฌ, ๋ฌธ์ ์ ๋ชฉ, ๋ณธ๋ฌธ ์ฒญํฌ๋ก ๊ตฌ์ฑ๋ฉ๋๋ค.
์์:
- ๋ญํฌ:
# Index [๋ญํฌ]
- ๋ฌธ์ ์ ๋ชฉ:
{๋ฌธ์ ์ ๋ชฉ}
- ๋ณธ๋ฌธ ์ฒญํฌ:
{๋ฌธ์ ์ฒญํฌ}
- ๋ญํฌ:
์:
# Index [1]: ์์ธ์ ๋ ์จ ์์ธ์ ์ค๋ ๋ง๊ณ ํ์ฐฝํ๋ฉฐ ๋ฎ ์ต๊ณ ๊ธฐ์จ์ 25๋์ ๋๋ค. # Index [2]: ๊ธฐ์์ฒญ ์ ๋ณด ์ด๋ฒ ์ฃผ ์์ธ์ ์ ๋ฐ์ ์ผ๋ก ๋ง์ ๋ ์จ๊ฐ ์ด์ด์ง ์์ ์ ๋๋ค.
- Input
- ์ฌ์ฉ์๊ฐ ์ถ๊ฐ๋ก ์ ๋ ฅํ ์ง๋ฌธ์ด๋ ์์ฒญ์ ํฌํจํฉ๋๋ค.
- Response
- ๋ชจ๋ธ์ด ์์ฑํ ๋ต๋ณ์ด ๋ค์ด๊ฐ๋ ๋ถ๋ถ์ ๋๋ค.
3. ์์
์ ๋ ฅ ์์
### Instruction:
๋น์ ์ ์ธ๋ถ๊ฒ์์ ์ด์ฉํ์ฌ ์ฌ์ฉ์์๊ฒ ๋์์ ์ฃผ๋ ์ธ๊ณต์ง๋ฅ ์กฐ์์
๋๋ค.
- Context๋ ์ธ๋ถ๊ฒ์์ ํตํด ๋ฐํ๋ ์ฌ์ฉ์ ์์ฒญ๊ณผ ๊ด๋ จ๋ ์ ๋ณด๋ค์
๋๋ค.
- Context๋ฅผ ํ์ฉํ ๋ ๋ฌธ์ฅ ๋์ ์ฌ์ฉํ ๋ฌธ์ ์กฐ๊ฐ์ [Index]๋ฅผ ๋ถ์ด๊ณ ์์ฐ์ค๋ฌ์ด ๋ต๋ณ์ ์์ฑํ์ธ์. (e.g. [1])
- Context์ ์ ๋ณด๊ฐ ์ฌ์ฉ์ ์์ฒญ๊ณผ ๊ด๋ จ์ด ์๊ฑฐ๋ ๋์์ด ์๋ ์๋ ์์ต๋๋ค. ๊ด๋ จ์๋ ์ ๋ณด๋ง ํ์ฉํ๊ณ , ์๋ ์ ๋ณด๋ฅผ ์ ๋ ์ง์ด๋ด์ง ๋ง์ธ์.
- ๋๋๋ก์ด๋ฉด ์ผ๋ฐ ์ง์์ผ๋ก ๋ต๋ณํ์ง๋ง๊ณ , ์ต๋ํ Context๋ฅผ ํตํด์ ๋ต๋ณ์ ํ๋ ค๊ณ ํ์ธ์. Context์ ์์ ๊ฒฝ์ฐ์๋ ์ด ์ ์ ์ธ๊ธํ๋ฉฐ ์ฌ์ฃํ๊ณ ๋ค๋ฅธ ์ฃผ์ ๋ ์ง๋ฌธ์ ์ถ์ฒํด์ฃผ์ธ์.
- ์ฌ์ฉ์ ์์ฒญ์ ์๋ง๋ ์์ฐ์ค๋ฌ์ด ๋ํ๋ฅผ ํ์ธ์.
- ํญ์ ์กด๋๋ง๋ก ๋ต๋ณํ์ธ์.
### Conversation:
User: ์์ธ์ ๋ ์จ๋ ์ด๋์?
Assistant: ์ค๋ ์์ธ์ ๋ง๊ณ ํ์ฐฝํฉ๋๋ค.
### Context:
# Index [1]: ์์ธ์ ๋ ์จ
์์ธ์ ์ค๋ ๋ง๊ณ ํ์ฐฝํ๋ฉฐ ๋ฎ ์ต๊ณ ๊ธฐ์จ์ 25๋์
๋๋ค.
# Index [2]: ๊ธฐ์์ฒญ ์ ๋ณด
์ด๋ฒ ์ฃผ ์์ธ์ ์ ๋ฐ์ ์ผ๋ก ๋ง์ ๋ ์จ๊ฐ ์ด์ด์ง ์์ ์
๋๋ค.
### Input:
์ด๋ฒ ์ฃผ๋ง์๋ ๋น๊ฐ ์ฌ ๊ฐ๋ฅ์ฑ์ด ์๋์?
### Response:
๊ธฐ์์ฒญ ์ ๋ณด์ ๋ฐ๋ฅด๋ฉด, ์ด๋ฒ ์ฃผ ์์ธ์ ์ ๋ฐ์ ์ผ๋ก ๋ง์ ๋ ์จ๊ฐ ์ด์ด์ง ์์ ์
๋๋ค. ์ฃผ๋ง์๋ ๋น๊ฐ ์ฌ ๊ฐ๋ฅ์ฑ์ ๋ฎ์ต๋๋ค. [2]
4. ์ปจํ ์คํธ ์ถ๊ฐ ๊ฐ์ด๋
- ๊ฒ์ ๊ฒฐ๊ณผ๋ฅผ ์์งํ์ฌ
Context
์ ์ถ๊ฐํฉ๋๋ค. - ๋ญํฌ๋ ๊ฒ์ ๊ฒฐ๊ณผ์ ์ฐ์ ์์๋ฅผ ๊ธฐ๋ฐ์ผ๋ก ์ง์ ํฉ๋๋ค.
- ๋ฌธ์ ์ ๋ชฉ๊ณผ ๋ณธ๋ฌธ ์ฒญํฌ๋ ๊ฐ ๊ฒ์ ๊ฒฐ๊ณผ์ ์ ๋ณด๋ฅผ ์์ถํ์ฌ ๋ฃ์ต๋๋ค.
- ์ฌ๋ฌ ๊ฐ์ ๊ฒ์ ๊ฒฐ๊ณผ๋ฅผ ํฌํจํ๋ ค๋ฉด ์ ์์์ฒ๋ผ ์ฌ๋ฌ
# Index
์น์ ์ ์ถ๊ฐํฉ๋๋ค.
์ถ๋ก ๋ฐฉ๋ฒ
Hugging Face์์ ๋ชจ๋ธ์ ๋ก๋ํฉ๋๋ค:
from transformers import AutoTokenizer, AutoModelForCausalLM tokenizer = AutoTokenizer.from_pretrained("Austin9/gemma-2-2b-it-ko-generator-v2.5") model = AutoModelForCausalLM.from_pretrained("Austin9/gemma-2-2b-it-ko-generator-v2.5")
ํ๋กฌํํธ๋ฅผ ์์ฑํฉ๋๋ค:
prompt = """\ ### Instruction: ๋น์ ์ ์ธ๋ถ๊ฒ์์ ์ด์ฉํ์ฌ ์ฌ์ฉ์์๊ฒ ๋์์ ์ฃผ๋ ์ธ๊ณต์ง๋ฅ ์กฐ์์ ๋๋ค. - Context๋ ์ธ๋ถ๊ฒ์์ ํตํด ๋ฐํ๋ ์ฌ์ฉ์ ์์ฒญ๊ณผ ๊ด๋ จ๋ ์ ๋ณด๋ค์ ๋๋ค. - Context๋ฅผ ํ์ฉํ ๋ ๋ฌธ์ฅ ๋์ ์ฌ์ฉํ ๋ฌธ์ ์กฐ๊ฐ์ [Index]๋ฅผ ๋ถ์ด๊ณ ์์ฐ์ค๋ฌ์ด ๋ต๋ณ์ ์์ฑํ์ธ์. (e.g. [1]) - Context์ ์ ๋ณด๊ฐ ์ฌ์ฉ์ ์์ฒญ๊ณผ ๊ด๋ จ์ด ์๊ฑฐ๋ ๋์์ด ์๋ ์๋ ์์ต๋๋ค. ๊ด๋ จ์๋ ์ ๋ณด๋ง ํ์ฉํ๊ณ , ์๋ ์ ๋ณด๋ฅผ ์ ๋ ์ง์ด๋ด์ง ๋ง์ธ์. - ๋๋๋ก์ด๋ฉด ์ผ๋ฐ ์ง์์ผ๋ก ๋ต๋ณํ์ง๋ง๊ณ , ์ต๋ํ Context๋ฅผ ํตํด์ ๋ต๋ณ์ ํ๋ ค๊ณ ํ์ธ์. Context์ ์์ ๊ฒฝ์ฐ์๋ ์ด ์ ์ ์ธ๊ธํ๋ฉฐ ์ฌ์ฃํ๊ณ ๋ค๋ฅธ ์ฃผ์ ๋ ์ง๋ฌธ์ ์ถ์ฒํด์ฃผ์ธ์. - ์ฌ์ฉ์ ์์ฒญ์ ์๋ง๋ ์์ฐ์ค๋ฌ์ด ๋ํ๋ฅผ ํ์ธ์. - ํญ์ ์กด๋๋ง๋ก ๋ต๋ณํ์ธ์. ### Conversation: User: ์์ธ์ ๋ ์จ๋ ์ด๋์? Assistant: ์ค๋ ์์ธ์ ๋ง๊ณ ํ์ฐฝํฉ๋๋ค. ### Context: # Index [1]: ์์ธ์ ๋ ์จ ์์ธ์ ์ค๋ ๋ง๊ณ ํ์ฐฝํ๋ฉฐ ๋ฎ ์ต๊ณ ๊ธฐ์จ์ 25๋์ ๋๋ค. # Index [2]: ๊ธฐ์์ฒญ ์ ๋ณด ์ด๋ฒ ์ฃผ ์์ธ์ ์ ๋ฐ์ ์ผ๋ก ๋ง์ ๋ ์จ๊ฐ ์ด์ด์ง ์์ ์ ๋๋ค. ### Input: ์ด๋ฒ ์ฃผ๋ง์๋ ๋น๊ฐ ์ฌ ๊ฐ๋ฅ์ฑ์ด ์๋์? ### Response: """ input_ids = tokenizer(prompt, return_tensors="pt").input_ids
์ถ๋ก ์ ์คํํฉ๋๋ค:
output = model.generate(input_ids, max_length=512, do_sample=True, top_p=0.1) response = tokenizer.decode(output[0], skip_special_tokens=True) print(response)
๋ฐ์ดํฐ์
์ด ๋ชจ๋ธ์ ๋ํ ๊ธฐ๋ก, ๊ฒ์ ๊ฒฐ๊ณผ, ์ฌ์ฉ์ ์ ๋ ฅ์ ํฌํจํ ํนํ๋ RAG ํ์ต ๋ฐ์ดํฐ์ ์ ์ฌ์ฉํ์ฌ ํ์ต๋์์ต๋๋ค.
๋ชจ๋ธ์ ๊ฐ์
- ์ปจํ ์คํธ๋ฅผ ํ์ฉํ ๋์ ์ ๋ขฐ์ฑ ์๋ ๋ต๋ณ ์ ๊ณต.
- ๊ฐ์ฃผ๋ฅผ ํตํด ์ถ์ฒ๋ฅผ ๋ช ํํ ํ์.
- ๋ํํ ํ์คํฌ์์ ์ ์ฐํ๊ณ ์์ฐ์ค๋ฌ์ด ์๋ต.
Gemma-2๋ฅผ ํตํด ํ๊ตญ์ด ๋ํ ์์คํ ์์์ ๊ฒ์ ๊ธฐ๋ฐ ์๋ต์ ์ต์ ํํ์ธ์! ๐
Model tree for Austin9/gemma-2-2b-it-ko-generator-v2.5
Base model
unsloth/gemma-2-2b-it