用途:在 Next.js 应用中添加分析仪表盘页面,使用 ibl.ai SDK 的 AnalyticsLayout 标签页布局,包含 Overview、Courses、Programs、Users、Topics、Financial、Transcripts、Reports 等标签,每个标签对应 /analytics/ 下的一个路由。
主要能力:页面模板以 assets/analytics-page.tsx.j2 形式提供,需渲染到 app/(app)/analytics/page.tsx;布局用 AnalyticsLayout 与 AnalyticsSettingsProvider 包裹,子页面组件从 @iblai/iblai-js/web-containers 导入,均需 tenantKey(必填)和 mentorId=""(空字符串表示组织范围)。各路由对应组件:/analytics 用 AnalyticsOverview,/analytics/courses 用 AnalyticsCourses,/analytics/programs 用 AnalyticsPrograms,/analytics/users 用 AnalyticsUsersStats,/analytics/topics 用 AnalyticsTopicsStats,/analytics/financial 用 AnalyticsFinancialStats(不接受 basePath),/analytics/transcripts 用 AnalyticsTranscriptsStats,/analytics/reports 用 AnalyticsReports。
使用方式:前置条件包括完成认证设置、配置 MCP 服务器与技能(.mcp.json 中的 @iblai/mcp)、iblai.env 中填好 PLATFORM、DOMAIN、TOKEN。验证命令为 pnpm build && pnpm test,随后 pnpm dev 并用 npx playwright screenshot http://localhost:3000/analytics /tmp/analytics.png 截图。REST API 基址为 ${dmUrl}/api/ai-analytics/ 和 ${dmUrl}/api/analytics/,认证头为 Authorization: Token <token>。
适用场景:需要为 ibl.ai 平台构建分析看板的前端项目,覆盖受众、参与度、表现、AI 导师对话、成本、主题、情感以及 LMS 内容、财务、评分等分析。
限制:不要给 ibl.ai SDK 组件添加自定义样式,未要求时不要实现暗色模式;组件优先级为 ibl.ai SDK 优先,其次 shadcn/ui。Redux store 必须包含 mentorReducer 和 mentorMiddleware;initializeDataLayer() 需 5 个参数。RBAC 要求 Ibl.Analytics/Core/read 或 Ibl.* 权限,逐学习者与聊天历史端点还需平台管理员权限。部分细节(如具体收费、价格、平台支持范围)暂未提供。