用途:通过 ibl.ai 平台 API 读取某个智能体的对话历史与摘要,适合审查或导出用户与智能体的聊天记录。
主要能力:列出用户与智能体的会话(支持情感、主题、用户、日期筛选,分页);获取可用筛选项;读取总体摘要、平均评分与主题;读取单会话记忆;异步导出完整聊天历史报告。
认证与约定:基础地址 https://api.iblai.app;每个请求带请求头 Authorization: Api-Token $IBLAI_API_KEY。路径变量 {org}=$IBLAI_ORG,{username}=$IBLAI_USERNAME,{mentor}=智能体唯一 id。会话读取走 AI-analytics 主机(…/dm/api/ai-analytics/…),导出走 reports 端点(…/dm/api/reports/…)。未连接时先运行 /iblai-api-login 以填充 IBLAI_ORG、IBLAI_USERNAME、IBLAI_API_KEY。
读取接口:GET …/dm/api/ai-mentor/orgs/{org}/users/{username}/mentors/{mentor}/public-settings/ 判断该智能体是否开放历史;GET …/dm/api/ai-analytics/orgs/{org}/users/{username}/chat-history/?mentor={mentor}&page={n}&page_size=10&sentiment={s}&topics={t}&filter_user_id={id}&start_date={d}&end_date={d} 获取会话列表;GET …/chat-history-filter/?mentor_id={mentor}&monthly_range=false&start_date=&end_date= 获取可用筛选项;GET …/ai-mentor/orgs/{org}/users/{username}/mentors/{mentor}/summaries/general/ 获取总体摘要;GET …/ai-mentor/orgs/{org}/users/{username}/memory/{conversationId}/ 获取单会话记忆。
导出:POST https://api.iblai.app/dm/api/reports/platforms/{org}/new 创建报告(字段含 report_name、mentor、usergroup_ids、start_date、end_date、sentiment、topics、source),再 GET …/dm/api/reports/platforms/{org}/{report_name}?mentor_unique_id={mentor} 轮询直到下载 URL 就绪。
限制:会话列表分页,需传 page 并保持 page_size=10,未使用的筛选参数应省略;筛选前先用 chat-history-filter/ 获取有效的情感、主题、用户值;导出不直接返回文件,需先 POST 再轮询 GET。其他细节暂未提供。