用于评估提示词和对 LLM 应用做红队测试的命令行工具与库,支持声明式配置和 CI/CD 集成。
langchain-ai/openevals
用于测试 LLM 应用输出的 Python/TypeScript 评估库,提供现成评估器和 LLM-as-judge 打分。
- Star
- 1,227
- Fork
- 133
- 未关闭 Issue
- 25
- 最近提交
- 2小时前
这是什么?
OpenEvals 是一个面向 LLM 应用的现成评估器库,思路上类似传统软件的单元测试。它提供起点性质的评估器,团队可以直接使用,也可以在此基础上编写更贴合自身应用的评估。
核心是 create_llm_as_judge 函数:传入提示词和评判模型,即可得到一个评估器,它会把输入和输出填入提示词,并解析评判模型给出的分数。包内置了质量、安全、安全性、RAG、代码、结构化抽取、Agent 轨迹以及语音和图像等场景的预置提示词。评判模型可以用 provider:model 字符串通过 LangChain 指定,也可以直接传入聊天模型或 OpenAI 客户端实例。
此外,OpenEvals 还提供精确匹配、编辑距离、向量相似度等非 LLM 评估器,并可与 LangSmith 的 pytest 以及 Vitest/Jest 运行器集成。同时支持 Python 和 TypeScript。针对 Agent 的评估器位于另一个项目 agentevals 中。
核心功能
- 01根据提示词和评判模型生成 LLM-as-judge 评估器。
- 02内置质量、安全、安全性、RAG 和代码检查等预置提示词。
- 03支持自定义评分值、输出结构和图像、音频、PDF 等多模态输入。
- 04提供精确匹配、编辑距离、嵌入相似度等非 LLM 评估器。
- 05可与 LangSmith 的 pytest 以及 Vitest/Jest 运行器配合使用。
适用场景
- 在上线前检查聊天机器人的回答是否简洁、正确且没有幻觉。
- 评估 RAG 流程的回答依据性和检索相关性。
- 检测模型输出中的有害内容、个人信息泄露或提示词注入。
- 将 LLM 输出检查纳入 CI 测试流程。
快速上手
- 1
使用 pip 安装 openevals
pip install openevals - 2
将 OpenAI API 密钥设置为环境变量
export OPENAI_API_KEY="your_openai_api_key" - 3
运行 README 中的简洁性评估器示例
使用前须知
- 快速入门和默认的 LLM-as-judge 评估器需要 OpenAI API 密钥,而 OpenAI 是付费服务。
标签
常见问题
- openevals 是什么?
- 用于测试 LLM 应用输出的 Python/TypeScript 评估库,提供现成评估器和 LLM-as-judge 打分。 OpenEvals 是一个面向 LLM 应用的现成评估器库,思路上类似传统软件的单元测试。它提供起点性质的评估器,团队可以直接使用,也可以在此基础上编写更贴合自身应用的评估。
- openevals 可以免费使用吗?用的什么许可证?
- openevals 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
- openevals 还在维护吗?
- 活跃维护中。openevals 最近一次提交是在 2026年10月21日。
- openevals 适合用来做什么?
- 在上线前检查聊天机器人的回答是否简洁、正确且没有幻觉。 评估 RAG 流程的回答依据性和检索相关性。 检测模型输出中的有害内容、个人信息泄露或提示词注入。 将 LLM 输出检查纳入 CI 测试流程。
- openevals 怎么安装和运行?
- 使用 pip 安装 openevals: pip install openevals 将 OpenAI API 密钥设置为环境变量: export OPENAI_API_KEY="your_openai_api_key" 运行 README 中的简洁性评估器示例
- 在哪里获取 openevals?
- 源代码和安装说明在 GitHub 上:https://github.com/langchain-ai/openevals
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
开源企业级智能体平台,集成 RAG 知识库、可视化工作流与 MCP 工具调用。
开源 Python LLM 评测框架,可像 Pytest 一样对 LLM 应用做单元测试,内置 RAG、Agent、多轮对话等指标。
基于 LangGraph 的 Python 库与可运行教程,实现了 35 种智能体 AI 架构,涵盖反思、检索增强、记忆与多智能体等模式。
一个可定制的大模型评测框架,覆盖 LLM、VLM 和 AIGC 模型的基准评测与推理性能压测。
按类别整理的 120 多个 LLM 开源库清单,涵盖训练、推理、RAG、智能体、评估与监控等环节。