SuperAPI AI 工具集

iblai-api-agent-history

编程与开发

查看项目

更新于 10-15 22:16

技能介绍

用途:读取 ibl.ai 智能体的对话历史与摘要。可列出用户与该智能体的会话,并按情绪、话题、用户和日期筛选;读取总体摘要与逐会话记忆;将完整聊天记录导出为报表。

认证与约定:基础地址 https://api.iblai.app。每个请求都需带请求头 Authorization: Api-Token $IBLAI_API_KEY。路径变量中 {org}=$IBLAI_ORG,{username}=$IBLAI_USERNAME,{mentor}=智能体唯一 id。会话读取走 AI-analytics 主机,路径含 …/dm/api/ai-analytics/…;导出走报表端点 …/dm/api/reports/…,且为异步。尚未连接时先运行 /iblai-api-login 填充环境变量。

主要读取端点: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 …/dm/api/ai-analytics/orgs/{org}/users/{username}/chat-history-filter/ 获取可用筛选项(情绪、话题、用户);GET …/dm/api/ai-mentor/orgs/{org}/users/{username}/mentors/{mentor}/summaries/general/ 获取总体摘要、平均评分与话题;GET …/dm/api/ai-mentor/orgs/{org}/users/{username}/memory/{conversationId}/ 获取逐会话记忆。

导出:POST …/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} 轮询直至下载链接就绪。

限制与说明:会话列表分页,保持 page_size=10,不用的筛选参数应省略;过滤前先用 chat-history-filter/ 确认有效取值;导出不直接返回文件,需先 POST 再 GET 轮询。资料未提供其他收费、平台或效果信息。