zep-eval-harness

Automate end-to-end evaluation of Zep memory retrieval and QA capabilities.

4.8k|647|Updated Apr 29, 2023
One-click install
npx skills add https://github.com/getzep/zep --skill zep-eval-harness
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: zep-eval-harness
Source: https://github.com/getzep/zep/tree/main/zep-eval-harness/.claude/commands/zep-eval-harness
Command: npx skills add https://github.com/getzep/zep --skill zep-eval-harness

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Zep Eval Harness provides an end-to-end evaluation framework to test Zep's memory retrieval and QA capabilities by feeding conversations, telemetry, and documents into graphs and scoring retrieved contexts against gold answers.

Core Features & Use Cases

  • Chunk documents: split documents into chunks and generate contextualized summaries for LLM consumption.
  • Ingest users and documents: create user graphs, ingest conversations and telemetry, and push document chunks into a standalone graph for evaluation.
  • Evaluate: run test cases, search graphs for context, generate LLM responses, and grade answers against golden solutions.
  • Inspect graphs: use zep_graph_inspect.py to view graph contents and diagnose retrieval or context gaps.
  • Compare runs: analyze aggregate and per-category metrics across different runs/configs.
  • Metrics and diagnostics: focus on Context Complete (PRIMARY) and Answer Accuracy (SECONDARY) to assess retrieval quality and response correctness.

Quick Start

Run the Zep eval harness end-to-end to chunk documents, ingest users and documents, run evaluations, inspect graphs, and analyze results.

Frequently Asked Questions about zep-eval-harness

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I evaluate graph-based memory retrieval and QA capabilities end-to-end?

You can evaluate graph-based memory retrieval by feeding conversations, telemetry, and documents into graphs, then scoring retrieved contexts against gold answers to validate retrieval quality and response correctness.

What metrics are used to score memory retrieval and answer accuracy?

Memory retrieval scoring focuses on Context Complete as the primary metric to assess retrieval quality, and Answer Accuracy as the secondary metric to evaluate response correctness against golden solutions.

How can I inspect graphs to debug retrieval or context gaps?

You can inspect graphs by using dedicated scripts to view graph contents, allowing you to diagnose retrieval failures and identify missing context nodes within your ingested conversations and documents.

How do I chunk documents and generate contextualized summaries for LLM consumption?

Document chunking splits source documents into manageable chunks and automatically generates contextualized summaries, preparing the text data for ingestion into standalone graphs for LLM evaluation.

Can I compare evaluation metrics across different runs and configurations?

You can compare evaluation runs by analyzing aggregate and per-category metrics stored in the runs directories, enabling side-by-side analysis of retrieval performance across different configurations.