byteforce

CPN 한국어 자습서 · 러닝패스 2 / 4 — Building with the Claude API

프롬프트 평가

전형적인 평가 워크플로

A typical eval workflow

프롬프트 평가가 실제로 굴러가는 다섯 단계를 한눈에 봅니다 — 초안 → 데이터셋 → Claude 응답 → 채점 → 평균. 정해진 표준은 없지만, 이 흐름을 이해하면 다음 레슨들에서 노트북으로 직접 구현할 때 길을 잃지 않습니다.

전체 내레이션영상 나레이션 한국어 번역 (전체)

Stephen Grider · Anthropic 기술 스태프

이 영상에서는 전형적인 프롬프트 평가 워크플로의 모든 단계를 따라가 봅니다. 먼저 두 가지를 짚어 두죠. 첫째, 워크플로를 짜는 방법은 아주 다양합니다. 업계 표준으로 정해진 단 하나의 방법론은 없습니다. 둘째, 직접 워크플로를 구현하도록 도와주는 오픈소스 패키지와 유료 옵션이 많습니다.

이 영상과 모듈에서는 Jupyter 노트북 안에서 우리만의 커스텀 워크플로를 처음부터 구현해 봅니다. 이렇게 하는 이유는 워크플로가 어떻게 동작하는지 이해를 돕기 위함이기도 하고, 프롬프트 평가를 하려고 꼭 무거운 솔루션을 들일 필요는 없다는 걸 보여 주기 위함이기도 합니다. 작게 시작해 감을 잡고, 거기서 확장하면 됩니다.

1단계, 초기 프롬프트 초안을 씁니다. 개선하고 싶은 어떤 프롬프트를 쓰는 거죠. 이 예시에서는 아주 단순하게 "사용자의 질문에 답하라"라고 하고, 사용자 입력(어떤 질문)을 끼워 넣습니다.

2단계, 평가 데이터셋을 만듭니다. 프롬프트에 넣어 볼 수 있는 입력들의 묶음이죠. 우리 프롬프트의 입력은 "사용자 질문" 하나뿐이니, 데이터셋은 넣어 볼 만한 질문들의 목록이 됩니다. 제 데이터셋엔 질문 세 개만 넣겠습니다. 실제 평가에서는 수십, 수백, 수천 개의 레코드가 들어가기도 합니다. 데이터셋은 손으로 만들 수도 있고, Claude로 생성할 수도 있습니다.

데이터셋이 준비되면, 각 질문을 프롬프트에 채워 완성된 프롬프트를 만들고 Claude에 보냅니다. 예를 들어 "사용자의 질문에 답하라 — 2 더하기 2는?"처럼요. 나머지 레코드도 똑같이 반복합니다. 각각을 Claude에 보내 실제 응답을 받습니다. 첫 번째는 "2 더하기 2는 4", 그다음은 오트밀 만드는 법, 그다음은 달까지 거리 같은 응답이 오겠죠.

Claude의 응답이 모이면, 이제 채점합니다. 데이터셋의 질문과 Claude의 응답을 짝지어 grader에 하나씩 넣습니다. grader를 구현하는 방법은 여러 가지이고, 뒤에서 자세히 봅니다. grader는 응답 품질에 따라 1~10점 같은 점수를 줍니다. 10이면 더 개선할 여지가 없는 완벽한 답, 4 정도면 개선 여지가 분명히 있다는 뜻이죠.

점수를 얻으면 전부 평균냅니다. 이 경우 세 점수를 더해 3으로 나누면 평균 7.66 같은 값이 나옵니다. 이제 원래 프롬프트가 얼마나 잘 동작했는지 객관적으로 표현할 수치가 생긴 겁니다.

이 점수가 있으면, 프롬프트를 어떤 식으로 바꾼 뒤 전체 과정을 반복할 수 있습니다. 점수를 올리고 싶으면 프롬프트에 디테일을 더해 보죠 — 예를 들어 끝에 "충분히 자세히 답하라"를 붙입니다. 두 번째 버전으로 파이프라인을 다시 돌리면 v1과 v2의 점수가 생기고, 더 높은 쪽이 — 완벽하진 않아도 — 더 나은 버전이라는 객관적 신호가 됩니다.

