프롬프트 엔지니어링: 서비스용 프롬프트 설계

1. Role (역할)
"You are a [전문가] who [전문성]"

2. Task (작업)
"Your task is to [구체적 목표]"

3. Constraints (제약)
"Always follow these rules:
- [규칙 1]
- [규칙 2]"

4. Output Format (출력)
"Respond in this format:
[형식 예시]"

const SYSTEM_PROMPT = `You are an English grammar tutor for Korean professionals.

Your task: Analyze the user's English text and provide:
1. Corrections with explanations in Korean
2. More natural alternatives
3. Common mistake pattern (if applicable)

Constraints:
- Tone: Encouraging, not condescending
- Length: Concise (max 300 words)
- Always explain WHY in Korean
- Suggest 2-3 alternative phrasings

Output format:
## 원문
[user input]

## 수정사항
[bullet list with Korean explanation]

## 자연스러운 대안
1. [alternative 1]
2. [alternative 2]

## 같은 실수 패턴
[if applicable]`;

const messages = [
  { role: 'system', content: SYSTEM_PROMPT },
  // 예시 1
  { role: 'user', content: 'I want to discuss about the project.' },
  { role: 'assistant', content: `## 수정사항
- "discuss about" → "discuss" (discuss는 자동사)

## 자연스러운 대안
1. I want to discuss the project.
2. I'd like to talk about the project.` },
  // 예시 2
  { role: 'user', content: 'I am agree with you.' },
  { role: 'assistant', content: `## 수정사항
- "I am agree" → "I agree" (agree는 동사, be 동사 불필요)` },
  // 실제
  { role: 'user', content: userInput },
];

import { generateObject } from 'ai';
import { z } from 'zod';

const ResultSchema = z.object({
  correction: z.string(),
  explanation: z.string().describe('Korean explanation'),
  alternatives: z.array(z.string()).min(2).max(3),
  pattern: z.string().optional(),
  confidence: z.number().min(0).max(1),
});

const { object } = await generateObject({
  model: anthropic('claude-sonnet-4-6'),
  schema: ResultSchema,
  prompt: `Analyze this English: "${userInput}"`,
});

// object.correction, object.alternatives 등 타입 안전

// lib/prompts.ts
export const PROMPTS = {
  englishTutor: {
    system: `You are an English tutor...`,
    examples: [...],
    version: '1.2.0',
  },
  contentWriter: {
    system: `You are a content writer...`,
    version: '2.0.0',
  },
};


// 사용
const result = streamText({
  system: PROMPTS.englishTutor.system,
  messages,
});


// 버전 업데이트 시 — 명시적
// A/B 테스트 가능

1. 너무 긴 시스템 프롬프트 → 비용·성능 저하
   → 핵심만 (300 토큰 이내)

2. 한국어 + 영어 혼용 일관성
   → 명확히 명시

3. Hallucination 방지
   → "If uncertain, say 'I don't know'"
   → "Only use information from the provided context"

4. Jailbreak 방어
   → 시스템 프롬프트로 제한
   → 사용자 입력 검증

// 같은 시스템 프롬프트 반복 → 캐시
const result = streamText({
  model: anthropic('claude-sonnet-4-6'),
  messages: [
    {
      role: 'system',
      content: LONG_SYSTEM_PROMPT,
      // ↓ 캐시 활성화
      providerOptions: { anthropic: { cacheControl: { type: 'ephemeral' } } },
    },
    ...messages,
  ],
});


// 효과:
// - 비용 90% 감소 (캐시 히트)
// - 응답 시간 50% 단축