SuperAPI AI 工具集

iblai-agent-memory

智能体与模型

查看项目

更新于 10-15 22:16

技能介绍

用途:在 Next.js 应用中接入 ibl.ai 的智能体记忆标签页,提供启用/禁用记忆的开关,以及可新增、编辑、批量删除、单条删除的记忆管理区。它是 agent-settings 系列中的一个标签页,所有标签页共用同一个 AgentSettingsProvider 包裹层。

主要能力:通过 @iblai/iblai-js/web-containers/next 导出 AgentMemoryTab 组件,可挂载到路由页面;支持用 labels 属性覆盖界面文案;相关导出包括 AGENT_MEMORY_TAB_LABELS 与 MemoryTabLabels 类型。记忆分三个控制层级:平台(管理员为租户开启)、导师(管理员/所有者按导师开启)、用户(用户自行选择是否采集与使用)。

使用方式:前置条件为已配置认证(/iblai-auth)、已配置 MCP 服务器与技能(.mcp.json 中的 @iblai/mcp)、路由已被 AgentSettingsProvider 包裹,并向用户索取真实的 mentorId(UUID),不得自行编造。项目根目录需有 iblai.env,包含 PLATFORM、DOMAIN、TOKEN;缺失时提示下载模板:curl -o iblai.env https://raw.githubusercontent.com/iblai/vibe/refs/heads/main/iblai.env。页面示例:在 app/(app)/agents/[mentorId]/memory/page.tsx 中导入并渲染 AgentMemoryTab。默认包管理器为 pnpm,未安装时回退 npm。完成后需运行 /iblai-ops-test,再启动 pnpm dev 供用户在 http://localhost:3000 查看。

限制与注意:不要给 ibl.ai SDK 组件添加自定义样式、颜色或 CSS 覆盖;除非用户明确要求,不要实现深色模式;存在 ibl.ai 或 shadcn 等价组件时不要自写组件。iblai.env 不是 .env.local 的替代,仅存放 DOMAIN、PLATFORM、TOKEN 三个简写变量。Redux store 需包含 mentorReducer 与 mentorMiddleware;initializeDataLayer() 为 5 个参数(v1.2+);需安装 peer 依赖 sonner 与 @iblai/iblai-web-mentor。记忆 REST API 以 ${dmUrl}/api/ai-mentor/orgs/{org}/ 为前缀,涵盖用户记忆设置、平台配置、导师开关、全局记忆、导师专属记忆与记忆分类等端点;常见错误包括 400 校验(内容少于 10 字符)、403 查看他人记忆、404 未找到、409 重复。可见性规则:仅当平台 memsearch-status 已启用且导师的 enable_memory_component 为 true 时显示记忆 UI,但用户级开关始终显示。