SuperAPI AI 工具集

memos-cloud-server

编程与开发

查看项目

更新于 10-16 00:28

技能介绍

用途:让智能体接入 MemOS Cloud,获得跨会话的长期记忆与知识库能力,包括搜索既有记忆、写入对话消息、删除或纠正记忆、管理知识库文档与反馈。

主要能力(对应 /search/memory、/add/message、/delete/memory、/add/feedback、/add/knowledgebase-file、/get/memory、/create/knowledgebase、/get/knowledgebase-file、/delete/knowledgebase-file、/delete/knowledgebase):

  • search:检索与用户查询相关的长期记忆,可设 --conversation-id、--filter、--knowledgebase-ids、--memory-limit-number、--include-preference、--include-tool-memory、--include-skill、--relativity 等参数。
  • add_message:存储多轮对话中的高价值内容,支持 --tags、--info、--allow-knowledgebase-ids、--agent-id、--app-id。
  • delete:按逗号分隔的记忆 ID 删除。
  • add_feedback:用自然语言纠正或强化记忆,支持 --conversation-first-message、--allow-knowledgebase-ids、--feedback-time、--agent-id、--app-id。
  • 知识库:create_kb 创建、add_kb_doc 上传(支持 URL、本地文件、--stdin、--name、--type document|skill)、get_kb_docs 查询、delete_kb_docs 删除文档、remove_kb 移除知识库。

使用方式:先配置环境变量 MEMOS_API_KEY(必填,勿暴露给模型)、MEMOS_USER_ID(必填,需确定性),可选 MEMOS_CLOUD_URL、MEMOS_AGENT_ID、MEMOS_APP_ID、MEMOS_ALLOW_PUBLIC、MEMOS_ASYNC_MODE;再运行 python3 scripts/memos_cloud.py 及各子命令。官方建议每轮先 search、作答、再 add_message;涉及身份或偏好同时调用 get_user_profile;纠正用 add_feedback 而非 add_message。会话需保持稳定的 conversation_id,可由宿主提供或由会话首条消息经 --conversation-first-message 派生。

适用场景:需要持久记忆与知识库的个人助手、多轮对话应用、多智能体/多租户隔离场景。

限制:必须配置密钥与用户 ID,缺失时需先提示用户;agent_id/app_id 默认不传,除非用户或编排器明确提供;MEMOS_ALLOW_PUBLIC 等为部署方安全边界,调用时不可覆盖;不应对同一查询重复搜索。其余细节暂未提供。