Overview

import { GradeLevelAppropriatenessEvaluator } from "@learning-commons/evaluators";

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

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

const result = await evaluator.evaluate(text);
console.log(result.score); // 4-5

import logging
from learning_commons_evaluators import (
    GradeLevelAppropriateness,
    GradeLevelAppropriatenessEvaluationInput,
    GoogleLLMProviderConfig,
    create_config_no_telemetry,
)

# Logger
logging.basicConfig(level=logging.INFO)

# Config with Google API key
config = create_config_no_telemetry(
  google_llm_provider_config=GoogleLLMProviderConfig(api_key="your-google-key"),
)

# Instantiate GradeLevelAppropriatenessEvaluator with created config
evaluator = GradeLevelAppropriatenessEvaluator(config)

# Evaluate some text for grade level appropriateness
result = evaluator.evaluate_sync(
  GradeLevelAppropriatenessEvaluationInput(text="The cat's out of the bag now.")
)

print(result.answer.label) # e.g. "Moderately complex"
print(result.explanation.summary) # Reasoning for the score