Outputs

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);

Student-Facing Text evaluator family

The Text Complexity evaluator runs multiple Student-Facing Text evaluators on the provided text input:

The output:

Throws an error if all Student-Facing Text evaluators fail
Otherwise outputs an error or result for each Student-Facing Text evaluator

For other evaluators

All Student-Facing Text evaluators besides the parent Text Complexity evaluator have the following output fields.

Field	Type	Description
`score`	`TextComplexityLevel` ↗	Complexity classification returned by the evaluator. Purpose Clarity evaluator also accepts “More context needed” for cases where the text alone is insufficient to determine complexity.
`reasoning`	`string`	Explanation for the assigned complexity score
`metadata`	`EvaluationMetadata` ↗	Includes model used to generate the evaluation, total evaluation processing time in milliseconds, input tokens, and output tokens.
`_internal`	Unique to each evaluator	Detailed 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 Appropriateness	Output fields	`GradeLevelAppropriatenessInternal` ↗
Background Knowledge Demands v0.2.0	Output fields	`SmkInternal` ↗
Vocabulary Complexity	Output fields	`VocabularyInternal` ↗
Sentence Structure	Output fields	`SentenceStructureInternal` ↗
Meaning Directness v0.3.0	Output fields	`ConventionalityInternal` ↗
Purpose Clarity v0.5.0	Output fields	`PurposeInternal` ↗

Quickstart

Install the SDK and run your first evaluator.

Configuration

Configure evaluators, including API keys and options.

Error handling

Handle configuration, validation, and API errors.

Batch evaluator

Evaluate a batch of text from a CSV file using literacy evaluators.

Understanding evaluators

Getting started

SDK API reference

Student-Facing Text evaluators

Feedback evaluators

Academic standards evaluators

Durable skills evaluators

Datasets

Resources

Student-Facing Text evaluator family

For other evaluators

Quickstart

Configuration

Error handling

Batch evaluator

​Student-Facing Text evaluator family

​For other evaluators

​Related topics

Quickstart

Configuration

Error handling

Batch evaluator

Student-Facing Text evaluator family

For other evaluators

Related topics