# EvaluatorRatingScale

Represents a rating scale for custom LLM-as-a-Judge evaluators.

Rating scales define how the evaluator scores agent performance.
Use either categorical (discrete labels) or numerical (labeled numeric values) scales.

- Source: [`aws-bedrockagentcore/lib/evaluation/evaluator-config.ts`](https://github.com/aws/aws-cdk/blob/v2.275.0/packages/aws-cdk-lib/aws-bedrockagentcore/lib/evaluation/evaluator-config.ts#L127)
- Type last changed: v2.255.0 · 19 May 2026

## Example

```ts
// Categorical rating scale
const categorical = agentcore.EvaluatorRatingScale.categorical([
  { label: 'Good', definition: 'The response fully addresses the query.' },
  { label: 'Bad', definition: 'The response fails to address the query.' },
]);

// Numerical rating scale
const numerical = agentcore.EvaluatorRatingScale.numerical([
  { label: 'Poor', definition: 'Inadequate response.', value: 1 },
  { label: 'Good', definition: 'Adequate response.', value: 3 },
  { label: 'Excellent', definition: 'Outstanding response.', value: 5 },
]);
```

## Methods

- `categorical(options: CategoricalRatingOption[]): EvaluatorRatingScale // chainable` (static) — Creates a categorical rating scale.

  Categorical scales define discrete labels for scoring, such as "Good" / "Bad"
  or "Pass" / "Fail".

  **Parameters**

  - `options` — - The categorical rating options (at least 1 required).

- `numerical(options: NumericalRatingOption[]): EvaluatorRatingScale // chainable` (static) — Creates a numerical rating scale.

  Numerical scales define labeled numeric values for scoring, such as
  1 (Poor) through 5 (Excellent).

  **Parameters**

  - `options` — - The numerical rating options (at least 1 required).