用途:管理决定谁可以编辑、对话或查看某智能体分析数据的基于角色的访问控制。搜索用于解析用户和群组,所有授权与撤销都通过同一个 mentor-access/ 写入端点完成。
认证与约定:基础 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 …/users/{username}/mentors/{mentor}/settings/ 解析数字 mentor_id;GET https://api.iblai.app/dm/api/core/rbac/mentor-access/?mentor_id={id}&platform_key={org} 列出当前角色策略;POST https://api.iblai.app/dm/api/core/rbac/permissions/check/ 检查用户能否搜索用户/群组;用户自动补全与群组自动补全分别使用 platform/users/ 和 rbac/groups/ 端点。
写入操作:POST https://api.iblai.app/dm/api/core/rbac/mentor-access/ 授予或撤销访问,请求体包含 platform_key、mentor_id、role(editor | chat | analytics_viewer)以及 users_to_add、users_to_remove、groups_to_add、groups_to_remove、emails_to_add、usernames_to_add 等数组。
限制与注意:写入端点使用数字 mentor_id 而非 {mentor} UUID,需先从 settings/ 读取解析;每次 POST 只处理一个角色;搜索前先用 permissions/check/,若缺少 /users/ 或 /groups/ 权限则跳过对应自动补全;emails_to_add 和 usernames_to_add 可按标识邀请而无需预先查 id,用户和群组则按搜索读取得到的数字 id 增删。