Skip to main content
Evaluator last updated May 7, 2026.

Overview

The Purpose evaluator assesses how clearly a text communicates its central purpose – whether it is to inform, persuade, explain, describe, or entertain. The evaluator analyzes whether a text’s intent is explicitly stated, indirectly hinted at, or masked (e.g., text may present as neutral information, but be building a persuasive argument).

At a glance

Input typeInformational text
Passage length200 words or more
Supported grades3–12
RubricSAP ↗‘s Qualitative Text Complexity Rubric for Informational Text ↗
The evaluator was built and validated using the model and temperature below (other configurations will produce different results and may have lower accuracy):
Model usedgemini-3-flash-preview
Temperature0

Getting started

Follow the Quickstart to start using this evaluator:
Access method
Evaluators PlaygroundView in the Learning Commons Platform ↗
SDKTypeScript ↗
Python notebookView in GitHub
PromptsView in GitHub

Inputs

InputDescriptionRequired
Target grade levelAllows grade-specific complexity guidanceYes
Text typeInformational textYes

Output

FieldDescription
Complexity scorePurpose complexity level:
  • Slightly complex: Purpose is explicitly stated, clear, concrete, and narrowly focused
  • Moderately complex: Purpose is implied, but easy to identify based upon context or source
  • Very complex: Purpose is implicit or subtle but fairly easy to infer; more theoretical or abstract than concrete
  • Exceedingly complex: Purpose is subtle and intricate, difficult to determine; includes many theoretical or abstract elements
  • More context needed: The passage is too short to determine its purpose. Longer portion of text or different text is needed.
ReasoningOverall and detailed explanation of the rating, citing specific text features and their impact on student comprehension.
Adjustment and scaffoldingSuggestions for adjusting the text or scaffolding students to make it appropriate for the target grade.
Recommended use casesInstructional opportunity recommendations for the passage’s purpose.

Interpreting results

High or low complexity scores are not inherently good or bad. A higher complexity score simply indicates a text that requires more interpretation by readers.
Example: A “Very complex” or “Exceedingly complex” text may be ideal if the instructional goal is identifying implicit or persuasive intent. However, that same text may not be a good fit if the instructional goal is content comprehension.

Accuracy and validation

This evaluator is provided as Early access. Comprehensive accuracy measures are still evolving, and validation testing is ongoing.
The evaluator was optimized using 35 annotated passages from the CLEAR Corpus ↗ and validated through expert review of additional samples.
MetricDescriptionResult
Complexity score accuracy84% agreement with expert annotations
Expert agreement70%
Reasoning soundnessAverage 3.7 / 5
Exceedingly complex texts aren’t common in lower grades and the benchmark dataset doesn’t include many examples of them. Use caution when applying this evaluator to higher grade levels where such texts are more frequent.

Evaluator release history

DateChanges
May 7, 2026First release