Workflow·AI & Agents·v2.6.0

RAG Eval

Filesystem RAG benchmarks: corpus/, train.json, evaluate_rag.py (RAGAS quality) for a deployed NVIDIA RAG Blueprint.

You say
Buy it · $89 Read it before you buy $89 Written by NVIDIA · unverified publisher
Context cost
10.9k tokensestimated from the bundle, loaded when it triggers
Bundle
9 files · 43.8 kBtext throughout, nothing executable
Licence
Apache-2.0paid listing
Last change
v2.6.0
Servers it uses
Noneruns standalone

What it does

Filesystem RAG benchmarks: corpus/, train.json, evaluate_rag.py (RAGAS quality). Not for prod monitoring, latency/throughput benchmarking (use rag-perf), or evals outside this repo layout.

Installed, it changes the agent in these ways.

What this skill changes about the agent is not written down here yet. The listing was collected from its source, and the description is in its own SKILL.md.

Workflow

Runs a procedure end to end.

ragevaluationragasbenchmarking
Filed under

AI & Agents

The skill itself

This is the whole product. A skill is instructions the model reads, so there is nothing behind the listing you cannot see first — the front matter loads with every session, and the body below it loads when the skill triggers.

SKILL.md9.4 kB · 131 lines
--- name: rag-eval version: "2.6.0" description: >- Filesystem RAG benchmarks: corpus/, train.json, evaluate_rag.py (RAGAS quality). Not for prod monitoring, latency/throughput benchmarking (use rag-perf), or evals outside this repo layout. license: Apache-2.0 compatibility: Repository checkout with uv; Python 3.11+; run from repo root; uv sync --project scripts/eval (eval deps live in scripts/eval/pyproject.toml); network to RAG, ingestor, and vdb endpoints; NVIDIA_API_KEY for RAGAS; optional RAG_EVAL_JUDGE_MODEL (default mistralai/mixtral-8x22b-instruct-v0.1). metadata: author: NVIDIA RAG <foundational-rag-dev@exchange.nvidia.com> github-url: "https://github.com/NVIDIA-AI-Blueprints/rag" endpoint-openapi-schemas: - docs/api_reference/openapi_schema_rag_server.json - docs/api_reference/openapi_schema_ingestor_server.json argument-hint: RAGAS eval | evaluate_rag | train.json | corpus | results json | error triage | uv run --project scripts/eval | enable_reranker | query_rewriting | temperature | skip_ingestion tags: - nvidia - blueprint - rag - evaluation - ragas - benchmarking - nvidia-rag-blueprint languages: - python - shell frameworks: - ragas - fastapi domain: ai-ml allowed-tools: Read Grep Glob Bash(ls *) Bash(python3 *) Bash(uv *) Write Edit ---
34# On-disk RAG evaluation (corpus/ + train.json)
35
36## Purpose
37
38Guide agents through NVIDIA RAG Blueprint **filesystem** benchmarks: preparing corpus/ and train.json, running scripts/eval/evaluate_rag.py, tuning retrieval and generation flags for **quality** comparisons, interpreting RAGAS JSON outputs, and triaging failures (HTTP/stream errors, empty contexts, collection mismatch, judge API).
39
40For **latency, throughput, and load testing**, use the **rag-perf** skill (scripts/rag-perf, docs/performance-benchmarking.md) — not this skill.
41
42## When not to use
43
44Do **not** use this skill for: deploying or repairing services (use rag-blueprint); evaluating APIs without the corpus/ + train.json layout; general ML experimentation unrelated to this evaluator; production monitoring/alerting; or latency/throughput benchmarking (use **rag-perf**).
45
46## Prerequisites
47
48- Repo cloned; **run commands from repo root** (imports and paths assume this).
49- Python **3.11+** and **uv**; eval deps: uv sync --project scripts/eval.
50- Reachable **RAG server** and **ingestor** (defaults often localhost:8081 / 8082).
51- **NVIDIA_API_KEY** for RAGAS (see [credential hygiene](references/benchmark-execution.md#credential-hygiene-nvidia_api_key)); optional **RAG_EVAL_JUDGE_MODEL**.
52- Dataset roots passed to --dataset-paths each contain **corpus/** and **train.json**.
53
54## Instructions
55
561. **Prepare data** — Ensure each dataset directory matches the layout and train.json rules in [references/dataset-and-conversion.md](references/dataset-and-conversion.md). When sources arrive as public links (sites or dataset pages), materialize documents under corpus/—prefer **PDF** for multimodal content so **images stay embedded**; convert CSV/JSONL/etc. using the patterns there.
572. **Run eval** — uv run --project scripts/eval python scripts/eval/evaluate_rag.py with --dataset-paths, --host, and --port. See [references/benchmark-execution.md](references/benchmark-execution.md) for command examples, outputs, and errors. Use [references/evaluate-rag-cli.md](references/evaluate-rag-cli.md) for flag-level detail.
583. **Tune quality** — Adjust --top_k / --vdb_top_k, reranker and query-rewriting toggles, and generation overrides (--temperature, --top-p, --max-tokens) as documented in [references/benchmark-execution.md](references/benchmark-execution.md) when comparing retrieval/generation configs for RAGAS scores.
594. **Analyze results** — Use [references/result-analysis.md](references/result-analysis.md) for scripts; scan rag_*_evaluation_summary.json for headline RAGAS metrics.
605. **Triage errors** — Use the [error signal table](references/benchmark-execution.md#common-error-cases-and-signals) and the **Troubleshooting** section below.
61
62## Examples
63
64**Set API key without putting secrets in shell history (preferred patterns):** load from a gitignored env file or secrets manager; avoid committing .env; rotate keys if exposed. Details: [references/benchmark-execution.md#credential-hygiene-nvidia_api_key](references/benchmark-execution.md#credential-hygiene-nvidia_api_key).
65
66**Minimal eval (key already in environment):**
67
68```bash
69uv sync --project scripts/eval
70uv run --project scripts/eval python scripts/eval/evaluate_rag.py \
71 --dataset-paths /path/to/my_dataset \
72 --host localhost \
73 --port 8081
74```
75
76**Pretty-print summary JSON:**
77
78```bash
79python3 -m json.tool results/my_dataset/rag_my_dataset_evaluation_summary.json
80```
81
82More examples (skip ingestion, quality sweeps): [references/benchmark-execution.md](references/benchmark-execution.md).
83
84## Limitations
85
86- Evaluator behavior is fixed to the **filesystem contract** and evaluate_rag.py; it does not substitute for custom offline judges or non-RAG benchmarks.
87- **Vector DB / embedding** choices follow deployed ingestor and RAG env — not overridden by this CLI alone.
88- **Scores depend on** retrieval quality, judge model availability, and NVIDIA_API_KEY; empty contexts yield partial RAGAS metrics (see references).
89- Large procedural detail lives under **references/** to keep routing concise; read those files when the user needs step-by-step conversion, full flags, or error tables.
90
91## Troubleshooting
92
93| Error / signal | Likely cause | What to do |
94|----------------|--------------|------------|
95| Immediate exit mentioning NVIDIA_API_KEY | Missing or invalid key | Set key via secure channel; see credential hygiene in [references/benchmark-execution.md](references/benchmark-execution.md). |
96| train.json must be a JSON array | Wrong JSON shape | Top-level array of objects; validate per [references/dataset-and-conversion.md](references/dataset-and-conversion.md). |
97| Fewer rows in evaluation_data.json than train.json | Per-query failures | Check stderr: network or stream JSON errors; see error table in benchmark-execution. |
98| Empty generated_contexts everywhere | Retrieval gap | Verify collection, ingestion, top_k / vdb_top_k, and ingestor_server_url **without** /v1 suffix. |
99| Ingestor 404 on upload | Bad ingestor base URL | Pass http://host:port only — code appends /v1/. |
100
101Full signal table: [references/benchmark-execution.md#common-error-cases-and-signals](references/benchmark-execution.md#common-error-cases-and-signals).
102
103## Gotchas
104
105- **Run from repo root**: paths and imports in scripts/eval/evaluate_rag.py assume this; a wrong directory silently breaks imports.
106- **--ingestor_server_url**: pass http://host:port without /v1—the code appends /v1/ automatically. Including /v1 causes 404s on ingestor calls.
107- **Vector DB / embedding settings**: not set by this CLI; configure via the deployed ingestor and RAG server env vars (e.g. APP_VECTORSTORE_URL, embedding model).
108- **--model / --llm_endpoint**: forwarded verbatim only when explicitly set; omit to keep the server's configured LLM.
109- **Stale collections**: a previous run's ingested data persists unless you use --force_ingestion. Use --collection with a unique name when comparing quality across isolated runs.
110- **Empty context metrics**: if all generated_contexts are empty, RAGAS scores only nv_accuracy and leaves the other two metrics blank—this is not a silent success.
111
112## Source of truth
113
114| Piece | Location |
115|-------|----------|
116| Driver | scripts/eval/evaluate_rag.py (CORPUS_DIRECTORY = corpus, EVAL_DATA = train.json) |
117| Human README (always in-repo) | scripts/eval/README.md |
118| Full CLI (flags, defaults) | scripts/eval/evaluate_rag.py --help; [references/evaluate-rag-cli.md](references/evaluate-rag-cli.md) |
119| Dataset / conversion | [references/dataset-and-conversion.md](references/dataset-and-conversion.md) |
120| Runs, outputs, errors | [references/benchmark-execution.md](references/benchmark-execution.md) |
121| Result analysis scripts | [references/result-analysis.md](references/result-analysis.md) |
122| Latency / throughput | **rag-perf** skill, docs/performance-benchmarking.md |
123
124## Agent playbook
125
1261. **Run eval** — uv sync --project scripts/eval then uv run --project scripts/eval python scripts/eval/evaluate_rag.py with required --dataset-paths, --host, and --port (and env NVIDIA_API_KEY). Argument --ingestor_server_url is optional (defaults to http://localhost:8082); pass it only when overriding the ingestor endpoint.
1272. **Quality tuning** — See [references/benchmark-execution.md](references/benchmark-execution.md): --top_k/--vdb_top_k, reranker and query-rewriting toggles, --temperature, --top-p, --max-tokens.
1283. **Data conversion** — Follow [references/dataset-and-conversion.md](references/dataset-and-conversion.md).
1294. **Analyze results** — [references/result-analysis.md](references/result-analysis.md); quick scan: python3 -m json.tool results/<dataset>/rag_<dataset>_evaluation_summary.json.
1305. **Error triage** — [references/benchmark-execution.md#common-error-cases-and-signals](references/benchmark-execution.md#common-error-cases-and-signals).
131
In the file
SKILL.md995 words
Files9
LicenceApache-2.0
Why you can read it

Nothing in a skill executes. The client loads the text and the model follows it, so a skill can be audited the way a runbook is — by reading it.

What it costs in context

Skills are not billed by the call. They are paid for in context: every token the instructions occupy is a token your code, your diff and your conversation cannot use. Here is what this one takes and when it takes it.

≈340
always loaded
The name and description, so the model knows the skill exists and when to reach for it.
10,610
on trigger
The instruction body and 8 supporting files, read only when the skill fires.
5.5%
of a 200k window
Ten skills this size would take about 55% of the window before you open a file.
050k100k150k200k context window

10.9k tokens, estimated from the bundle at four bytes to the token, held for the rest of the session once it triggers. Heavy. Teams tend to install this one per project rather than globally, and load it only when the job comes up.

Servers bill, skills cost

A server charges by the month. A skill charges once per session, in context, and then keeps charging it for as long as the session lives.

Before and after

The same question, put to the same model twice: once as it comes, and once with these instructions loaded.

No worked example has been published for this skill yet.

Adoption
Installsnone yet
Ratingno reviews yet

The procedure it runs

The procedure has not been published here. It is in the skill’s own SKILL.md, which its author has not sent to the marketplace yet.

Prose, not code

These steps are written for a model to follow, not executed by a runtime. It can still be told to skip one, and it will say so when it does.

Servers it uses

None. This skill calls no MCP servers at all.

Everything it needs is in the instructions, so it works in a project with nothing connected — the model reads the file and changes how it works with what it can already reach.

It asks the agent to write files, using whatever file access your client already has. It never touches the network.

What it asks for
Writes filesyes
Network accessno

Read from the allowed-tools line of this skill’s own SKILL.md. A skill grants no permissions of its own — it can only ask for tools your client already has.

What it will not do

Every skill is narrow, and the useful ones say where they stop. These are the jobs this one is the wrong tool for.

What this skill is not for has not been published here. Nothing is implied by that: it is a section the author has not filled in.

What is in the bundle

9 files, 43.8 kB on disk. A bundle is text throughout: the instructions the model reads, plus the templates it fills in.

  • BENCHMARK.md2.9 kB
  • SKILL.md9.4 kB
  • skill-card.md2.7 kB
  • eval/h100.json2.9 kB
  • eval/nvidia_hosted.json2.0 kB
  • references/benchmark-execution.md8.3 kB
  • references/dataset-and-conversion.md8.4 kB
  • references/evaluate-rag-cli.md4.3 kB
  • references/result-analysis.md2.9 kB
What is not in it

No dependencies and nothing executable: a skill is text the agent reads, so the bundle is 9 files you can review in full before installing. The Apache-2.0 licence covers the templates and examples as well as the instructions.

Install

Installing copies the bundle into your project. Nothing runs at install time — the files sit on disk until the model reads them.

$89 once
RAG Eval · Apache-2.0 · NVIDIA
one-time
Price$89 once
LicenceApache-2.0 — the author’s, unchanged by this purchase
Paid throughStripe, once, on the card you add at the checkout
Keeps workingfor good — the files are yours once they are on disk
Updatesevery release of 2.x through this account

You can read the whole bundle before paying — the SKILL.md above is the product, not a preview of it. What the money buys is the delivery: the folder packaged and handed to your machine by key, every update its author ships, and our support if it does not do what this listing says. The terms of use are Apache-2.0, set by the author and unchanged by buying it here.

Payment runs through Stripe, on a page like this one rather than a redirect. Once there is an account it joins the same mcprush invoice as everything else you run, so there is never a second card to enter.

Which clients pick it up on their own

A skill is a folder of text. A client with a skills folder reads it without being told; everywhere else the same text works, it is just handed to the model rather than found.

Claude Code.claude/skills/
Claude Desktop
ChatGPT
Cursor.cursor/skills/
VS Code.github/skills/
Codex CLI.agents/skills/
Gemini CLI.gemini/skills/
Grok.grok/skills/
Zed.agents/skills/
Windsurf.windsurf/skills/
Agent SDK.claude/skills/
HTTP / API
This release
Version2.6.0
Publishedno release date on file
Price$89
Referencenvidia/rag-eval

Versions

v2.6.0 is what is on the shelf; no release here carries a date. Instructions change more often than APIs do — a skill can be rewritten entirely without anything it depends on moving.

v2.6.0
  • No earlier releases have been published to the marketplace.
Pinning

Put nvidia/rag-eval@2.6.0 in the install command to hold this exact version. Without the suffix you get whatever is current the day you install, and nothing moves under you afterwards.

Reviews

no reviews yet · no installs yet

Nobody has reviewed this skill yet. The rating is the mean of the reviews written here, so there is none until somebody writes the first.

Who can post

Only accounts that have had the skill installed for fourteen days, so a review is written after living with it rather than after reading it. Publishers may reply once.

Publisher
Servers0