Platform Docs
Try DatumoEval

평가지표 관리

평가지표(Metric)를 Default와 Custom으로 나눠 설명하고, 각 유형에 어떤 평가지표가 있는지와 태스크에 추가하는 방법을 안내합니다.

평가지표는 애플리케이션이나 에이전트의 출력을 계산하거나 판정해 점수를 매기는 방법입니다. 한 태스크에 평가지표를 여러 개 연결할 수 있습니다. 평가지표는 DATUMO가 만들어 둔 Default와 사용자가 직접 만드는 Custom으로 나뉩니다.

1. Default와 Custom

①두 유형의 차이

구분DefaultCustom
무엇인가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. 1-1Metric 추가 시작

    1. Task Detail 화면에서 + Add Metric을 클릭합니다.
    2. Metric Type에서 만들 방식을 고릅니다. 차이는 어떤 유형을 고를까를 보세요.
    • DATUMO Default: 제공되는 Metric 템플릿에서 고릅니다.
    • Generative Model: 평가 프롬프트를 직접 입력합니다. 사유도 받습니다.
    • Decision Model: 질문과 선택지를 정해 빠르게 채점합니다.

2. Default 평가지표

①Default에 있는 평가지표

DATUMO는 바로 쓸 수 있는 Default 평가지표 131개를 제공합니다. 태스크 템플릿에도 포함되어 있어, 템플릿을 고르면 맞는 평가지표가 함께 선택됩니다. 채점 방식은 4가지입니다.

채점 방식개수어떻게 채점하나예시
LLM as a Judge101평가 모델이 정해진 프롬프트와 루브릭으로 판정문서 충실도, 답변 정확도
Rule-based23일치 여부, 단어 겹침, 순위 같은 계산식으로 점수 계산정확 일치, BLEU, ROUGE, Precision@k
Embedding4답변과 기준 문장을 벡터로 바꿔 의미가 가까운 정도 계산의미 유사도, 사실 일관성
Statistical3데이터별 판정을 벤치마크셋 전체로 모아 비율 계산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를 연결하면 다음과 같습니다.

평가지표 필수 키태스크 키
queryquery 입력
responseanswer 출력
expected_responseexpected_response 참조
  1. 2-1템플릿으로 추가

    1. DATUMO Default를 선택합니다.
    2. 추가할 Metric을 선택합니다.
    3. Add 1 Metric을 클릭합니다.

    여러 Metric을 한 번에 고를 수 있습니다. 버튼의 숫자는 고른 Metric 수입니다.

  2. 2-2Key 연결

    1. Metric 목록에서 빨간 Key가 있는 Metric을 클릭합니다.
    2. Required Key에서 Metric이 요구하는 Key를 확인합니다. 연결 방식은 추가하고 키 매핑하기을 보세요.
    3. Mapping incomplete를 눌러 연결할 Task Key를 고릅니다.
    4. Save를 클릭합니다.

    요구하는 Key를 모두 연결해야 이 Metric으로 평가할 수 있습니다.


3. Custom 평가지표

①Custom에 있는 평가지표

목록에 없는 기준은 Custom으로 만듭니다. 만드는 방식은 생성형 모델(Generative Model)과 판단형 모델(Decision Model) 2가지입니다.

구분생성형 모델Decision 모델
판정 방식프롬프트를 읽고 답을 글로 제공정한 선택지 중 하나를 선택
만드는 방법시스템 프롬프트와 유저 프롬프트를 직접 작성화면 가이드를 따라 평가 키, 질문, 선택지를 선택·입력
결과점수와 정의한 결과 키(예: 사유)0~1 점수와 추가 질문의 답. 사유는 없음
속도·비용느리고 비용이 큼빠르고 비용이 적음
평가 모델등록한 LLMDavi, 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)을 둡니다.

  1. 3-1프롬프트 작성

    1. Generative Model을 선택합니다.
    2. Metric Name을 입력합니다.
    3. System Prompt와 User Prompt를 입력합니다. 무엇을 쓸지는 생성형 모델로 만들기를 먼저 읽어 보세요.
    4. Evaluation Result에 결과로 받을 Key를 정합니다. 자세한 내용은 생성형 모델로 만들기를 보세요.
    5. 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, NoYes 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: 답변이 환불 가능 여부를 분명히 설명하나요?BinaryYes: 환불 가능 여부와 조건을 분명히 말함 / No: 모호하거나 없는 조건을 지어냄
clarity: 답변이 얼마나 이해하기 쉬운가요?Continuous1: 명확하고 간결함 / 0.5: 대체로 명확함 / 0: 따라가기 어려움
response_tone: 답변의 말투는 어떤가요?Choiceformal / casual / curt

평가 모델은 DATUMO Model 아래 Davi (Datumo)와 Typesafe (Datumo)(Jev)에서 고릅니다.

