用途:把 ibl.ai 分析仪表盘接入 Next.js 应用,按组织范围展示,可缩小到单个智能体与用户组。首次使用若 iblai.env 无 ARCHITECTURE=,需先运行 /iblai-vibe-start。
主要能力:一个 AnalyticsLayout 渲染标签条(Overview、Users、Courses、Programs、Topics、Transcripts、Memory、Cost、Audit,右侧 Data Reports),并带统一控制栏:智能体选择器、用户组筛选、Today/7D/30D/90D/Custom 日期范围,所有图表跟随。每个标签是 basePath 下的 Next.js 路由。Overview 模板为 assets/analytics-page.tsx.j2。
使用方式:前置条件包括完成认证(/iblai-vibe-auth)、配置 MCP 服务器与技能(@iblai/mcp 于 .mcp.json)、@iblai/iblai-js ≥ 2.12 且解析 @iblai/web-containers ≥ 1.21、iblai.env 含 PLATFORM、DOMAIN、TOKEN。缺失时可执行 curl -o iblai.env https://raw.githubusercontent.com/iblai/vibe/refs/heads/main/iblai.env。推荐安装 API 参考:npx skills add iblai/vibe --all。布局文件 app/(app)/analytics/layout.tsx 负责共享状态;各标签为小型客户端页面,按需传入 usergroupIds、userId 等。
限制与注意:不要给 ibl.ai SDK 组件加自定义样式,未要求不要实现暗色模式。组件优先级为 ibl.ai SDK(@iblai/iblai-js)优先,其次 shadcn/ui(npx shadcn@latest add)。智能体作用域规则为 selectedMentorId || mentorId || picker,组织级页面传 mentorId=""。平台审计仅组织管理员或持有 /auditlogs/#list 者可见;Usage & latency/Traces 需组织管理员分析权限;Memory 无权限返回 403。成本为平台加价后的美元,空成本块表示成本存储不可达而非零支出。按智能体成本排名仅向前生效。日期默认值服务端不同:llm-usage 默认今天,其他端点默认 30 天。若在 vibe-starter,仪表盘已在 /admin/analytics,需删除 pnpm-workspace.yaml 中对 @iblai/web-containers 的 1.16.0 固定并运行 pnpm install,补充 memory 与 audit 路由,并传 excludeTabs={["courses", "programs"]}。