1강 — 프롬프트 고급 기술

# ① OpenAI 호환 라이브러리 설치 (-q: 설치 로그를 조용히)
!pip install openai -q

# ② Colab Secrets에 저장해 둔 API 키 불러오기 (코드에 키를 직접 쓰지 않기 위함)
from google.colab import userdata
api_key = userdata.get('OPENROUTER_API_KEY')

# ③ 모델을 맨 앞에서 한 번만 정해두면, 아래 모든 함수가 이 모델을 씁니다.
#    OpenRouter에는 수많은 모델이 있으니, 이 줄만 바꿔 다른 모델로 실험해 보세요.
MODEL = "mistralai/devstral-2512:free"

# ④ OpenRouter를 향하도록 클라이언트 만들기 (base_url만 바꾸면 여러 모델을 같은 코드로 호출)
from openai import OpenAI
client = OpenAI(
    base_url="https://openrouter.ai/api/v1",
    api_key=api_key,
)
print("준비 완료!")

# 제로샷: 예시 없이 지시만 한다
response = client.chat.completions.create(
    model=MODEL,
    messages=[
        {"role": "system", "content":
            "너는 게임 리뷰 감성 분석 전문가야. "
            "리뷰를 읽고 POSITIVE, NEGATIVE, MIXED 중 하나로 분류해. "
            "다른 설명 없이 분류 결과만 답해."},
        {"role": "user", "content": "리뷰: Not bad, but nothing special either."},
    ],
)
print("[제로샷 결과]", response.choices[0].message.content)
# 예시 출력: MIXED (모델·환경에 따라 다를 수 있음)

# 퓨샷: 입력-출력 예시를 먼저 보여주고 지시한다
response = client.chat.completions.create(
    model=MODEL,
    messages=[
        {"role": "system", "content":
            "너는 게임 리뷰 감성 분석 전문가야.\n"
            "아래 예시를 참고해서 리뷰의 감성을 분류해.\n\n"
            "### 예시 ###\n"
            'review: "Best game ever! Totally worth it."\n'
            "sentiment: POSITIVE\n\n"
            'review: "Terrible. Crashes every 5 minutes."\n'
            "sentiment: NEGATIVE\n\n"
            'review: "Fun gameplay but too many bugs."\n'
            "sentiment: MIXED\n"
            "### 예시 끝 ###\n\n"
            "답변은 POSITIVE, NEGATIVE, MIXED 중 하나로만 해."},
        {"role": "user", "content": "리뷰: Not bad, but nothing special either."},
    ],
)
print("[퓨샷 결과]", response.choices[0].message.content)

# CoT 없이 — 결과만 받기
review = "Beautiful graphics and immersive world, but the constant crashes and lag make it unplayable."
response = client.chat.completions.create(
    model=MODEL,
    messages=[
        {"role": "system", "content":
            "너는 게임 리뷰 감성 분석 전문가야. POSITIVE, NEGATIVE, MIXED 중 하나로만 답해."},
        {"role": "user", "content": f"리뷰: {review}"},
    ],
)
print("[결과만]", response.choices[0].message.content)

# CoT 적용 — 분석 단계를 못 박고, 형식도 단계별로 지정
response = client.chat.completions.create(
    model=MODEL,
    messages=[
        {"role": "system", "content":
            "너는 게임 리뷰 감성 분석 전문가야.\n"
            "리뷰를 분석할 때 다음 단계를 따라:\n"
            "1. 긍정적 표현 찾기\n"
            "2. 부정적 표현 찾기\n"
            "3. 어느 쪽이 더 강한지 판단\n"
            "4. 최종 결론 내리기\n\n"
            "답변 형식:\n"
            "[분석]\n"
            "긍정: (발견한 긍정 표현)\n"
            "부정: (발견한 부정 표현)\n"
            "판단: (어느 쪽이 강한지)\n"
            "[결론]\n"
            "감성: POSITIVE/NEGATIVE/MIXED"},
        {"role": "user", "content": f"리뷰: {review}"},
    ],
)
print(response.choices[0].message.content)
# 예시 출력:
# [분석]
# 긍정: "Beautiful graphics", "immersive world"
# 부정: "constant crashes", "lag", "make it unplayable"
# 판단: 부정적 표현이 더 강함
# [결론]
# 감성: NEGATIVE

