[{"data":1,"prerenderedAt":2591},["ShallowReactive",2],{"\u002Fmemos_cloud\u002Fmem_operations\u002Fadd_message":3,"surround-\u002Fmemos_cloud\u002Fmem_operations\u002Fadd_message":2577},{"id":4,"title":5,"avatar":6,"banner":6,"body":7,"category":6,"desc":2570,"description":174,"extension":2571,"links":6,"meta":2572,"navigation":6,"path":2573,"seo":2574,"stem":2575,"__hash__":2576},"docs\u002Fen\u002Fmemos_cloud\u002Fmem_operations\u002Fadd_message.md","Add Message",null,{"type":8,"value":9,"toc":2557},"minimark",[10,34,36,41,44,66,92,94,98,129,131,135,155,162,164,168,757,768,770,774,779,782,1341,1343,1345,1349,1352,1606,1608,1610,1614,1617,1744,1746,1748,1752,1760,1768,1779,1951,1953,1960,1967,2156,2165,2167,2174,2185,2388,2390,2395,2400,2403,2417,2420,2428,2430,2432,2436,2444,2553],[11,12,13,29],"warning",{},[14,15,16,24,27],"p",{},[17,18,19],"strong",{},[20,21,23],"a",{"href":22},"\u002Fapi_docs\u002Fcore\u002Fadd_message","Go directly to API Docs",[25,26],"br",{},[25,28],{},[14,30,31],{},[17,32,33],{},"This article focuses on functionality. For detailed interface fields and restrictions, please click the link above.",[25,35],{},[37,38,40],"h2",{"id":39},"_1-how-to-add-a-message","1. How to Add a Message?",[14,42,43],{},"Memories in MemOS are based on original message content. Any message you add is uniformly processed into retrievable memories, ready for future querying and use. When building AI applications, you can decide when to add messages to MemOS, whether you are already managing user memories or just getting started. Typical scenarios include:",[45,46,47,54,60],"ul",{},[48,49,50,53],"li",{},[17,51,52],{},"Batch Import",": Import existing user conversation history into MemOS at once to quickly establish initial memories.",[48,55,56,59],{},[17,57,58],{},"Real-time Addition",": Add messages to MemOS in real time every time a user sends a message.",[48,61,62,65],{},[17,63,64],{},"Add Every N Turns",": For your business needs, set to add user messages every fixed number of dialogue turns.",[67,68,69,74],"note",{},[14,70,71],{},[17,72,73],{}," Why is memory important?",[75,76,78],"div",{"style":77},"padding-left: 2em;",[45,79,80,83,86,89],{},[48,81,82],{},"Enables long-term memory across sessions to prevent information loss after a conversation ends.",[48,84,85],{},"With ongoing interactions, the AI understands the user better and better.",[48,87,88],{},"Continuously writes new information during chats, dynamically updating the user's memory.",[48,90,91],{},"Shares user memories across your multiple apps or products, ensuring consistent user experience.",[25,93],{},[37,95,97],{"id":96},"_2-key-parameters","2. Key Parameters",[45,99,100,111,120],{},[48,101,102,110],{},[17,103,104,105,109],{},"User ID (",[106,107,108],"code",{},"user_id",")",": Uniquely identifies the user to whom the message belongs. All conversations must be associated with a specific and unique user identifier.",[48,112,113,119],{},[17,114,115,116,109],{},"Conversation ID (",[106,117,118],{},"conversation_id",": Uniquely identifies the conversation to which the message belongs. All messages must be tied to a specific and unique conversation ID.",[48,121,122,128],{},[17,123,124,125,109],{},"Messages (",[106,126,127],{},"messages",": Ordered list of messages between the user and AI, to be added to MemOS.",[25,130],{},[37,132,134],{"id":133},"_3-working-principle","3. Working Principle",[45,136,137,143,149],{},[48,138,139,142],{},[17,140,141],{},"Information Extraction",": Internally, MemOS uses an LLM to extract facts, preferences, etc., from messages and process them into memories, including types like factual memory, preference memory, tool usage memory, etc.",[48,144,145,148],{},[17,146,147],{},"Conflict Resolution",": Existing memories are checked for duplication or conflict and updated accordingly.",[48,150,151,154],{},[17,152,153],{},"Memory Storage",": Generated memories are stored in vector databases and graph databases for efficient recall during future retrieval.",[14,156,157,158,161],{},"All of these processes are triggered by calling the ",[106,159,160],{},"add\u002Fmessage"," API. Manual memory operations are not required.",[25,163],{},[37,165,167],{"id":166},"_4-quick-start","4. Quick Start",[169,170,175],"pre",{"className":171,"code":172,"language":173,"meta":174,"style":174},"language-python shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import os\nimport requests\nimport json\n\n# Replace with your MemOS API Key\nos.environ[\"MEMOS_API_KEY\"] = \"YOUR_API_KEY\"\nos.environ[\"MEMOS_BASE_URL\"] = \"https:\u002F\u002Fmemos.memtensor.cn\u002Fapi\u002Fopenmem\u002Fv1\"\n\ndata = {\n    \"user_id\": \"memos_user_123\",\n    \"conversation_id\": \"0610\",\n    \"messages\": [\n      {\"role\": \"user\", \"content\": \"I've planned to travel to Guangzhou this summer. What chain hotels are available?\"},\n      {\"role\": \"assistant\", \"content\": \"You can consider {'7 Days', 'Atour', 'Hilton'}, among others.\"},\n      {\"role\": \"user\", \"content\": \"I'll choose 7 Days.\"},\n      {\"role\": \"assistant\", \"content\": \"Alright! Let me know if you have any other questions.\"}\n    ]\n  }\nheaders = {\n  \"Content-Type\": \"application\u002Fjson\",\n  \"Authorization\": f\"Token {os.environ['MEMOS_API_KEY']}\"\n}\nurl = f\"{os.environ['MEMOS_BASE_URL']}\u002Fadd\u002Fmessage\"\n\nres = requests.post(url=url, headers=headers, data=json.dumps(data))\n\nprint(f\"result: {res.json()}\")\n","python","",[106,176,177,190,198,206,213,220,261,290,295,307,330,350,364,408,447,485,524,530,536,546,568,613,618,653,658,719,724],{"__ignoreMap":174},[178,179,182,186],"span",{"class":180,"line":181},"line",1,[178,183,185],{"class":184},"s7zQu","import",[178,187,189],{"class":188},"sTEyZ"," os\n",[178,191,193,195],{"class":180,"line":192},2,[178,194,185],{"class":184},[178,196,197],{"class":188}," requests\n",[178,199,201,203],{"class":180,"line":200},3,[178,202,185],{"class":184},[178,204,205],{"class":188}," json\n",[178,207,209],{"class":180,"line":208},4,[178,210,212],{"emptyLinePlaceholder":211},true,"\n",[178,214,216],{"class":180,"line":215},5,[178,217,219],{"class":218},"sHwdD","# Replace with your MemOS API Key\n",[178,221,223,226,230,234,237,240,244,246,249,252,255,258],{"class":180,"line":222},6,[178,224,225],{"class":188},"os",[178,227,229],{"class":228},"sMK4o",".",[178,231,233],{"class":232},"swJcz","environ",[178,235,236],{"class":228},"[",[178,238,239],{"class":228},"\"",[178,241,243],{"class":242},"sfazB","MEMOS_API_KEY",[178,245,239],{"class":228},[178,247,248],{"class":228},"]",[178,250,251],{"class":228}," =",[178,253,254],{"class":228}," \"",[178,256,257],{"class":242},"YOUR_API_KEY",[178,259,260],{"class":228},"\"\n",[178,262,264,266,268,270,272,274,277,279,281,283,285,288],{"class":180,"line":263},7,[178,265,225],{"class":188},[178,267,229],{"class":228},[178,269,233],{"class":232},[178,271,236],{"class":228},[178,273,239],{"class":228},[178,275,276],{"class":242},"MEMOS_BASE_URL",[178,278,239],{"class":228},[178,280,248],{"class":228},[178,282,251],{"class":228},[178,284,254],{"class":228},[178,286,287],{"class":242},"https:\u002F\u002Fmemos.memtensor.cn\u002Fapi\u002Fopenmem\u002Fv1",[178,289,260],{"class":228},[178,291,293],{"class":180,"line":292},8,[178,294,212],{"emptyLinePlaceholder":211},[178,296,298,301,304],{"class":180,"line":297},9,[178,299,300],{"class":188},"data ",[178,302,303],{"class":228},"=",[178,305,306],{"class":228}," {\n",[178,308,310,313,315,317,320,322,325,327],{"class":180,"line":309},10,[178,311,312],{"class":228},"    \"",[178,314,108],{"class":242},[178,316,239],{"class":228},[178,318,319],{"class":228},":",[178,321,254],{"class":228},[178,323,324],{"class":242},"memos_user_123",[178,326,239],{"class":228},[178,328,329],{"class":228},",\n",[178,331,333,335,337,339,341,343,346,348],{"class":180,"line":332},11,[178,334,312],{"class":228},[178,336,118],{"class":242},[178,338,239],{"class":228},[178,340,319],{"class":228},[178,342,254],{"class":228},[178,344,345],{"class":242},"0610",[178,347,239],{"class":228},[178,349,329],{"class":228},[178,351,353,355,357,359,361],{"class":180,"line":352},12,[178,354,312],{"class":228},[178,356,127],{"class":242},[178,358,239],{"class":228},[178,360,319],{"class":228},[178,362,363],{"class":228}," [\n",[178,365,367,370,372,375,377,379,381,384,386,389,391,394,396,398,400,403,405],{"class":180,"line":366},13,[178,368,369],{"class":228},"      {",[178,371,239],{"class":228},[178,373,374],{"class":242},"role",[178,376,239],{"class":228},[178,378,319],{"class":228},[178,380,254],{"class":228},[178,382,383],{"class":242},"user",[178,385,239],{"class":228},[178,387,388],{"class":228},",",[178,390,254],{"class":228},[178,392,393],{"class":242},"content",[178,395,239],{"class":228},[178,397,319],{"class":228},[178,399,254],{"class":228},[178,401,402],{"class":242},"I've planned to travel to Guangzhou this summer. What chain hotels are available?",[178,404,239],{"class":228},[178,406,407],{"class":228},"},\n",[178,409,411,413,415,417,419,421,423,426,428,430,432,434,436,438,440,443,445],{"class":180,"line":410},14,[178,412,369],{"class":228},[178,414,239],{"class":228},[178,416,374],{"class":242},[178,418,239],{"class":228},[178,420,319],{"class":228},[178,422,254],{"class":228},[178,424,425],{"class":242},"assistant",[178,427,239],{"class":228},[178,429,388],{"class":228},[178,431,254],{"class":228},[178,433,393],{"class":242},[178,435,239],{"class":228},[178,437,319],{"class":228},[178,439,254],{"class":228},[178,441,442],{"class":242},"You can consider {'7 Days', 'Atour', 'Hilton'}, among others.",[178,444,239],{"class":228},[178,446,407],{"class":228},[178,448,450,452,454,456,458,460,462,464,466,468,470,472,474,476,478,481,483],{"class":180,"line":449},15,[178,451,369],{"class":228},[178,453,239],{"class":228},[178,455,374],{"class":242},[178,457,239],{"class":228},[178,459,319],{"class":228},[178,461,254],{"class":228},[178,463,383],{"class":242},[178,465,239],{"class":228},[178,467,388],{"class":228},[178,469,254],{"class":228},[178,471,393],{"class":242},[178,473,239],{"class":228},[178,475,319],{"class":228},[178,477,254],{"class":228},[178,479,480],{"class":242},"I'll choose 7 Days.",[178,482,239],{"class":228},[178,484,407],{"class":228},[178,486,488,490,492,494,496,498,500,502,504,506,508,510,512,514,516,519,521],{"class":180,"line":487},16,[178,489,369],{"class":228},[178,491,239],{"class":228},[178,493,374],{"class":242},[178,495,239],{"class":228},[178,497,319],{"class":228},[178,499,254],{"class":228},[178,501,425],{"class":242},[178,503,239],{"class":228},[178,505,388],{"class":228},[178,507,254],{"class":228},[178,509,393],{"class":242},[178,511,239],{"class":228},[178,513,319],{"class":228},[178,515,254],{"class":228},[178,517,518],{"class":242},"Alright! Let me know if you have any other questions.",[178,520,239],{"class":228},[178,522,523],{"class":228},"}\n",[178,525,527],{"class":180,"line":526},17,[178,528,529],{"class":228},"    ]\n",[178,531,533],{"class":180,"line":532},18,[178,534,535],{"class":228},"  }\n",[178,537,539,542,544],{"class":180,"line":538},19,[178,540,541],{"class":188},"headers ",[178,543,303],{"class":228},[178,545,306],{"class":228},[178,547,549,552,555,557,559,561,564,566],{"class":180,"line":548},20,[178,550,551],{"class":228},"  \"",[178,553,554],{"class":242},"Content-Type",[178,556,239],{"class":228},[178,558,319],{"class":228},[178,560,254],{"class":228},[178,562,563],{"class":242},"application\u002Fjson",[178,565,239],{"class":228},[178,567,329],{"class":228},[178,569,571,573,576,578,580,584,587,591,593,595,597,599,602,604,606,608,611],{"class":180,"line":570},21,[178,572,551],{"class":228},[178,574,575],{"class":242},"Authorization",[178,577,239],{"class":228},[178,579,319],{"class":228},[178,581,583],{"class":582},"spNyl"," f",[178,585,586],{"class":242},"\"Token ",[178,588,590],{"class":589},"sbssI","{",[178,592,225],{"class":188},[178,594,229],{"class":228},[178,596,233],{"class":232},[178,598,236],{"class":228},[178,600,601],{"class":228},"'",[178,603,243],{"class":242},[178,605,601],{"class":228},[178,607,248],{"class":228},[178,609,610],{"class":589},"}",[178,612,260],{"class":242},[178,614,616],{"class":180,"line":615},22,[178,617,523],{"class":228},[178,619,621,624,626,628,630,632,634,636,638,640,642,644,646,648,650],{"class":180,"line":620},23,[178,622,623],{"class":188},"url ",[178,625,303],{"class":228},[178,627,583],{"class":582},[178,629,239],{"class":242},[178,631,590],{"class":589},[178,633,225],{"class":188},[178,635,229],{"class":228},[178,637,233],{"class":232},[178,639,236],{"class":228},[178,641,601],{"class":228},[178,643,276],{"class":242},[178,645,601],{"class":228},[178,647,248],{"class":228},[178,649,610],{"class":589},[178,651,652],{"class":242},"\u002Fadd\u002Fmessage\"\n",[178,654,656],{"class":180,"line":655},24,[178,657,212],{"emptyLinePlaceholder":211},[178,659,661,664,666,669,671,675,678,682,684,686,688,691,693,696,698,701,703,706,708,711,713,716],{"class":180,"line":660},25,[178,662,663],{"class":188},"res ",[178,665,303],{"class":228},[178,667,668],{"class":188}," requests",[178,670,229],{"class":228},[178,672,674],{"class":673},"s2Zo4","post",[178,676,677],{"class":228},"(",[178,679,681],{"class":680},"sHdIc","url",[178,683,303],{"class":228},[178,685,681],{"class":673},[178,687,388],{"class":228},[178,689,690],{"class":680}," headers",[178,692,303],{"class":228},[178,694,695],{"class":673},"headers",[178,697,388],{"class":228},[178,699,700],{"class":680}," data",[178,702,303],{"class":228},[178,704,705],{"class":673},"json",[178,707,229],{"class":228},[178,709,710],{"class":673},"dumps",[178,712,677],{"class":228},[178,714,715],{"class":673},"data",[178,717,718],{"class":228},"))\n",[178,720,722],{"class":180,"line":721},26,[178,723,212],{"emptyLinePlaceholder":211},[178,725,727,730,732,735,738,740,743,745,747,750,752,754],{"class":180,"line":726},27,[178,728,729],{"class":673},"print",[178,731,677],{"class":228},[178,733,734],{"class":582},"f",[178,736,737],{"class":242},"\"result: ",[178,739,590],{"class":589},[178,741,742],{"class":673},"res",[178,744,229],{"class":228},[178,746,705],{"class":673},[178,748,749],{"class":228},"()",[178,751,610],{"class":589},[178,753,239],{"class":242},[178,755,756],{"class":228},")\n",[67,758,759],{},[14,760,761,762,229],{},"Want to see which memories were generated? Just copy and run the code above, then go to ",[20,763,765],{"href":764},"\u002Fmemos_cloud\u002Fmem_operations\u002Fsearch_memory",[17,766,767],{},"Search Memory",[25,769],{},[37,771,773],{"id":772},"_5-more-ways-to-use","5. More Ways to Use",[775,776,778],"h3",{"id":777},"real-time-import-of-conversations","Real-time Import of Conversations",[14,780,781],{},"You can call the API to add messages each time the user receives a reply from the model, synchronizing conversations between users and assistants with MemOS in real time. MemOS will continually update the user’s memory backend as new dialogs come in.",[169,783,785],{"className":171,"code":784,"language":173,"meta":174,"style":174},"import os\nimport json\nimport requests\n\nos.environ[\"MEMOS_API_KEY\"] = \"YOUR_API_KEY\"\nos.environ[\"MEMOS_BASE_URL\"] = \"https:\u002F\u002Fmemos.memtensor.cn\u002Fapi\u002Fopenmem\u002Fv1\"\n\n# Headers and Base URL\nheaders = {\n  \"Authorization\": f\"Token {os.environ['MEMOS_API_KEY']}\",\n  \"Content-Type\": \"application\u002Fjson\"\n}\nBASE_URL = os.environ['MEMOS_BASE_URL']\n\ndef add_message(user_id, conversation_id, messages):\n    data = {\n        \"user_id\": user_id,\n        \"conversation_id\": conversation_id,\n        \"messages\": messages\n    }\n    \n    res = requests.post(f\"{BASE_URL}\u002Fadd\u002Fmessage\", headers=headers, data=json.dumps(data))\n    result = res.json()\n  \n    if result.get('code') == 0: \n      print(f\"✅ Successfully added\")\n    else:\n      print(f\"❌ Add failed, {result.get('message')}\")\n\n# Add user-assistant conversation messages\nadd_message(\"memos_user_123\", \"memos_conversation_123\",\n            [{\"role\": \"user\", \"content\": \"I ran 5 kilometers this morning, my knees feel a bit sore\"}, \n             {\"role\": \"assistant\", \"content\": \"You ran 5km this morning and feel a bit of knee soreness, which shows your joints and muscles are still adapting to the intensity. For tomorrow, I suggest reducing to about 3km, focusing on warming up and relaxation. This way you can maintain your rhythm while allowing time for recovery.\"}])\n\n",[106,786,787,793,799,805,809,835,861,865,870,878,916,932,936,961,965,990,999,1015,1029,1042,1047,1052,1107,1124,1129,1163,1177,1185,1223,1228,1234,1259,1301],{"__ignoreMap":174},[178,788,789,791],{"class":180,"line":181},[178,790,185],{"class":184},[178,792,189],{"class":188},[178,794,795,797],{"class":180,"line":192},[178,796,185],{"class":184},[178,798,205],{"class":188},[178,800,801,803],{"class":180,"line":200},[178,802,185],{"class":184},[178,804,197],{"class":188},[178,806,807],{"class":180,"line":208},[178,808,212],{"emptyLinePlaceholder":211},[178,810,811,813,815,817,819,821,823,825,827,829,831,833],{"class":180,"line":215},[178,812,225],{"class":188},[178,814,229],{"class":228},[178,816,233],{"class":232},[178,818,236],{"class":228},[178,820,239],{"class":228},[178,822,243],{"class":242},[178,824,239],{"class":228},[178,826,248],{"class":228},[178,828,251],{"class":228},[178,830,254],{"class":228},[178,832,257],{"class":242},[178,834,260],{"class":228},[178,836,837,839,841,843,845,847,849,851,853,855,857,859],{"class":180,"line":222},[178,838,225],{"class":188},[178,840,229],{"class":228},[178,842,233],{"class":232},[178,844,236],{"class":228},[178,846,239],{"class":228},[178,848,276],{"class":242},[178,850,239],{"class":228},[178,852,248],{"class":228},[178,854,251],{"class":228},[178,856,254],{"class":228},[178,858,287],{"class":242},[178,860,260],{"class":228},[178,862,863],{"class":180,"line":263},[178,864,212],{"emptyLinePlaceholder":211},[178,866,867],{"class":180,"line":292},[178,868,869],{"class":218},"# Headers and Base URL\n",[178,871,872,874,876],{"class":180,"line":297},[178,873,541],{"class":188},[178,875,303],{"class":228},[178,877,306],{"class":228},[178,879,880,882,884,886,888,890,892,894,896,898,900,902,904,906,908,910,912,914],{"class":180,"line":309},[178,881,551],{"class":228},[178,883,575],{"class":242},[178,885,239],{"class":228},[178,887,319],{"class":228},[178,889,583],{"class":582},[178,891,586],{"class":242},[178,893,590],{"class":589},[178,895,225],{"class":188},[178,897,229],{"class":228},[178,899,233],{"class":232},[178,901,236],{"class":228},[178,903,601],{"class":228},[178,905,243],{"class":242},[178,907,601],{"class":228},[178,909,248],{"class":228},[178,911,610],{"class":589},[178,913,239],{"class":242},[178,915,329],{"class":228},[178,917,918,920,922,924,926,928,930],{"class":180,"line":332},[178,919,551],{"class":228},[178,921,554],{"class":242},[178,923,239],{"class":228},[178,925,319],{"class":228},[178,927,254],{"class":228},[178,929,563],{"class":242},[178,931,260],{"class":228},[178,933,934],{"class":180,"line":352},[178,935,523],{"class":228},[178,937,938,941,943,946,948,950,952,954,956,958],{"class":180,"line":366},[178,939,940],{"class":188},"BASE_URL ",[178,942,303],{"class":228},[178,944,945],{"class":188}," os",[178,947,229],{"class":228},[178,949,233],{"class":232},[178,951,236],{"class":228},[178,953,601],{"class":228},[178,955,276],{"class":242},[178,957,601],{"class":228},[178,959,960],{"class":228},"]\n",[178,962,963],{"class":180,"line":410},[178,964,212],{"emptyLinePlaceholder":211},[178,966,967,970,973,975,977,979,982,984,987],{"class":180,"line":449},[178,968,969],{"class":582},"def",[178,971,972],{"class":673}," add_message",[178,974,677],{"class":228},[178,976,108],{"class":680},[178,978,388],{"class":228},[178,980,981],{"class":680}," conversation_id",[178,983,388],{"class":228},[178,985,986],{"class":680}," messages",[178,988,989],{"class":228},"):\n",[178,991,992,995,997],{"class":180,"line":487},[178,993,994],{"class":188},"    data ",[178,996,303],{"class":228},[178,998,306],{"class":228},[178,1000,1001,1004,1006,1008,1010,1013],{"class":180,"line":526},[178,1002,1003],{"class":228},"        \"",[178,1005,108],{"class":242},[178,1007,239],{"class":228},[178,1009,319],{"class":228},[178,1011,1012],{"class":188}," user_id",[178,1014,329],{"class":228},[178,1016,1017,1019,1021,1023,1025,1027],{"class":180,"line":532},[178,1018,1003],{"class":228},[178,1020,118],{"class":242},[178,1022,239],{"class":228},[178,1024,319],{"class":228},[178,1026,981],{"class":188},[178,1028,329],{"class":228},[178,1030,1031,1033,1035,1037,1039],{"class":180,"line":538},[178,1032,1003],{"class":228},[178,1034,127],{"class":242},[178,1036,239],{"class":228},[178,1038,319],{"class":228},[178,1040,1041],{"class":188}," messages\n",[178,1043,1044],{"class":180,"line":548},[178,1045,1046],{"class":228},"    }\n",[178,1048,1049],{"class":180,"line":570},[178,1050,1051],{"class":188},"    \n",[178,1053,1054,1057,1059,1061,1063,1065,1067,1069,1071,1073,1076,1078,1081,1083,1085,1087,1089,1091,1093,1095,1097,1099,1101,1103,1105],{"class":180,"line":615},[178,1055,1056],{"class":188},"    res ",[178,1058,303],{"class":228},[178,1060,668],{"class":188},[178,1062,229],{"class":228},[178,1064,674],{"class":673},[178,1066,677],{"class":228},[178,1068,734],{"class":582},[178,1070,239],{"class":242},[178,1072,590],{"class":589},[178,1074,1075],{"class":673},"BASE_URL",[178,1077,610],{"class":589},[178,1079,1080],{"class":242},"\u002Fadd\u002Fmessage\"",[178,1082,388],{"class":228},[178,1084,690],{"class":680},[178,1086,303],{"class":228},[178,1088,695],{"class":673},[178,1090,388],{"class":228},[178,1092,700],{"class":680},[178,1094,303],{"class":228},[178,1096,705],{"class":673},[178,1098,229],{"class":228},[178,1100,710],{"class":673},[178,1102,677],{"class":228},[178,1104,715],{"class":673},[178,1106,718],{"class":228},[178,1108,1109,1112,1114,1117,1119,1121],{"class":180,"line":620},[178,1110,1111],{"class":188},"    result ",[178,1113,303],{"class":228},[178,1115,1116],{"class":188}," res",[178,1118,229],{"class":228},[178,1120,705],{"class":673},[178,1122,1123],{"class":228},"()\n",[178,1125,1126],{"class":180,"line":655},[178,1127,1128],{"class":188},"  \n",[178,1130,1131,1134,1137,1139,1142,1144,1146,1148,1150,1152,1155,1158,1160],{"class":180,"line":660},[178,1132,1133],{"class":184},"    if",[178,1135,1136],{"class":188}," result",[178,1138,229],{"class":228},[178,1140,1141],{"class":673},"get",[178,1143,677],{"class":228},[178,1145,601],{"class":228},[178,1147,106],{"class":242},[178,1149,601],{"class":228},[178,1151,109],{"class":228},[178,1153,1154],{"class":228}," ==",[178,1156,1157],{"class":589}," 0",[178,1159,319],{"class":228},[178,1161,1162],{"class":188}," \n",[178,1164,1165,1168,1170,1172,1175],{"class":180,"line":721},[178,1166,1167],{"class":673},"      print",[178,1169,677],{"class":228},[178,1171,734],{"class":582},[178,1173,1174],{"class":242},"\"✅ Successfully added\"",[178,1176,756],{"class":228},[178,1178,1179,1182],{"class":180,"line":726},[178,1180,1181],{"class":184},"    else",[178,1183,1184],{"class":228},":\n",[178,1186,1188,1190,1192,1194,1197,1199,1202,1204,1206,1208,1210,1213,1215,1217,1219,1221],{"class":180,"line":1187},28,[178,1189,1167],{"class":673},[178,1191,677],{"class":228},[178,1193,734],{"class":582},[178,1195,1196],{"class":242},"\"❌ Add failed, ",[178,1198,590],{"class":589},[178,1200,1201],{"class":673},"result",[178,1203,229],{"class":228},[178,1205,1141],{"class":673},[178,1207,677],{"class":228},[178,1209,601],{"class":228},[178,1211,1212],{"class":242},"message",[178,1214,601],{"class":228},[178,1216,109],{"class":228},[178,1218,610],{"class":589},[178,1220,239],{"class":242},[178,1222,756],{"class":228},[178,1224,1226],{"class":180,"line":1225},29,[178,1227,212],{"emptyLinePlaceholder":211},[178,1229,1231],{"class":180,"line":1230},30,[178,1232,1233],{"class":218},"# Add user-assistant conversation messages\n",[178,1235,1237,1240,1242,1244,1246,1248,1250,1252,1255,1257],{"class":180,"line":1236},31,[178,1238,1239],{"class":673},"add_message",[178,1241,677],{"class":228},[178,1243,239],{"class":228},[178,1245,324],{"class":242},[178,1247,239],{"class":228},[178,1249,388],{"class":228},[178,1251,254],{"class":228},[178,1253,1254],{"class":242},"memos_conversation_123",[178,1256,239],{"class":228},[178,1258,329],{"class":228},[178,1260,1262,1265,1267,1269,1271,1273,1275,1277,1279,1281,1283,1285,1287,1289,1291,1294,1296,1299],{"class":180,"line":1261},32,[178,1263,1264],{"class":228},"            [{",[178,1266,239],{"class":228},[178,1268,374],{"class":242},[178,1270,239],{"class":228},[178,1272,319],{"class":228},[178,1274,254],{"class":228},[178,1276,383],{"class":242},[178,1278,239],{"class":228},[178,1280,388],{"class":228},[178,1282,254],{"class":228},[178,1284,393],{"class":242},[178,1286,239],{"class":228},[178,1288,319],{"class":228},[178,1290,254],{"class":228},[178,1292,1293],{"class":242},"I ran 5 kilometers this morning, my knees feel a bit sore",[178,1295,239],{"class":228},[178,1297,1298],{"class":228},"},",[178,1300,1162],{"class":673},[178,1302,1304,1307,1309,1311,1313,1315,1317,1319,1321,1323,1325,1327,1329,1331,1333,1336,1338],{"class":180,"line":1303},33,[178,1305,1306],{"class":228},"             {",[178,1308,239],{"class":228},[178,1310,374],{"class":242},[178,1312,239],{"class":228},[178,1314,319],{"class":228},[178,1316,254],{"class":228},[178,1318,425],{"class":242},[178,1320,239],{"class":228},[178,1322,388],{"class":228},[178,1324,254],{"class":228},[178,1326,393],{"class":242},[178,1328,239],{"class":228},[178,1330,319],{"class":228},[178,1332,254],{"class":228},[178,1334,1335],{"class":242},"You ran 5km this morning and feel a bit of knee soreness, which shows your joints and muscles are still adapting to the intensity. For tomorrow, I suggest reducing to about 3km, focusing on warming up and relaxation. This way you can maintain your rhythm while allowing time for recovery.",[178,1337,239],{"class":228},[178,1339,1340],{"class":228},"}])\n",[25,1342],{},[25,1344],{},[775,1346,1348],{"id":1347},"import-historical-conversations","Import Historical Conversations",[14,1350,1351],{},"If you already have an AI chat application, MemOS supports batch importing existing chat records, helping your chatbot remember users and provide more personalized replies.",[169,1353,1355],{"className":171,"code":1354,"language":173,"meta":174,"style":174},"# Sample historical conversation data\n\"messages\": [\n  # User's conversation with AI on the first day\n    {\"role\": \"user\", \"content\": \"I love spicy food\", \"chat_time\": \"2025-09-12 08:00:00\"},\n    {\"role\": \"assistant\", \"content\": \"Noted, I’ve remembered you prefer spicy food.\", \"chat_time\": \"2025-09-12 08:01:00\"},\n  # Conversation a few days later\n    {\"role\": \"user\", \"content\": \"But I don't like greasy foods, like spicy hotpot or braised dishes.\", \"chat_time\": \"2025-09-25 12:00:00\"},\n    {\"role\": \"assistant\", \"content\": \"So you prefer light yet spicy dishes. I can recommend some suitable spicy foods for you~\", \"chat_time\": \"2025-09-25 12:01:00\"}\n]\n",[106,1356,1357,1362,1374,1379,1435,1489,1494,1548,1602],{"__ignoreMap":174},[178,1358,1359],{"class":180,"line":181},[178,1360,1361],{"class":218},"# Sample historical conversation data\n",[178,1363,1364,1366,1368,1370,1372],{"class":180,"line":192},[178,1365,239],{"class":184},[178,1367,127],{"class":218},[178,1369,239],{"class":184},[178,1371,319],{"class":228},[178,1373,363],{"class":228},[178,1375,1376],{"class":180,"line":200},[178,1377,1378],{"class":218},"  # User's conversation with AI on the first day\n",[178,1380,1381,1384,1386,1388,1390,1392,1394,1396,1398,1400,1402,1404,1406,1408,1410,1413,1415,1417,1419,1422,1424,1426,1428,1431,1433],{"class":180,"line":208},[178,1382,1383],{"class":228},"    {",[178,1385,239],{"class":228},[178,1387,374],{"class":242},[178,1389,239],{"class":228},[178,1391,319],{"class":228},[178,1393,254],{"class":228},[178,1395,383],{"class":242},[178,1397,239],{"class":228},[178,1399,388],{"class":228},[178,1401,254],{"class":228},[178,1403,393],{"class":242},[178,1405,239],{"class":228},[178,1407,319],{"class":228},[178,1409,254],{"class":228},[178,1411,1412],{"class":242},"I love spicy food",[178,1414,239],{"class":228},[178,1416,388],{"class":228},[178,1418,254],{"class":228},[178,1420,1421],{"class":242},"chat_time",[178,1423,239],{"class":228},[178,1425,319],{"class":228},[178,1427,254],{"class":228},[178,1429,1430],{"class":242},"2025-09-12 08:00:00",[178,1432,239],{"class":228},[178,1434,407],{"class":228},[178,1436,1437,1439,1441,1443,1445,1447,1449,1451,1453,1455,1457,1459,1461,1463,1465,1468,1470,1472,1474,1476,1478,1480,1482,1485,1487],{"class":180,"line":215},[178,1438,1383],{"class":228},[178,1440,239],{"class":228},[178,1442,374],{"class":242},[178,1444,239],{"class":228},[178,1446,319],{"class":228},[178,1448,254],{"class":228},[178,1450,425],{"class":242},[178,1452,239],{"class":228},[178,1454,388],{"class":228},[178,1456,254],{"class":228},[178,1458,393],{"class":242},[178,1460,239],{"class":228},[178,1462,319],{"class":228},[178,1464,254],{"class":228},[178,1466,1467],{"class":242},"Noted, I’ve remembered you prefer spicy food.",[178,1469,239],{"class":228},[178,1471,388],{"class":228},[178,1473,254],{"class":228},[178,1475,1421],{"class":242},[178,1477,239],{"class":228},[178,1479,319],{"class":228},[178,1481,254],{"class":228},[178,1483,1484],{"class":242},"2025-09-12 08:01:00",[178,1486,239],{"class":228},[178,1488,407],{"class":228},[178,1490,1491],{"class":180,"line":222},[178,1492,1493],{"class":218},"  # Conversation a few days later\n",[178,1495,1496,1498,1500,1502,1504,1506,1508,1510,1512,1514,1516,1518,1520,1522,1524,1527,1529,1531,1533,1535,1537,1539,1541,1544,1546],{"class":180,"line":263},[178,1497,1383],{"class":228},[178,1499,239],{"class":228},[178,1501,374],{"class":242},[178,1503,239],{"class":228},[178,1505,319],{"class":228},[178,1507,254],{"class":228},[178,1509,383],{"class":242},[178,1511,239],{"class":228},[178,1513,388],{"class":228},[178,1515,254],{"class":228},[178,1517,393],{"class":242},[178,1519,239],{"class":228},[178,1521,319],{"class":228},[178,1523,254],{"class":228},[178,1525,1526],{"class":242},"But I don't like greasy foods, like spicy hotpot or braised dishes.",[178,1528,239],{"class":228},[178,1530,388],{"class":228},[178,1532,254],{"class":228},[178,1534,1421],{"class":242},[178,1536,239],{"class":228},[178,1538,319],{"class":228},[178,1540,254],{"class":228},[178,1542,1543],{"class":242},"2025-09-25 12:00:00",[178,1545,239],{"class":228},[178,1547,407],{"class":228},[178,1549,1550,1552,1554,1556,1558,1560,1562,1564,1566,1568,1570,1572,1574,1576,1578,1581,1583,1585,1587,1589,1591,1593,1595,1598,1600],{"class":180,"line":292},[178,1551,1383],{"class":228},[178,1553,239],{"class":228},[178,1555,374],{"class":242},[178,1557,239],{"class":228},[178,1559,319],{"class":228},[178,1561,254],{"class":228},[178,1563,425],{"class":242},[178,1565,239],{"class":228},[178,1567,388],{"class":228},[178,1569,254],{"class":228},[178,1571,393],{"class":242},[178,1573,239],{"class":228},[178,1575,319],{"class":228},[178,1577,254],{"class":228},[178,1579,1580],{"class":242},"So you prefer light yet spicy dishes. I can recommend some suitable spicy foods for you~",[178,1582,239],{"class":228},[178,1584,388],{"class":228},[178,1586,254],{"class":228},[178,1588,1421],{"class":242},[178,1590,239],{"class":228},[178,1592,319],{"class":228},[178,1594,254],{"class":228},[178,1596,1597],{"class":242},"2025-09-25 12:01:00",[178,1599,239],{"class":228},[178,1601,523],{"class":228},[178,1603,1604],{"class":180,"line":297},[178,1605,960],{"class":228},[25,1607],{},[25,1609],{},[775,1611,1613],{"id":1612},"record-user-preferences-or-behaviors","Record User Preferences or Behaviors",[14,1615,1616],{},"Besides importing conversations, you can also import user preferences or behavioral data (e.g., questionnaire info at first app launch) as part of their memories in MemOS.",[169,1618,1620],{"className":171,"code":1619,"language":173,"meta":174,"style":174},"# Sample user interest information\n\"messages\": [\n    {\n      \"role\": \"user\",\n      \"content\": \"\"\"\nFavorite movie genres: Sci-fi, Action, Comedy\nFavorite TV genres: Mystery, Historical\nFavorite book genres: Popular Science, Technology, Self-improvement\nPreferred learning modes: Articles, Videos, Podcasts\nExercise habits: Running, Fitness\nDietary habits: Prefer spicy, healthy eating\nTravel preferences: Natural scenery, Urban culture, Adventure\nFavorite chat style: Humorous, Warm, Casual\nTypes of help wanted from AI: Advice, Information queries, Inspiration\nTopics I’m most interested in: AI, Future technologies, Film reviews\nWhat I want AI to help with: Daily study planning, Movie & book recommendations, Providing emotional companionship\n      \"\"\"\n    }\n]\n",[106,1621,1622,1627,1639,1644,1663,1676,1681,1686,1691,1696,1701,1706,1711,1716,1721,1726,1731,1736,1740],{"__ignoreMap":174},[178,1623,1624],{"class":180,"line":181},[178,1625,1626],{"class":218},"# Sample user interest information\n",[178,1628,1629,1631,1633,1635,1637],{"class":180,"line":192},[178,1630,239],{"class":184},[178,1632,127],{"class":218},[178,1634,239],{"class":184},[178,1636,319],{"class":228},[178,1638,363],{"class":228},[178,1640,1641],{"class":180,"line":200},[178,1642,1643],{"class":228},"    {\n",[178,1645,1646,1649,1651,1653,1655,1657,1659,1661],{"class":180,"line":208},[178,1647,1648],{"class":228},"      \"",[178,1650,374],{"class":242},[178,1652,239],{"class":228},[178,1654,319],{"class":228},[178,1656,254],{"class":228},[178,1658,383],{"class":242},[178,1660,239],{"class":228},[178,1662,329],{"class":228},[178,1664,1665,1667,1669,1671,1673],{"class":180,"line":215},[178,1666,1648],{"class":228},[178,1668,393],{"class":242},[178,1670,239],{"class":228},[178,1672,319],{"class":228},[178,1674,1675],{"class":228}," \"\"\"\n",[178,1677,1678],{"class":180,"line":222},[178,1679,1680],{"class":242},"Favorite movie genres: Sci-fi, Action, Comedy\n",[178,1682,1683],{"class":180,"line":263},[178,1684,1685],{"class":242},"Favorite TV genres: Mystery, Historical\n",[178,1687,1688],{"class":180,"line":292},[178,1689,1690],{"class":242},"Favorite book genres: Popular Science, Technology, Self-improvement\n",[178,1692,1693],{"class":180,"line":297},[178,1694,1695],{"class":242},"Preferred learning modes: Articles, Videos, Podcasts\n",[178,1697,1698],{"class":180,"line":309},[178,1699,1700],{"class":242},"Exercise habits: Running, Fitness\n",[178,1702,1703],{"class":180,"line":332},[178,1704,1705],{"class":242},"Dietary habits: Prefer spicy, healthy eating\n",[178,1707,1708],{"class":180,"line":352},[178,1709,1710],{"class":242},"Travel preferences: Natural scenery, Urban culture, Adventure\n",[178,1712,1713],{"class":180,"line":366},[178,1714,1715],{"class":242},"Favorite chat style: Humorous, Warm, Casual\n",[178,1717,1718],{"class":180,"line":410},[178,1719,1720],{"class":242},"Types of help wanted from AI: Advice, Information queries, Inspiration\n",[178,1722,1723],{"class":180,"line":449},[178,1724,1725],{"class":242},"Topics I’m most interested in: AI, Future technologies, Film reviews\n",[178,1727,1728],{"class":180,"line":487},[178,1729,1730],{"class":242},"What I want AI to help with: Daily study planning, Movie & book recommendations, Providing emotional companionship\n",[178,1732,1733],{"class":180,"line":526},[178,1734,1735],{"class":228},"      \"\"\"\n",[178,1737,1738],{"class":180,"line":532},[178,1739,1046],{"class":228},[178,1741,1742],{"class":180,"line":538},[178,1743,960],{"class":228},[25,1745],{},[25,1747],{},[775,1749,1751],{"id":1750},"adding-messages-with-memory-filters","Adding Messages with Memory Filters",[14,1753,1754,1755,1759],{},"MemOS supports recalling memories from specified ranges based on your needs. When adding messages, use the following fields to tag generated memories, so you can filter with ",[20,1756,1758],{"href":1757},"\u002Fmemos_cloud\u002Ffeatures\u002Fbasic\u002Ffilters","Memory Filter"," at retrieval time.",[1761,1762,1763],"ol",{},[48,1764,1765],{},[17,1766,1767],{},"Same User Talking to Multiple Agents (Across Multiple Apps)",[14,1769,1770,1771,1774,1775,1778],{},"Add fields like ",[106,1772,1773],{},"agent_id",", ",[106,1776,1777],{},"app_id"," when adding a message, to mark which agent\u002Fapp this dialog is associated with. This distinguishes memories of \"the same user under different agents\u002Fapps\".",[169,1780,1782],{"className":171,"code":1781,"language":173,"meta":174,"style":174},"data = {\n  \"user_id\": \"memos_user_123\",\n  \"agent_id\":\"health_assistant\", # The agent of the current conversation, provided by the developer\n  \"conversation_id\": 610,\n  \"messages\":[\n    {\"role\": \"user\", \"content\": \"I ran 5 kilometers this morning, my knees feel a bit sore\"}, \n    {\"role\": \"assistant\", \"content\": \"You ran 5km this morning and feel a bit sore, which shows your joints and muscles are still adapting to the exercise. Tomorrow, limit the distance to about 3km, focus on warming up and relaxation. This keeps up your training rhythm and allows time for knee recovery.\"}\n  ]\n}\n\n# Later, you can use \"agent_id\":\"health_assistant\" to retrieve memories of chats with this agent.\n",[106,1783,1784,1792,1810,1832,1847,1858,1896,1933,1938,1942,1946],{"__ignoreMap":174},[178,1785,1786,1788,1790],{"class":180,"line":181},[178,1787,300],{"class":188},[178,1789,303],{"class":228},[178,1791,306],{"class":228},[178,1793,1794,1796,1798,1800,1802,1804,1806,1808],{"class":180,"line":192},[178,1795,551],{"class":228},[178,1797,108],{"class":242},[178,1799,239],{"class":228},[178,1801,319],{"class":228},[178,1803,254],{"class":228},[178,1805,324],{"class":242},[178,1807,239],{"class":228},[178,1809,329],{"class":228},[178,1811,1812,1814,1816,1818,1820,1822,1825,1827,1829],{"class":180,"line":200},[178,1813,551],{"class":228},[178,1815,1773],{"class":242},[178,1817,239],{"class":228},[178,1819,319],{"class":228},[178,1821,239],{"class":228},[178,1823,1824],{"class":242},"health_assistant",[178,1826,239],{"class":228},[178,1828,388],{"class":228},[178,1830,1831],{"class":218}," # The agent of the current conversation, provided by the developer\n",[178,1833,1834,1836,1838,1840,1842,1845],{"class":180,"line":208},[178,1835,551],{"class":228},[178,1837,118],{"class":242},[178,1839,239],{"class":228},[178,1841,319],{"class":228},[178,1843,1844],{"class":589}," 610",[178,1846,329],{"class":228},[178,1848,1849,1851,1853,1855],{"class":180,"line":215},[178,1850,551],{"class":228},[178,1852,127],{"class":242},[178,1854,239],{"class":228},[178,1856,1857],{"class":228},":[\n",[178,1859,1860,1862,1864,1866,1868,1870,1872,1874,1876,1878,1880,1882,1884,1886,1888,1890,1892,1894],{"class":180,"line":222},[178,1861,1383],{"class":228},[178,1863,239],{"class":228},[178,1865,374],{"class":242},[178,1867,239],{"class":228},[178,1869,319],{"class":228},[178,1871,254],{"class":228},[178,1873,383],{"class":242},[178,1875,239],{"class":228},[178,1877,388],{"class":228},[178,1879,254],{"class":228},[178,1881,393],{"class":242},[178,1883,239],{"class":228},[178,1885,319],{"class":228},[178,1887,254],{"class":228},[178,1889,1293],{"class":242},[178,1891,239],{"class":228},[178,1893,1298],{"class":228},[178,1895,1162],{"class":188},[178,1897,1898,1900,1902,1904,1906,1908,1910,1912,1914,1916,1918,1920,1922,1924,1926,1929,1931],{"class":180,"line":263},[178,1899,1383],{"class":228},[178,1901,239],{"class":228},[178,1903,374],{"class":242},[178,1905,239],{"class":228},[178,1907,319],{"class":228},[178,1909,254],{"class":228},[178,1911,425],{"class":242},[178,1913,239],{"class":228},[178,1915,388],{"class":228},[178,1917,254],{"class":228},[178,1919,393],{"class":242},[178,1921,239],{"class":228},[178,1923,319],{"class":228},[178,1925,254],{"class":228},[178,1927,1928],{"class":242},"You ran 5km this morning and feel a bit sore, which shows your joints and muscles are still adapting to the exercise. Tomorrow, limit the distance to about 3km, focus on warming up and relaxation. This keeps up your training rhythm and allows time for knee recovery.",[178,1930,239],{"class":228},[178,1932,523],{"class":228},[178,1934,1935],{"class":180,"line":292},[178,1936,1937],{"class":228},"  ]\n",[178,1939,1940],{"class":180,"line":297},[178,1941,523],{"class":228},[178,1943,1944],{"class":180,"line":309},[178,1945,212],{"emptyLinePlaceholder":211},[178,1947,1948],{"class":180,"line":332},[178,1949,1950],{"class":218},"# Later, you can use \"agent_id\":\"health_assistant\" to retrieve memories of chats with this agent.\n",[25,1952],{},[1761,1954,1955],{"start":192},[48,1956,1957],{},[17,1958,1959],{},"Semantic Classification with Your Own Tagging System",[14,1961,1962,1963,1966],{},"MemOS auto-generates tags for every memory, but you might want to use your own business tags. Add custom ",[106,1964,1965],{},"tags"," when adding messages, and MemOS will apply those labels to content as well.",[169,1968,1970],{"className":171,"code":1969,"language":173,"meta":174,"style":174},"data = {\n  \"user_id\": \"memos_user_123\",\n  \"conversation_id\": 610,\n  \"tags\":[\"Exercise Advice\", \"Fitness Plan\", \"Workout Record\"], # Your custom topic classification tags\n  \"messages\":[\n    {\"role\": \"user\", \"content\": \"I ran 5 kilometers this morning, my knees feel a bit sore\"}, \n    {\"role\": \"assistant\", \"content\": \"You ran 5km this morning and feel a bit sore, which shows your joints and muscles are still adapting. Tomorrow, limit to 3km, with focus on warm-up and relaxation.\"}\n  ]\n}\n\n# Later, you can pass \"tags\":\"Exercise Advice\" to retrieve memories on workout suggestions.\n",[106,1971,1972,1980,1998,2012,2054,2064,2102,2139,2143,2147,2151],{"__ignoreMap":174},[178,1973,1974,1976,1978],{"class":180,"line":181},[178,1975,300],{"class":188},[178,1977,303],{"class":228},[178,1979,306],{"class":228},[178,1981,1982,1984,1986,1988,1990,1992,1994,1996],{"class":180,"line":192},[178,1983,551],{"class":228},[178,1985,108],{"class":242},[178,1987,239],{"class":228},[178,1989,319],{"class":228},[178,1991,254],{"class":228},[178,1993,324],{"class":242},[178,1995,239],{"class":228},[178,1997,329],{"class":228},[178,1999,2000,2002,2004,2006,2008,2010],{"class":180,"line":200},[178,2001,551],{"class":228},[178,2003,118],{"class":242},[178,2005,239],{"class":228},[178,2007,319],{"class":228},[178,2009,1844],{"class":589},[178,2011,329],{"class":228},[178,2013,2014,2016,2018,2020,2023,2025,2028,2030,2032,2034,2037,2039,2041,2043,2046,2048,2051],{"class":180,"line":208},[178,2015,551],{"class":228},[178,2017,1965],{"class":242},[178,2019,239],{"class":228},[178,2021,2022],{"class":228},":[",[178,2024,239],{"class":228},[178,2026,2027],{"class":242},"Exercise Advice",[178,2029,239],{"class":228},[178,2031,388],{"class":228},[178,2033,254],{"class":228},[178,2035,2036],{"class":242},"Fitness Plan",[178,2038,239],{"class":228},[178,2040,388],{"class":228},[178,2042,254],{"class":228},[178,2044,2045],{"class":242},"Workout Record",[178,2047,239],{"class":228},[178,2049,2050],{"class":228},"],",[178,2052,2053],{"class":218}," # Your custom topic classification tags\n",[178,2055,2056,2058,2060,2062],{"class":180,"line":215},[178,2057,551],{"class":228},[178,2059,127],{"class":242},[178,2061,239],{"class":228},[178,2063,1857],{"class":228},[178,2065,2066,2068,2070,2072,2074,2076,2078,2080,2082,2084,2086,2088,2090,2092,2094,2096,2098,2100],{"class":180,"line":222},[178,2067,1383],{"class":228},[178,2069,239],{"class":228},[178,2071,374],{"class":242},[178,2073,239],{"class":228},[178,2075,319],{"class":228},[178,2077,254],{"class":228},[178,2079,383],{"class":242},[178,2081,239],{"class":228},[178,2083,388],{"class":228},[178,2085,254],{"class":228},[178,2087,393],{"class":242},[178,2089,239],{"class":228},[178,2091,319],{"class":228},[178,2093,254],{"class":228},[178,2095,1293],{"class":242},[178,2097,239],{"class":228},[178,2099,1298],{"class":228},[178,2101,1162],{"class":188},[178,2103,2104,2106,2108,2110,2112,2114,2116,2118,2120,2122,2124,2126,2128,2130,2132,2135,2137],{"class":180,"line":263},[178,2105,1383],{"class":228},[178,2107,239],{"class":228},[178,2109,374],{"class":242},[178,2111,239],{"class":228},[178,2113,319],{"class":228},[178,2115,254],{"class":228},[178,2117,425],{"class":242},[178,2119,239],{"class":228},[178,2121,388],{"class":228},[178,2123,254],{"class":228},[178,2125,393],{"class":242},[178,2127,239],{"class":228},[178,2129,319],{"class":228},[178,2131,254],{"class":228},[178,2133,2134],{"class":242},"You ran 5km this morning and feel a bit sore, which shows your joints and muscles are still adapting. Tomorrow, limit to 3km, with focus on warm-up and relaxation.",[178,2136,239],{"class":228},[178,2138,523],{"class":228},[178,2140,2141],{"class":180,"line":292},[178,2142,1937],{"class":228},[178,2144,2145],{"class":180,"line":297},[178,2146,523],{"class":228},[178,2148,2149],{"class":180,"line":309},[178,2150,212],{"emptyLinePlaceholder":211},[178,2152,2153],{"class":180,"line":332},[178,2154,2155],{"class":218},"# Later, you can pass \"tags\":\"Exercise Advice\" to retrieve memories on workout suggestions.\n",[67,2157,2158],{},[14,2159,2160,2161],{},"Want to know more? See ",[20,2162,2164],{"href":2163},"\u002Fmemos_cloud\u002Ffeatures\u002Fbasic\u002Fcustom_tags","Custom Tagging",[25,2166],{},[1761,2168,2169],{"start":200},[48,2170,2171],{},[17,2172,2173],{},"Precise Filtering with Business Information",[14,2175,2176,2177,2180,2181,2184],{},"Add ",[106,2178,2179],{},"info"," with structured business fields or other custom information (like ",[106,2182,2183],{},"scene=order","), to precisely distinguish current scene, business line, source, status, etc.",[169,2186,2188],{"className":171,"code":2187,"language":173,"meta":174,"style":174},"data = {\n  \"user_id\": \"memos_user_123\",\n  \"conversation_id\": 610,\n  \"messages\":[\n    {\"role\": \"user\", \"content\": \"Help me find flights with proper timing\"}, \n    {\"role\": \"assistant\", \"content\": \"I found several flights that fit your time:\\n1. Beijing → Shanghai, Feb 15, 08:30–12:30\\n2. Beijing → Shanghai, Feb 15, 14:00–18:00\\n3. Beijing → Shanghai, Feb 16, 09:00–13:00\\nWhich would you like to book, or do you want me to filter by other options?\"}\n  ],\n  \"info\":{\n    \"scene\":\"flight_ticket\"\n  }\n}\n\n# Later, you can use \"info\":{\"scene\":\"flight_ticket\"} to retrieve flight-purchase related memories.\n",[106,2189,2190,2198,2216,2230,2240,2279,2337,2342,2353,2371,2375,2379,2383],{"__ignoreMap":174},[178,2191,2192,2194,2196],{"class":180,"line":181},[178,2193,300],{"class":188},[178,2195,303],{"class":228},[178,2197,306],{"class":228},[178,2199,2200,2202,2204,2206,2208,2210,2212,2214],{"class":180,"line":192},[178,2201,551],{"class":228},[178,2203,108],{"class":242},[178,2205,239],{"class":228},[178,2207,319],{"class":228},[178,2209,254],{"class":228},[178,2211,324],{"class":242},[178,2213,239],{"class":228},[178,2215,329],{"class":228},[178,2217,2218,2220,2222,2224,2226,2228],{"class":180,"line":200},[178,2219,551],{"class":228},[178,2221,118],{"class":242},[178,2223,239],{"class":228},[178,2225,319],{"class":228},[178,2227,1844],{"class":589},[178,2229,329],{"class":228},[178,2231,2232,2234,2236,2238],{"class":180,"line":208},[178,2233,551],{"class":228},[178,2235,127],{"class":242},[178,2237,239],{"class":228},[178,2239,1857],{"class":228},[178,2241,2242,2244,2246,2248,2250,2252,2254,2256,2258,2260,2262,2264,2266,2268,2270,2273,2275,2277],{"class":180,"line":215},[178,2243,1383],{"class":228},[178,2245,239],{"class":228},[178,2247,374],{"class":242},[178,2249,239],{"class":228},[178,2251,319],{"class":228},[178,2253,254],{"class":228},[178,2255,383],{"class":242},[178,2257,239],{"class":228},[178,2259,388],{"class":228},[178,2261,254],{"class":228},[178,2263,393],{"class":242},[178,2265,239],{"class":228},[178,2267,319],{"class":228},[178,2269,254],{"class":228},[178,2271,2272],{"class":242},"Help me find flights with proper timing",[178,2274,239],{"class":228},[178,2276,1298],{"class":228},[178,2278,1162],{"class":188},[178,2280,2281,2283,2285,2287,2289,2291,2293,2295,2297,2299,2301,2303,2305,2307,2309,2312,2315,2318,2320,2323,2325,2328,2330,2333,2335],{"class":180,"line":222},[178,2282,1383],{"class":228},[178,2284,239],{"class":228},[178,2286,374],{"class":242},[178,2288,239],{"class":228},[178,2290,319],{"class":228},[178,2292,254],{"class":228},[178,2294,425],{"class":242},[178,2296,239],{"class":228},[178,2298,388],{"class":228},[178,2300,254],{"class":228},[178,2302,393],{"class":242},[178,2304,239],{"class":228},[178,2306,319],{"class":228},[178,2308,254],{"class":228},[178,2310,2311],{"class":242},"I found several flights that fit your time:",[178,2313,2314],{"class":188},"\\n",[178,2316,2317],{"class":242},"1. Beijing → Shanghai, Feb 15, 08:30–12:30",[178,2319,2314],{"class":188},[178,2321,2322],{"class":242},"2. Beijing → Shanghai, Feb 15, 14:00–18:00",[178,2324,2314],{"class":188},[178,2326,2327],{"class":242},"3. Beijing → Shanghai, Feb 16, 09:00–13:00",[178,2329,2314],{"class":188},[178,2331,2332],{"class":242},"Which would you like to book, or do you want me to filter by other options?",[178,2334,239],{"class":228},[178,2336,523],{"class":228},[178,2338,2339],{"class":180,"line":263},[178,2340,2341],{"class":228},"  ],\n",[178,2343,2344,2346,2348,2350],{"class":180,"line":292},[178,2345,551],{"class":228},[178,2347,2179],{"class":242},[178,2349,239],{"class":228},[178,2351,2352],{"class":228},":{\n",[178,2354,2355,2357,2360,2362,2364,2366,2369],{"class":180,"line":297},[178,2356,312],{"class":228},[178,2358,2359],{"class":242},"scene",[178,2361,239],{"class":228},[178,2363,319],{"class":228},[178,2365,239],{"class":228},[178,2367,2368],{"class":242},"flight_ticket",[178,2370,260],{"class":228},[178,2372,2373],{"class":180,"line":309},[178,2374,535],{"class":228},[178,2376,2377],{"class":180,"line":332},[178,2378,523],{"class":228},[178,2380,2381],{"class":180,"line":352},[178,2382,212],{"emptyLinePlaceholder":211},[178,2384,2385],{"class":180,"line":366},[178,2386,2387],{"class":218},"# Later, you can use \"info\":{\"scene\":\"flight_ticket\"} to retrieve flight-purchase related memories.\n",[25,2389],{},[14,2391,2392],{},[17,2393,2394],{},"Usage Tips",[14,2396,2397,2399],{},[106,2398,2179],{}," supports any custom key-value pairs; all fields are stored and can be retrieved as filters.",[14,2401,2402],{},"The following fields have optimized query performance (because they are indexed):",[45,2404,2405,2408,2411,2414],{},[48,2406,2407],{},"business_type (business type)",[48,2409,2410],{},"biz_id (business unique identifier)",[48,2412,2413],{},"scene (business or conversation scenario)",[48,2415,2416],{},"custom_status (custom status)",[14,2418,2419],{},"You are not required to use these fields. Other custom fields will function the same, though query performance may vary.",[67,2421,2422],{},[14,2423,2424,2425,2427],{},"Note: ",[106,2426,2179],{}," should be a flat key-value object, with both key and value as strings (for query filtering); non-string values should be converted to a string before passing in.",[25,2429],{},[25,2431],{},[37,2433,2435],{"id":2434},"_6-more-features","6. More Features",[67,2437,2438],{},[14,2439,2440,2441,229],{},"For the complete list of API fields, formats, and details, see the ",[20,2442,2443],{"href":22},"Add Message API documentation",[2445,2446,2447,2469],"table",{},[2448,2449,2450],"thead",{},[2451,2452,2453,2459,2464],"tr",{},[2454,2455,2456],"th",{},[17,2457,2458],{},"Function",[2454,2460,2461],{},[17,2462,2463],{},"Field",[2454,2465,2466],{},[17,2467,2468],{},"Description",[2470,2471,2472,2507,2523,2536],"tbody",{},[2451,2473,2474,2478,2482],{},[2475,2476,2477],"td",{},"Multimodal Messages",[2475,2479,2480],{},[106,2481,127],{},[2475,2483,2484,2485,2487,2488,2490,2491,2493,2494,2496,2497,229,2500,2502,2503,229],{},"Message list to add.",[25,2486],{},"Supported roles: user \u002F assistant \u002F system \u002F tool;",[25,2489],{},"Supported message types:",[25,2492],{},"• Text",[25,2495],{},"• Documents, Images, see ",[20,2498,2477],{"href":2499},"\u002Fmemos_cloud\u002Ffeatures\u002Fbasic\u002Fmultimodal",[25,2501],{},"• Tool call info, see ",[20,2504,2506],{"href":2505},"\u002Fmemos_cloud\u002Ffeatures\u002Fadvanced\u002Ftool_calling","Tool Calling",[2451,2508,2509,2512,2517],{},[2475,2510,2511],{},"Async Mode",[2475,2513,2514],{},[106,2515,2516],{},"async_mode",[2475,2518,2519,2520,229],{},"Controls post-message-addition processing. Supports both async and sync modes; details in ",[20,2521,2511],{"href":2522},"\u002Fmemos_cloud\u002Ffeatures\u002Fbasic\u002Fasync_mode",[2451,2524,2525,2528,2533],{},[2475,2526,2527],{},"Write to Public Memory",[2475,2529,2530],{},[106,2531,2532],{},"allow_public",[2475,2534,2535],{},"Controls whether memories from this user's messages are written to project-level shared memory (available to all users under the project). Off by default.",[2451,2537,2538,2541,2546],{},[2475,2539,2540],{},"Write to Knowledge Base Memory",[2475,2542,2543],{},[106,2544,2545],{},"allow_knowledgebase_ids",[2475,2547,2548,2549,229],{},"Controls whether memories are written to specified knowledge bases associated with the project (available to all with KB access). Default is empty array; pass your target KBs as needed. See ",[20,2550,2552],{"href":2551},"\u002Fmemos_cloud\u002Ffeatures\u002Fadvanced\u002Fknowledge_base","Knowledge Base",[2554,2555,2556],"style",{},"html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sHdIc, html code.shiki .sHdIc{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#EEFFFF;--shiki-default-font-style:italic;--shiki-dark:#BABED8;--shiki-dark-font-style:italic}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":174,"searchDepth":192,"depth":192,"links":2558},[2559,2560,2561,2562,2563,2569],{"id":39,"depth":192,"text":40},{"id":96,"depth":192,"text":97},{"id":133,"depth":192,"text":134},{"id":166,"depth":192,"text":167},{"id":772,"depth":192,"text":773,"children":2564},[2565,2566,2567,2568],{"id":777,"depth":200,"text":778},{"id":1347,"depth":200,"text":1348},{"id":1612,"depth":200,"text":1613},{"id":1750,"depth":200,"text":1751},{"id":2434,"depth":192,"text":2435},"MemOS will automatically process the multimodal content you add—such as text, files, images—into personal, retrievable memories.","md",{},"\u002Fen\u002Fmemos_cloud\u002Fmem_operations\u002Fadd_message",{"title":5,"description":174},"en\u002Fmemos_cloud\u002Fmem_operations\u002Fadd_message","3RbLhpIa4tNjxaOXJAmoG3JjqTjNxgmfxOEjSRSh5tY",[2578,2586],{"title":2579,"path":2580,"stem":2581,"icon":2582,"framework":6,"module":6,"class":2583,"target":-1,"active":2584,"defaultOpen":2584,"children":-1,"description":2585},"FAQs","\u002Fmemos_cloud\u002Ffaq","memos_cloud\u002Ffaq","i-ri-question-line",[],false,"We have compiled the most common questions about using MemOS. No need to search around; you can quickly find the answers here.",{"title":767,"path":764,"stem":2587,"icon":2588,"framework":6,"module":6,"class":2589,"target":-1,"active":2584,"defaultOpen":2584,"children":-1,"description":2590},"memos_cloud\u002Fmem_operations\u002Fsearch_memory","i-ri-search-2-line",[],"MemOS recalls relevant memories through semantic retrieval and filtering capabilities.",1775811152582]