●Change8

Migrating to RAGAS v0.3.9

Version v0.3.9 introduces 2 breaking changes. This guide details how to update your code.

Released: 11/11/2025

2
Breaking Changes
3
Migration Steps
5
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

aspect critic metricsimple criteria metricground_truthsAnswerSimilaritySemanticSimilarity

Breaking Changes

●Issue #1

The metrics 'aspect critic' and 'simple criteria' have been removed and replaced with discrete metric examples.

●Issue #2

The metric 'AnswerSimilarity' has been removed from the collections API in favor of 'SemanticSimilarity'.

Migration Steps

  1. 1
    Replace usage of removed metrics 'aspect critic' and 'simple criteria' with discrete metric examples.
  2. 2
    Replace usage of 'AnswerSimilarity' in collections API with 'SemanticSimilarity'.
  3. 3
    Remove usage of the deprecated `ground_truths` field.

Release Summary

This release focuses heavily on migrating core metrics to a new structure, removing deprecated metrics like 'aspect critic', and introducing new features like synthetic data traceability metadata. Several documentation fixes and minor bug fixes related to OpenAI models were also implemented.

Need More Details?

View the full release notes and all changes for RAGAS v0.3.9.

View Full Changelog