SuperAPI AI 工具集

benchmark-context

数据与分析

查看项目

更新于 10-16 02:06

技能介绍

用途

MemoryBench 集成技能用于自动将你自建的记忆/上下文系统与业界成熟方案进行基准测试。当你构建了自定义记忆系统、希望获得客观指标来对比行业方案,或正在考虑选用哪种记忆系统时,可以使用该技能。它支持在标准化数据集(对话记忆、RAG、对话)上进行评测。

主要能力

技能从项目根目录调用后,端到端处理完整基准测试流程:

  • 询问 5 个设置问题:提供者名称、记忆代码位置、基准数据集、对比目标(多选)、测试规模。
  • 使用 AI 代理分析你的记忆代码库,识别初始化、摄入(ingestion)和搜索方法,检测所需配置与 API 密钥,理解数据格式。
  • 自动生成实现 MemoryBench 接口的提供者适配器,将你的记忆代码复制并适配到提供者中,必要时生成自定义提示词。
  • 注册提供者:更新 src/types/provider.ts、src/providers/index.ts、src/utils/config.ts,并记录环境变量。
  • 配置环境:创建 .env.local,收集你的提供者凭据、对比提供者密钥以及用于评判的 OpenAI/Anthropic 密钥。
  • 验证:用单个问题快速测试,确认提供者初始化、摄入和搜索正常。
  • 执行完整基准测试,实时显示进度(摄入、索引、搜索、回答、评估),并与所选竞品对比,展示准确率和延迟指标。

使用方式

从你的项目根目录调用(不要在 memorybench 目录内运行):

# 在 Claude Code CLI 中调用技能
/memorybench

# 或以编程方式使用
skill:memorybench

技能会自动完成以下阶段:

  1. 设置:从 https://github.com/supermemoryai/memorybench 克隆 memorybench 到 ./memorybench,使用 bun 安装依赖,验证环境。
  2. 发现:用 AI 代理分析你的记忆代码库。
  3. 代码生成:创建提供者适配器。
  4. 注册:更新类型、提供者索引和配置。
  5. 配置:创建 .env.local 并收集密钥。
  6. 验证:单问题快速测试。
  7. 基准执行:运行完整基准并展示结果。

克隆命令(请勿修改 URL):

git clone https://github.com/supermemoryai/memorybench.git memorybench
cd memorybench && bun install && cd ..

运行基准测试:

# 带对比
cd memorybench && bun run src/index.ts compare -p {providerName},{others} -b {benchmark} -l {limit}

# 不带对比
cd memorybench && bun run src/index.ts run -p {providerName} -b {benchmark} -l {limit}

查看结果与失败:

cd memorybench && bun run src/index.ts serve
cd memorybench && bun run src/index.ts show-failures -r {run-id}

基准数据集

  • LoCoMo:跨多个会话、持续数天/数周的长期对话记忆。适用于聊天应用、AI 助手、客服机器人。
  • LongMemEval:长文档与复杂检索的记忆。适用于 RAG 系统、文档分析、知识库。
  • ConvoMem:多轮对话理解与上下文跟踪。适用于对话系统、面试机器人、会议助手。

对比目标

  • Supermemory:快速混合向量 + 图记忆,自动提取。
  • Mem0:面向 AI 代理的持久记忆,带图关系。
  • Zep:长期对话记忆,自动摘要。
  • Filesystem:基线向量搜索(无需 API)。
  • RAG:带 LLM 提取的基线 RAG(无需 API)。

测试规模

  • Small(5 个问题):快速验证,约 2-5 分钟。
  • Medium(20 个问题):较好样本量,约 10-15 分钟。
  • Full(全部问题):完整评估,约 30-60 分钟。

适用场景

  • 已构建自定义记忆/上下文系统,想了解其表现。
  • 需要客观指标将你的实现与行业方案对比。
  • 想在标准化数据集上做基准测试。
  • 正在选型记忆系统,希望获得数据驱动的对比。

限制与注意事项

  • 必须从项目根目录运行,不能在 memorybench 目录内运行。
  • 需要 bun 环境,以及 OpenAI/Anthropic 密钥用于评判,可能还需要你的提供者和对比提供者的 API 密钥。
  • 克隆必须使用指定 URL https://github.com/supermemoryai/memorybench.git。
  • 常见问题:提供者未初始化(检查 .env.local 中的 API 密钥)、摄入失败(检查数据格式转换)、搜索无结果(检查 containerTag 处理与索引完成情况)、答案错误(可能需要为结果格式自定义提示词)。
  • 关于收费、价格、平台支持等具体信息,资料中暂未提供。