> ## Documentation Index > Fetch the complete documentation index at: https://docs.learningcommons.org/llms.txt > Use this file to discover all available pages before exploring further. # Purpose > Reference documentation for the Purpose literacy evaluator. export const EarlyAccessCallout = ({children}) =>
Early access
{children}
; [Evaluator last updated May 7, 2026.](#evaluator-release-history) This functionality is actively evolving. Changes may occur as we expand capabilities and improve accuracy and reliability. Email [support@learningcommons.org](mailto:support@learningcommons.org) ↗ with your feedback or issues. ## 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](https://learnwithsap.org/) ↗'s [Qualitative Text Complexity Rubric for Informational Text](https://learnwithsap.b-cdn.net/app/uploads/2026/04/Qualitative-Text-Complexity-Rubric-Informational.pdf) ↗ | 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](/evaluators/getting-started/quickstart) to start using this evaluator: | Access method | | | :------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Evaluators Playground** | [View in the Learning Commons Platform](https://platform.learningcommons.org/apps/evaluators/playground?utm_source=docs\&utm_medium=evaluators) ↗ | | **SDK** | [TypeScript](https://github.com/learning-commons-org/evaluators/blob/main/sdks/typescript/src/evaluators/purpose.ts?utm_source=docs\&utm_medium=evaluators) ↗ | | **Python notebook** | [View in GitHub](https://github.com/learning-commons-org/evaluators/blob/main/evals/purpose_evaluator.ipynb?utm_source=docs\&utm_medium=evaluators) ↗ | | **Prompts** | [View in GitHub](https://github.com/learning-commons-org/evaluators/tree/main/evals/prompts/purpose/?utm_source=docs\&utm_medium=evaluators) ↗ | ## Inputs | 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: | | **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](https://docs.google.com/spreadsheets/d/1sfsZhhP2umXXtmEP_NRErxLuwgN98TyH7LWOq3j07O0/edit) ↗ 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 |