11

Metadata Fields

Every training example needs more than just content. These metadata fields help you filter, balance, deduplicate, and debug your datasets.

FieldDescriptionWhy It Matters
Source / provenanceWhere the data came fromEnables filtering by quality, license compliance, and bias auditing
License / permissionUsage rights for the dataPrevents legal risk; some sources restrict commercial use
Split (train/valid/test)Train / validation / test assignmentPrevents data leakage between training and evaluation
Language / localeLanguage and regional variantControls multilingual balance and prevents unexpected language mixing
Domain / task tagSubject area or task categoryEnables domain-specific training runs and balanced sampling
Quality scoreAutomated or human quality ratingSupports quality-weighted sampling; a smaller clean set often beats a larger messy one
Deduplication cluster IDNear-duplicate group identifierPrevents the model from memorizing repeated content and inflating metrics
Safety / PII flagsContent safety and personal data markersRequired for compliance (GDPR, etc.) and safety filtering
Difficulty levelEstimated complexity of the exampleSupports curriculum learning: easy examples first, hard examples later
Ground truth / referenceVerified correct answer or labelEnables held-out evaluation and reward verification
Tool / schema versionAPI version or schema the tool call targetsPrevents training on outdated API signatures that will fail at inference
Freshness / timestampWhen the content was created or last verifiedFacts go stale; freshness metadata enables time-aware filtering
Annotator agreementInter-annotator agreement scoreLow agreement = ambiguous example; filtering by agreement improves signal quality
Curriculum Learning

Curriculum learning presents training examples in order of difficulty: easy examples first, then progressively harder ones. This is particularly relevant for reasoning and math training, where the "difficulty level" metadata field enables sorting examples by complexity.

Research suggests curriculum learning can improve both training efficiency and final accuracy, especially when combined with process supervision. The key requirement is having reliable difficulty annotations, which is why the metadata field matters.