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 type | Informational text |
| Passage length | 200 words or more |
| Supported grades | 3–12 |
| Rubric | SAP ↗‘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 used | gemini-3-flash-preview |
| Temperature | 0 |
Getting started
Follow the Quickstart to start using this evaluator:
| Input | Description | Required |
|---|
| Target grade level | Allows grade-specific complexity guidance | Yes |
| Text type | Informational text | Yes |
Output
| Field | Description |
|---|
| Complexity score | Purpose 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.
|
| Reasoning | Overall and detailed explanation of the rating, citing specific text features and their impact on student comprehension. |
| Adjustment and scaffolding | Suggestions for adjusting the text or scaffolding students to make it appropriate for the target grade. |
| Recommended use cases | Instructional 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.
| Metric | Description | Result |
|---|
| Complexity score accuracy | | 84% agreement with expert annotations |
| Expert agreement | | 70% |
| Reasoning soundness | | Average 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
| Date | Changes |
|---|
| May 7, 2026 | First release |