---
title: AgentJudge
seo:
  title: AgentJudge — Python SDK
  description: A prompt-based Agent Judge stored on the Judgment platform. (Python SDK)
description: A prompt-based Agent Judge stored on the Judgment platform.
---

| Prop | Type | Default | Description |
| - | - | - | - |
| `ScoreType?` | `Any` | `Literal['numeric', 'binary', 'categorical']` | |

A prompt-based Agent Judge stored on the Judgment platform.

Agent Judges are LLM-driven scorers. The `prompt` field is the **rubric
prompt** used by the agent-judge harness when scoring an output. Versions
are managed implicitly — calling `.update()` writes a new minor version of
the underlying prompt scorer (matching the default "save" flow in the UI).

```python
client = Judgeval(project_name="my-project")
judge = client.agent_judges.create(
    name="helpfulness",
    prompt="Score the assistant's helpfulness from 0 to 1.",
    model="gpt-5.2",
    score_type="numeric",
)

judge = client.agent_judges.update(
    judge_id=judge.judge_id,
    prompt="Updated rubric prompt.",
)
```

## Attributes

| Prop | Type | Default | Description |
| - | - | - | - |
| `judge_id?` | `str` | - | Unique judge identifier on the Judgment platform. |
| `name?` | `str` | - | Human-readable name of the judge (unique per project). |
| `prompt?` | `str` | - | Rubric prompt template used by the agent judge. |
| `model?` | `str` | - | LiteLLM model id driving the agent judge (e.g. "gpt-5.2"). |
| `score_type?` | `ScoreType` | - | One of "numeric", "binary", or "categorical". |
| `description?` | `Optional[str]` | `None` | Optional description stored on the scorer version. |
| `judge_description?` | `Optional[str]` | `None` | Optional human-readable description shown in the UI. |
| `categories?` | `Optional[List[Dict[str, Any]]]` | `field(default=None)` | Choice list for categorical judges (e.g. [{"name": "good", "description": "..."}, ...]). |
| `min_score?` | `Optional[float]` | `None` | Lower bound for numeric judges (defaults to 0). |
| `max_score?` | `Optional[float]` | `None` | Upper bound for numeric judges (defaults to 1). |
| `major_version?` | `Optional[int]` | `None` | Latest major version of the underlying prompt scorer. |
| `minor_version?` | `Optional[int]` | `None` | Latest minor version of the underlying prompt scorer. |