Maintained by deepset

Integration: Ragas

Use the Ragas evaluation framework to calculate model-based metrics


Table of Contents


Ragas is an open source framework for model-based evaluation to evaluate your LLM applications by quantifying their performance on aspects such as correctness, tonality, hallucination, fluency, etc. More information can be found on the documentation page.


Install the Ragas integration:

pip install ragas-haystack


Once installed, you will have access to a RagasEvaluator that supports a variety of model-based evaluation metrics:

  • Faithfulness
  • Answer relevancy
  • Context recall
  • Context precision
  • Context relevancy
  • Aspect Critique


To use this integration for calculating model-based evaluation metrics, initialize a RagasEvaluator with the metric name and optional metric input parameters:

# A valid OpenAI API key must be provided as an environment variable "OPENAI_API_KEY" to run this example.

from haystack import Pipeline

from haystack_integrations.components.evaluators.ragas import RagasEvaluator, RagasMetric

    "Which is the most popular global sport?",
    "Who created the Python language?",
        "The popularity of sports can be measured in various ways, including TV viewership, social media presence, number of participants, and economic impact. Football is undoubtedly the world's most popular sport with major events like the FIFA World Cup and sports personalities like Ronaldo and Messi, drawing a followership of more than 4 billion people."
        "Python, created by Guido van Rossum in the late 1980s, is a high-level general-purpose programming language. Its design philosophy emphasizes code readability, and its language constructs aim to help programmers write clear, logical code for both small and large-scale software projects."
    "Football is the most popular sport with around 4 billion followers worldwide",
    "Python language was created by Guido van Rossum.",

    "Football is the most popular sport",
    "Python language was created by Guido van Rossum.",

pipeline = Pipeline()
evaluator_context = RagasEvaluator(
evaluator_aspect = RagasEvaluator(
    metric_params={"name": "custom", "definition": "Is this answer problematic for children?", "strictness": 3},
pipeline.add_component("evaluator_context", evaluator_context)
pipeline.add_component("evaluator_aspect", evaluator_aspect)

# Each metric expects a specific set of parameters as input. Refer to the
# Ragas class' documentation for more details.
results =
        "evaluator_context": {"questions": QUESTIONS, "contexts": CONTEXTS, "ground_truths": GROUND_TRUTHS},
        "evaluator_aspect": {"questions": QUESTIONS, "contexts": CONTEXTS, "responses": RESPONSES},

for component in ["evaluator_context", "evaluator_aspect"]:
    for output in results[component]["results"]: