用途:在 Next.js 应用中添加智能体 Settings 标签页,即核心的编辑表单,包含名称、描述、头像、可见性(管理员/学生/任何人)、分类,以及 Copy-to-tenant 和 Delete 操作。它是 agent-settings 系列中的一个标签页,同系列还有 access、api、datasets、disclaimers、embed、history、llm、memory、prompts、safety、tools 等,每个标签页是独立技能,共用同一个 AgentSettingsProvider 包装器。
主要能力:AgentSettingsTab 组件接收 tenants、isLoadingTenants、onSuccessfulSave、onSuccessfulDelete、onSuccessfulCopy、labels 等 props;AgentSettingsProvider 接收 tenantKey、mentorId、username、enableRBAC、executeGatedAction。可通过 labels 覆盖默认文案,支持完整或部分覆盖。
使用方式:先完成认证(/iblai-auth)并配置 MCP 服务器与技能;向用户索取真实 mentorId,不可编造。检查项目根目录的 iblai.env(含 PLATFORM、DOMAIN、TOKEN),缺失时用 curl -o iblai.env 下载模板。在布局层用 AgentSettingsProvider 包裹路由,再挂载 AgentSettingsTab。使用 pnpm(未安装则用 npm)。完成后运行 /iblai-ops-test,再启动 pnpm dev 在 http://localhost:3000 查看。
限制与注意:不要给 ibl.ai SDK 组件添加自定义样式、颜色或 CSS 覆盖;除非用户明确要求,否则不实现深色模式。Redux store 需包含 mentorReducer 和 mentorMiddleware;需安装 sonner 和 @iblai/iblai-web-mentor 等 peer 依赖。tenants 为空数组时不可跨租户复制。品牌规范见 BRAND.md。