用途：通过 ibl.ai 平台 API 以无界面方式读取分析数据，与 /iblai-vibe-analytics 仪表盘同源同端点。所有分析端点位于 Data Manager 服务，经网关 /dm 前缀访问，基础地址为 https://api.iblai.app/dm。
主要能力：智能体（聊天）分析，加 mentor_unique_id 可将话题、会话、对话、评分、成本、记录限定到单个智能体；内容分析按 metric=courses|programs|pathways|skills 获取目录参与度与停留时间；省略 mentor_unique_id 即组织级汇总；单用户分析含选课、成绩、停留时间、参与度与跨平台快照；另有成本、LLM 用量（成本/令牌/延迟）、审计日志与异步数据报告。
使用方式：每个请求带 Authorization: Api-Token $IBLAI_API_KEY 头。常用查询参数包括 platform_key、date_filter（today|7d|30d|90d|all_time|custom）、mentor_unique_id、granularity、usergroup_ids、page/limit。端点形如 {dm_url}/api/analytics/topics/、/content/、/financial/、/llm-usage/、/user、/learner/details 等。数据报告为异步：先 POST /api/reports/platforms/{platform}/new，再轮询并下载。
限制：读取为只读，写入仅限数据报告与停留时间事件。端点 schema 以 https://api.iblai.app/dm/api/docs/schema/ 为准，可能随版本漂移，构建请求前应校验。llm-usage 的 measures、aggregation、group_by、order_by 均为白名单值，非法值返回 400；observations 不接受 session_id 与 mentor_unique_id；limit 上限 1000。访问受 RBAC 限制，非管理员终端用户仅能读取自身数据，越权返回 403，跨组织记录返回 404。未连接时需先运行 /iblai-api-login。