평가지표 관리
평가지표(Metric)를 Default와 Custom으로 나눠 설명하고, 각 유형에 어떤 평가지표가 있는지와 태스크에 추가하는 방법을 안내합니다.
평가지표는 애플리케이션이나 에이전트의 출력을 계산하거나 판정해 점수를 매기는 방법입니다. 한 태스크에 평가지표를 여러 개 연결할 수 있습니다. 평가지표는 DATUMO가 만들어 둔 Default와 사용자가 직접 만드는 Custom으로 나뉩니다.
1. Default와 Custom
①두 유형의 차이
| 구분 | Default | Custom |
|---|---|---|
| 무엇인가 | DATUMO가 만들어 제공하는 평가지표 | 서비스만의 기준으로 사용자가 만드는 평가지표 |
| 만드는 방법 | 목록에서 골라 추가 | 생성형 모델 또는 Decision 모델로 직접 작성 |
| 채점 방식 | LLM as a Judge, Rule-based, Embedding, Statistical | 평가 모델이 사용자가 정한 기준으로 판정 |
| 평가 결과 | LLM as a Judge는 점수와 사유, 나머지는 점수 | 생성형 모델은 점수와 정의한 결과 키, Decision 모델은 점수와 추가 질문의 답 |
| 키 매핑 | 필요 | 필요 없음 (고른 키가 그대로 연결) |
②어떤 유형을 고를까
| 상황 | 고를 유형 |
|---|---|
| 원하는 평가 방식이 이미 목록에 있을 때 | Default |
| 서비스만의 기준으로 점수와 함께 사유도 받고 싶을 때 | Custom › 생성형 모델 |
| 서비스만의 기준으로 많은 데이터를 빠르고 저렴하게, 일관되게 채점하고 싶을 때 | Custom › Decision 모델 |
- 태스크 화면에서
+ Add Metric을 누르면Metric Type에Default아래DATUMO Default,Custom아래Generative Model과Decision Model카드가 보입니다. - 카드의 태그로도 차이를 볼 수 있습니다. 생성형 모델은
Reasons,Flexible,Slower,Higher cost, Decision 모델은Fast,Low cost,Consistent,No reasons입니다. - 같은 답변도 평가지표에 따라 점수가 다릅니다. 표현만 다르고 뜻이 같은 답변은 ExactMatch에서 0점, Similarity에서는 높은 점수를 받습니다. 목적이 다르면 여러 평가지표를 함께 연결합니다.
③점수 범위
Default 평가지표의 점수는 0에서 1 사이이며, 높을수록 품질이 좋다는 뜻입니다. Custom도 다른 평가지표와 비교하기 쉽도록 같은 범위를 권장합니다. Decision 모델은 고른 답을 0~1 점수로 자동으로 바꿉니다.
1-1Metric 추가 시작
- Task Detail 화면에서
+ Add Metric을 클릭합니다. Metric Type에서 만들 방식을 고릅니다. 차이는 어떤 유형을 고를까를 보세요.
DATUMO Default: 제공되는 Metric 템플릿에서 고릅니다.Generative Model: 평가 프롬프트를 직접 입력합니다. 사유도 받습니다.Decision Model: 질문과 선택지를 정해 빠르게 채점합니다.
- Task Detail 화면에서
2. Default 평가지표
①Default에 있는 평가지표
DATUMO는 바로 쓸 수 있는 Default 평가지표 131개를 제공합니다. 태스크 템플릿에도 포함되어 있어, 템플릿을 고르면 맞는 평가지표가 함께 선택됩니다. 채점 방식은 4가지입니다.
| 채점 방식 | 개수 | 어떻게 채점하나 | 예시 |
|---|---|---|---|
| LLM as a Judge | 101 | 평가 모델이 정해진 프롬프트와 루브릭으로 판정 | 문서 충실도, 답변 정확도 |
| Rule-based | 23 | 일치 여부, 단어 겹침, 순위 같은 계산식으로 점수 계산 | 정확 일치, BLEU, ROUGE, Precision@k |
| Embedding | 4 | 답변과 기준 문장을 벡터로 바꿔 의미가 가까운 정도 계산 | 의미 유사도, 사실 일관성 |
| Statistical | 3 | 데이터별 판정을 벤치마크셋 전체로 모아 비율 계산 | F1 점수, 재현율, 위양성률 |
평가 영역(안전성, 검색 품질, 답변 정확성, 에이전트 등 10개)별 전체 목록은 Datumo 평가지표 소개에 있습니다. 처음이라면 다음 평가지표부터 봅니다.
| 확인하고 싶은 것 | 평가지표 | 필요한 키 |
|---|---|---|
| 유해 질문을 잘 막는지 | F1 점수 | query, query_safety_label, safety_taxonomy_lv2 |
| 문서에 없는 내용을 지어내지 않는지 | 문서 충실도 (Faithfulness) | response, retrieved_context |
| 정답과 같은 말을 했는지 | 답변 정확도 (Answer Accuracy) | query, response, expected_response |
②추가하고 키 매핑하기
DATUMO Default를 고르면 평가지표 카드 목록이 보입니다. 카드에는방법,필수(채점에 쓰는 키),평가 결과가 표시됩니다. 여러 개를 한 번에 고를 수 있습니다.- 추가한 뒤 키 매핑으로 평가지표가 요구하는 키를 태스크의 키에 연결합니다. 왼쪽
평가지표 필수 키마다 오른쪽태스크 키를 고릅니다. - 연결하지 않은 키는
매핑 미완료로 표시되고, 평가지표 카드에서 빨간색으로 보입니다.
예를 들어 Answer Correctness를 연결하면 다음과 같습니다.
| 평가지표 필수 키 | 태스크 키 |
|---|---|
query | query 입력 |
response | answer 출력 |
expected_response | expected_response 참조 |
2-1템플릿으로 추가
DATUMO Default를 선택합니다.- 추가할 Metric을 선택합니다.
Add 1 Metric을 클릭합니다.
여러 Metric을 한 번에 고를 수 있습니다. 버튼의 숫자는 고른 Metric 수입니다.
2-2Key 연결
- Metric 목록에서 빨간 Key가 있는 Metric을 클릭합니다.
Required Key에서 Metric이 요구하는 Key를 확인합니다. 연결 방식은 추가하고 키 매핑하기을 보세요.Mapping incomplete를 눌러 연결할 Task Key를 고릅니다.Save를 클릭합니다.
요구하는 Key를 모두 연결해야 이 Metric으로 평가할 수 있습니다.
3. Custom 평가지표
①Custom에 있는 평가지표
목록에 없는 기준은 Custom으로 만듭니다. 만드는 방식은 생성형 모델(Generative Model)과 판단형 모델(Decision Model) 2가지입니다.
| 구분 | 생성형 모델 | Decision 모델 |
|---|---|---|
| 판정 방식 | 프롬프트를 읽고 답을 글로 제공 | 정한 선택지 중 하나를 선택 |
| 만드는 방법 | 시스템 프롬프트와 유저 프롬프트를 직접 작성 | 화면 가이드를 따라 평가 키, 질문, 선택지를 선택·입력 |
| 결과 | 점수와 정의한 결과 키(예: 사유) | 0~1 점수와 추가 질문의 답. 사유는 없음 |
| 속도·비용 | 느리고 비용이 큼 | 빠르고 비용이 적음 |
| 평가 모델 | 등록한 LLM | Davi, Jev |
②생성형 모델로 만들기
Metric Info에 이름과 설명(선택)을 쓰고,Select Model의Judgement Model에서 평가 모델을 고릅니다.시스템 프롬프트에 역할, 평가 기준, 점수 규칙, 출력 형식을 씁니다.유저 프롬프트에 평가할 값이 들어갈 자리를{{query}}처럼 키로 넣습니다. 프롬프트 위에 보이는 키를 누르면 커서 위치에 들어갑니다. 두 칸 중 한 곳에 키가 하나 이상 있어야 저장됩니다.Evaluation Result에 돌려받을 항목을 정합니다.Score(Number)는 기본으로 있고,+ Add Key로reason(text) 같은 항목을 더합니다. 평가 결과 표에 이 이름으로 열이 생깁니다.
프롬프트 예시: Answer Correctness 직접 만들기
시스템 프롬프트
You are an evaluation judge for answer correctness.
Evaluate whether the response correctly answers the user's question based on the reference answer.
Scoring rubric:
- 1.0: Fully correct and consistent with the reference answer
- 0.5: Partially correct but missing or misstating important details
- 0.0: Incorrect, misleading, or contradicts the reference answer
Return:
- score: float between 0 and 1
- reasoning: brief explanation of the score
Output must be valid JSON.유저 프롬프트
Query: {{query}}
Response: {{answer}}
Reference: {{expected_response}}시스템 프롬프트에서 score와 reasoning을 돌려받도록 썼으므로, Evaluation Result에 Score와 Reasoning(text)을 둡니다.
3-1프롬프트 작성
Generative Model을 선택합니다.Metric Name을 입력합니다.System Prompt와User Prompt를 입력합니다. 무엇을 쓸지는 생성형 모델로 만들기를 먼저 읽어 보세요.Evaluation Result에 결과로 받을 Key를 정합니다. 자세한 내용은 생성형 모델로 만들기를 보세요.Save를 클릭합니다.
- 프롬프트에 위쪽 Key를 하나 이상 넣어야 합니다.
- 다른 Metric과 비교하기 쉽도록 점수 범위는 0~1을 권장합니다. 점수 범위를 참고하세요.
③Decision 모델로 만들기
Evaluation Key에서 평가 모델이 읽을 키(입력, 출력, 필요하면 참조)를 고릅니다.Evaluation Instructions에 질문을 쓰고 점수 유형을 고릅니다.Binary(Yes 1 / No 0),Continuous(단계별 1에서 0),Choice(보기 순서대로 1에서 0) 중 하나입니다. 첫 질문만 점수가 되고, 추가 질문은 결과에 따로 보입니다.Judgement Model에서 평가 모델을 고릅니다. 한국어 데이터는 Davi, 영어 데이터는 Jev를 권장합니다.Metric Info에 이름을 넣고Save를 누릅니다. 태스크의 평가지표 목록에Custom Decision Model카드가 추가됩니다.
질문 예시와 점수 유형 자세히 보기
| 점수 유형 | 이럴 때 | 선택지 | 점수 |
|---|---|---|---|
Binary | 맞다, 아니다로 판정할 때 | Yes, No | Yes 1, No 0 |
Continuous | 정도를 단계로 매길 때. 처음 선택된 유형입니다. | 기본 3단계(1, 0.5, 0). 2~101단계 | 1~0 사이 값. 단계 사이 값도 반영됩니다. |
Choice | 정해 둔 보기 중 하나를 고를 때 | 기본 3개 | 보기 순서대로 1~0을 같은 간격으로 나눈 값 |
- 단계와 보기마다 어떤 답이 해당하는지 설명을 씁니다. 설명이 구체적일수록 채점이 정확해집니다.
+ Add Level(Continuous)이나+ Add Option(Choice)으로 늘립니다.+ Add Instruction으로 추가 질문을 더하며, 추가 질문은 이름이 꼭 있어야 합니다(예:clarity).- 출력 키 없이 저장하면 확인 창이 뜹니다.
JSON을 누르면 같은 내용을 JSON으로 보고 고칠 수 있습니다.
예를 들어 환불 정책을 바르게 안내하는지 평가하면 다음처럼 정합니다.
| 질문 | 유형 | 선택지 |
|---|---|---|
| Score: 답변이 환불 가능 여부를 분명히 설명하나요? | Binary | Yes: 환불 가능 여부와 조건을 분명히 말함 / No: 모호하거나 없는 조건을 지어냄 |
clarity: 답변이 얼마나 이해하기 쉬운가요? | Continuous | 1: 명확하고 간결함 / 0.5: 대체로 명확함 / 0: 따라가기 어려움 |
response_tone: 답변의 말투는 어떤가요? | Choice | formal / casual / curt |
평가 모델은 DATUMO Model 아래 Davi (Datumo)와 Typesafe (Datumo)(Jev)에서 고릅니다.
| 모델 | 특징 | 이럴 때 |
|---|---|---|
| Davi | DATUMO가 만든 모델입니다. 한국어 평가에 더 정확합니다. | 한국어 데이터를 평가할 때 |
| Jev | Typesafe가 만든 모델입니다. 항상 정해진 형식으로 답해 점수가 일관됩니다. Jev-latest와 Jev-preview 중에서 고릅니다. | 영어 데이터를 평가할 때 |
3-1Decision Model 선택
- Task Detail 화면에서
+ Add Metric을 클릭합니다. Custom아래Decision Model을 선택합니다. 차이는 어떤 유형을 고를까를 보세요.
Decision Model은 빠르고 저렴하게 채점하지만 사유는 주지 않습니다. 사유가 필요하면Generative Model을 고르세요.- Task Detail 화면에서
3-2Key와 질문 입력
Evaluation Key에서 모델이 읽을 Key를 고릅니다. 오른쪽 가이드에 각 Key의 뜻이 보입니다.Evaluation Instructions에서 점수 유형을 고릅니다. 유형은 Decision 모델로 만들기을 보세요.Instructions에 질문을 쓰고 단계마다 설명을 입력합니다.- 질문을 더하려면
+ Add Instruction을 클릭합니다.
첫 질문만 점수가 됩니다. 추가 질문은 점수에 반영되지 않고 결과에 따로 보입니다.
3-3모델 선택과 저장
Judgement Model에서 평가 모델을 고릅니다. 처음에는Davi가 선택돼 있습니다.- Jev를 쓰려면
Typesafe (Datumo)에서 버전을 고릅니다. Metric Info에Metric Name을 입력합니다.Save를 클릭합니다.- Task의 Metric 목록에
Custom Decision Model카드가 추가됩니다.
한국어 데이터를 평가하면 Davi를 권장합니다.
④평가 미리보기
저장한 Custom 평가지표는 예시 데이터로 미리 돌려 보고 의도대로 채점하는지 확인합니다. 골드 점수(기대 정답 점수)를 넣고 테스트 실행(Decision 모델은 Run Test)을 누르면 평가 점수와 골드 점수의 차이가 보입니다. Decision 모델은 결과 행을 펼쳐 선택지별 확률도 볼 수 있습니다. 결과가 기대와 다르면 프롬프트나 질문을 고쳐 다시 실행합니다.
미리보기 결과 자세히 보기
- 표의 열은 평가지표가 쓰는 키입니다. 이 칸은 비워 둘 수 없고, 골드 점수는 비워 둘 수 있습니다.
Accuracy는 평가 점수가 골드 점수에 얼마나 가까운지 보여 줍니다. 예를 들어 골드 점수1.0인 행이0.95를 받으면 차이는-0.05이고, 두 점수가 같으면일치로 표시됩니다.- Decision 모델은
Run Test결과가Test #1처럼 번호, 시각, 평가 모델, 점수 유형과 함께 쌓입니다. Binary와 Choice는Match또는Mismatch로, Continuous는 차이(예:+0.08)로 보입니다. Avg.Difference는 골드 점수가 있는 행에서 모델 점수와 골드 점수 차이의 평균입니다. 0에 가까울수록 골드와 비슷합니다.
| 확인할 것 | 볼 곳 |
|---|---|
| 점수가 골드와 맞는지 | Match, Mismatch, 차이, Avg.Difference |
| 모델이 얼마나 확신했는지 | 행을 펼쳐 본 선택지별 확률 |
| 추가 질문의 답 | Additional 아래 질문 이름 열 |
3-1예시 입력
+ Add Query/Response로 행을 추가합니다.- 칸마다 예시 값을 입력합니다.
- Metric 설정을 저장해야 Preview를 쓸 수 있습니다.
Gold Score는 입력하지 않아도 됩니다. 뜻은 평가 미리보기를 보세요.
3-2Run Test 실행
Run Test를 클릭합니다.- 결과에서 점수와
Accuracy를 확인합니다.
3-3Decision 모델 결과 확인
- Decision 모델 평가지표에서 예시 값과
Gold값을 입력하고Run Test를 클릭합니다. - 점수마다
Match,Mismatch또는 차이를 확인합니다. Avg.Difference로 골드 점수와 얼마나 가까운지 봅니다.- 행을 클릭하면 선택지별 확률이 펼쳐집니다.
결과가 기대와 다르면
Edit으로 질문과 선택지 설명을 고친 뒤 다시 실행합니다. 뜻은 평가 미리보기을 보세요.- Decision 모델 평가지표에서 예시 값과
자주 묻는 질문
평가지표 카드에 왜 빨간 키가 보이나요?아직 연결하지 않은 키가 있기 때문이에요.
- 원인
- 평가지표가 요구하는 키 중 태스크 키와 연결되지 않은 키가 빨간색으로 보여요.
- 해결 방법
- 평가지표를 열고
필수 키의매핑 미완료에서 태스크 키를 골라 주세요. 그다음저장을 눌러 주세요.
테스트 실행 버튼을 왜 누를 수 없나요?평가지표 설정을 아직 저장하지 않았기 때문이에요.
- 원인
- 저장하지 않은 평가지표는 미리보기를 실행할 수 없어요.
- 해결 방법
- 왼쪽 아래
저장을 눌러 설정을 저장해 주세요.
미리보기 칸이 왜 빨갛게 표시되나요?꼭 입력해야 하는 예시 값이 비어 있기 때문이에요.
- 원인
- 평가지표가 요구하는 키의 칸은 비워 둘 수 없어요.
골드 점수만 비워 둘 수 있어요. - 해결 방법
- 빨간 칸에 예시 값을 입력한 뒤 다시
테스트 실행을 눌러 주세요.
Decision 모델 결과에는 왜 점수 사유가 없나요?Decision 모델은 사유를 쓰지 않기 때문이에요.
- 원인
- Decision 모델은 글을 작성하지 않고, 정해 둔 선택지 중 하나만 골라요. 그래서 빠르고 저렴하지만 점수에 대한 사유는 볼 수 없어요.
- 해결 방법
- 사유가 필요하면
생성형 모델로 평가지표를 만들어 주세요. Decision 모델에서는 결과 행을 눌러 선택지별 확률을 볼 수 있어요.
생성형 모델 평가지표를 왜 저장할 수 없나요?프롬프트에 키가 하나도 없기 때문이에요.
- 원인
시스템 프롬프트나유저 프롬프트에 키가 하나 이상 있어야 해요.- 해결 방법
{{query}}처럼 위쪽에 보이는 키를 프롬프트에 넣어 주세요. 예시는 생성형 모델로 만들기에 있어요.