用途:在 Next.js 应用中为智能体添加 Memory 标签页,包含启用/禁用智能体记忆的开关,以及支持添加、编辑、批量删除和单条删除的记忆管理区。它是更广泛的 agent-settings 家族中的一个标签页,所有标签页共用同一个 AgentSettingsProvider 包裹层。
前提条件:需先完成认证设置(/iblai-vibe-auth);需在 .mcp.json 中配置 @iblai/mcp 的 MCP 服务器与技能;路由需由 AgentSettingsProvider 包裹;需向用户索取真实的 mentorId(智能体 UUID),不得虚构。
使用方式:在 app/(app)/agents/[mentorId]/memory/page.tsx 中从 @iblai/iblai-js/web-containers/next 引入并渲染 AgentMemoryTab,组件可选传入 labels 覆盖可见文案。根目录需存在含 PLATFORM、DOMAIN、TOKEN 的 iblai.env,缺失时可运行 curl -o iblai.env https://raw.githubusercontent.com/iblai/vibe/refs/heads/main/iblai.env 下载模板填写。验证需运行 /iblai-vibe-ops-test,确保 pnpm build 零错误、pnpm test(vitest)通过,并启动开发服务器进行点击测试。
主要能力与接口:前端相关 REST 接口前缀为 ${dmUrl}/api/ai-mentor/orgs/{org}/,涵盖用户记忆设置(memsearch-settings)、平台配置(memsearch-config 与 memsearch-status)、智能体开关(enable_memory_component)、全局记忆与按分类分组的智能体记忆增删改查,以及记忆分类管理(默认分类含 knowledge_gaps、learning_goals、preferences、progress_milestones、personal_context)。记忆条目带 owner 的 username、email、user_full_name,无需二次请求即可渲染。系统含平台、智能体、用户三级控制。
限制与注意事项:Redux store 需包含 mentorReducer 与 mentorMiddleware;initializeDataLayer() 在 v1.2+ 为 5 个参数;需安装 sonner 与 @iblai/iblai-web-mentor。当平台 memsearch-status 未启用或智能体 enable_memory_component 为 false 时应隐藏记忆 UI,但用户级开关需始终显示。常见错误含 400 校验(内容少于 10 字符)、403 越权、404、409 重复。缺失信息:具体收费、价格与效果暂未提供。