用途:通过 DashScope REST API 管理阿里云百炼(Model Studio)记忆库中的对话记忆与用户画像。记忆库会自动从对话中抽取关键信息并存储为记忆片段,使智能体可跨会话引用用户偏好与历史上下文。架构为 Agent → Python 脚本 → DashScope REST API → 记忆库(记忆 + 用户画像)。
主要能力:覆盖 12 项记忆与用户画像操作及 7 项管理操作。记忆写入均为异步:请求立即受理,抽取在后台运行并返回 event_id。记忆项目(创建/列表/获取/更新)与画像 Schema(创建/列表/更新)由本技能直接管理;项目/Schema 的删除不在覆盖范围内,需使用百炼控制台。核心概念包括记忆库(memory_library_id)、记忆片段(memory_node_id)、记忆项目(project_id,二级隔离,含 plan_version)、记忆实体(user_id)、画像 Schema(profile_schema_id)与异步事件(event_id)。
使用方式:首次使用需安装依赖(python3 --version 需 >= 3.7,pip3 install -r scripts/requirements.txt),配置 API Key(支持阿里云 CLI 配置、环境变量 DASHSCOPE_API_KEY,或手动 export DASHSCOPE_API_KEY=sk-xxx),并在百炼控制台激活记忆库服务。脚本位于 scripts/ 目录,输出原始 API JSON。常用命令如 python3 scripts/add_memory_messages.py --user-id "<user_id>" --messages '<json>'、python3 scripts/search_memory.py --user-id "<user_id>" --query "<text>"、python3 scripts/list_memories.py --user-id "<user_id>" --page-num 1 --page-size 10。每次 API 调用须带 User-Agent 头,脚本通过环境变量 SKILL_SESSION_ID 自动加入。
适用场景:让智能体记住对话事实、按用户偏好与历史回答问题、审计某用户已存记忆、修正或删除过期记忆、查询结构化用户画像、设置记忆隔离项目与定义抽取哪些用户属性。
限制:API Key 格式须为 sk-xxx,不支持 sk-sp-xxx(Coding Plan Key);Key 必须与端点环境一致,否则返回 401 InvalidApiKey。删除不可逆且删除 API 不校验 user_id 归属,须严格按“获取并引用内容→停止并请求明确确认→确认后删除→列表验证”四步执行。project_id 与 memory_library_id 不可混用。add_memory_messages 的 --project-id 与 --project-ids 互斥;add_memory_content 仅绑定单一项目且不支持画像抽取。update_user_profile 每次仅操作一个值项。禁止硬编码、提取或输出任何密钥,任务完成前须运行 grep -rn "sk-" <output_directory>/ 自检。异步写入默认不轮询,仅在用户要求确认或后续步骤依赖抽取完成时查询。搜索参数(plan_version、min_score)由服务端控制,不可调整。其余未在资料中说明的细节暂未提供。