企业官网建设流程全解析

如何使用 Quivr Analytics 分析各 Brain 的使用活跃度？

【免费下载链接】quivrOpiniated RAG for integrating GenAI in your apps 🧠 Focus on your product rather than the RAG. Easy integration in existing products with customisation! Any LLM: GPT4, Groq, Llama. Any Vectorstore: PGVector, Faiss. Any Files. Anyway you want.项目地址: https://gitcode.com/GitHub_Trending/qui/quivr

Quivr 提供 Analytics 功能，用于查看你名下各 Brain 的使用活跃度，判断哪些 Brain 最常用、哪些基本没人问。本文说明如何通过 Brain Studio 界面查看活跃度图表，并给出对应的 API 请求方式用于核对数据。前提是你已登录一个 Quivr 实例，且相关 Brain 已有聊天记录；Analytics 的统计范围只覆盖当前登录用户自己的 Brain，图表统计口径是这些 Brain 在所选时间范围内的每日提问次数。

Analytics 统计的是什么

先明确口径，再看图表才有意义。后端在 analytics repository 中按如下逻辑统计：

• 数据源是chat_history表：按当前用户名下的 Brain 取出聊天记录，每条记录按message_time所在日期计 1 次使用；
• 指定brain_id时只统计该 Brain 的聊天记录，不指定时统计该用户全部 Brain 的合计；
• 统计窗口由graph_range决定，从当前日期往前推；窗口内没有记录的日期会补 0，保证图表每天都有一个点；
• 返回结构是按日期排序的usages列表，每项包含date和usage_count（见 analytics entity）。

因此图表中的“使用活跃度”就是每日提问条数，而不是独立用户数或 token 量。

在 Brain Studio 中查看活跃度图表

官方文档 docs/features/analytics.mdx 给出的操作路径是：进入 Brain Studio，点击 Analytics，然后按 Brain 过滤或查看全部 Brain 的统计。具体操作：

1. 登录 Quivr，进入Brain Studio页面。
2. 点击Analytics标签。
3. 图表加载出来后，顶部有两个选择器（见前端组件 Analytics.tsx）：
   • 时间范围：Last 7 days、Last 30 days、Last 90 days，对应参数值7、30、90，默认加载的是最近 7 天；
   • Brain 过滤：占位文案为Select specific brain，从中选择一个 Brain 后图表只展示它的每日提问量；点返回（清空选择）则回到全部 Brain 的合计视图。
4. 图表是一条折线：横轴是日期，纵轴是当天提问次数，纵轴从 0 开始、刻度步长为 1。选中单个 Brain 时图例显示为Daily questions to <Brain 名称>，未选择时显示为Daily questions to your brains。

对比各 Brain 的活跃度

界面上没有并排多条折线的对比视图，对比单个 Brain 的做法是逐个切换过滤器：

• 在Select specific brain下拉中依次选择每个 Brain，观察其折线的高低与分布；
• 每次切换后组件会重新请求数据（依赖selectedBrainId和currentChartRange），无需刷新页面；
• 判断依据：同一时间范围下，某 Brain 曲线整体更高、非零天数更多，说明它被使用得更频繁。

用 API 核对数据

界面读数有疑问时，可以直接调用界面背后的接口核对。前端请求代码见 analytics.ts，路由定义见 analytics_routes.py：

• 端点：GET /analytics/brains-usages
• 查询参数：
  • brain_id：可选，某个 Brain 的 UUID；省略则统计全部 Brain；
  • graph_range：可选，取值7/30/90，路由默认值为7（即Range.WEEK）。
• 需要携带登录后的认证凭据（该路由挂有AuthBearer依赖），下方示例中的Authorization请求头请替换为你自己的有效 token。

curl -X GET "http://<your-quivr-host>/analytics/brains-usages?graph_range=30" \ -H "Authorization: Bearer <your-token>"

响应结构为{"usages": [{"date": "...", "usage_count": ...}, ...]}，下面是按 BrainsUsages 模型 标注的示例结果（数值仅为示例，不代表真实预期）：

{ "usages": [ {"date": "2026-08-11", "usage_count": 0}, {"date": "2026-08-12", "usage_count": 3}, {"date": "2026-08-13", "usage_count": 1} ] }

核对方式：取窗口内usage_count的分布与总和，与图表中折线的逐日高度和整体水平对照；指定brain_id时再与选中该 Brain 的图表对照，两者应当一致。

限制与边界

• 小屏幕不可用：前端组件在小屏下不渲染图表，只显示提示This feature is not available on small screens。此时可改用上面的 API 方式获取数据。
• 时间范围只有三档：graph_range仅支持7、30、90，统计窗口相对当前日期计算。
• 范围仅限本人：统计只包含当前登录用户名下的 Brain；brain_id不在其名下时不会纳入统计。
• 口径是聊天条数：一次问答对应chat_history中的一条记录并计 1，图表反映的是提问频率，不区分问题长短或 token 消耗。

完成以上步骤后，你就能够通过界面快速比较各 Brain 的相对活跃度，并在需要精确数值时用GET /analytics/brains-usages的返回结果做最终确认。

【免费下载链接】quivrOpiniated RAG for integrating GenAI in your apps 🧠 Focus on your product rather than the RAG. Easy integration in existing products with customisation! Any LLM: GPT4, Groq, Llama. Any Vectorstore: PGVector, Faiss. Any Files. Anyway you want.项目地址: https://gitcode.com/GitHub_Trending/qui/quivr