用途：通过 ibl.ai 平台 API 读取各类分析数据。所有分析端点位于 Data Manager 服务，经网关 /dm 前缀访问，基准地址 dm_url=https://api.iblai.app/dm，每个请求需带 Authorization: Api-Token $IBLAI_API_KEY。
主要能力：智能体（聊天）分析，加 mentor_unique_id 可将话题、会话、对话、评分、成本、记录限定到单个智能体；内容分析 /api/analytics/content/，metric=courses|programs|pathways|skills；省略 mentor_unique_id 即组织级汇总；单用户分析含选课、成绩、时长、参与度与跨平台快照；成本与 LLM 用量（成本/令牌/延迟，resource=metrics|observations|traces）；审计日志；异步数据报告。
使用方式：共享查询参数包括 platform_key（多数读取必填）、date_filter（today|7d|30d|90d|all_time|custom，custom 需 start_date 与 end_date，格式 yyyy-MM-dd）、mentor_unique_id、granularity、usergroup_ids、page/limit。示例：curl -s "$dm_url/api/analytics/topics/?platform_key=$IBLAI_ORG&date_filter=30d&metric=overview" -H "Authorization: Api-Token $IBLAI_API_KEY"。数据报告为异步：先 POST /api/reports/platforms/{platform}/new，再轮询并下载。
限制：读取为只读，写入仅数据报告与时长事件；schema 是唯一契约，调用前应核对 https://api.iblai.app/dm/api/docs/schema/；成本为尽力而为，空值表示成本库不可达而非零支出；时长单位为秒；单用户读取受 RBAC 限制，读他人需授权，learners/list/ 需平台管理员；llm-usage 的 observations 不接受 session_id 与 mentor_unique_id；limit 上限 1000。未连接时先运行 /iblai-api-login。