Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: Add link to RAGAS metrics page #2019

Open
wants to merge 2 commits into
base: main
Choose a base branch
from
Open

docs: Add link to RAGAS metrics page #2019

wants to merge 2 commits into from

Conversation

ssbushi
Copy link
Contributor

@ssbushi ssbushi commented Feb 18, 2025

Checklist (if applicable):

@github-actions github-actions bot added the docs Improvements or additions to documentation label Feb 18, 2025
@ssbushi ssbushi requested review from thedmail and pavelgj February 18, 2025 15:46
@@ -252,6 +252,9 @@ given prompt
* Maliciousness -- Measures whether the generated output intends to deceive,
harm, or exploit

For more details on how each metric is computed, please refer to the
[RAGAS metrics documentation](https://docs.ragas.io/en/stable/concepts/metrics/available_metrics/){: .external}.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

looking at the page, there are many more metrics listed there... do we want to link to specific metrics instead?
Ex: https://docs.ragas.io/en/stable/concepts/metrics/available_metrics/faithfulness/

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I thought of that, but RAGAS change their metrics frequently, I was afraid we might have to keep up with them so I used the parent page instead.

I can switch to using specific metrics if you feel that's preferred.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

if they change the metrics frequently then it means that whatever we have may not be up-to-date, right? what's the point of linking to their docs if it may or may not be accurate?

Copy link
Contributor Author

@ssbushi ssbushi Feb 19, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The reason we should link is because they have detailed explanation on how a metric is computed. Some of the feedback we received for evals is a scenario like: 'user expects relevancy to be 1.0 but it is only 0.5, why is that?'

The reason I am hesitant to link to individual docs for each metric is because RAGAS seem to change their metrics collection (either removing them or renaming them). E.g.: ANSWER_RELEVANCY in genkitEvals is now called "Response Relevancy" in RAGAS.

Catching up to RAGAS is a different problem altogether.

You are right though... taking them to a top level directory does not guarantee that the metric details would be available. The way I see it, both approaches have their cons.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs Improvements or additions to documentation
Projects
Status: No status
Development

Successfully merging this pull request may close these issues.

2 participants