Skip to content
Judgment Labs
Esc
↑↓navigate↵open⌘Jpreview
On this page

AgentJudge

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

PropType
ScoreType?Any
TypeAny
DefaultLiteral['numeric', 'binary', 'categorical']
ReasoningLevel?Any
TypeAny
DefaultLiteral['lite', 'normal', 'high']

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 judge (matching the default “save” flow in the UI).

client = Judgeval(project_name="my-project")
judge = client.agent_judges.create(
    name="helpfulness",
    prompt="Did the assistant answer the user's question?",
    score_type="binary",
)

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

Attributes

PropType
judge_id?str

Unique judge identifier on the Judgment platform.

Typestr
name?str

Human-readable name of the judge (unique per project).

Typestr
prompt?str

Rubric prompt template used by the Agent judge.

Typestr
model?str

Model the platform resolved from reasoning_level.

Typestr
score_type?ScoreType

One of "numeric", "binary", or "categorical".

TypeScoreType
description?Optional[str]

Optional description stored on the judge version.

TypeOptional[str]
DefaultNone
judge_description?Optional[str]

Optional human-readable description shown in the UI.

TypeOptional[str]
DefaultNone
categories?Optional[List[Dict[str, Any]]]

Choice list for categorical judges (e.g. [{"name": "good", "description": "..."}, ...]).

TypeOptional[List[Dict[str, Any]]]
Defaultfield(default=None)
min_score?Optional[float]

Lower bound for numeric judges (defaults to 0).

TypeOptional[float]
DefaultNone
max_score?Optional[float]

Upper bound for numeric judges (defaults to 1).

TypeOptional[float]
DefaultNone
major_version?Optional[int]

Major version this judge was read at.

TypeOptional[int]
DefaultNone
minor_version?Optional[int]

Minor version this judge was read at.

TypeOptional[int]
DefaultNone
reasoning_level?Optional[ReasoningLevel]

One of "lite", "normal", or "high".

TypeOptional[ReasoningLevel]
DefaultNone

Was this page helpful?