이렇게 전체 과정을 큰 그림으로 봤으니, 다음 영상부터 Jupyter 노트북 안에서 우리만의 커스텀 평가 프레임워크를 직접 구현해 보겠습니다.

이 장에서 배우는 것What you'll learn

약 5분
1

정해진 표준 워크플로는 없다 — 도구도 많지만, 우리는 노트북에서 직접·가볍게

2

5단계: 초안 → 데이터셋 → Claude → 채점 → 평균

3

데이터셋은 손으로, 또는 Claude로 생성

4

grader가 1~10점 → 평균 = 객관적 지표

5

프롬프트를 고쳐 반복 → v1 vs v2 점수 비교

6

작게 시작해 점차 확장

먼저 짚고 갈 용어
eval dataset (평가 데이터셋)
프롬프트에 넣어 볼 입력(질문 등)의 목록. 손으로 또는 Claude로 만든다.
grader (채점기)
질문·응답을 받아 점수(예: 1~10)를 내는 장치. 구현 방식은 뒤에서 다룬다.
score · metric (점수·지표)
응답 품질 점수. 평균이 프롬프트의 객관적 지표가 된다.
iterate (반복)
프롬프트를 고쳐 파이프라인을 다시 돌리고 점수를 비교한다.

워크플로 개요

No single standard

먼저 두 가지를 짚어 둡니다. 평가 워크플로를 짜는 표준 방법은 없습니다. 그리고 직접 구현을 돕는 오픈소스·유료 도구도 많습니다.

5단계 파이프라인

The five steps

전체 흐름은 다섯 단계입니다. 아래에서 단계를 눌러, 같은 데이터가 어떻게 점수로 바뀌는지 따라가 보세요.

평가 파이프라인 5단계 · 단계를 눌러 따라가기
프롬프트  ·  사용자의 질문에 답하라: {question}
평균 점수  =  (8 + 7 + 8) / 37.67

입력 하나(질문)짜리 단순 프롬프트라 데이터셋은 질문 목록입니다. 입력이 여러 개면 데이터셋의 각 레코드도 여러 칸을 갖습니다.

점수로 무엇을 하나

Scoring & iterating

점수를 평균내면 프롬프트가 얼마나 잘 동작하는지 하나의 수치로 말할 수 있습니다. 이제 이 수치를 기준으로 개선을 반복합니다.

반복과 비교
  • 프롬프트를 바꿔 본다 — 예: 끝에 "충분히 자세히 답하라"를 더해 원하는 출력을 더 유도.
  • 두 번째 버전으로 전체 파이프라인을 다시 돌린다.
  • v1과 v2의 점수를 비교 — 더 높은 쪽이, 완벽하진 않아도, 더 나은 버전이라는 객관적 신호.
grader는?

점수를 어떻게 매기는지(grader 구현)에는 숨은 복잡성이 있습니다. 모델 기반 채점·코드 기반 채점 등은 뒤 레슨에서 자세히 다룹니다.

정리 & 점검

Recap & check
핵심 정리
  • 표준은 없다 — 노트북에서 직접, 작게 시작.
  • 5단계: 초안 → 데이터셋 → Claude 응답 → 채점 → 평균.
  • grader가 1~10점, 평균이 객관적 지표.
  • 프롬프트를 고쳐 반복하고 버전 점수를 비교한다.

Q1평가 데이터셋(eval dataset)은 무엇인가요?

Q2grader가 매긴 점수들로 프롬프트의 객관적 지표를 얻으려면?

Q3프롬프트를 개선했는지 객관적으로 확인하려면?

MEMBER SESSION REQUIRED · REGISTRATION IS FREE

여기부터는 등록한 분에게 열립니다.

전 코스는 계속 무료입니다. 등록하면 이 코스의 남은 76개 레슨을 끝까지 읽을 수 있습니다.

등록하고 이어서 읽기

이미 등록하셨다면 그때 쓰신 이메일을 넣어 주세요.