모델특징이럴 때
DaviDATUMO가 만든 모델입니다. 한국어 평가에 더 정확합니다.한국어 데이터를 평가할 때
JevTypesafe가 만든 모델입니다. 항상 정해진 형식으로 답해 점수가 일관됩니다. Jev-latest와 Jev-preview 중에서 고릅니다.영어 데이터를 평가할 때
  1. 3-1Decision Model 선택

    1. Task Detail 화면에서 + Add Metric을 클릭합니다.
    2. Custom 아래 Decision Model을 선택합니다. 차이는 어떤 유형을 고를까를 보세요.

    Decision Model은 빠르고 저렴하게 채점하지만 사유는 주지 않습니다. 사유가 필요하면 Generative Model을 고르세요.

  2. 3-2Key와 질문 입력

    1. Evaluation Key에서 모델이 읽을 Key를 고릅니다. 오른쪽 가이드에 각 Key의 뜻이 보입니다.
    2. Evaluation Instructions에서 점수 유형을 고릅니다. 유형은 Decision 모델로 만들기을 보세요.
    3. Instructions에 질문을 쓰고 단계마다 설명을 입력합니다.
    4. 질문을 더하려면 + Add Instruction을 클릭합니다.

    첫 질문만 점수가 됩니다. 추가 질문은 점수에 반영되지 않고 결과에 따로 보입니다.

  3. 3-3모델 선택과 저장

    1. Judgement Model에서 평가 모델을 고릅니다. 처음에는 Davi가 선택돼 있습니다.
    2. Jev를 쓰려면 Typesafe (Datumo)에서 버전을 고릅니다.
    3. Metric Info에 Metric Name을 입력합니다.
    4. Save를 클릭합니다.
    5. 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 아래 질문 이름 열
  1. 3-1예시 입력

    1. + Add Query/Response로 행을 추가합니다.
    2. 칸마다 예시 값을 입력합니다.
    • Metric 설정을 저장해야 Preview를 쓸 수 있습니다.
    • Gold Score는 입력하지 않아도 됩니다. 뜻은 평가 미리보기를 보세요.
  2. 3-2Run Test 실행

    1. Run Test를 클릭합니다.
    2. 결과에서 점수와 Accuracy를 확인합니다.
  3. 3-3Decision 모델 결과 확인

    1. Decision 모델 평가지표에서 예시 값과 Gold 값을 입력하고 Run Test를 클릭합니다.
    2. 점수마다 Match, Mismatch 또는 차이를 확인합니다.
    3. Avg.Difference로 골드 점수와 얼마나 가까운지 봅니다.
    4. 행을 클릭하면 선택지별 확률이 펼쳐집니다.

    결과가 기대와 다르면 Edit으로 질문과 선택지 설명을 고친 뒤 다시 실행합니다. 뜻은 평가 미리보기을 보세요.


자주 묻는 질문

평가지표 카드에 왜 빨간 키가 보이나요?아직 연결하지 않은 키가 있기 때문이에요.
원인
평가지표가 요구하는 키 중 태스크 키와 연결되지 않은 키가 빨간색으로 보여요.
해결 방법
평가지표를 열고 필수 키의 매핑 미완료에서 태스크 키를 골라 주세요. 그다음 저장을 눌러 주세요.
테스트 실행 버튼을 왜 누를 수 없나요?평가지표 설정을 아직 저장하지 않았기 때문이에요.
원인
저장하지 않은 평가지표는 미리보기를 실행할 수 없어요.
해결 방법
왼쪽 아래 저장을 눌러 설정을 저장해 주세요.
미리보기 칸이 왜 빨갛게 표시되나요?꼭 입력해야 하는 예시 값이 비어 있기 때문이에요.
원인
평가지표가 요구하는 키의 칸은 비워 둘 수 없어요. 골드 점수만 비워 둘 수 있어요.
해결 방법
빨간 칸에 예시 값을 입력한 뒤 다시 테스트 실행을 눌러 주세요.
Decision 모델 결과에는 왜 점수 사유가 없나요?Decision 모델은 사유를 쓰지 않기 때문이에요.
원인
Decision 모델은 글을 작성하지 않고, 정해 둔 선택지 중 하나만 골라요. 그래서 빠르고 저렴하지만 점수에 대한 사유는 볼 수 없어요.
해결 방법
사유가 필요하면 생성형 모델로 평가지표를 만들어 주세요. Decision 모델에서는 결과 행을 눌러 선택지별 확률을 볼 수 있어요.
생성형 모델 평가지표를 왜 저장할 수 없나요?프롬프트에 키가 하나도 없기 때문이에요.
원인
시스템 프롬프트나 유저 프롬프트에 키가 하나 이상 있어야 해요.
해결 방법
{{query}}처럼 위쪽에 보이는 키를 프롬프트에 넣어 주세요. 예시는 생성형 모델로 만들기에 있어요.

최종 수정일