Outputs

Once you’ve configured your evaluator, you can start evaluating text inputs for grade level appropriateness:

example.ts

const evaluator = new GradeLevelAppropriatenessEvaluator({
  googleApiKey: process.env.GOOGLE_API_KEY,
});

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

await evaluator.evaluate(text);

Text Complexity evaluator family

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

The output:

Throws an error if all Text Complexity evaluators fail
Otherwise outputs an error or result for each Text Complexity evaluator

For other evaluators

All Text Complexity 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 Text Complexity evaluators.

Understanding evaluators

Getting started

SDK API reference

Text Complexity evaluators

Graphics evaluators

Feedback evaluators

Academic standards evaluators

Durable skills evaluators

Datasets

Resources

Text Complexity evaluator family

For other evaluators

Quickstart

Configuration

Error handling

Batch evaluator

​Text Complexity evaluator family

​For other evaluators

​Related topics

Quickstart

Configuration

Error handling

Batch evaluator

Text Complexity evaluator family

For other evaluators

Related topics