用途 该技能作为火山引擎记忆库 Mem0 的对话式运维代理,理解中英文自然语言需求,调用内置脚本 scripts/call_mem0.py 获取 Mem0 实时响应,并对结果或用户粘贴的错误信息进行解释与诊断。
主要能力 控制面仅支持读操作:查询记忆项目列表、项目详情(含提取策略、连接地址、API Key ID)和已有 API Key 详情(值脱敏)。数据面支持服务探活与权限校验、记忆添加、列举、搜索、读取、更新、删除、按范围清空记忆以及异步任务查询。
使用方式 需 Python 3.9+,无第三方依赖,可用 uv run 或 python3 运行脚本,例如: uv run ./scripts/call_mem0.py list-projects python3 ./scripts/call_mem0.py search-memories --user-id user-001 --query '用户喜欢喝什么?' --top-k 5
常用操作包括 list-projects、describe-project、describe-api-key、ping、list-memories、add-memories、search-memories、get-memory、update-memory、delete-memory、delete-memories、get-event。通用参数如 --region(默认 cn-beijing,支持 cn-shanghai)、--project-id、--api-key-id 可放在子命令前后;记忆范围参数 --user-id、--agent-id、--run-id 至少提供一个。
鉴权与环境变量 控制面使用火山引擎 AK/SK 签名,需配置 VOLCENGINE_ACCESS_KEY、VOLCENGINE_SECRET_KEY;地域、MEM0_PROJECT_ID、MEM0_API_KEY_ID 可通过环境变量或参数提供。数据面默认通过控制面只读接口发现项目公网地址,并读取已有 Ready 状态的 API Key 完成鉴权,自动读取的 Key 仅发送到项目 VisitAddrs 中的 HTTPS 地址。也可直接配置 MEM0_ENDPOINT 与 MEM0_API_KEY 连接数据面,需用户明确配对指定。--env-file 可读取字面量赋值的凭证文件,不执行 shell。API Key 值始终脱敏输出,不打印凭证明文。
输出与错误处理 操作信息输出到 stderr,脱敏 JSON 响应输出到 stdout;--output 可另存响应文件(权限 0600)。参数、鉴权、HTTP 或控制面业务错误返回非零退出码。异步添加返回 event_id 后需调用 get-event 检查状态,HTTP 200 不代表任务成功;写操作不自动重试,超时后先查询已有事件或记忆状态。限流时降低请求频率。
适用场景 查看或按名称搜索记忆项目、查看项目与 API Key 信息、检查数据面连通性、查看指定用户/智能体/运行的记忆、同步导入或从对话异步提取记忆、语义搜索与读取单条记忆、更新或删除记忆、查询异步任务状态。
限制 控制面不提供创建、修改或删除项目与 API Key 的能力,仅支持读操作。不用于自建开源 mem0 的部署配置、内部 MemoryBase 运维或日志查询。搜索过滤目前仅支持官方文档说明的时间范围与策略,不假定任意元数据键均可过滤。无法发现公网地址时需在可访问私网的环境中以 --data-endpoint 指定 HTTPS 地址。--no-infer 必须与 --no-async-mode 同时使用。清空指定范围记忆需用户明确要求并加 --confirm。