用途:通过 ibl.ai 平台 API 管理组织的基于角色的访问控制(RBAC),包括定义角色与策略、绑定用户组和用户、检查权限、发现可分配资源与动作、共享智能体与团队,以及切换学生权限。接口位于 …/dm/api/core/rbac/…,批量用户策略位于 …/dm/api/core/platform/…。
认证与约定:基础 URL 为 https://api.iblai.app,每个请求需带 Authorization: Api-Token $IBLAI_API_KEY。路径变量 {org}=$IBLAI_ORG(即 platform_key)、{username}=$IBLAI_USERNAME、{mentor_id} 为智能体数字 id。未连接时先运行 /iblai-api-login 填充环境变量。mentor-* 路由为规范路径,agent-* 为等价别名,但动作、数据动作与资源字符串必须写 Mentor/mentors 字面形式。
概念:权限检查回答“某身份能否对某资源执行某动作”,分动作级(list/read/write/delete/action)与数据级(字段读写掩码)。资源路径层级化,策略授予父资源即覆盖子资源;请求体使用平台相对短路径,服务端自动补 /platforms/{pk}/ 前缀。动作格式为 Ibl.{Namespace}/{Resource}/{operation},支持通配符;数据动作控制字段级访问。角色含允许与拒绝列表,策略将角色绑定到资源与用户/组,权限为叠加式。
主要能力:角色、策略、用户组的完整 CRUD;资源与动作发现接口;权限检查(只读);智能体访问授权/撤销;团队共享;学生智能体创建与 LLM 访问开关;批量用户策略。
使用方式:读取以查询参数传 platform_key,写入在请求体传 platform_key。删除、共享、组织级策略变更等破坏性操作需先与用户确认。
限制:角色、策略、用户组 CRUD 需管理员令牌;user-group-access 端点尚未完整文档化;具体字段与响应结构以官方文档为准。