Overview

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

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

const { result } = await evaluator.evaluate({
  text: "The cat's out of the bag now.",
});

console.log(result.grade_band); // 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.grade_band) # e.g. 4-5
print(result.reasoning) # Reasoning for the grade band