SuperAPI AI 工具集

iblai-access-tab

前端与建站

查看项目

更新于 10-15 22:16

技能介绍

用途:为 Next.js 应用添加智能体设置中的 Access(访问)标签页,对智能体进行基于角色的访问管理。管理员可分配 editor 和 chat 角色,按角色添加或移除用户与用户组,并以表格查看现有访问策略。该标签页属于 agent-settings 系列(access、api、datasets、disclaimers、embed、history、llm、memory、prompts、safety、settings、tools)之一,各标签页共用同一 AgentSettingsProvider 包装器。

主要能力:从 @iblai/iblai-js/web-containers/next 导入 AgentAccessTab 组件挂载到路由;通过 labels 属性(DeepPartial<AccessTabLabels>)覆盖标题、表格列、空状态、对话框等文案;通过 onPermissionsLoaded 回调在挂载获取 /users/ 与 /groups/ 的 RBAC 权限时触发。相关导出包括 AGENT_ACCESS_TAB_LABELS 与 AccessTabLabels 类型。

必要用法:需先完成 /iblai-auth 认证设置,并执行 iblai add mcp 配置 MCP 与技能;路由须由 AgentSettingsProvider 在布局层包裹(提供 tenantKey、mentorId、username、enableRBAC),需向用户索取真实的 mentorId,不可自行编造。挂载示例见资料中 app/(app)/agents/[mentorId]/access/page.tsx 片段。环境变量需项目根目录存在 iblai.env(含 PLATFORM、DOMAIN、TOKEN),缺失时按资料提示下载模板;注意 iblai.env 不是 .env.local 的替代,Next.js 运行时环境变量仍读 .env.local。运行 iblai 命令前先检查 CLI 版本,可 pip install --upgrade iblai-app-cli 或 npm install -g @iblai/cli@latest。使用 pnpm(未安装则退回 npm)。

限制与注意:不得为 ibl.ai SDK 组件添加自定义样式、颜色或 CSS 覆盖,不要实现暗色模式(除非用户明确要求)。构建自定义 UI 时按 ibl.ai 品牌规范与 BRAND.md,优先使用 ibl.ai SDK 组件,其次 shadcn/ui(npx shadcn@latest add <component>)。Redux store 须包含 mentorReducer 与 mentorMiddleware;initializeDataLayer() 在 v1.2+ 为 5 个参数;@reduxjs/toolkit 通过 next.config.ts 的 webpack aliases 去重;对等依赖 sonner 与 @iblai/iblai-web-mentor 需安装。RBAC 由 enableRBAC 与 rbacPermissions 控制增改操作,默认 false 时允许所有操作;默认角色 editor 和 chat 来自包内 DEFAULT_MENTOR_ROLES,不能通过 props 配置。完成前须运行 /iblai-test(pnpm build 零错误、pnpm test 通过),再执行 pnpm dev 启动开发服务器供用户查看。