用途：通过 ibl.ai 平台 API 管理组织的基于角色的访问控制（RBAC），覆盖角色、策略、用户组、权限检查、资源与操作发现、智能体与团队共享，以及学生权限开关。
主要能力：角色支持 actions/data_actions（允许）与 not_actions/not_data_actions（拒绝）；策略把角色绑定到资源及用户/组；组用于聚合用户；权限检查为只读；可发现资源树与操作目录；可授予或撤销智能体访问、共享团队、批量设置用户策略、切换学生创建智能体与可用 LLM。
使用方式：基础地址 https://api.iblai.app，每个请求带 Authorization: Api-Token $IBLAI_API_KEY。路径变量 {org}=$IBLAI_ORG、{username}=$IBLAI_USERNAME、{mentor_id} 为智能体数字 id。未连接时先运行 /iblai-api-login 填充环境变量。读取以查询参数传 platform_key，写入在请求体传 platform_key。资源路径为层级结构，策略授予父资源即覆盖子资源；请求体使用平台相对短路径（如 /mentors/、/usergroups/5/），服务端自动补 /platforms/{pk}/ 前缀。操作命名形如 Ibl.{Namespace}/{Resource}/{operation}，支持通配符；数据操作控制字段级读写。
适用场景：组织内角色与策略的增删改查、权限自查、智能体与团队共享、学生权限的集中配置。
限制：角色、策略、组为完整 CRUD，需管理员令牌；删除、共享、批量策略与全局开关均为破坏性或组织级变更，应先与用户确认。mentor/agent 仅为 URL 路由别名，actions、data_actions 与 resources 中必须写 Mentor/mentors 字面形式，Ibl.Agent 与 /agents/ 不被识别。user-group-access 端点尚未完整文档化。具体字段与响应细节以官方文档为准。