基于 Azure 的 RAG 解决方案加速器,让聊天助手基于你自己的文档作答,并附带原文引用。
Azure-Samples/ai-rag-chat-evaluator
使用 Azure AI Evaluate SDK 与 OpenAI 评估模型,对 RAG 问答应用的回答质量进行测试的工具集。
- Star
- 336
- Fork
- 116
- 未关闭 Issue
- 25
- 最近提交
- 4天前
这是什么?
这是一个命令行评估工具,用于衡量基于检索增强生成(RAG)构建的问答应用的回答质量。系统提示词、搜索参数和 GPT 模型设置都会影响回答效果,因此每次修改都可以用一组标准问答对进行验证。
工具会把问题发送到正在运行的聊天接口,并使用基于 GPT 的指标(如 groundedness、relevance、coherence、similarity)对回答打分,同时支持延迟、回答长度、引用是否存在等本地计算指标。项目还提供生成工具,可以生成文档中无法回答的问题,用于测试应用能否正确回答“不知道”。
每次运行的结果都会按问题明细和汇总统计保存。终端中的 summary 与 diff 命令可以查看和对比多次运行的结果及参数。项目支持 Azure OpenAI(默认使用无密钥访问)和 openai.com 账户,并可通过 azd CLI 部署所需资源。
核心功能
- 01使用 groundedness、relevance、coherence 等基于 GPT 的指标为 RAG 回答打分。
- 02计算延迟、回答长度、引用格式等本地代码指标。
- 03生成标准问答集,包括文档无法回答的问题。
- 04在终端中逐题对比多次运行的回答,并可按变化的指标筛选。
- 05支持 Azure OpenAI(无密钥认证)和 openai.com 账户。
适用场景
- 在上线前验证提示词或搜索参数的修改是否真正提升回答质量。
- 衡量 RAG 应用在资料中没有答案时是否会主动说“不知道”。
- 开发过程中用少量问题快速运行子集评估。
- 逐题对比两次实验结果,定位回答质量的退化。
快速上手
- 1
安装 Python 3.10 或更高版本
- 2
创建并激活 Python 虚拟环境
- 3
在虚拟环境中安装本项目
python -m pip install -e . - 4
使用示例配置运行评估
python -m evaltools evaluate --config=example_config.json
使用前须知
- 评估依赖 GPT-4 级别的模型,因此需要 Azure OpenAI 或 openai.com 实例。
- 使用基于 GPT 的评估器会为每个问题和每个评估器产生令牌费用。
- 内置指标使用英文提示词,仅适用于英文答案。
收录于专题
标签
常见问题
- ai-rag-chat-evaluator 是什么?
- 使用 Azure AI Evaluate SDK 与 OpenAI 评估模型,对 RAG 问答应用的回答质量进行测试的工具集。 这是一个命令行评估工具,用于衡量基于检索增强生成(RAG)构建的问答应用的回答质量。系统提示词、搜索参数和 GPT 模型设置都会影响回答效果,因此每次修改都可以用一组标准问答对进行验证。
- ai-rag-chat-evaluator 可以免费使用吗?用的什么许可证?
- ai-rag-chat-evaluator 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
- ai-rag-chat-evaluator 还在维护吗?
- 活跃维护中。ai-rag-chat-evaluator 最近一次提交是在 2026年11月3日。
- ai-rag-chat-evaluator 适合用来做什么?
- 在上线前验证提示词或搜索参数的修改是否真正提升回答质量。 衡量 RAG 应用在资料中没有答案时是否会主动说“不知道”。 开发过程中用少量问题快速运行子集评估。 逐题对比两次实验结果,定位回答质量的退化。
- ai-rag-chat-evaluator 怎么安装和运行?
- 安装 Python 3.10 或更高版本 创建并激活 Python 虚拟环境 在虚拟环境中安装本项目: python -m pip install -e . 使用示例配置运行评估: python -m evaltools evaluate --config=example_config.json
- 在哪里获取 ai-rag-chat-evaluator?
- 源代码和安装说明在 GitHub 上:https://github.com/Azure-Samples/ai-rag-chat-evaluator
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
开源 Python LLM 评测框架,可像 Pytest 一样对 LLM 应用做单元测试,内置 RAG、Agent、多轮对话等指标。
一个 Python/TypeScript 库,用 LLM 评审、启发式和统计方法为 AI 模型输出打分。
用于测试 LLM 应用输出的 Python/TypeScript 评估库,提供现成评估器和 LLM-as-judge 打分。
一个基于 Python 的聊天应用,使用托管标识调用 Azure OpenAI,并通过 azd 部署到 Azure Container Apps。
基于 Azure 的解决方案加速器,利用生成式 AI 从对话与文档数据中挖掘洞察,提供对话式探索和自动生成的仪表板。