用途:为 Next.js 应用加入智能体 Settings 标签页,即核心的智能体编辑表单,包含名称、描述、头像、可见性(管理员/学生/任何人)、分类,以及 Copy-to-organization 和 Delete 操作。它是更大 agent-settings 家族中的一个标签(家族还包括 access、api、datasets、disclaimers、embed、history、llm、memory、prompts、safety、settings、tasks、tools),每个标签是独立技能,全部共用同一个 AgentSettingsProvider 包装器,只需设置一次即可按需挂载多个标签。
前提条件:需先完成鉴权(/iblai-vibe-auth);需在 .mcp.json 配置 MCP 服务器与技能(@iblai/mcp);需向用户索要真实的 mentorId(智能体 UUID),不可自行编造。项目根目录需有 iblai.env,包含 PLATFORM、DOMAIN、TOKEN 变量,缺失时可下载模板:curl -o iblai.env https://raw.githubusercontent.com/iblai/vibe/refs/heads/main/iblai.env
使用方式:在路由布局中一次性包上 AgentSettingsProvider(传入 tenantKey、mentorId、username、enableRBAC),再在 settings 页面挂载 AgentSettingsTab,传入 tenants、isLoadingTenants 及 onSuccessfulSave、onSuccessfulDelete、onSuccessfulCopy 等回调。可通过 labels 属性覆盖默认文案,支持传入完整 SettingsTabLabels 包或仅覆盖部分键,相关默认包为 AGENT_SETTINGS_TAB_LABELS,合并工具为 resolveSettingsTabLabels。也可用 MCP 工具 get_component_info 查看 AgentSettingsTab、AgentSettingsProvider、CopyMentorModal、DeleteMentorModal 的信息。
主要能力:编辑智能体身份与可见性,复制到指定组织,删除智能体;tenants 属性为空数组时可禁止跨组织复制。
限制与注意:Redux store 必须包含 mentorReducer 与 mentorMiddleware;initializeDataLayer() 在 v1.2+ 为 5 个参数;@reduxjs/toolkit 通过 next.config.ts 中的 webpack 别名去重;peer 依赖需安装 sonner 和 @iblai/iblai-web-mentor(pnpm add sonner @iblai/iblai-web-mentor);Provider 应挂在布局层而非各标签页单独包裹。验证需先运行 /iblai-vibe-ops-test,pnpm build 零错误、pnpm test 通过,并启动 dev 做触测。安装命令:npx skills add iblai/vibe --all。其他平台、收费或效果信息暂未提供。