用途:通过 ibl.ai 平台 API 管理智能体记忆,包括浏览筛选智能体已记住的内容、整理跨智能体全局记忆、增删改单条记忆、管理记忆分类,以及控制捕获与召回设置。
认证与约定:基础地址为 https://api.iblai.app,每个请求需带请求头 Authorization: Api-Token $IBLAI_API_KEY。路径变量 {org}=$IBLAI_ORG、{username}=$IBLAI_USERNAME、{mentor} 为智能体唯一 id。未连接时先运行 /iblai-api-login 填充上述变量。端点位于 ai-mentor 基础路径下,并有把 mentor 换成 agent 的孪生路径,二者均可用。
主要能力:读取方面,可获取某智能体的记忆分页列表(按分类、my_memory、user_id、email、日期筛选)、按分类分组的记忆、跨所有智能体的用户记忆、智能体分类列表、共享的智能体知识分页列表、跨智能体全局记忆(支持 session_id、content 子串、日期筛选),以及 memsearch 设置和组织级启用状态。写入方面,可新增/编辑/删除智能体记忆、增删改分类、新增/替换/删除共享智能体知识、新增/删除全局记忆,以及更新捕获/召回设置。
使用方式示例: curl -s "https://api.iblai.app/dm/api/ai-mentor/orgs/$IBLAI_ORG/users/$IBLAI_USERNAME/mentors/$MENTOR/mentor-memories-list/?page=1&page_size=20&category=preferences&start_date=2026-01-01" -H "Authorization: Api-Token $IBLAI_API_KEY"
限制与注意:记忆内容写入时至少 10 个字符;agent 记忆的 category_slug 必须匹配已有分类。共享智能体知识去重基于内容哈希,重复返回 409;无批量删除端点,需逐条 DELETE;删除操作具破坏性,应先向用户确认。分类按组织+智能体作用域,记忆按用户作用域。列表读取返回 DRF 分页包裹 { "count": n, "results": [...] }。