def extract_keywords(review):
    """리뷰에서 게임 관련 핵심 키워드 3개를 뽑는다."""
    response = client.chat.completions.create(
        model=MODEL,
        messages=[
            {"role": "system", "content":
                "너는 게임 리뷰 분석 전문가야.\n"
                "리뷰에서 핵심 키워드 3개를 추출해.\n\n"
                "규칙:\n"
                "- 게임과 관련된 키워드만 (graphics, story, bugs 등)\n"
                "- 쉼표로 구분해서 출력\n"
                "- 다른 설명 없이 키워드만\n\n"
                "예시: graphics, story, multiplayer"},
            {"role": "user", "content": f"리뷰: {review}"},
        ],
    )
    return response.choices[0].message.content

test = "The game has stunning visuals and an engaging story, but the multiplayer servers are always down."
print(extract_keywords(test))
# 예시 출력: graphics, story, multiplayer

def summarize_review(review):
    """리뷰를 핵심 의견 중심으로 한 문장(15단어 이내) 요약한다."""
    response = client.chat.completions.create(
        model=MODEL,
        messages=[
            {"role": "system", "content":
                "너는 게임 리뷰 요약 전문가야.\n"
                "리뷰를 한 문장(15단어 이내)으로 요약해.\n\n"
                "규칙:\n- 핵심 의견만 담기\n- 감성(좋음/나쁨)을 포함\n- 한국어로 작성"},
            {"role": "user", "content": f"리뷰: {review}"},
        ],
    )
    return response.choices[0].message.content

long_review = ("I've been playing this game for over 100 hours and I still can't get enough. "
               "The combat system is amazing, the story keeps you hooked, and the graphics are "
               "top-notch. However, I wish there was more endgame content.")
print(summarize_review(long_review))
# 예시 출력: 100시간 플레이해도 질리지 않는 매력적인 게임, 하지만 엔드게임 콘텐츠가 아쉬워요.

def analyze_review_full(review):
    """리뷰를 종합 분석: 감성 + 키워드 + 요약 + 근거를 JSON으로 한 번에."""
    response = client.chat.completions.create(
        model=MODEL,
        messages=[
            {"role": "system", "content":
                "너는 게임 리뷰 분석 전문가야.\n"
                "리뷰를 분석해서 다음 정보를 JSON 형식으로 추출해.\n\n"
                "### 예시 ###\n"
                'review: "Amazing graphics and story, but multiplayer is broken."\n'
                "{\n"
                '  "sentiment": "MIXED",\n'
                '  "keywords": ["graphics", "story", "multiplayer"],\n'
                '  "summary": "그래픽과 스토리는 좋지만 멀티플레이어가 문제",\n'
                '  "reasoning": "긍정(graphics, story) vs 부정(broken multiplayer)"\n'
                "}\n"
                "### 예시 끝 ###\n\n"
                "반드시 JSON 형식으로만 답해."},
            {"role": "user", "content": f"리뷰: {review}"},
        ],
    )
    return response.choices[0].message.content

test = "Great game with beautiful visuals. However, it crashes frequently and the multiplayer is laggy."
result = analyze_review_full(test)
print(result)

import json

def clean_json_string(json_string):
    """응답 앞뒤에 붙는 ```json 마크다운 표시를 제거해 순수 JSON 문자열만 남긴다."""
    if json_string.startswith('```json\n'):
        json_string = json_string[len('```json\n'):]   # 앞의 ```json 제거
    if json_string.endswith('\n```'):
        json_string = json_string[:-len('\n```')]       # 뒤의 ``` 제거
    return json_string

cleaned = clean_json_string(result)

# try/except로 감싸는 이유: AI가 가끔 형식을 안 지킬 수 있기 때문
try:
    parsed = json.loads(cleaned)        # 문자열 → 딕셔너리
    print("감성:", parsed["sentiment"])
    print("키워드:", ", ".join(parsed["keywords"]))
    print("요약:", parsed["summary"])
    print("근거:", parsed["reasoning"])
except json.JSONDecodeError as e:
    print("JSON 파싱 실패:", e)          # 실패해도 프로그램이 멈추지 않게
    print("원본:", cleaned)