用途:通过 ibl.ai 平台 API 读取某智能体的对话历史与摘要,适合审查或导出用户与智能体的聊天记录。
主要能力:列出对话(分页,支持 sentiment、topics、filter_user_id、start_date、end_date 筛选);获取可用筛选项(情感、主题、用户);读取总体摘要、平均评分与主题;读取单次对话记忆;异步导出完整聊天历史报告。
使用方式:基础地址 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/…),先 POST 创建报告,再 GET 轮询直到下载 URL 就绪。未连接时先运行 /iblai-login 填充 IBLAI_ORG、IBLAI_USERNAME、IBLAI_API_KEY。
示例:curl -s "https://api.iblai.app/dm/api/ai-analytics/orgs/$IBLAI_ORG/users/$IBLAI_USERNAME/chat-history/?mentor=$MENTOR&page=1&page_size=10&sentiment=positive" -H "Authorization: Api-Token $IBLAI_API_KEY"
限制:对话列表分页,需传 page 并保持 page_size=10,未使用的筛选参数应省略;筛选前先用 chat-history-filter/ 端点获取有效的情感、主题、用户值;导出不直接返回文件,POST 返回报告句柄,GET 轮询在生成完成后返回下载 URL。