Skip to main content
Once you’ve configured your evaluator, you can start evaluating text inputs for grade level appropriateness:
example.ts
const evaluator = new GradeLevelAppropriatenessEvaluator(configOptions);

const text = "The cat's out of the bag now.";

await evaluator.evaluate(text);

​
Literacy evaluators family

The Text Complexity Evaluator runs multiple literacy evaluators on the provided text input: The output:

​
For other evaluators

All literacy evaluators besides the parent Text Complexity Evaluator have the following output fields.
FieldTypeDescription
scoreTextComplexityLevel ↗Complexity classification returned by the evaluator. Purpose evaluator also accepts “More context needed” for cases where the text alone is insufficient to determine complexity.
reasoningstringExplanation for the assigned complexity score
metadataEvaluationMetadata ↗Includes model used to generate the evaluation, total evaluation processing time in milliseconds, input tokens, and output tokens.
_internalUnique to each evaluatorDetailed internal analysis data specific to each evaluator.
The _internal field includes detailed internal analysis data specific to that evaluator:
Evaluator_internal description_internal type
Grade Level AppropriatenessOutput fieldsGradeLevelAppropriatenessInternal ↗
Subject Matter Knowledge
v0.2.0
Output fieldsSmkInternal ↗
VocabularyOutput fieldsVocabularyInternal ↗
Sentence StructureOutput fieldsSentenceStructureInternal ↗
Conventionality
v0.3.0
Output fieldsConventionalityInternal ↗
Purpose
v0.5.0
Output fieldsPurposeInternal ↗