[{"data":1,"prerenderedAt":277},["ShallowReactive",2],{"docs-page-en-\u002Fmemos_cloud\u002Fintroduction\u002Fmemory_types":3,"surround-en-\u002Fmemos_cloud\u002Fintroduction\u002Fmemory_types":261},{"id":4,"title":5,"avatar":6,"banner":6,"body":7,"category":6,"desc":254,"description":13,"extension":255,"links":6,"meta":256,"navigation":6,"path":257,"seo":258,"stem":259,"__hash__":260},"docs\u002Fen\u002Fmemos_cloud\u002Fintroduction\u002Fmemory_types.md","Memory Categories",null,{"type":8,"value":9,"toc":239},"minimark",[10,14,17,22,25,28,38,41,58,60,64,67,69,80,83,85,89,97,99,103,110,112,116,119,121,132,139,141,145,150,153,169,171,175,178,204,213,215,219],[11,12,13],"p",{},"MemOS generates and uses different categories of memories. They play different roles during recall: some confirm events, some describe preferences, some guide how an Agent should complete a task, and some provide supporting knowledge. Distinguishing memory categories helps retrieval return more relevant content and gives the model more accurate context.",[15,16],"br",{},[18,19,21],"h2",{"id":20},"_1-fact-memories","1. Fact Memories",[11,23,24],{},"Fact memories describe relatively objective information, usually from explicit user statements, behavior events, files, or feedback.",[11,26,27],{},"Common examples:",[29,30,31,35],"ul",{},[32,33,34],"li",{},"The user lives in Shanghai.",[32,36,37],{},"The user's device is a 13-inch Intel MacBook Pro.",[11,39,40],{},"Fact memories are useful for answering questions such as \"who is the user\", \"what has the user done\", \"what state is the user currently in\", and \"whether something happened\".",[42,43,44],"note",{},[11,45,46,47,52,53,57],{},"Memories may change over time. MemOS combines ",[48,49,51],"a",{"href":50},"\u002Fmemos_cloud\u002Fintroduction\u002Ftime_awareness","Time Awareness"," and ",[48,54,56],{"href":55},"\u002Fmemos_cloud\u002Fintroduction\u002Fmem_lifecycle","Memory Lifecycle Management"," to handle these changes.",[15,59],{},[18,61,63],{"id":62},"_2-preference-memories","2. Preference Memories",[11,65,66],{},"Preference memories describe long-term or stage-specific user tendencies. They may come from explicit user statements, or from summaries and inferences based on repeated behavior.",[11,68,27],{},[29,70,71,74,77],{},[32,72,73],{},"The user prefers concise and direct answers.",[32,75,76],{},"When planning trips, the user prefers cultural attractions and dislikes shopping malls.",[32,78,79],{},"When buying pet food, the user needs to avoid chicken flavor.",[11,81,82],{},"Preference memories are useful for recommendation, generation, ranking, and personalized decisions. They do more than answer \"what did the user say\"; they help the Agent decide \"what would better fit this user\".",[15,84],{},[18,86,88],{"id":87},"_3-skills","3. Skills",[11,90,91,92,96],{},"Skills record \"how to do a task\". MemOS can automatically extract skills from historical messages, or you can upload existing skill packages to a knowledge base. Tasks with stable steps, such as travel planning, reimbursement review, and customer issue triage, are good candidates for Skills. See ",[48,93,95],{"href":94},"\u002Fmemos_cloud\u002Ffeatures\u002Fskill","Skill",".",[15,98],{},[18,100,102],{"id":101},"_4-tool-memories","4. Tool Memories",[11,104,105,106,96],{},"Tool memories record \"how to use tools\". They are distilled from Tool Schemas, tool call parameters, tool results, and tool trajectories. They help the Agent select tools, fill parameters, and use returned results more reliably. See ",[48,107,109],{"href":108},"\u002Fmemos_cloud\u002Ffeatures\u002Ftool_calling","Tool Memory",[15,111],{},[18,113,115],{"id":114},"_5-knowledge-base-memories","5. Knowledge Base Memories",[11,117,118],{},"Knowledge Base memories come from project-level documents, policies, manuals, FAQs, process files, or Skill files. They are not part of a single user's personal history and are better shared by multiple users or Agents.",[11,120,27],{},[29,122,123,126,129],{},[32,124,125],{},"Company reimbursement policy.",[32,127,128],{},"Product manual.",[32,130,131],{},"Return and after-sales policy.",[11,133,134,135,96],{},"Knowledge Base memories can participate in recall together with user memories. For example, when an employee asks \"The intranet proxy does not open. Which version should I reinstall?\", the knowledge base provides installation instructions, while user fact memory adds that the employee uses an Intel MacBook Pro. Combining both leads to a more accurate answer. See ",[48,136,138],{"href":137},"\u002Fmemos_cloud\u002Ffeatures\u002Fknowledge_base","Knowledge Base",[15,140],{},[18,142,144],{"id":143},"_6-how-to-generate-and-use-them","6. How to Generate and Use Them",[146,147,149],"h3",{"id":148},"generating-memories","Generating memories",[11,151,152],{},"Currently, MemOS generates all memory categories by default.",[29,154,155,158,166],{},[32,156,157],{},"Fact, preference, and Skill memories are generated after adding messages.",[32,159,160,161,165],{},"Tool memories require Tool Call information with ",[162,163,164],"code",{},"\"role\": \"tool\""," when adding messages.",[32,167,168],{},"Knowledge Base memories require creating a knowledge base and uploading documents.",[15,170],{},[146,172,174],{"id":173},"using-memories","Using memories",[11,176,177],{},"When searching memories, control the following parameters according to the memory categories you need:",[29,179,180,186,192,198],{},[32,181,182,185],{},[162,183,184],{},"include_preference",": intelligently recall user preference memories based on the query.",[32,187,188,191],{},[162,189,190],{},"include_skill",": intelligently recall user Skill memories based on the query.",[32,193,194,197],{},[162,195,196],{},"include_tool_memory",": intelligently recall user tool memories based on the query.",[32,199,200,203],{},[162,201,202],{},"knowledgebase_ids",": specify the knowledge bases that can be searched.",[42,205,206],{},[11,207,208,209,96],{},"For the full field list, request format, and response format, see the ",[48,210,212],{"href":211},"\u002Fapi_docs\u002Fcore\u002Fsearch_memory","Search Memory API documentation",[15,214],{},[18,216,218],{"id":217},"_7-start-using-directly","7. Start Using Directly",[220,221,222,231],"card-group",{},[223,224,228],"card",{"icon":225,"title":226,"to":227},"i-ri-message-3-line","Add Message","\u002Fmemos_cloud\u002Fmem_operations\u002Fadd_message",[11,229,230],{},"Write user conversations, files, and tool call traces",[223,232,236],{"icon":233,"title":234,"to":235},"i-ri-search-2-line","Search Memory","\u002Fmemos_cloud\u002Fmem_operations\u002Fsearch_memory",[11,237,238],{},"Retrieve different categories of memories",{"title":240,"searchDepth":241,"depth":241,"links":242},"",2,[243,244,245,246,247,248,253],{"id":20,"depth":241,"text":21},{"id":62,"depth":241,"text":63},{"id":87,"depth":241,"text":88},{"id":101,"depth":241,"text":102},{"id":114,"depth":241,"text":115},{"id":143,"depth":241,"text":144,"children":249},[250,252],{"id":148,"depth":251,"text":149},3,{"id":173,"depth":251,"text":174},{"id":217,"depth":241,"text":218},"Understand the different categories of memories generated and used by MemOS.","md",{},"\u002Fen\u002Fmemos_cloud\u002Fintroduction\u002Fmemory_types",{"title":5,"description":13},"en\u002Fmemos_cloud\u002Fintroduction\u002Fmemory_types","ABeaVuhQXjnlWU8Y928HH3jlCyv9zl8VlxbB9wdUDoo",[262,270],{"title":263,"path":264,"stem":265,"icon":266,"framework":6,"module":6,"class":267,"target":-1,"active":268,"defaultOpen":268,"children":-1,"description":269},"Raw Input Content","\u002Fmemos_cloud\u002Fintroduction\u002Fraw_inputs","memos_cloud\u002Fintroduction\u002Fraw_inputs","i-ri-inbox-archive-line",[],false,"MemOS can generate memories from different kinds of raw input content.",{"title":271,"path":272,"stem":273,"icon":274,"framework":6,"module":6,"class":275,"target":-1,"active":268,"defaultOpen":268,"children":-1,"description":276},"Multi-user \u002F Multi-Agent Isolation","\u002Fmemos_cloud\u002Fintroduction\u002Fisolation_filters","memos_cloud\u002Fintroduction\u002Fisolation_filters","i-ri-filter-3-line",[],"Understand how MemOS Cloud separates users, Agents, conversations, and shared knowledge.",1779709046052]