> ## Documentation Index
> Fetch the complete documentation index at: https://www.adaline.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# LLM-as-a-Judge

> Use an LLM to evaluate your prompt responses against a custom rubric

LLM-as-a-Judge is the most versatile evaluator in Adaline. It uses an LLM to assess your prompt outputs against a custom [rubric](/docs/others/glossary#rubric), excelling at qualitative assessment where nuanced judgment matters more than simple metrics.

## Set up LLM-as-a-Judge

<Steps>
  <Step title="Open Evaluate from your prompt">
    Open the prompt you want to test and click **Evaluate** in the prompt header.

    <img src="https://mintcdn.com/adaline/6qZ1-Sm8NeEttI_w/images/evaluate/open-evaluate-tab.png?fit=max&auto=format&n=6qZ1-Sm8NeEttI_w&q=85&s=8a70c493b8cafd7a141b0220eff30640" alt="Opening the Evaluate tab from a prompt" title="Opening the Evaluate tab from a prompt" style={{ width: "100%" }} width="3456" height="1839" data-path="images/evaluate/open-evaluate-tab.png" />
  </Step>

  <Step title="Select the evaluator">
    Add the LLM-as-a-Judge evaluator from the evaluator menu.

    <img src="https://mintcdn.com/adaline/6qZ1-Sm8NeEttI_w/images/evaluate/add-llm-as-a-judge.png?fit=max&auto=format&n=6qZ1-Sm8NeEttI_w&q=85&s=128d391794e44a4d3364f0996c9158eb" alt="Adding the LLM-as-a-Judge evaluator" title="Adding the LLM-as-a-Judge evaluator" style={{ width: "100%" }} width="1274" height="774" data-path="images/evaluate/add-llm-as-a-judge.png" />
  </Step>

  <Step title="Link a dataset">
    Give a name to the evaluator and link a dataset containing your test cases.

    <img src="https://mintcdn.com/adaline/Um_T8BffW4hfcoYD/images/evaluate/link-dataset-llm-as-a-judge.png?fit=max&auto=format&n=Um_T8BffW4hfcoYD&q=85&s=4f4b6d55348d26a3fa222f867012b557" alt="Linking a dataset to LLM-as-a-Judge" title="Linking a dataset to LLM-as-a-Judge" style={{ width: "100%" }} width="1600" height="312" data-path="images/evaluate/link-dataset-llm-as-a-judge.png" />
  </Step>

  <Step title="Define your rubric">
    Write the rubric that defines your evaluation criteria. A well-crafted rubric is the key to high-quality evaluations — it should be specific, actionable, and aligned with your success metrics.

    <img src="https://mintcdn.com/adaline/Um_T8BffW4hfcoYD/images/evaluate/rubric-definition.png?fit=max&auto=format&n=Um_T8BffW4hfcoYD&q=85&s=2122b555a361f52ecdd112367f011d02" alt="Defining a rubric for LLM-as-a-Judge" title="Defining a rubric for LLM-as-a-Judge" style={{ width: "100%" }} width="1600" height="267" data-path="images/evaluate/rubric-definition.png" />
  </Step>

  <Step title="Run the evaluation">
    Click **Evaluate** to execute the evaluation and see the results.

    <img src="https://mintcdn.com/adaline/Um_T8BffW4hfcoYD/images/evaluate/llm-as-a-judge-results.png?fit=max&auto=format&n=Um_T8BffW4hfcoYD&q=85&s=30d87bf5e895eaee3ca33d5277ae6d30" alt="LLM-as-a-Judge evaluation results" title="LLM-as-a-Judge evaluation results" style={{ width: "100%" }} width="991" height="309" data-path="images/evaluate/llm-as-a-judge-results.png" />
  </Step>
</Steps>

## Writing effective rubrics

Your rubric directly determines the quality of the evaluation. Follow these guidelines:

* **Be specific** — Define clear criteria for each score level. Avoid vague terms like "good" or "bad" without context.
* **Be actionable** — Include concrete examples of what constitutes each rating.
* **Align with goals** — Match your rubric to your actual production success metrics.
* **Use a consistent scale** — Define a numerical scale (e.g., 1–4 or 1–5) with clear definitions for each level.

## Example rubrics

### Customer support response quality

```markdown theme={null}
Evaluate this customer support response using the following criteria:

Scoring Scale (1-4):
4 - Excellent: Completely resolves the issue, professional tone, anticipates follow-up needs
3 - Good: Addresses the main concern clearly and professionally
2 - Fair: Partially helpful but missing key information or context
1 - Poor: Fails to address the issue or uses inappropriate tone

Evaluation Factors:
- Problem resolution completeness
- Professional communication standards
- Information accuracy
- User experience quality

Provide a score and brief justification for your assessment.
```

### Content marketing effectiveness

```markdown theme={null}
Rate this content piece on effectiveness for our target audience (1-5):

5 - Outstanding: Highly engaging, actionable insights, clear value proposition
4 - Strong: Good engagement with solid practical value
3 - Adequate: Informative but limited engagement or actionability
2 - Weak: Basic information with minimal practical value
1 - Poor: Lacks clarity, value, or relevance to target audience

Consider these dimensions:
- Audience alignment and relevance
- Practical value and actionability
- Engagement potential
- Brand positioning effectiveness
```

### Technical documentation quality

```markdown theme={null}
Assess this feature documentation quality (1-4):

4 - Comprehensive: Clear explanation, complete coverage, excellent user guidance
3 - Good: Well-explained with adequate detail and guidance
2 - Acceptable: Basic explanation but missing important details or clarity
1 - Inadequate: Confusing, incomplete, or lacks necessary user guidance

Evaluation Areas:
- Technical accuracy and completeness
- User comprehension and clarity
- Implementation guidance quality
- Overall user experience
```

### Brand voice consistency

```markdown theme={null}
Evaluate brand voice alignment (1-3 scale):

3 - Excellent Alignment: Perfect adherence to brand guidelines, authentic voice
2 - Good Alignment: Generally consistent with minor deviations
1 - Poor Alignment: Inconsistent with established brand voice

Assessment Criteria:
- Tone consistency with brand guidelines
- Language and terminology alignment
- Audience appropriateness
- Brand personality expression
```

## When to use

LLM-as-a-Judge is best suited for:

* **Response quality assessment** — Evaluating helpfulness, accuracy, and completeness.
* **Tone and voice validation** — Ensuring consistent brand voice and appropriate communication style.
* **Factual accuracy checking** — Verifying that responses contain correct information.
* **User satisfaction prediction** — Assessing whether responses would meet user expectations.
* **Multi-turn conversation quality** — Evaluating context retention and coherence across [chat turns](/docs/evaluate/evaluate-multi-turn-chat).

For technical validation (format checking, business logic, pattern matching), consider [JavaScript](/docs/evaluate/javascript) or [Text Matcher](/docs/evaluate/text-matcher) evaluators instead.

## Next steps

<CardGroup cols={2}>
  <Card title="JavaScript Evaluator" icon="code" href="/docs/evaluate/javascript">
    Write custom code to validate structured outputs.
  </Card>

  <Card title="Analyze Reports" icon="chart-bar" href="/docs/evaluate/analyze-evaluation-reports">
    Review LLM-as-a-Judge results in detail.
  </Card>
</CardGroup>
