Score Configs
Score definitions — data types, ranges, and categories that every score conforms to.
Score Configs
A score config is the schema for a score: its data type and its valid range or set of categories. Configs make scores consistent — a helpfulness numeric always runs 1–5, a sentiment categorical always uses the same labels. Served by Hanzo O11y, tenant-scoped by org.
Data types
dataType | Constraint fields | Use for |
|---|---|---|
NUMERIC | minValue, maxValue | Ratings and rubric scores (1–5, 0.0–1.0) |
CATEGORICAL | categories[] | Labeled buckets (good / neutral / bad) |
BOOLEAN | categories[] (True/False) | Pass/fail checks |
TEXT | — | Free-text judgments |
Each entry in categories is a { label, value } pair, so a categorical score carries a human-readable label and a numeric code for aggregation.
Archiving
Archived configs stay attached to historical scores but are hidden from new scoring. A config is referenced by a score through its configId, and by an annotation queue through scoreConfigIds.
Related
- Scores — the values that conform to these configs
- Annotation Queues — queues score against a set of configs
How is this guide?