用途:通过 ibl.ai 平台 API 管理智能体的两类免责声明——Advisory 提示文本(智能体 settings 中的单个 disclaimer 字段)和用户协议(User Agreement,具有独立的创建、更新、启用生命周期)。适用于需要向用户展示或要求用户接受法律或提示性声明的场景。
认证与约定:基础 URL 为 https://api.iblai.app;每个请求都需携带请求头 Authorization: Api-Token $IBLAI_API_KEY。路径变量中 {org} 对应 $IBLAI_ORG,{username} 对应 $IBLAI_USERNAME,{mentor} 为智能体的唯一 id。若尚未连接,先运行 /iblai-api-login 以填充 IBLAI_ORG、IBLAI_USERNAME 和 IBLAI_API_KEY。
读取:GET …/mentors/{mentor}/settings/ 获取 Advisory 文本,位于 disclaimer 字段;GET …/disclaimers/?mentor_id={mentor}&scope=mentor 获取用户协议列表,results[0] 为当前启用的协议。
写入:PUT …/mentors/{mentor}/settings/ 保存 Advisory 文本,请求体仅含 disclaimer 字段;POST …/disclaimers/ 创建用户协议,字段包括 content(必填)、mentors(uuid 数组)、scope、active;PATCH …/disclaimers/{id}/ 更新 content 或切换 active 状态。
限制与说明:Advisory 是 settings 上的单个字段,PUT 时只需发送该键,其他设置保持不变;用户协议是用户须单独接受的独立对象,每个智能体应仅启用一个(active: true),其余用 PATCH active: false 停用;协议列表需通过 mentor_id 加 scope=mentor 过滤,当前生效协议为 results 中的第一项。官方未提供的收费、价格、平台或效果信息暂无资料。