用途:通过 ibl.ai 平台 API 管理某个智能体的训练数据集(RAG),适合为智能体补充知识。
主要能力:列出智能体的训练文档;添加训练资源,类型包括文件、URL、YouTube、Blackboard、网站爬取(webcrawler)和 GitHub 仓库;对文档执行训练/取消训练并设置 public 或 private 可见性;配置重训计划;删除数据集。
使用方式:基础地址为 https://api.iblai.app,所有请求需带请求头 Authorization: Api-Token $IBLAI_API_KEY。路径变量中 {org} 为 $IBLAI_ORG,{username} 为 $IBLAI_USERNAME,{mentor} 为智能体唯一 id(如 d17dc729-60fd-4363-81a0-f67d9318b03e),在训练与 PUT 调用中作为 pathway。相关端点位于 …/dm/api/ai-index/… 下。若尚未连接,先运行 /iblai-login 以填充 IBLAI_ORG、IBLAI_USERNAME 和 IBLAI_API_KEY。
读取:GET …/documents/pathways/{mentor}/?limit=5&offset={n}&search={q} 列出训练文档,当有文档处于 pending 时建议每 2 秒轮询一次;GET …/documents/{document_id}/settings/ 获取重训计划;GET https://api.github.com/repos/{owner}/{repo}/branches 列出 GitHub 分支(外部接口,无需认证)。
写入:POST …/documents/train/ 添加训练资源,使用 multipart/form-data,字段随类型不同(文件、url/youtube/blackboard、webcrawler、github);PUT …/documents/{document_id}/ 用于训练/取消训练及可见性;POST …/documents/{document_id}/settings/ 设置 retrain_interval_days;DELETE …/documents/{document_id}/ 删除数据集。
限制与注意:删除为破坏性操作,需先与用户确认;GitHub 资源的分支列表来自未认证的 api.github.com 接口;文档处理期间需轮询列表端点。其余如配额、计费、平台支持范围等资料暂未提供。