[{"data":1,"prerenderedAt":3685},["ShallowReactive",2],{"/memos_cloud/mem_operations/search_memory":3,"surround-/memos_cloud/mem_operations/search_memory":3671},{"id":4,"title":5,"avatar":6,"banner":6,"body":7,"category":6,"desc":3664,"description":142,"extension":3665,"links":6,"meta":3666,"navigation":6,"path":3667,"seo":3668,"stem":3669,"__hash__":3670},"docs/en/memos_cloud/mem_operations/search_memory.md","Search Memory",null,{"type":8,"value":9,"toc":3651},"minimark",[10,34,36,41,44,66,68,72,86,88,92,118,126,128,132,845,853,855,859,871,879,881,885,890,893,900,911,1909,1911,1915,1920,1927,2783,2785,2789,2792,2795,3529,3536,3538,3542,3550,3647],[11,12,13,29],"warning",{},[14,15,16,24,27],"p",{},[17,18,19],"strong",{},[20,21,23],"a",{"href":22},"/api_docs/core/search_memory","Go directly to API Docs",[25,26],"br",{},[25,28],{},[14,30,31],{},[17,32,33],{},"This article focuses on functional explanation. For detailed interface fields and limits, please click the link above.",[25,35],{},[37,38,40],"h2",{"id":39},"_1-what-is-search-memory","1. What is Search Memory?",[14,42,43],{},"Search Memory refers to MemOS recalling the most relevant and important memory content from the memory store based on developer-defined filtering conditions when a user asks a question. When generating an answer, the model will refer to these recalled memories to provide a more accurate, appropriate response that fits the user's context.",[45,46,47,52],"note",{},[14,48,49],{},[17,50,51],{}," Why do we need Search Memory?",[53,54,56],"div",{"style":55},"padding-left: 2em;",[57,58,59,63],"ul",{},[60,61,62],"li",{},"No need to build context from scratch, directly obtain correct and reliable memories;",[60,64,65],{},"Ensure that recalled memories are always highly relevant to the current question through filtering conditions, etc.",[25,67],{},[37,69,71],{"id":70},"_2-key-parameters","2. Key Parameters",[57,73,74,80],{},[60,75,76,79],{},[17,77,78],{},"Query Content (query)",": Natural language questions or statements used for retrieval. The system will match relevant memories based on semantics.",[60,81,82,85],{},[17,83,84],{},"Memory Filter (filter)",": JSON-based logical conditions used to narrow down the retrieval scope by entity, time, tag, meta information, etc.",[25,87],{},[37,89,91],{"id":90},"_3-working-principle","3. Working Principle",[57,93,94,100,106,112],{},[60,95,96,99],{},[17,97,98],{},"Query Rewrite",": MemOS cleans and semantically enhances the input natural language query to improve the accuracy of subsequent retrieval.",[60,101,102,105],{},[17,103,104],{},"Memory Filter",": Combines logical and comparison operators to filter memories and narrow down the scope of memory recall.",[60,107,108,111],{},[17,109,110],{},"Memory Retrieval",": Generates embeddings based on the rewritten query and matches the user's most relevant memory content through similarity.",[60,113,114,117],{},[17,115,116],{},"Output Memory",": The final filtered memory results will be responded to and returned to you within one second for subsequent reasoning and answer generation.",[14,119,120,121,125],{},"All the above processes can be triggered by simply calling the ",[122,123,124],"code",{},"search/memory"," interface, without the need for you to manually operate on user memories.",[25,127],{},[37,129,131],{"id":130},"_4-quick-start","4. Quick Start",[133,134,135,569],"code-group",{},[136,137,143],"pre",{"className":138,"code":139,"filename":140,"language":141,"meta":142,"style":142},"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://api.memt.ai/openmem/v1\"\n\ndata = {\n  \"query\": \"I want to go on a trip during the National Day holiday. Help me recommend a city I haven't been to and a hotel brand I haven't stayed at.\",\n  \"user_id\": \"memos_user_123\",\n  \"conversation_id\": \"0928\" # Optional. If filled, we will prioritize content in this conversation when recalling memories, but it is not a forced hit, only increasing relevance weight.\n}\nheaders = {\n  \"Content-Type\": \"application/json\",\n  \"Authorization\": f\"Token {os.environ['MEMOS_API_KEY']}\"\n}\nurl = f\"{os.environ['MEMOS_BASE_URL']}/search/memory\"\n\nres = requests.post(url=url, headers=headers, data=json.dumps(data))\n\nprint(f\"result: {res.json()}\")\n","Python (HTTP)","python","",[122,144,145,158,166,174,181,188,229,258,263,275,299,320,342,348,358,379,424,429,464,469,531,536],{"__ignoreMap":142},[146,147,150,154],"span",{"class":148,"line":149},"line",1,[146,151,153],{"class":152},"s7zQu","import",[146,155,157],{"class":156},"sTEyZ"," os\n",[146,159,161,163],{"class":148,"line":160},2,[146,162,153],{"class":152},[146,164,165],{"class":156}," requests\n",[146,167,169,171],{"class":148,"line":168},3,[146,170,153],{"class":152},[146,172,173],{"class":156}," json\n",[146,175,177],{"class":148,"line":176},4,[146,178,180],{"emptyLinePlaceholder":179},true,"\n",[146,182,184],{"class":148,"line":183},5,[146,185,187],{"class":186},"sHwdD","# Replace with your MemOS API Key\n",[146,189,191,194,198,202,205,208,212,214,217,220,223,226],{"class":148,"line":190},6,[146,192,193],{"class":156},"os",[146,195,197],{"class":196},"sMK4o",".",[146,199,201],{"class":200},"swJcz","environ",[146,203,204],{"class":196},"[",[146,206,207],{"class":196},"\"",[146,209,211],{"class":210},"sfazB","MEMOS_API_KEY",[146,213,207],{"class":196},[146,215,216],{"class":196},"]",[146,218,219],{"class":196}," =",[146,221,222],{"class":196}," \"",[146,224,225],{"class":210},"YOUR_API_KEY",[146,227,228],{"class":196},"\"\n",[146,230,232,234,236,238,240,242,245,247,249,251,253,256],{"class":148,"line":231},7,[146,233,193],{"class":156},[146,235,197],{"class":196},[146,237,201],{"class":200},[146,239,204],{"class":196},[146,241,207],{"class":196},[146,243,244],{"class":210},"MEMOS_BASE_URL",[146,246,207],{"class":196},[146,248,216],{"class":196},[146,250,219],{"class":196},[146,252,222],{"class":196},[146,254,255],{"class":210},"https://api.memt.ai/openmem/v1",[146,257,228],{"class":196},[146,259,261],{"class":148,"line":260},8,[146,262,180],{"emptyLinePlaceholder":179},[146,264,266,269,272],{"class":148,"line":265},9,[146,267,268],{"class":156},"data ",[146,270,271],{"class":196},"=",[146,273,274],{"class":196}," {\n",[146,276,278,281,284,286,289,291,294,296],{"class":148,"line":277},10,[146,279,280],{"class":196},"  \"",[146,282,283],{"class":210},"query",[146,285,207],{"class":196},[146,287,288],{"class":196},":",[146,290,222],{"class":196},[146,292,293],{"class":210},"I want to go on a trip during the National Day holiday. Help me recommend a city I haven't been to and a hotel brand I haven't stayed at.",[146,295,207],{"class":196},[146,297,298],{"class":196},",\n",[146,300,302,304,307,309,311,313,316,318],{"class":148,"line":301},11,[146,303,280],{"class":196},[146,305,306],{"class":210},"user_id",[146,308,207],{"class":196},[146,310,288],{"class":196},[146,312,222],{"class":196},[146,314,315],{"class":210},"memos_user_123",[146,317,207],{"class":196},[146,319,298],{"class":196},[146,321,323,325,328,330,332,334,337,339],{"class":148,"line":322},12,[146,324,280],{"class":196},[146,326,327],{"class":210},"conversation_id",[146,329,207],{"class":196},[146,331,288],{"class":196},[146,333,222],{"class":196},[146,335,336],{"class":210},"0928",[146,338,207],{"class":196},[146,340,341],{"class":186}," # Optional. If filled, we will prioritize content in this conversation when recalling memories, but it is not a forced hit, only increasing relevance weight.\n",[146,343,345],{"class":148,"line":344},13,[146,346,347],{"class":196},"}\n",[146,349,351,354,356],{"class":148,"line":350},14,[146,352,353],{"class":156},"headers ",[146,355,271],{"class":196},[146,357,274],{"class":196},[146,359,361,363,366,368,370,372,375,377],{"class":148,"line":360},15,[146,362,280],{"class":196},[146,364,365],{"class":210},"Content-Type",[146,367,207],{"class":196},[146,369,288],{"class":196},[146,371,222],{"class":196},[146,373,374],{"class":210},"application/json",[146,376,207],{"class":196},[146,378,298],{"class":196},[146,380,382,384,387,389,391,395,398,402,404,406,408,410,413,415,417,419,422],{"class":148,"line":381},16,[146,383,280],{"class":196},[146,385,386],{"class":210},"Authorization",[146,388,207],{"class":196},[146,390,288],{"class":196},[146,392,394],{"class":393},"spNyl"," f",[146,396,397],{"class":210},"\"Token ",[146,399,401],{"class":400},"sbssI","{",[146,403,193],{"class":156},[146,405,197],{"class":196},[146,407,201],{"class":200},[146,409,204],{"class":196},[146,411,412],{"class":196},"'",[146,414,211],{"class":210},[146,416,412],{"class":196},[146,418,216],{"class":196},[146,420,421],{"class":400},"}",[146,423,228],{"class":210},[146,425,427],{"class":148,"line":426},17,[146,428,347],{"class":196},[146,430,432,435,437,439,441,443,445,447,449,451,453,455,457,459,461],{"class":148,"line":431},18,[146,433,434],{"class":156},"url ",[146,436,271],{"class":196},[146,438,394],{"class":393},[146,440,207],{"class":210},[146,442,401],{"class":400},[146,444,193],{"class":156},[146,446,197],{"class":196},[146,448,201],{"class":200},[146,450,204],{"class":196},[146,452,412],{"class":196},[146,454,244],{"class":210},[146,456,412],{"class":196},[146,458,216],{"class":196},[146,460,421],{"class":400},[146,462,463],{"class":210},"/search/memory\"\n",[146,465,467],{"class":148,"line":466},19,[146,468,180],{"emptyLinePlaceholder":179},[146,470,472,475,477,480,482,486,489,493,495,497,500,503,505,508,510,513,515,518,520,523,525,528],{"class":148,"line":471},20,[146,473,474],{"class":156},"res ",[146,476,271],{"class":196},[146,478,479],{"class":156}," requests",[146,481,197],{"class":196},[146,483,485],{"class":484},"s2Zo4","post",[146,487,488],{"class":196},"(",[146,490,492],{"class":491},"sHdIc","url",[146,494,271],{"class":196},[146,496,492],{"class":484},[146,498,499],{"class":196},",",[146,501,502],{"class":491}," headers",[146,504,271],{"class":196},[146,506,507],{"class":484},"headers",[146,509,499],{"class":196},[146,511,512],{"class":491}," data",[146,514,271],{"class":196},[146,516,517],{"class":484},"json",[146,519,197],{"class":196},[146,521,522],{"class":484},"dumps",[146,524,488],{"class":196},[146,526,527],{"class":484},"data",[146,529,530],{"class":196},"))\n",[146,532,534],{"class":148,"line":533},21,[146,535,180],{"emptyLinePlaceholder":179},[146,537,539,542,544,547,550,552,555,557,559,562,564,566],{"class":148,"line":538},22,[146,540,541],{"class":484},"print",[146,543,488],{"class":196},[146,545,546],{"class":393},"f",[146,548,549],{"class":210},"\"result: ",[146,551,401],{"class":400},[146,553,554],{"class":484},"res",[146,556,197],{"class":196},[146,558,517],{"class":484},[146,560,561],{"class":196},"()",[146,563,421],{"class":400},[146,565,207],{"class":210},[146,567,568],{"class":196},")\n",[136,570,573],{"className":138,"code":571,"filename":572,"language":141,"meta":142,"style":142},"# Example Output (Simplified for easier understanding, for reference only)\n\n# Preference type memories\npreference_detail_list [\n    {\n      \"preference_type\": \"implicit_preference\",  # Implicit preference\n      \"preference\": \"User may prefer high cost-performance hotel choices.\",\n      \"reasoning\": \"7 Days Inn is usually known for being affordable. The user's choice of 7 Days Inn may indicate a tendency to choose cost-effective options for accommodation. Although the user did not explicitly mention budget constraints or specific hotel preferences, choosing 7 Days among the provided options may reflect an emphasis on price and practicality.\",\n      \"conversation_id\": \"0610\"\n    }\n  ]\n\n# Fact type memories\nmemory_detail_list [\n    {\n      \"memory_key\": \"Summer Guangzhou Travel Plan\",\n      \"memory_value\": \"User plans to travel to Guangzhou during the summer vacation and chose 7 Days Inn as accommodation.\",\n      \"conversation_id\": \"0610\",\n      \"tags\": [\n        \"Travel\",\n        \"Guangzhou\",\n        \"Accommodation\",\n        \"Hotel\"\n      ]\n    }\n  ]\n","Output",[122,574,575,580,584,589,597,602,626,646,666,683,688,693,697,702,709,713,733,753,771,785,797,808,819,829,835,840],{"__ignoreMap":142},[146,576,577],{"class":148,"line":149},[146,578,579],{"class":186},"# Example Output (Simplified for easier understanding, for reference only)\n",[146,581,582],{"class":148,"line":160},[146,583,180],{"emptyLinePlaceholder":179},[146,585,586],{"class":148,"line":168},[146,587,588],{"class":186},"# Preference type memories\n",[146,590,591,594],{"class":148,"line":176},[146,592,593],{"class":156},"preference_detail_list ",[146,595,596],{"class":196},"[\n",[146,598,599],{"class":148,"line":183},[146,600,601],{"class":196},"    {\n",[146,603,604,607,610,612,614,616,619,621,623],{"class":148,"line":190},[146,605,606],{"class":196},"      \"",[146,608,609],{"class":210},"preference_type",[146,611,207],{"class":196},[146,613,288],{"class":196},[146,615,222],{"class":196},[146,617,618],{"class":210},"implicit_preference",[146,620,207],{"class":196},[146,622,499],{"class":196},[146,624,625],{"class":186},"  # Implicit preference\n",[146,627,628,630,633,635,637,639,642,644],{"class":148,"line":231},[146,629,606],{"class":196},[146,631,632],{"class":210},"preference",[146,634,207],{"class":196},[146,636,288],{"class":196},[146,638,222],{"class":196},[146,640,641],{"class":210},"User may prefer high cost-performance hotel choices.",[146,643,207],{"class":196},[146,645,298],{"class":196},[146,647,648,650,653,655,657,659,662,664],{"class":148,"line":260},[146,649,606],{"class":196},[146,651,652],{"class":210},"reasoning",[146,654,207],{"class":196},[146,656,288],{"class":196},[146,658,222],{"class":196},[146,660,661],{"class":210},"7 Days Inn is usually known for being affordable. The user's choice of 7 Days Inn may indicate a tendency to choose cost-effective options for accommodation. Although the user did not explicitly mention budget constraints or specific hotel preferences, choosing 7 Days among the provided options may reflect an emphasis on price and practicality.",[146,663,207],{"class":196},[146,665,298],{"class":196},[146,667,668,670,672,674,676,678,681],{"class":148,"line":265},[146,669,606],{"class":196},[146,671,327],{"class":210},[146,673,207],{"class":196},[146,675,288],{"class":196},[146,677,222],{"class":196},[146,679,680],{"class":210},"0610",[146,682,228],{"class":196},[146,684,685],{"class":148,"line":277},[146,686,687],{"class":196},"    }\n",[146,689,690],{"class":148,"line":301},[146,691,692],{"class":196},"  ]\n",[146,694,695],{"class":148,"line":322},[146,696,180],{"emptyLinePlaceholder":179},[146,698,699],{"class":148,"line":344},[146,700,701],{"class":186},"# Fact type memories\n",[146,703,704,707],{"class":148,"line":350},[146,705,706],{"class":156},"memory_detail_list ",[146,708,596],{"class":196},[146,710,711],{"class":148,"line":360},[146,712,601],{"class":196},[146,714,715,717,720,722,724,726,729,731],{"class":148,"line":381},[146,716,606],{"class":196},[146,718,719],{"class":210},"memory_key",[146,721,207],{"class":196},[146,723,288],{"class":196},[146,725,222],{"class":196},[146,727,728],{"class":210},"Summer Guangzhou Travel Plan",[146,730,207],{"class":196},[146,732,298],{"class":196},[146,734,735,737,740,742,744,746,749,751],{"class":148,"line":426},[146,736,606],{"class":196},[146,738,739],{"class":210},"memory_value",[146,741,207],{"class":196},[146,743,288],{"class":196},[146,745,222],{"class":196},[146,747,748],{"class":210},"User plans to travel to Guangzhou during the summer vacation and chose 7 Days Inn as accommodation.",[146,750,207],{"class":196},[146,752,298],{"class":196},[146,754,755,757,759,761,763,765,767,769],{"class":148,"line":431},[146,756,606],{"class":196},[146,758,327],{"class":210},[146,760,207],{"class":196},[146,762,288],{"class":196},[146,764,222],{"class":196},[146,766,680],{"class":210},[146,768,207],{"class":196},[146,770,298],{"class":196},[146,772,773,775,778,780,782],{"class":148,"line":466},[146,774,606],{"class":196},[146,776,777],{"class":210},"tags",[146,779,207],{"class":196},[146,781,288],{"class":196},[146,783,784],{"class":196}," [\n",[146,786,787,790,793,795],{"class":148,"line":471},[146,788,789],{"class":196},"        \"",[146,791,792],{"class":210},"Travel",[146,794,207],{"class":196},[146,796,298],{"class":196},[146,798,799,801,804,806],{"class":148,"line":533},[146,800,789],{"class":196},[146,802,803],{"class":210},"Guangzhou",[146,805,207],{"class":196},[146,807,298],{"class":196},[146,809,810,812,815,817],{"class":148,"line":538},[146,811,789],{"class":196},[146,813,814],{"class":210},"Accommodation",[146,816,207],{"class":196},[146,818,298],{"class":196},[146,820,822,824,827],{"class":148,"line":821},23,[146,823,789],{"class":196},[146,825,826],{"class":210},"Hotel",[146,828,228],{"class":196},[146,830,832],{"class":148,"line":831},24,[146,833,834],{"class":196},"      ]\n",[146,836,838],{"class":148,"line":837},25,[146,839,687],{"class":196},[146,841,843],{"class":148,"line":842},26,[146,844,692],{"class":196},[45,846,847],{},[14,848,849,850,852],{}," Please note that ",[122,851,306],{}," is required. Currently, a single user must be specified for each memory retrieval.",[25,854],{},[37,856,858],{"id":857},"_5-example-of-assembling-memories-into-a-prompt","5. Example of Assembling Memories into a Prompt",[45,860,861,868],{},[14,862,863,866],{},[17,864,865],{},"Memory Assembly",[25,867],{},[14,869,870],{},"Using recalled memories requires certain techniques. Below is an assembly example.",[136,872,877],{"className":873,"code":875,"language":876,"meta":142},[874],"language-text","# Role\nYou are an intelligent assistant powered by MemOS. Your goal is to provide personalized and accurate responses by leveraging retrieved memory fragments, while strictly avoiding hallucinations caused by past AI inferences.\n\n# System Context\n- Current time: 2026-01-06 15:05 (Baseline for freshness)\n\n# Memory Data\nBelow is the information retrieved by MemOS, categorized into \"Facts\" and \"Preferences\".\n- **Facts**: May contain user attributes, historical logs, or third-party details.\n- **Warning**: Content tagged with '[assistant观点]' or '[summary]' represents **past AI inferences**, NOT direct user quotes.\n- **Preferences**: Explicit or implicit user requirements regarding response style and format.\n\n\u003Cmemories>\n  \u003Cfacts>\n    -[2025-12-26 21:45] User plans to travel to Guangzhou during the summer vacation and chose 7 Days Inn as accommodation.\n    -[2025-12-26 14:26] The user's name is Grace.\n  \u003C/facts>\n\n  \u003Cpreferences>\n    -[2026-01-04 20:41] [Explicit Preference] The user likes traveling to southern regions.\n    -[2025-12-26 21:45] [Implicit Preference] User may prefer hotels with higher cost-performance ratio.\n  \u003C/preferences>\n\u003C/memories>\n\n# Critical Protocol: Memory Safety\nYou must strictly execute the following **\"Four-Step Verdict\"**. If a memory fails any step, **DISCARD IT**:\n\n1. **Source Verification (CRITICAL)**:\n  - **Core**: Distinguish between \"User's Input\" and \"AI's Inference\".\n  - If a memory is tagged as '[assistant观点]', treat it as a **hypothesis**, not a hard fact.\n  - *Example*: Memory says '[assistant view] User loves mango'. Do not treat this as absolute truth unless reaffirmed.\n  - **Principle: AI summaries have much lower authority than direct user statements.**\n\n2. **Attribution Check**:\n  - Is the \"Subject\" of the memory definitely the User?\n  - If the memory describes a **Third Party** (e.g., Candidate, Fictional Character), **NEVER** attribute these traits to the User.\n\n3. **Relevance Check**:\n  - Does the memory *directly* help answer the current 'Original Query'?\n  - If it is merely a keyword match with different context, **IGNORE IT**.\n\n4. **Freshness Check**:\n  - Does the memory conflict with the user's current intent? The current 'Original Query' is always the supreme Source of Truth.\n\n\n# Instructions\n1. **Filter**: Apply the \"Four-Step Verdict\" to all '\u003Cfacts>' to filter out noise and unreliable AI views.\n2. **Synthesize**: Use only validated memories for context.\n3. **Style**: Strictly adhere to '\u003Cpreferences>'.\n4. **Output**: Answer directly. **NEVER** mention \"retrieved memories,\" \"database,\" or \"AI views\" in your response.\n\n#Original Query\nI want to travel during the National Day holiday. Please recommend a city I haven’t been to and a hotel brand I haven’t stayed at.\n\n","text",[122,878,875],{"__ignoreMap":142},[25,880],{},[37,882,884],{"id":883},"_6-usage-scenarios","6. Usage Scenarios",[886,887,889],"h3",{"id":888},"use-memory-in-conversation","Use Memory in Conversation",[14,891,892],{},"During the user's conversation with AI, you can call MemOS to retrieve memories most relevant to the current user's statement and fill them into the large model's reply prompt.",[45,894,895],{},[14,896,897,899],{},[122,898,327],{}," is optional. If filled, it can help MemOS understand the context of the current session, improve the weight of memories related to this session, and make the dialogue model's reply content more coherent.",[14,901,902,903,907,908,910],{},"As shown in the example below, if you have already tried ",[20,904,906],{"href":905},"/memos_cloud/mem_operations/add_message","Add Message"," and added historical conversation messages for user ",[122,909,315],{},", you can copy and refer to this example to retrieve user memories.",[133,912,913,1281],{},[136,914,916],{"className":138,"code":915,"filename":140,"language":141,"meta":142,"style":142},"import os\nimport json\nimport requests\n\nos.environ[\"MEMOS_API_KEY\"] = \"YOUR_API_KEY\"\nos.environ[\"MEMOS_BASE_URL\"] = \"https://api.memt.ai/openmem/v1\"\n\n# headers and base URL\nheaders = {\n  \"Authorization\": f\"Token {os.environ['MEMOS_API_KEY']}\",\n  \"Content-Type\": \"application/json\"\n}\nBASE_URL = os.environ['MEMOS_BASE_URL']\n\n# User's current statement, directly used as query\nquery_text = \"I'm going to Yunnan for the National Day holiday. Do you have any food recommendations?\"\n\ndata = {\n    \"user_id\": \"memos_user_123\",\n    \"conversation_id\": \"memos_conversation_123\",  # Created a new conversation ID\n    \"query\": query_text,\n}\n\n# Call /search/memory to query relevant memories\nres = requests.post(f\"{BASE_URL}/search/memory\", headers=headers, data=json.dumps(data))\n\nprint(f\"result: {res.json()}\")\n",[122,917,918,924,930,936,940,966,992,996,1001,1009,1047,1063,1067,1092,1096,1101,1115,1119,1127,1146,1168,1183,1187,1191,1196,1250,1254],{"__ignoreMap":142},[146,919,920,922],{"class":148,"line":149},[146,921,153],{"class":152},[146,923,157],{"class":156},[146,925,926,928],{"class":148,"line":160},[146,927,153],{"class":152},[146,929,173],{"class":156},[146,931,932,934],{"class":148,"line":168},[146,933,153],{"class":152},[146,935,165],{"class":156},[146,937,938],{"class":148,"line":176},[146,939,180],{"emptyLinePlaceholder":179},[146,941,942,944,946,948,950,952,954,956,958,960,962,964],{"class":148,"line":183},[146,943,193],{"class":156},[146,945,197],{"class":196},[146,947,201],{"class":200},[146,949,204],{"class":196},[146,951,207],{"class":196},[146,953,211],{"class":210},[146,955,207],{"class":196},[146,957,216],{"class":196},[146,959,219],{"class":196},[146,961,222],{"class":196},[146,963,225],{"class":210},[146,965,228],{"class":196},[146,967,968,970,972,974,976,978,980,982,984,986,988,990],{"class":148,"line":190},[146,969,193],{"class":156},[146,971,197],{"class":196},[146,973,201],{"class":200},[146,975,204],{"class":196},[146,977,207],{"class":196},[146,979,244],{"class":210},[146,981,207],{"class":196},[146,983,216],{"class":196},[146,985,219],{"class":196},[146,987,222],{"class":196},[146,989,255],{"class":210},[146,991,228],{"class":196},[146,993,994],{"class":148,"line":231},[146,995,180],{"emptyLinePlaceholder":179},[146,997,998],{"class":148,"line":260},[146,999,1000],{"class":186},"# headers and base URL\n",[146,1002,1003,1005,1007],{"class":148,"line":265},[146,1004,353],{"class":156},[146,1006,271],{"class":196},[146,1008,274],{"class":196},[146,1010,1011,1013,1015,1017,1019,1021,1023,1025,1027,1029,1031,1033,1035,1037,1039,1041,1043,1045],{"class":148,"line":277},[146,1012,280],{"class":196},[146,1014,386],{"class":210},[146,1016,207],{"class":196},[146,1018,288],{"class":196},[146,1020,394],{"class":393},[146,1022,397],{"class":210},[146,1024,401],{"class":400},[146,1026,193],{"class":156},[146,1028,197],{"class":196},[146,1030,201],{"class":200},[146,1032,204],{"class":196},[146,1034,412],{"class":196},[146,1036,211],{"class":210},[146,1038,412],{"class":196},[146,1040,216],{"class":196},[146,1042,421],{"class":400},[146,1044,207],{"class":210},[146,1046,298],{"class":196},[146,1048,1049,1051,1053,1055,1057,1059,1061],{"class":148,"line":301},[146,1050,280],{"class":196},[146,1052,365],{"class":210},[146,1054,207],{"class":196},[146,1056,288],{"class":196},[146,1058,222],{"class":196},[146,1060,374],{"class":210},[146,1062,228],{"class":196},[146,1064,1065],{"class":148,"line":322},[146,1066,347],{"class":196},[146,1068,1069,1072,1074,1077,1079,1081,1083,1085,1087,1089],{"class":148,"line":344},[146,1070,1071],{"class":156},"BASE_URL ",[146,1073,271],{"class":196},[146,1075,1076],{"class":156}," os",[146,1078,197],{"class":196},[146,1080,201],{"class":200},[146,1082,204],{"class":196},[146,1084,412],{"class":196},[146,1086,244],{"class":210},[146,1088,412],{"class":196},[146,1090,1091],{"class":196},"]\n",[146,1093,1094],{"class":148,"line":350},[146,1095,180],{"emptyLinePlaceholder":179},[146,1097,1098],{"class":148,"line":360},[146,1099,1100],{"class":186},"# User's current statement, directly used as query\n",[146,1102,1103,1106,1108,1110,1113],{"class":148,"line":381},[146,1104,1105],{"class":156},"query_text ",[146,1107,271],{"class":196},[146,1109,222],{"class":196},[146,1111,1112],{"class":210},"I'm going to Yunnan for the National Day holiday. Do you have any food recommendations?",[146,1114,228],{"class":196},[146,1116,1117],{"class":148,"line":426},[146,1118,180],{"emptyLinePlaceholder":179},[146,1120,1121,1123,1125],{"class":148,"line":431},[146,1122,268],{"class":156},[146,1124,271],{"class":196},[146,1126,274],{"class":196},[146,1128,1129,1132,1134,1136,1138,1140,1142,1144],{"class":148,"line":466},[146,1130,1131],{"class":196},"    \"",[146,1133,306],{"class":210},[146,1135,207],{"class":196},[146,1137,288],{"class":196},[146,1139,222],{"class":196},[146,1141,315],{"class":210},[146,1143,207],{"class":196},[146,1145,298],{"class":196},[146,1147,1148,1150,1152,1154,1156,1158,1161,1163,1165],{"class":148,"line":471},[146,1149,1131],{"class":196},[146,1151,327],{"class":210},[146,1153,207],{"class":196},[146,1155,288],{"class":196},[146,1157,222],{"class":196},[146,1159,1160],{"class":210},"memos_conversation_123",[146,1162,207],{"class":196},[146,1164,499],{"class":196},[146,1166,1167],{"class":186},"  # Created a new conversation ID\n",[146,1169,1170,1172,1174,1176,1178,1181],{"class":148,"line":533},[146,1171,1131],{"class":196},[146,1173,283],{"class":210},[146,1175,207],{"class":196},[146,1177,288],{"class":196},[146,1179,1180],{"class":156}," query_text",[146,1182,298],{"class":196},[146,1184,1185],{"class":148,"line":538},[146,1186,347],{"class":196},[146,1188,1189],{"class":148,"line":821},[146,1190,180],{"emptyLinePlaceholder":179},[146,1192,1193],{"class":148,"line":831},[146,1194,1195],{"class":186},"# Call /search/memory to query relevant memories\n",[146,1197,1198,1200,1202,1204,1206,1208,1210,1212,1214,1216,1219,1221,1224,1226,1228,1230,1232,1234,1236,1238,1240,1242,1244,1246,1248],{"class":148,"line":837},[146,1199,474],{"class":156},[146,1201,271],{"class":196},[146,1203,479],{"class":156},[146,1205,197],{"class":196},[146,1207,485],{"class":484},[146,1209,488],{"class":196},[146,1211,546],{"class":393},[146,1213,207],{"class":210},[146,1215,401],{"class":400},[146,1217,1218],{"class":484},"BASE_URL",[146,1220,421],{"class":400},[146,1222,1223],{"class":210},"/search/memory\"",[146,1225,499],{"class":196},[146,1227,502],{"class":491},[146,1229,271],{"class":196},[146,1231,507],{"class":484},[146,1233,499],{"class":196},[146,1235,512],{"class":491},[146,1237,271],{"class":196},[146,1239,517],{"class":484},[146,1241,197],{"class":196},[146,1243,522],{"class":484},[146,1245,488],{"class":196},[146,1247,527],{"class":484},[146,1249,530],{"class":196},[146,1251,1252],{"class":148,"line":842},[146,1253,180],{"emptyLinePlaceholder":179},[146,1255,1257,1259,1261,1263,1265,1267,1269,1271,1273,1275,1277,1279],{"class":148,"line":1256},27,[146,1258,541],{"class":484},[146,1260,488],{"class":196},[146,1262,546],{"class":393},[146,1264,549],{"class":210},[146,1266,401],{"class":400},[146,1268,554],{"class":484},[146,1270,197],{"class":196},[146,1272,517],{"class":484},[146,1274,561],{"class":196},[146,1276,421],{"class":400},[146,1278,207],{"class":210},[146,1280,568],{"class":196},[136,1282,1284],{"className":138,"code":1283,"filename":572,"language":141,"meta":142,"style":142}," {\n  \"memory_detail_list\": [\n    {\n      \"id\": \"c6c63472-25d3-49ee-b360-9b0702d96781\",\n      \"memory_key\": \"Spicy Food Preference\",\n      \"memory_value\": \"User likes spicy food but doesn't like heavy oil dishes, such as spicy hot pot and Mao Xue Wang. User prefers refreshing and spicy dishes.\",\n      \"memory_type\": \"UserMemory\",\n      \"create_time\": 1762674694466,\n      \"conversation_id\": \"memos_conversation_123\",\n      \"status\": \"activated\",\n      \"confidence\": 0.99,\n      \"tags\": [\n        \"Dietary Preference\",\n        \"Spicy\",\n        \"Heavy Oil\"\n      ],\n      \"update_time\": 1762674694423,\n      \"relativity\": 0.00242424\n    }\n  ],\n  \"preference_detail_list\": [\n    {\n      \"id\": \"46d8372d-241a-4ffc-890b-ae13c90d5565\",\n      \"preference_type\": \"explicit_preference\",\n      \"preference\": \"User likes spicy food but dislikes heavy oil spicy food.\",\n      \"reasoning\": \"In the first query, the user explicitly stated they like spicy food. In the second query, they further explained they don't like heavy oil spicy food. This indicates the user's preference is for spicy but refreshing food.\",\n      \"create_time\": 1762675342352,\n      \"conversation_id\": \"memos_conversation_123\",\n      \"status\": \"activated\",\n      \"update_time\": 1762674923302\n    },\n    {\n      \"id\": \"9d62c1ae-a069-478d-a2fd-cb4aadfb6868\",\n      \"preference_type\": \"implicit_preference\",\n      \"preference\": \"User may prefer healthier dietary choices\",\n      \"reasoning\": \"The user expressed a clear preference for spicy flavors but disliked heavy oil food. This indicates the user may be more concerned about dietary health and tends to choose less greasy food. The combination of liking spicy food and rejecting heavy oil food may imply an implicit preference for healthy eating.\",\n      \"create_time\": 1762674923448,\n      \"conversation_id\": \"memos_conversation_123\",\n      \"status\": \"activated\",\n      \"update_time\": 1762674851542\n    }\n  ],\n  \"preference_note\": \"\\n# Note:\\nFactual memory is a summary of facts, while preference memory is a summary of user preferences.\\nYour reply must not violate any of the user's preferences, whether explicit or implicit, and briefly explain why you answered this way to avoid conflicts.\\n\"\n}\n",[122,1285,1286,1290,1303,1307,1327,1346,1365,1385,1401,1419,1439,1455,1467,1478,1489,1498,1503,1519,1533,1537,1542,1555,1559,1578,1597,1616,1635,1650,1669,1688,1702,1708,1713,1733,1752,1772,1792,1808,1827,1846,1860,1865,1870,1904],{"__ignoreMap":142},[146,1287,1288],{"class":148,"line":149},[146,1289,274],{"class":196},[146,1291,1292,1294,1297,1299,1301],{"class":148,"line":160},[146,1293,280],{"class":196},[146,1295,1296],{"class":210},"memory_detail_list",[146,1298,207],{"class":196},[146,1300,288],{"class":196},[146,1302,784],{"class":196},[146,1304,1305],{"class":148,"line":168},[146,1306,601],{"class":196},[146,1308,1309,1311,1314,1316,1318,1320,1323,1325],{"class":148,"line":176},[146,1310,606],{"class":196},[146,1312,1313],{"class":210},"id",[146,1315,207],{"class":196},[146,1317,288],{"class":196},[146,1319,222],{"class":196},[146,1321,1322],{"class":210},"c6c63472-25d3-49ee-b360-9b0702d96781",[146,1324,207],{"class":196},[146,1326,298],{"class":196},[146,1328,1329,1331,1333,1335,1337,1339,1342,1344],{"class":148,"line":183},[146,1330,606],{"class":196},[146,1332,719],{"class":210},[146,1334,207],{"class":196},[146,1336,288],{"class":196},[146,1338,222],{"class":196},[146,1340,1341],{"class":210},"Spicy Food Preference",[146,1343,207],{"class":196},[146,1345,298],{"class":196},[146,1347,1348,1350,1352,1354,1356,1358,1361,1363],{"class":148,"line":190},[146,1349,606],{"class":196},[146,1351,739],{"class":210},[146,1353,207],{"class":196},[146,1355,288],{"class":196},[146,1357,222],{"class":196},[146,1359,1360],{"class":210},"User likes spicy food but doesn't like heavy oil dishes, such as spicy hot pot and Mao Xue Wang. User prefers refreshing and spicy dishes.",[146,1362,207],{"class":196},[146,1364,298],{"class":196},[146,1366,1367,1369,1372,1374,1376,1378,1381,1383],{"class":148,"line":231},[146,1368,606],{"class":196},[146,1370,1371],{"class":210},"memory_type",[146,1373,207],{"class":196},[146,1375,288],{"class":196},[146,1377,222],{"class":196},[146,1379,1380],{"class":210},"UserMemory",[146,1382,207],{"class":196},[146,1384,298],{"class":196},[146,1386,1387,1389,1392,1394,1396,1399],{"class":148,"line":260},[146,1388,606],{"class":196},[146,1390,1391],{"class":210},"create_time",[146,1393,207],{"class":196},[146,1395,288],{"class":196},[146,1397,1398],{"class":400}," 1762674694466",[146,1400,298],{"class":196},[146,1402,1403,1405,1407,1409,1411,1413,1415,1417],{"class":148,"line":265},[146,1404,606],{"class":196},[146,1406,327],{"class":210},[146,1408,207],{"class":196},[146,1410,288],{"class":196},[146,1412,222],{"class":196},[146,1414,1160],{"class":210},[146,1416,207],{"class":196},[146,1418,298],{"class":196},[146,1420,1421,1423,1426,1428,1430,1432,1435,1437],{"class":148,"line":277},[146,1422,606],{"class":196},[146,1424,1425],{"class":210},"status",[146,1427,207],{"class":196},[146,1429,288],{"class":196},[146,1431,222],{"class":196},[146,1433,1434],{"class":210},"activated",[146,1436,207],{"class":196},[146,1438,298],{"class":196},[146,1440,1441,1443,1446,1448,1450,1453],{"class":148,"line":301},[146,1442,606],{"class":196},[146,1444,1445],{"class":210},"confidence",[146,1447,207],{"class":196},[146,1449,288],{"class":196},[146,1451,1452],{"class":400}," 0.99",[146,1454,298],{"class":196},[146,1456,1457,1459,1461,1463,1465],{"class":148,"line":322},[146,1458,606],{"class":196},[146,1460,777],{"class":210},[146,1462,207],{"class":196},[146,1464,288],{"class":196},[146,1466,784],{"class":196},[146,1468,1469,1471,1474,1476],{"class":148,"line":344},[146,1470,789],{"class":196},[146,1472,1473],{"class":210},"Dietary Preference",[146,1475,207],{"class":196},[146,1477,298],{"class":196},[146,1479,1480,1482,1485,1487],{"class":148,"line":350},[146,1481,789],{"class":196},[146,1483,1484],{"class":210},"Spicy",[146,1486,207],{"class":196},[146,1488,298],{"class":196},[146,1490,1491,1493,1496],{"class":148,"line":360},[146,1492,789],{"class":196},[146,1494,1495],{"class":210},"Heavy Oil",[146,1497,228],{"class":196},[146,1499,1500],{"class":148,"line":381},[146,1501,1502],{"class":196},"      ],\n",[146,1504,1505,1507,1510,1512,1514,1517],{"class":148,"line":426},[146,1506,606],{"class":196},[146,1508,1509],{"class":210},"update_time",[146,1511,207],{"class":196},[146,1513,288],{"class":196},[146,1515,1516],{"class":400}," 1762674694423",[146,1518,298],{"class":196},[146,1520,1521,1523,1526,1528,1530],{"class":148,"line":431},[146,1522,606],{"class":196},[146,1524,1525],{"class":210},"relativity",[146,1527,207],{"class":196},[146,1529,288],{"class":196},[146,1531,1532],{"class":400}," 0.00242424\n",[146,1534,1535],{"class":148,"line":466},[146,1536,687],{"class":196},[146,1538,1539],{"class":148,"line":471},[146,1540,1541],{"class":196},"  ],\n",[146,1543,1544,1546,1549,1551,1553],{"class":148,"line":533},[146,1545,280],{"class":196},[146,1547,1548],{"class":210},"preference_detail_list",[146,1550,207],{"class":196},[146,1552,288],{"class":196},[146,1554,784],{"class":196},[146,1556,1557],{"class":148,"line":538},[146,1558,601],{"class":196},[146,1560,1561,1563,1565,1567,1569,1571,1574,1576],{"class":148,"line":821},[146,1562,606],{"class":196},[146,1564,1313],{"class":210},[146,1566,207],{"class":196},[146,1568,288],{"class":196},[146,1570,222],{"class":196},[146,1572,1573],{"class":210},"46d8372d-241a-4ffc-890b-ae13c90d5565",[146,1575,207],{"class":196},[146,1577,298],{"class":196},[146,1579,1580,1582,1584,1586,1588,1590,1593,1595],{"class":148,"line":831},[146,1581,606],{"class":196},[146,1583,609],{"class":210},[146,1585,207],{"class":196},[146,1587,288],{"class":196},[146,1589,222],{"class":196},[146,1591,1592],{"class":210},"explicit_preference",[146,1594,207],{"class":196},[146,1596,298],{"class":196},[146,1598,1599,1601,1603,1605,1607,1609,1612,1614],{"class":148,"line":837},[146,1600,606],{"class":196},[146,1602,632],{"class":210},[146,1604,207],{"class":196},[146,1606,288],{"class":196},[146,1608,222],{"class":196},[146,1610,1611],{"class":210},"User likes spicy food but dislikes heavy oil spicy food.",[146,1613,207],{"class":196},[146,1615,298],{"class":196},[146,1617,1618,1620,1622,1624,1626,1628,1631,1633],{"class":148,"line":842},[146,1619,606],{"class":196},[146,1621,652],{"class":210},[146,1623,207],{"class":196},[146,1625,288],{"class":196},[146,1627,222],{"class":196},[146,1629,1630],{"class":210},"In the first query, the user explicitly stated they like spicy food. In the second query, they further explained they don't like heavy oil spicy food. This indicates the user's preference is for spicy but refreshing food.",[146,1632,207],{"class":196},[146,1634,298],{"class":196},[146,1636,1637,1639,1641,1643,1645,1648],{"class":148,"line":1256},[146,1638,606],{"class":196},[146,1640,1391],{"class":210},[146,1642,207],{"class":196},[146,1644,288],{"class":196},[146,1646,1647],{"class":400}," 1762675342352",[146,1649,298],{"class":196},[146,1651,1653,1655,1657,1659,1661,1663,1665,1667],{"class":148,"line":1652},28,[146,1654,606],{"class":196},[146,1656,327],{"class":210},[146,1658,207],{"class":196},[146,1660,288],{"class":196},[146,1662,222],{"class":196},[146,1664,1160],{"class":210},[146,1666,207],{"class":196},[146,1668,298],{"class":196},[146,1670,1672,1674,1676,1678,1680,1682,1684,1686],{"class":148,"line":1671},29,[146,1673,606],{"class":196},[146,1675,1425],{"class":210},[146,1677,207],{"class":196},[146,1679,288],{"class":196},[146,1681,222],{"class":196},[146,1683,1434],{"class":210},[146,1685,207],{"class":196},[146,1687,298],{"class":196},[146,1689,1691,1693,1695,1697,1699],{"class":148,"line":1690},30,[146,1692,606],{"class":196},[146,1694,1509],{"class":210},[146,1696,207],{"class":196},[146,1698,288],{"class":196},[146,1700,1701],{"class":400}," 1762674923302\n",[146,1703,1705],{"class":148,"line":1704},31,[146,1706,1707],{"class":196},"    },\n",[146,1709,1711],{"class":148,"line":1710},32,[146,1712,601],{"class":196},[146,1714,1716,1718,1720,1722,1724,1726,1729,1731],{"class":148,"line":1715},33,[146,1717,606],{"class":196},[146,1719,1313],{"class":210},[146,1721,207],{"class":196},[146,1723,288],{"class":196},[146,1725,222],{"class":196},[146,1727,1728],{"class":210},"9d62c1ae-a069-478d-a2fd-cb4aadfb6868",[146,1730,207],{"class":196},[146,1732,298],{"class":196},[146,1734,1736,1738,1740,1742,1744,1746,1748,1750],{"class":148,"line":1735},34,[146,1737,606],{"class":196},[146,1739,609],{"class":210},[146,1741,207],{"class":196},[146,1743,288],{"class":196},[146,1745,222],{"class":196},[146,1747,618],{"class":210},[146,1749,207],{"class":196},[146,1751,298],{"class":196},[146,1753,1755,1757,1759,1761,1763,1765,1768,1770],{"class":148,"line":1754},35,[146,1756,606],{"class":196},[146,1758,632],{"class":210},[146,1760,207],{"class":196},[146,1762,288],{"class":196},[146,1764,222],{"class":196},[146,1766,1767],{"class":210},"User may prefer healthier dietary choices",[146,1769,207],{"class":196},[146,1771,298],{"class":196},[146,1773,1775,1777,1779,1781,1783,1785,1788,1790],{"class":148,"line":1774},36,[146,1776,606],{"class":196},[146,1778,652],{"class":210},[146,1780,207],{"class":196},[146,1782,288],{"class":196},[146,1784,222],{"class":196},[146,1786,1787],{"class":210},"The user expressed a clear preference for spicy flavors but disliked heavy oil food. This indicates the user may be more concerned about dietary health and tends to choose less greasy food. The combination of liking spicy food and rejecting heavy oil food may imply an implicit preference for healthy eating.",[146,1789,207],{"class":196},[146,1791,298],{"class":196},[146,1793,1795,1797,1799,1801,1803,1806],{"class":148,"line":1794},37,[146,1796,606],{"class":196},[146,1798,1391],{"class":210},[146,1800,207],{"class":196},[146,1802,288],{"class":196},[146,1804,1805],{"class":400}," 1762674923448",[146,1807,298],{"class":196},[146,1809,1811,1813,1815,1817,1819,1821,1823,1825],{"class":148,"line":1810},38,[146,1812,606],{"class":196},[146,1814,327],{"class":210},[146,1816,207],{"class":196},[146,1818,288],{"class":196},[146,1820,222],{"class":196},[146,1822,1160],{"class":210},[146,1824,207],{"class":196},[146,1826,298],{"class":196},[146,1828,1830,1832,1834,1836,1838,1840,1842,1844],{"class":148,"line":1829},39,[146,1831,606],{"class":196},[146,1833,1425],{"class":210},[146,1835,207],{"class":196},[146,1837,288],{"class":196},[146,1839,222],{"class":196},[146,1841,1434],{"class":210},[146,1843,207],{"class":196},[146,1845,298],{"class":196},[146,1847,1849,1851,1853,1855,1857],{"class":148,"line":1848},40,[146,1850,606],{"class":196},[146,1852,1509],{"class":210},[146,1854,207],{"class":196},[146,1856,288],{"class":196},[146,1858,1859],{"class":400}," 1762674851542\n",[146,1861,1863],{"class":148,"line":1862},41,[146,1864,687],{"class":196},[146,1866,1868],{"class":148,"line":1867},42,[146,1869,1541],{"class":196},[146,1871,1873,1875,1878,1880,1882,1884,1887,1890,1892,1895,1897,1900,1902],{"class":148,"line":1872},43,[146,1874,280],{"class":196},[146,1876,1877],{"class":210},"preference_note",[146,1879,207],{"class":196},[146,1881,288],{"class":196},[146,1883,222],{"class":196},[146,1885,1886],{"class":156},"\\n",[146,1888,1889],{"class":210},"# Note:",[146,1891,1886],{"class":156},[146,1893,1894],{"class":210},"Factual memory is a summary of facts, while preference memory is a summary of user preferences.",[146,1896,1886],{"class":156},[146,1898,1899],{"class":210},"Your reply must not violate any of the user's preferences, whether explicit or implicit, and briefly explain why you answered this way to avoid conflicts.",[146,1901,1886],{"class":156},[146,1903,228],{"class":196},[146,1905,1907],{"class":148,"line":1906},44,[146,1908,347],{"class":196},[25,1910],{},[886,1912,1914],{"id":1913},"get-user-profile","Get User Profile",[14,1916,1917,1918,197],{},"If you need to analyze users for your developed application, or hope to display their \"key personal impressions\" to users in real-time in the AI application, you can call MemOS to globally retrieve user memories to help the large model generate personalized user profiles. In this case, you don't need to fill in ",[122,1919,327],{},[14,1921,902,1922,907,1924,1926],{},[20,1923,906],{"href":905},[122,1925,315],{},", you can copy this example to retrieve user memories with one click.",[133,1928,1929,2264],{},[136,1930,1932],{"className":138,"code":1931,"filename":140,"language":141,"meta":142,"style":142},"import os\nimport json\nimport requests\n\nos.environ[\"MEMOS_API_KEY\"] = \"YOUR_API_KEY\"\nos.environ[\"MEMOS_BASE_URL\"] = \"https://api.memt.ai/openmem/v1\"\n\n# headers and base URL\nheaders = {\n  \"Authorization\": f\"Token {os.environ['MEMOS_API_KEY']}\",\n  \"Content-Type\": \"application/json\"\n}\nBASE_URL = os.environ['MEMOS_BASE_URL']\n\n# Ask for user profile directly as query\nquery_text = \"What are my character keywords?\"\n\ndata = {\n    \"user_id\": \"memos_user_123\",\n    \"query\": query_text,\n}\n\n# Call /search/memory to query relevant memories\nres = requests.post(f\"{BASE_URL}/search/memory\", headers=headers, data=json.dumps(data))\n\nprint(f\"result: {res.json()}\")\n",[122,1933,1934,1940,1946,1952,1956,1982,2008,2012,2016,2024,2062,2078,2082,2104,2108,2113,2126,2130,2138,2156,2170,2174,2178,2182,2234,2238],{"__ignoreMap":142},[146,1935,1936,1938],{"class":148,"line":149},[146,1937,153],{"class":152},[146,1939,157],{"class":156},[146,1941,1942,1944],{"class":148,"line":160},[146,1943,153],{"class":152},[146,1945,173],{"class":156},[146,1947,1948,1950],{"class":148,"line":168},[146,1949,153],{"class":152},[146,1951,165],{"class":156},[146,1953,1954],{"class":148,"line":176},[146,1955,180],{"emptyLinePlaceholder":179},[146,1957,1958,1960,1962,1964,1966,1968,1970,1972,1974,1976,1978,1980],{"class":148,"line":183},[146,1959,193],{"class":156},[146,1961,197],{"class":196},[146,1963,201],{"class":200},[146,1965,204],{"class":196},[146,1967,207],{"class":196},[146,1969,211],{"class":210},[146,1971,207],{"class":196},[146,1973,216],{"class":196},[146,1975,219],{"class":196},[146,1977,222],{"class":196},[146,1979,225],{"class":210},[146,1981,228],{"class":196},[146,1983,1984,1986,1988,1990,1992,1994,1996,1998,2000,2002,2004,2006],{"class":148,"line":190},[146,1985,193],{"class":156},[146,1987,197],{"class":196},[146,1989,201],{"class":200},[146,1991,204],{"class":196},[146,1993,207],{"class":196},[146,1995,244],{"class":210},[146,1997,207],{"class":196},[146,1999,216],{"class":196},[146,2001,219],{"class":196},[146,2003,222],{"class":196},[146,2005,255],{"class":210},[146,2007,228],{"class":196},[146,2009,2010],{"class":148,"line":231},[146,2011,180],{"emptyLinePlaceholder":179},[146,2013,2014],{"class":148,"line":260},[146,2015,1000],{"class":186},[146,2017,2018,2020,2022],{"class":148,"line":265},[146,2019,353],{"class":156},[146,2021,271],{"class":196},[146,2023,274],{"class":196},[146,2025,2026,2028,2030,2032,2034,2036,2038,2040,2042,2044,2046,2048,2050,2052,2054,2056,2058,2060],{"class":148,"line":277},[146,2027,280],{"class":196},[146,2029,386],{"class":210},[146,2031,207],{"class":196},[146,2033,288],{"class":196},[146,2035,394],{"class":393},[146,2037,397],{"class":210},[146,2039,401],{"class":400},[146,2041,193],{"class":156},[146,2043,197],{"class":196},[146,2045,201],{"class":200},[146,2047,204],{"class":196},[146,2049,412],{"class":196},[146,2051,211],{"class":210},[146,2053,412],{"class":196},[146,2055,216],{"class":196},[146,2057,421],{"class":400},[146,2059,207],{"class":210},[146,2061,298],{"class":196},[146,2063,2064,2066,2068,2070,2072,2074,2076],{"class":148,"line":301},[146,2065,280],{"class":196},[146,2067,365],{"class":210},[146,2069,207],{"class":196},[146,2071,288],{"class":196},[146,2073,222],{"class":196},[146,2075,374],{"class":210},[146,2077,228],{"class":196},[146,2079,2080],{"class":148,"line":322},[146,2081,347],{"class":196},[146,2083,2084,2086,2088,2090,2092,2094,2096,2098,2100,2102],{"class":148,"line":344},[146,2085,1071],{"class":156},[146,2087,271],{"class":196},[146,2089,1076],{"class":156},[146,2091,197],{"class":196},[146,2093,201],{"class":200},[146,2095,204],{"class":196},[146,2097,412],{"class":196},[146,2099,244],{"class":210},[146,2101,412],{"class":196},[146,2103,1091],{"class":196},[146,2105,2106],{"class":148,"line":350},[146,2107,180],{"emptyLinePlaceholder":179},[146,2109,2110],{"class":148,"line":360},[146,2111,2112],{"class":186},"# Ask for user profile directly as query\n",[146,2114,2115,2117,2119,2121,2124],{"class":148,"line":381},[146,2116,1105],{"class":156},[146,2118,271],{"class":196},[146,2120,222],{"class":196},[146,2122,2123],{"class":210},"What are my character keywords?",[146,2125,228],{"class":196},[146,2127,2128],{"class":148,"line":426},[146,2129,180],{"emptyLinePlaceholder":179},[146,2131,2132,2134,2136],{"class":148,"line":431},[146,2133,268],{"class":156},[146,2135,271],{"class":196},[146,2137,274],{"class":196},[146,2139,2140,2142,2144,2146,2148,2150,2152,2154],{"class":148,"line":466},[146,2141,1131],{"class":196},[146,2143,306],{"class":210},[146,2145,207],{"class":196},[146,2147,288],{"class":196},[146,2149,222],{"class":196},[146,2151,315],{"class":210},[146,2153,207],{"class":196},[146,2155,298],{"class":196},[146,2157,2158,2160,2162,2164,2166,2168],{"class":148,"line":471},[146,2159,1131],{"class":196},[146,2161,283],{"class":210},[146,2163,207],{"class":196},[146,2165,288],{"class":196},[146,2167,1180],{"class":156},[146,2169,298],{"class":196},[146,2171,2172],{"class":148,"line":533},[146,2173,347],{"class":196},[146,2175,2176],{"class":148,"line":538},[146,2177,180],{"emptyLinePlaceholder":179},[146,2179,2180],{"class":148,"line":821},[146,2181,1195],{"class":186},[146,2183,2184,2186,2188,2190,2192,2194,2196,2198,2200,2202,2204,2206,2208,2210,2212,2214,2216,2218,2220,2222,2224,2226,2228,2230,2232],{"class":148,"line":831},[146,2185,474],{"class":156},[146,2187,271],{"class":196},[146,2189,479],{"class":156},[146,2191,197],{"class":196},[146,2193,485],{"class":484},[146,2195,488],{"class":196},[146,2197,546],{"class":393},[146,2199,207],{"class":210},[146,2201,401],{"class":400},[146,2203,1218],{"class":484},[146,2205,421],{"class":400},[146,2207,1223],{"class":210},[146,2209,499],{"class":196},[146,2211,502],{"class":491},[146,2213,271],{"class":196},[146,2215,507],{"class":484},[146,2217,499],{"class":196},[146,2219,512],{"class":491},[146,2221,271],{"class":196},[146,2223,517],{"class":484},[146,2225,197],{"class":196},[146,2227,522],{"class":484},[146,2229,488],{"class":196},[146,2231,527],{"class":484},[146,2233,530],{"class":196},[146,2235,2236],{"class":148,"line":837},[146,2237,180],{"emptyLinePlaceholder":179},[146,2239,2240,2242,2244,2246,2248,2250,2252,2254,2256,2258,2260,2262],{"class":148,"line":842},[146,2241,541],{"class":484},[146,2243,488],{"class":196},[146,2245,546],{"class":393},[146,2247,549],{"class":210},[146,2249,401],{"class":400},[146,2251,554],{"class":484},[146,2253,197],{"class":196},[146,2255,517],{"class":484},[146,2257,561],{"class":196},[146,2259,421],{"class":400},[146,2261,207],{"class":210},[146,2263,568],{"class":196},[136,2265,2267],{"className":138,"code":2266,"filename":572,"language":141,"meta":142,"style":142},"# Example return (Showing recalled memory fragments)\n{\n  \"memory_detail_list\": [\n    {\n      \"id\": \"00d8bb4e-aa8c-4fee-a83e-bf67ed6c3ea1\",\n      \"memory_key\": \"Things hoped for AI help\",\n      \"memory_value\": \"User hopes AI can help plan daily study schedules, recommend movies and books, and provide emotional companionship.\",\n      \"memory_type\": \"WorkingMemory\",\n      \"create_time\": 1762675190743,\n      \"conversation_id\": \"memos_conversation_456\",\n      \"status\": \"activated\",\n      \"confidence\": 0.99,\n      \"tags\": [\n        \"Help\",\n        \"Study Plan\",\n        \"Recommend\",\n        \"Companionship\"\n      ],\n      \"update_time\": 1762675209112,\n      \"relativity\": 0.00013480317\n    },\n    {\n      \"id\": \"17f039d5-d034-41e9-a385-765992a4ab00\",\n      \"memory_key\": \"Types of help desired from AI\",\n      \"memory_value\": \"User hopes AI provides suggestions, information query, and inspiration.\",\n      \"memory_type\": \"WorkingMemory\",\n      \"create_time\": 1762675153211,\n      \"conversation_id\": \"memos_conversation_456\",\n      \"status\": \"activated\",\n      \"confidence\": 0.99,\n      \"tags\": [\n        \"AI\",\n        \"Help\",\n        \"Type\"\n      ],\n      \"update_time\": 1762675206651,\n      \"relativity\": 0.00010301525\n    }\n  ],\n  \"preference_detail_list\": [],\n  \"preference_note\": \"\"\n}\n",[122,2268,2269,2274,2279,2291,2295,2314,2333,2352,2371,2386,2405,2423,2437,2449,2460,2471,2482,2491,2495,2510,2523,2527,2531,2550,2569,2588,2606,2621,2639,2657,2671,2683,2694,2704,2713,2717,2732,2745,2749,2753,2766,2779],{"__ignoreMap":142},[146,2270,2271],{"class":148,"line":149},[146,2272,2273],{"class":186},"# Example return (Showing recalled memory fragments)\n",[146,2275,2276],{"class":148,"line":160},[146,2277,2278],{"class":196},"{\n",[146,2280,2281,2283,2285,2287,2289],{"class":148,"line":168},[146,2282,280],{"class":196},[146,2284,1296],{"class":210},[146,2286,207],{"class":196},[146,2288,288],{"class":196},[146,2290,784],{"class":196},[146,2292,2293],{"class":148,"line":176},[146,2294,601],{"class":196},[146,2296,2297,2299,2301,2303,2305,2307,2310,2312],{"class":148,"line":183},[146,2298,606],{"class":196},[146,2300,1313],{"class":210},[146,2302,207],{"class":196},[146,2304,288],{"class":196},[146,2306,222],{"class":196},[146,2308,2309],{"class":210},"00d8bb4e-aa8c-4fee-a83e-bf67ed6c3ea1",[146,2311,207],{"class":196},[146,2313,298],{"class":196},[146,2315,2316,2318,2320,2322,2324,2326,2329,2331],{"class":148,"line":190},[146,2317,606],{"class":196},[146,2319,719],{"class":210},[146,2321,207],{"class":196},[146,2323,288],{"class":196},[146,2325,222],{"class":196},[146,2327,2328],{"class":210},"Things hoped for AI help",[146,2330,207],{"class":196},[146,2332,298],{"class":196},[146,2334,2335,2337,2339,2341,2343,2345,2348,2350],{"class":148,"line":231},[146,2336,606],{"class":196},[146,2338,739],{"class":210},[146,2340,207],{"class":196},[146,2342,288],{"class":196},[146,2344,222],{"class":196},[146,2346,2347],{"class":210},"User hopes AI can help plan daily study schedules, recommend movies and books, and provide emotional companionship.",[146,2349,207],{"class":196},[146,2351,298],{"class":196},[146,2353,2354,2356,2358,2360,2362,2364,2367,2369],{"class":148,"line":260},[146,2355,606],{"class":196},[146,2357,1371],{"class":210},[146,2359,207],{"class":196},[146,2361,288],{"class":196},[146,2363,222],{"class":196},[146,2365,2366],{"class":210},"WorkingMemory",[146,2368,207],{"class":196},[146,2370,298],{"class":196},[146,2372,2373,2375,2377,2379,2381,2384],{"class":148,"line":265},[146,2374,606],{"class":196},[146,2376,1391],{"class":210},[146,2378,207],{"class":196},[146,2380,288],{"class":196},[146,2382,2383],{"class":400}," 1762675190743",[146,2385,298],{"class":196},[146,2387,2388,2390,2392,2394,2396,2398,2401,2403],{"class":148,"line":277},[146,2389,606],{"class":196},[146,2391,327],{"class":210},[146,2393,207],{"class":196},[146,2395,288],{"class":196},[146,2397,222],{"class":196},[146,2399,2400],{"class":210},"memos_conversation_456",[146,2402,207],{"class":196},[146,2404,298],{"class":196},[146,2406,2407,2409,2411,2413,2415,2417,2419,2421],{"class":148,"line":301},[146,2408,606],{"class":196},[146,2410,1425],{"class":210},[146,2412,207],{"class":196},[146,2414,288],{"class":196},[146,2416,222],{"class":196},[146,2418,1434],{"class":210},[146,2420,207],{"class":196},[146,2422,298],{"class":196},[146,2424,2425,2427,2429,2431,2433,2435],{"class":148,"line":322},[146,2426,606],{"class":196},[146,2428,1445],{"class":210},[146,2430,207],{"class":196},[146,2432,288],{"class":196},[146,2434,1452],{"class":400},[146,2436,298],{"class":196},[146,2438,2439,2441,2443,2445,2447],{"class":148,"line":344},[146,2440,606],{"class":196},[146,2442,777],{"class":210},[146,2444,207],{"class":196},[146,2446,288],{"class":196},[146,2448,784],{"class":196},[146,2450,2451,2453,2456,2458],{"class":148,"line":350},[146,2452,789],{"class":196},[146,2454,2455],{"class":210},"Help",[146,2457,207],{"class":196},[146,2459,298],{"class":196},[146,2461,2462,2464,2467,2469],{"class":148,"line":360},[146,2463,789],{"class":196},[146,2465,2466],{"class":210},"Study Plan",[146,2468,207],{"class":196},[146,2470,298],{"class":196},[146,2472,2473,2475,2478,2480],{"class":148,"line":381},[146,2474,789],{"class":196},[146,2476,2477],{"class":210},"Recommend",[146,2479,207],{"class":196},[146,2481,298],{"class":196},[146,2483,2484,2486,2489],{"class":148,"line":426},[146,2485,789],{"class":196},[146,2487,2488],{"class":210},"Companionship",[146,2490,228],{"class":196},[146,2492,2493],{"class":148,"line":431},[146,2494,1502],{"class":196},[146,2496,2497,2499,2501,2503,2505,2508],{"class":148,"line":466},[146,2498,606],{"class":196},[146,2500,1509],{"class":210},[146,2502,207],{"class":196},[146,2504,288],{"class":196},[146,2506,2507],{"class":400}," 1762675209112",[146,2509,298],{"class":196},[146,2511,2512,2514,2516,2518,2520],{"class":148,"line":471},[146,2513,606],{"class":196},[146,2515,1525],{"class":210},[146,2517,207],{"class":196},[146,2519,288],{"class":196},[146,2521,2522],{"class":400}," 0.00013480317\n",[146,2524,2525],{"class":148,"line":533},[146,2526,1707],{"class":196},[146,2528,2529],{"class":148,"line":538},[146,2530,601],{"class":196},[146,2532,2533,2535,2537,2539,2541,2543,2546,2548],{"class":148,"line":821},[146,2534,606],{"class":196},[146,2536,1313],{"class":210},[146,2538,207],{"class":196},[146,2540,288],{"class":196},[146,2542,222],{"class":196},[146,2544,2545],{"class":210},"17f039d5-d034-41e9-a385-765992a4ab00",[146,2547,207],{"class":196},[146,2549,298],{"class":196},[146,2551,2552,2554,2556,2558,2560,2562,2565,2567],{"class":148,"line":831},[146,2553,606],{"class":196},[146,2555,719],{"class":210},[146,2557,207],{"class":196},[146,2559,288],{"class":196},[146,2561,222],{"class":196},[146,2563,2564],{"class":210},"Types of help desired from AI",[146,2566,207],{"class":196},[146,2568,298],{"class":196},[146,2570,2571,2573,2575,2577,2579,2581,2584,2586],{"class":148,"line":837},[146,2572,606],{"class":196},[146,2574,739],{"class":210},[146,2576,207],{"class":196},[146,2578,288],{"class":196},[146,2580,222],{"class":196},[146,2582,2583],{"class":210},"User hopes AI provides suggestions, information query, and inspiration.",[146,2585,207],{"class":196},[146,2587,298],{"class":196},[146,2589,2590,2592,2594,2596,2598,2600,2602,2604],{"class":148,"line":842},[146,2591,606],{"class":196},[146,2593,1371],{"class":210},[146,2595,207],{"class":196},[146,2597,288],{"class":196},[146,2599,222],{"class":196},[146,2601,2366],{"class":210},[146,2603,207],{"class":196},[146,2605,298],{"class":196},[146,2607,2608,2610,2612,2614,2616,2619],{"class":148,"line":1256},[146,2609,606],{"class":196},[146,2611,1391],{"class":210},[146,2613,207],{"class":196},[146,2615,288],{"class":196},[146,2617,2618],{"class":400}," 1762675153211",[146,2620,298],{"class":196},[146,2622,2623,2625,2627,2629,2631,2633,2635,2637],{"class":148,"line":1652},[146,2624,606],{"class":196},[146,2626,327],{"class":210},[146,2628,207],{"class":196},[146,2630,288],{"class":196},[146,2632,222],{"class":196},[146,2634,2400],{"class":210},[146,2636,207],{"class":196},[146,2638,298],{"class":196},[146,2640,2641,2643,2645,2647,2649,2651,2653,2655],{"class":148,"line":1671},[146,2642,606],{"class":196},[146,2644,1425],{"class":210},[146,2646,207],{"class":196},[146,2648,288],{"class":196},[146,2650,222],{"class":196},[146,2652,1434],{"class":210},[146,2654,207],{"class":196},[146,2656,298],{"class":196},[146,2658,2659,2661,2663,2665,2667,2669],{"class":148,"line":1690},[146,2660,606],{"class":196},[146,2662,1445],{"class":210},[146,2664,207],{"class":196},[146,2666,288],{"class":196},[146,2668,1452],{"class":400},[146,2670,298],{"class":196},[146,2672,2673,2675,2677,2679,2681],{"class":148,"line":1704},[146,2674,606],{"class":196},[146,2676,777],{"class":210},[146,2678,207],{"class":196},[146,2680,288],{"class":196},[146,2682,784],{"class":196},[146,2684,2685,2687,2690,2692],{"class":148,"line":1710},[146,2686,789],{"class":196},[146,2688,2689],{"class":210},"AI",[146,2691,207],{"class":196},[146,2693,298],{"class":196},[146,2695,2696,2698,2700,2702],{"class":148,"line":1715},[146,2697,789],{"class":196},[146,2699,2455],{"class":210},[146,2701,207],{"class":196},[146,2703,298],{"class":196},[146,2705,2706,2708,2711],{"class":148,"line":1735},[146,2707,789],{"class":196},[146,2709,2710],{"class":210},"Type",[146,2712,228],{"class":196},[146,2714,2715],{"class":148,"line":1754},[146,2716,1502],{"class":196},[146,2718,2719,2721,2723,2725,2727,2730],{"class":148,"line":1774},[146,2720,606],{"class":196},[146,2722,1509],{"class":210},[146,2724,207],{"class":196},[146,2726,288],{"class":196},[146,2728,2729],{"class":400}," 1762675206651",[146,2731,298],{"class":196},[146,2733,2734,2736,2738,2740,2742],{"class":148,"line":1794},[146,2735,606],{"class":196},[146,2737,1525],{"class":210},[146,2739,207],{"class":196},[146,2741,288],{"class":196},[146,2743,2744],{"class":400}," 0.00010301525\n",[146,2746,2747],{"class":148,"line":1810},[146,2748,687],{"class":196},[146,2750,2751],{"class":148,"line":1829},[146,2752,1541],{"class":196},[146,2754,2755,2757,2759,2761,2763],{"class":148,"line":1848},[146,2756,280],{"class":196},[146,2758,1548],{"class":210},[146,2760,207],{"class":196},[146,2762,288],{"class":196},[146,2764,2765],{"class":196}," [],\n",[146,2767,2768,2770,2772,2774,2776],{"class":148,"line":1862},[146,2769,280],{"class":196},[146,2771,1877],{"class":210},[146,2773,207],{"class":196},[146,2775,288],{"class":196},[146,2777,2778],{"class":196}," \"\"\n",[146,2780,2781],{"class":148,"line":1867},[146,2782,347],{"class":196},[25,2784],{},[886,2786,2788],{"id":2787},"search-memory-with-filters","Search Memory with Filters",[14,2790,2791],{},"MemOS provides a powerful memory filter feature that allows developers to filter memories based on their properties. This feature is particularly useful when you need to retrieve memories based on specific characteristics, such as the creation time of the memory, the associated conversation ID, or the type of memory.",[14,2793,2794],{},"The following is an example of using a memory filter to filter out all memories that contain \"Study Plan\" in their tags and were created after 2025-11-09:",[133,2796,2797,3233],{},[136,2798,2800],{"className":138,"code":2799,"filename":140,"language":141,"meta":142,"style":142},"import os\nimport json\nimport requests\n\nos.environ[\"MEMOS_API_KEY\"] = \"YOUR_API_KEY\"\nos.environ[\"MEMOS_BASE_URL\"] = \"https://api.memt.ai/openmem/v1\"\n\n# headers and base URL\nheaders = {\n  \"Authorization\": f\"Token {os.environ['MEMOS_API_KEY']}\",\n  \"Content-Type\": \"application/json\"\n}\nBASE_URL = os.environ['MEMOS_BASE_URL']\n\nquery_text = \"What are my persona keywords?\"\n\ndata = {\n    \"user_id\": \"memos_user_123\",\n    \"query\": query_text,\n    \"filter\": {\n        \"and\": [\n            {\"tags\": {\"contains\": \"Study Plan\"}},\n            {\"create_time\": {\"gt\": \"2025-11-09\"}}\n        ]\n    } # By passing the filter field, filter out all memories that contain \"Study Plan\" in their tags and were created after 2025-11-09\n}\n\n# Call /search/memory to query relevant memories\nres = requests.post(f\"{BASE_URL}/search/memory\", headers=headers, data=json.dumps(data))\n\nprint(f\"result: {res.json()}\")\n",[122,2801,2802,2808,2814,2820,2824,2850,2876,2880,2884,2892,2930,2946,2950,2972,2976,2989,2993,3001,3019,3033,3046,3059,3093,3126,3131,3139,3143,3147,3151,3203,3207],{"__ignoreMap":142},[146,2803,2804,2806],{"class":148,"line":149},[146,2805,153],{"class":152},[146,2807,157],{"class":156},[146,2809,2810,2812],{"class":148,"line":160},[146,2811,153],{"class":152},[146,2813,173],{"class":156},[146,2815,2816,2818],{"class":148,"line":168},[146,2817,153],{"class":152},[146,2819,165],{"class":156},[146,2821,2822],{"class":148,"line":176},[146,2823,180],{"emptyLinePlaceholder":179},[146,2825,2826,2828,2830,2832,2834,2836,2838,2840,2842,2844,2846,2848],{"class":148,"line":183},[146,2827,193],{"class":156},[146,2829,197],{"class":196},[146,2831,201],{"class":200},[146,2833,204],{"class":196},[146,2835,207],{"class":196},[146,2837,211],{"class":210},[146,2839,207],{"class":196},[146,2841,216],{"class":196},[146,2843,219],{"class":196},[146,2845,222],{"class":196},[146,2847,225],{"class":210},[146,2849,228],{"class":196},[146,2851,2852,2854,2856,2858,2860,2862,2864,2866,2868,2870,2872,2874],{"class":148,"line":190},[146,2853,193],{"class":156},[146,2855,197],{"class":196},[146,2857,201],{"class":200},[146,2859,204],{"class":196},[146,2861,207],{"class":196},[146,2863,244],{"class":210},[146,2865,207],{"class":196},[146,2867,216],{"class":196},[146,2869,219],{"class":196},[146,2871,222],{"class":196},[146,2873,255],{"class":210},[146,2875,228],{"class":196},[146,2877,2878],{"class":148,"line":231},[146,2879,180],{"emptyLinePlaceholder":179},[146,2881,2882],{"class":148,"line":260},[146,2883,1000],{"class":186},[146,2885,2886,2888,2890],{"class":148,"line":265},[146,2887,353],{"class":156},[146,2889,271],{"class":196},[146,2891,274],{"class":196},[146,2893,2894,2896,2898,2900,2902,2904,2906,2908,2910,2912,2914,2916,2918,2920,2922,2924,2926,2928],{"class":148,"line":277},[146,2895,280],{"class":196},[146,2897,386],{"class":210},[146,2899,207],{"class":196},[146,2901,288],{"class":196},[146,2903,394],{"class":393},[146,2905,397],{"class":210},[146,2907,401],{"class":400},[146,2909,193],{"class":156},[146,2911,197],{"class":196},[146,2913,201],{"class":200},[146,2915,204],{"class":196},[146,2917,412],{"class":196},[146,2919,211],{"class":210},[146,2921,412],{"class":196},[146,2923,216],{"class":196},[146,2925,421],{"class":400},[146,2927,207],{"class":210},[146,2929,298],{"class":196},[146,2931,2932,2934,2936,2938,2940,2942,2944],{"class":148,"line":301},[146,2933,280],{"class":196},[146,2935,365],{"class":210},[146,2937,207],{"class":196},[146,2939,288],{"class":196},[146,2941,222],{"class":196},[146,2943,374],{"class":210},[146,2945,228],{"class":196},[146,2947,2948],{"class":148,"line":322},[146,2949,347],{"class":196},[146,2951,2952,2954,2956,2958,2960,2962,2964,2966,2968,2970],{"class":148,"line":344},[146,2953,1071],{"class":156},[146,2955,271],{"class":196},[146,2957,1076],{"class":156},[146,2959,197],{"class":196},[146,2961,201],{"class":200},[146,2963,204],{"class":196},[146,2965,412],{"class":196},[146,2967,244],{"class":210},[146,2969,412],{"class":196},[146,2971,1091],{"class":196},[146,2973,2974],{"class":148,"line":350},[146,2975,180],{"emptyLinePlaceholder":179},[146,2977,2978,2980,2982,2984,2987],{"class":148,"line":360},[146,2979,1105],{"class":156},[146,2981,271],{"class":196},[146,2983,222],{"class":196},[146,2985,2986],{"class":210},"What are my persona keywords?",[146,2988,228],{"class":196},[146,2990,2991],{"class":148,"line":381},[146,2992,180],{"emptyLinePlaceholder":179},[146,2994,2995,2997,2999],{"class":148,"line":426},[146,2996,268],{"class":156},[146,2998,271],{"class":196},[146,3000,274],{"class":196},[146,3002,3003,3005,3007,3009,3011,3013,3015,3017],{"class":148,"line":431},[146,3004,1131],{"class":196},[146,3006,306],{"class":210},[146,3008,207],{"class":196},[146,3010,288],{"class":196},[146,3012,222],{"class":196},[146,3014,315],{"class":210},[146,3016,207],{"class":196},[146,3018,298],{"class":196},[146,3020,3021,3023,3025,3027,3029,3031],{"class":148,"line":466},[146,3022,1131],{"class":196},[146,3024,283],{"class":210},[146,3026,207],{"class":196},[146,3028,288],{"class":196},[146,3030,1180],{"class":156},[146,3032,298],{"class":196},[146,3034,3035,3037,3040,3042,3044],{"class":148,"line":471},[146,3036,1131],{"class":196},[146,3038,3039],{"class":210},"filter",[146,3041,207],{"class":196},[146,3043,288],{"class":196},[146,3045,274],{"class":196},[146,3047,3048,3050,3053,3055,3057],{"class":148,"line":533},[146,3049,789],{"class":196},[146,3051,3052],{"class":210},"and",[146,3054,207],{"class":196},[146,3056,288],{"class":196},[146,3058,784],{"class":196},[146,3060,3061,3064,3066,3068,3070,3072,3075,3077,3080,3082,3084,3086,3088,3090],{"class":148,"line":538},[146,3062,3063],{"class":196},"            {",[146,3065,207],{"class":196},[146,3067,777],{"class":210},[146,3069,207],{"class":196},[146,3071,288],{"class":196},[146,3073,3074],{"class":196}," {",[146,3076,207],{"class":196},[146,3078,3079],{"class":210},"contains",[146,3081,207],{"class":196},[146,3083,288],{"class":196},[146,3085,222],{"class":196},[146,3087,2466],{"class":210},[146,3089,207],{"class":196},[146,3091,3092],{"class":196},"}},\n",[146,3094,3095,3097,3099,3101,3103,3105,3107,3109,3112,3114,3116,3118,3121,3123],{"class":148,"line":821},[146,3096,3063],{"class":196},[146,3098,207],{"class":196},[146,3100,1391],{"class":210},[146,3102,207],{"class":196},[146,3104,288],{"class":196},[146,3106,3074],{"class":196},[146,3108,207],{"class":196},[146,3110,3111],{"class":210},"gt",[146,3113,207],{"class":196},[146,3115,288],{"class":196},[146,3117,222],{"class":196},[146,3119,3120],{"class":210},"2025-11-09",[146,3122,207],{"class":196},[146,3124,3125],{"class":196},"}}\n",[146,3127,3128],{"class":148,"line":831},[146,3129,3130],{"class":196},"        ]\n",[146,3132,3133,3136],{"class":148,"line":837},[146,3134,3135],{"class":196},"    }",[146,3137,3138],{"class":186}," # By passing the filter field, filter out all memories that contain \"Study Plan\" in their tags and were created after 2025-11-09\n",[146,3140,3141],{"class":148,"line":842},[146,3142,347],{"class":196},[146,3144,3145],{"class":148,"line":1256},[146,3146,180],{"emptyLinePlaceholder":179},[146,3148,3149],{"class":148,"line":1652},[146,3150,1195],{"class":186},[146,3152,3153,3155,3157,3159,3161,3163,3165,3167,3169,3171,3173,3175,3177,3179,3181,3183,3185,3187,3189,3191,3193,3195,3197,3199,3201],{"class":148,"line":1671},[146,3154,474],{"class":156},[146,3156,271],{"class":196},[146,3158,479],{"class":156},[146,3160,197],{"class":196},[146,3162,485],{"class":484},[146,3164,488],{"class":196},[146,3166,546],{"class":393},[146,3168,207],{"class":210},[146,3170,401],{"class":400},[146,3172,1218],{"class":484},[146,3174,421],{"class":400},[146,3176,1223],{"class":210},[146,3178,499],{"class":196},[146,3180,502],{"class":491},[146,3182,271],{"class":196},[146,3184,507],{"class":484},[146,3186,499],{"class":196},[146,3188,512],{"class":491},[146,3190,271],{"class":196},[146,3192,517],{"class":484},[146,3194,197],{"class":196},[146,3196,522],{"class":484},[146,3198,488],{"class":196},[146,3200,527],{"class":484},[146,3202,530],{"class":196},[146,3204,3205],{"class":148,"line":1690},[146,3206,180],{"emptyLinePlaceholder":179},[146,3208,3209,3211,3213,3215,3217,3219,3221,3223,3225,3227,3229,3231],{"class":148,"line":1704},[146,3210,541],{"class":484},[146,3212,488],{"class":196},[146,3214,546],{"class":393},[146,3216,549],{"class":210},[146,3218,401],{"class":400},[146,3220,554],{"class":484},[146,3222,197],{"class":196},[146,3224,517],{"class":484},[146,3226,561],{"class":196},[146,3228,421],{"class":400},[146,3230,207],{"class":210},[146,3232,568],{"class":196},[136,3234,3236],{"className":138,"code":3235,"filename":572,"language":141,"meta":142,"style":142},"Example return (showing recalled memory fragments)\n{\n  \"memory_detail_list\": [\n    {\n      \"id\": \"00d8bb4e-aa8c-4fee-a83e-bf67ed6c3ea1\",\n      \"memory_key\": \"Matters hoping AI can help with\",\n      \"memory_value\": \"The user hopes AI can help plan daily study schedules, recommend movies and books, and provide emotional companionship.\",\n      \"memory_type\": \"WorkingMemory\",\n      \"create_time\": 1762675190743,\n      \"conversation_id\": \"memos_conversation_456\",\n      \"status\": \"activated\",\n      \"confidence\": 0.99,\n      \"tags\": [\n        \"Help\",\n        \"Study Plan\",\n        \"Recommendation\",\n        \"Companionship\"\n      ],\n      \"update_time\": 1762675209112,\n      \"relativity\": 0.00013480317\n    }\n  ],\n  \"preference_detail_list\": [],\n  \"preference_note\": \"\"\n}\n",[122,3237,3238,3254,3258,3270,3274,3292,3311,3330,3348,3362,3380,3398,3412,3424,3434,3444,3455,3463,3467,3481,3493,3497,3501,3513,3525],{"__ignoreMap":142},[146,3239,3240,3243,3246,3249,3252],{"class":148,"line":149},[146,3241,3242],{"class":156},"Example ",[146,3244,3245],{"class":152},"return",[146,3247,3248],{"class":196}," (",[146,3250,3251],{"class":156},"showing recalled memory fragments",[146,3253,568],{"class":196},[146,3255,3256],{"class":148,"line":160},[146,3257,2278],{"class":196},[146,3259,3260,3262,3264,3266,3268],{"class":148,"line":168},[146,3261,280],{"class":196},[146,3263,1296],{"class":210},[146,3265,207],{"class":196},[146,3267,288],{"class":196},[146,3269,784],{"class":196},[146,3271,3272],{"class":148,"line":176},[146,3273,601],{"class":196},[146,3275,3276,3278,3280,3282,3284,3286,3288,3290],{"class":148,"line":183},[146,3277,606],{"class":196},[146,3279,1313],{"class":210},[146,3281,207],{"class":196},[146,3283,288],{"class":196},[146,3285,222],{"class":196},[146,3287,2309],{"class":210},[146,3289,207],{"class":196},[146,3291,298],{"class":196},[146,3293,3294,3296,3298,3300,3302,3304,3307,3309],{"class":148,"line":190},[146,3295,606],{"class":196},[146,3297,719],{"class":210},[146,3299,207],{"class":196},[146,3301,288],{"class":196},[146,3303,222],{"class":196},[146,3305,3306],{"class":210},"Matters hoping AI can help with",[146,3308,207],{"class":196},[146,3310,298],{"class":196},[146,3312,3313,3315,3317,3319,3321,3323,3326,3328],{"class":148,"line":231},[146,3314,606],{"class":196},[146,3316,739],{"class":210},[146,3318,207],{"class":196},[146,3320,288],{"class":196},[146,3322,222],{"class":196},[146,3324,3325],{"class":210},"The user hopes AI can help plan daily study schedules, recommend movies and books, and provide emotional companionship.",[146,3327,207],{"class":196},[146,3329,298],{"class":196},[146,3331,3332,3334,3336,3338,3340,3342,3344,3346],{"class":148,"line":260},[146,3333,606],{"class":196},[146,3335,1371],{"class":210},[146,3337,207],{"class":196},[146,3339,288],{"class":196},[146,3341,222],{"class":196},[146,3343,2366],{"class":210},[146,3345,207],{"class":196},[146,3347,298],{"class":196},[146,3349,3350,3352,3354,3356,3358,3360],{"class":148,"line":265},[146,3351,606],{"class":196},[146,3353,1391],{"class":210},[146,3355,207],{"class":196},[146,3357,288],{"class":196},[146,3359,2383],{"class":400},[146,3361,298],{"class":196},[146,3363,3364,3366,3368,3370,3372,3374,3376,3378],{"class":148,"line":277},[146,3365,606],{"class":196},[146,3367,327],{"class":210},[146,3369,207],{"class":196},[146,3371,288],{"class":196},[146,3373,222],{"class":196},[146,3375,2400],{"class":210},[146,3377,207],{"class":196},[146,3379,298],{"class":196},[146,3381,3382,3384,3386,3388,3390,3392,3394,3396],{"class":148,"line":301},[146,3383,606],{"class":196},[146,3385,1425],{"class":210},[146,3387,207],{"class":196},[146,3389,288],{"class":196},[146,3391,222],{"class":196},[146,3393,1434],{"class":210},[146,3395,207],{"class":196},[146,3397,298],{"class":196},[146,3399,3400,3402,3404,3406,3408,3410],{"class":148,"line":322},[146,3401,606],{"class":196},[146,3403,1445],{"class":210},[146,3405,207],{"class":196},[146,3407,288],{"class":196},[146,3409,1452],{"class":400},[146,3411,298],{"class":196},[146,3413,3414,3416,3418,3420,3422],{"class":148,"line":344},[146,3415,606],{"class":196},[146,3417,777],{"class":210},[146,3419,207],{"class":196},[146,3421,288],{"class":196},[146,3423,784],{"class":196},[146,3425,3426,3428,3430,3432],{"class":148,"line":350},[146,3427,789],{"class":196},[146,3429,2455],{"class":210},[146,3431,207],{"class":196},[146,3433,298],{"class":196},[146,3435,3436,3438,3440,3442],{"class":148,"line":360},[146,3437,789],{"class":196},[146,3439,2466],{"class":210},[146,3441,207],{"class":196},[146,3443,298],{"class":196},[146,3445,3446,3448,3451,3453],{"class":148,"line":381},[146,3447,789],{"class":196},[146,3449,3450],{"class":210},"Recommendation",[146,3452,207],{"class":196},[146,3454,298],{"class":196},[146,3456,3457,3459,3461],{"class":148,"line":426},[146,3458,789],{"class":196},[146,3460,2488],{"class":210},[146,3462,228],{"class":196},[146,3464,3465],{"class":148,"line":431},[146,3466,1502],{"class":196},[146,3468,3469,3471,3473,3475,3477,3479],{"class":148,"line":466},[146,3470,606],{"class":196},[146,3472,1509],{"class":210},[146,3474,207],{"class":196},[146,3476,288],{"class":196},[146,3478,2507],{"class":400},[146,3480,298],{"class":196},[146,3482,3483,3485,3487,3489,3491],{"class":148,"line":471},[146,3484,606],{"class":196},[146,3486,1525],{"class":210},[146,3488,207],{"class":196},[146,3490,288],{"class":196},[146,3492,2522],{"class":400},[146,3494,3495],{"class":148,"line":533},[146,3496,687],{"class":196},[146,3498,3499],{"class":148,"line":538},[146,3500,1541],{"class":196},[146,3502,3503,3505,3507,3509,3511],{"class":148,"line":821},[146,3504,280],{"class":196},[146,3506,1548],{"class":210},[146,3508,207],{"class":196},[146,3510,288],{"class":196},[146,3512,2765],{"class":196},[146,3514,3515,3517,3519,3521,3523],{"class":148,"line":831},[146,3516,280],{"class":196},[146,3518,1877],{"class":210},[146,3520,207],{"class":196},[146,3522,288],{"class":196},[146,3524,2778],{"class":196},[146,3526,3527],{"class":148,"line":837},[146,3528,347],{"class":196},[14,3530,3531,3532,197],{},"For more filtering options in the filter, please refer to ",[20,3533,3535],{"href":3534},"/memos_cloud/features/basic/filters","Memory Filters",[25,3537],{},[37,3539,3541],{"id":3540},"_7-more-features","7. More Features",[45,3543,3544],{},[14,3545,3546,3547,197],{}," For a complete list of API fields, formats, etc., please see ",[20,3548,3549],{"href":22},"Search Memory API Docs",[3551,3552,3553,3576],"table",{},[3554,3555,3556],"thead",{},[3557,3558,3559,3566,3571],"tr",{},[3560,3561,3563],"th",{"align":3562},"left",[17,3564,3565],{},"Feature",[3560,3567,3568],{"align":3562},[17,3569,3570],{},"Related Field",[3560,3572,3573],{"align":3562},[17,3574,3575],{},"Description",[3577,3578,3579,3604,3630],"tbody",{},[3557,3580,3581,3585,3601],{},[3582,3583,3584],"td",{"align":3562},"Recall Preference Memory",[3582,3586,3587,3590,3592,3596,3598],{"align":3562},[122,3588,3589],{},"include_preference",[25,3591],{},[146,3593,3595],{"style":3594},"line-height:0.6;"," ",[25,3597],{},[122,3599,3600],{},"preference_limit_number",[3582,3602,3603],{"align":3562},"Preference memory is user preference information generated by MemOS based on user historical message analysis. After enabling, user preference memories can be recalled in retrieval results.",[3557,3605,3606,3609,3623],{},[3582,3607,3608],{"align":3562},"Recall Tool Memory",[3582,3610,3611,3614,3616,3618,3620],{"align":3562},[122,3612,3613],{},"include_tool_memory",[25,3615],{},[146,3617,3595],{"style":3594},[25,3619],{},[122,3621,3622],{},"tool_memory_limit_number",[3582,3624,3625,3626,197],{"align":3562},"Tool memory is memory generated by MemOS after analyzing added tool calling information. After enabling, tool memories can be recalled in retrieval results. See ",[20,3627,3629],{"href":3628},"/memos_cloud/features/advanced/tool_calling","Tool Calling",[3557,3631,3632,3635,3640],{},[3582,3633,3634],{"align":3562},"Search Specific Knowledge Base",[3582,3636,3637],{"align":3562},[122,3638,3639],{},"knowledgebase_ids",[3582,3641,3642,3643,197],{"align":3562},"Used to specify the scope of project-associated knowledge bases accessible for this retrieval. Developers can use this to implement fine-grained permission control and flexibly define the set of knowledge bases accessible to different end users. See ",[20,3644,3646],{"href":3645},"/memos_cloud/features/advanced/knowledge_base","Knowledge Base",[3648,3649,3650],"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":142,"searchDepth":160,"depth":160,"links":3652},[3653,3654,3655,3656,3657,3658,3663],{"id":39,"depth":160,"text":40},{"id":70,"depth":160,"text":71},{"id":90,"depth":160,"text":91},{"id":130,"depth":160,"text":131},{"id":857,"depth":160,"text":858},{"id":883,"depth":160,"text":884,"children":3659},[3660,3661,3662],{"id":888,"depth":168,"text":889},{"id":1913,"depth":168,"text":1914},{"id":2787,"depth":168,"text":2788},{"id":3540,"depth":160,"text":3541},"MemOS recalls relevant memories through semantic retrieval and filtering functions.","md",{},"/en/memos_cloud/mem_operations/search_memory",{"title":5,"description":142},"en/memos_cloud/mem_operations/search_memory","xAbb8raaR2Y5E8lNezgQwGm0kiAosdrZJc5F-p9dakg",[3672,3678],{"title":906,"path":905,"stem":3673,"icon":3674,"framework":6,"module":6,"class":3675,"target":-1,"active":3676,"defaultOpen":3676,"children":-1,"description":3677},"memos_cloud/mem_operations/add_message","i-ri-message-3-line",[],false,"MemOS automatically processes multimodal content you add, such as text, files, and images, into retrievable personal memories.",{"title":3679,"path":3680,"stem":3681,"icon":3682,"framework":6,"module":6,"class":3683,"target":-1,"active":3676,"defaultOpen":3676,"children":-1,"description":3684},"Delete Memory","/memos_cloud/mem_operations/delete_memory","memos_cloud/mem_operations/delete_memory","i-ri-delete-bin-line",[],"Delete memories from MemOS, supporting batch deletion of memories for multiple users.",1770372079799]