[{"data":1,"prerenderedAt":2385},["ShallowReactive",2],{"\u002Fcn\u002Fmemos_cloud\u002Fmem_operations\u002Fsearch_memory":3,"surround-\u002Fcn\u002Fmemos_cloud\u002Fmem_operations\u002Fsearch_memory":2369},{"id":4,"title":5,"avatar":6,"banner":6,"body":7,"category":6,"desc":2362,"description":161,"extension":2363,"links":6,"meta":2364,"navigation":6,"path":2365,"seo":2366,"stem":2367,"__hash__":2368},"docs\u002Fcn\u002Fmemos_cloud\u002Fmem_operations\u002Fsearch_memory.md","Search Memory",null,{"type":8,"value":9,"toc":2349},"minimark",[10,34,36,41,44,66,68,72,92,94,98,137,145,147,151,866,874,876,880,892,900,902,906,910,916,927,1544,1546,1549,1552,1557,2076,2086,2088,2092,2101,2112,2203,2209,2211,2215,2223,2345],[11,12,13,29],"warning",{},[14,15,16,24,27],"p",{},[17,18,19],"strong",{},[20,21,23],"a",{"href":22},"\u002Fapi_docs\u002Fcore\u002Fsearch_memory","直接看 API文档 点这里哦",[25,26],"br",{},[25,28],{},[14,30,31],{},[17,32,33],{},"本文聚焦于功能说明，详细接口字段及限制请点击上方文字链接查看",[25,35],{},[37,38,40],"h2",{"id":39},"_1-什么是检索记忆","1. 什么是检索记忆？",[14,42,43],{},"检索记忆是指 MemOS 在用户提出问题时，结合开发者预先定义的过滤条件，从记忆库中召回最相关、最重要的记忆内容。模型在生成回答时，会参考这些已召回的记忆，从而给出更加准确、贴切且符合用户上下文的回复。",[45,46,47,52],"note",{},[14,48,49],{},[17,50,51],{}," 为什么需要检索记忆？",[53,54,56],"div",{"style":55},"padding-left: 2em;",[57,58,59,63],"ul",{},[60,61,62],"li",{},"无需从头构建上下文，直接获取正确且可靠的记忆；",[60,64,65],{},"通过过滤条件等方式，确保召回的记忆始终与当前问题高度相关。",[25,67],{},[37,69,71],{"id":70},"_2-关键参数","2. 关键参数",[57,73,74,80,86],{},[60,75,76,79],{},[17,77,78],{},"查询内容（query）","：用户的提问内容，用于检索的自然语言问题或陈述，系统将基于语义匹配相关记忆。",[60,81,82,85],{},[17,83,84],{},"记忆过滤（filter）","：基于 JSON 的逻辑条件，用于过滤 agent、create_time、tags、info 等字段，缩小记忆检索的范围；例如，仅检索“近30天的记忆”。",[60,87,88,91],{},[17,89,90],{},"相关性阈值（relativity）","：相关性是指召回的记忆与用户提问内容的语义匹配程度，相关性越高，该记忆与当前用户提问越相关。相关性阈值用于约束召回记忆的匹配程度，当前系统默认值为 0.45，低于该值的记忆将被过滤。",[25,93],{},[37,95,97],{"id":96},"_3-工作原理","3. 工作原理",[57,99,100,106,131],{},[60,101,102,105],{},[17,103,104],{},"查询内容重写","：MemOS 会对输入的自然语言查询进行清理与语义增强，自动补全关键信息与检索意图，以提升后续检索的准确性。",[60,107,108,111],{},[17,109,110],{},"记忆召回",[57,112,113,119,125],{},[60,114,115,118],{},[17,116,117],{},"混合检索与排序","：系统基于重写后的查询生成嵌入向量，结合关键词检索与向量语义检索的混合策略召回候选记忆，对候选记忆进行统一排序。",[60,120,121,124],{},[17,122,123],{},"记忆过滤与筛选","：基于逻辑条件与比较运算符对记忆进行结构化过滤，缩小记忆检索的范围；按开发者设定的相关性阈值筛选排序后的记忆，控制召回结果质量。",[60,126,127,130],{},[17,128,129],{},"结果去重","：对召回的候选记忆进行跨源去重与语义聚合处理。",[60,132,133,136],{},[17,134,135],{},"输出记忆","：最终结果将按照设定的记忆条数上限返回，将在600ms内响应并返回，用于后续推理与回答生成。",[14,138,139,140,144],{},"以上所有流程，仅需调用",[141,142,143],"code",{},"search\u002Fmemory","接口即可触发，无需您对用户的记忆手动操作。",[25,146],{},[37,148,150],{"id":149},"_4-快速上手","4. 快速上手",[152,153,154,588],"code-group",{},[155,156,162],"pre",{"className":157,"code":158,"filename":159,"language":160,"meta":161,"style":161},"language-python shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import os\nimport requests\nimport json\n\n# 替换成你的 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  \"query\": \"我国庆想出去玩，帮我推荐个没去过的城市，以及没住过的酒店品牌\",\n  \"user_id\": \"memos_user_123\",\n  \"conversation_id\": \"0928\" # 当前所在的会话ID，非必填。填写后我们会在召回记忆时优先考虑该会话中的内容，但不是强制命中，仅提升相关性权重。\n}\nheaders = {\n  \"Content-Type\": \"application\u002Fjson\",\n  \"Authorization\": f\"Token {os.environ['MEMOS_API_KEY']}\"\n}\nurl = f\"{os.environ['MEMOS_BASE_URL']}\u002Fsearch\u002Fmemory\"\n\nres = requests.post(url=url, headers=headers, data=json.dumps(data))\n\nprint(f\"result: {res.json()}\")\n","Python (HTTP)","python","",[141,163,164,177,185,193,200,207,248,277,282,294,318,339,361,367,377,398,443,448,483,488,550,555],{"__ignoreMap":161},[165,166,169,173],"span",{"class":167,"line":168},"line",1,[165,170,172],{"class":171},"s7zQu","import",[165,174,176],{"class":175},"sTEyZ"," os\n",[165,178,180,182],{"class":167,"line":179},2,[165,181,172],{"class":171},[165,183,184],{"class":175}," requests\n",[165,186,188,190],{"class":167,"line":187},3,[165,189,172],{"class":171},[165,191,192],{"class":175}," json\n",[165,194,196],{"class":167,"line":195},4,[165,197,199],{"emptyLinePlaceholder":198},true,"\n",[165,201,203],{"class":167,"line":202},5,[165,204,206],{"class":205},"sHwdD","# 替换成你的 MemOS API Key\n",[165,208,210,213,217,221,224,227,231,233,236,239,242,245],{"class":167,"line":209},6,[165,211,212],{"class":175},"os",[165,214,216],{"class":215},"sMK4o",".",[165,218,220],{"class":219},"swJcz","environ",[165,222,223],{"class":215},"[",[165,225,226],{"class":215},"\"",[165,228,230],{"class":229},"sfazB","MEMOS_API_KEY",[165,232,226],{"class":215},[165,234,235],{"class":215},"]",[165,237,238],{"class":215}," =",[165,240,241],{"class":215}," \"",[165,243,244],{"class":229},"YOUR_API_KEY",[165,246,247],{"class":215},"\"\n",[165,249,251,253,255,257,259,261,264,266,268,270,272,275],{"class":167,"line":250},7,[165,252,212],{"class":175},[165,254,216],{"class":215},[165,256,220],{"class":219},[165,258,223],{"class":215},[165,260,226],{"class":215},[165,262,263],{"class":229},"MEMOS_BASE_URL",[165,265,226],{"class":215},[165,267,235],{"class":215},[165,269,238],{"class":215},[165,271,241],{"class":215},[165,273,274],{"class":229},"https:\u002F\u002Fmemos.memtensor.cn\u002Fapi\u002Fopenmem\u002Fv1",[165,276,247],{"class":215},[165,278,280],{"class":167,"line":279},8,[165,281,199],{"emptyLinePlaceholder":198},[165,283,285,288,291],{"class":167,"line":284},9,[165,286,287],{"class":175},"data ",[165,289,290],{"class":215},"=",[165,292,293],{"class":215}," {\n",[165,295,297,300,303,305,308,310,313,315],{"class":167,"line":296},10,[165,298,299],{"class":215},"  \"",[165,301,302],{"class":229},"query",[165,304,226],{"class":215},[165,306,307],{"class":215},":",[165,309,241],{"class":215},[165,311,312],{"class":229},"我国庆想出去玩，帮我推荐个没去过的城市，以及没住过的酒店品牌",[165,314,226],{"class":215},[165,316,317],{"class":215},",\n",[165,319,321,323,326,328,330,332,335,337],{"class":167,"line":320},11,[165,322,299],{"class":215},[165,324,325],{"class":229},"user_id",[165,327,226],{"class":215},[165,329,307],{"class":215},[165,331,241],{"class":215},[165,333,334],{"class":229},"memos_user_123",[165,336,226],{"class":215},[165,338,317],{"class":215},[165,340,342,344,347,349,351,353,356,358],{"class":167,"line":341},12,[165,343,299],{"class":215},[165,345,346],{"class":229},"conversation_id",[165,348,226],{"class":215},[165,350,307],{"class":215},[165,352,241],{"class":215},[165,354,355],{"class":229},"0928",[165,357,226],{"class":215},[165,359,360],{"class":205}," # 当前所在的会话ID，非必填。填写后我们会在召回记忆时优先考虑该会话中的内容，但不是强制命中，仅提升相关性权重。\n",[165,362,364],{"class":167,"line":363},13,[165,365,366],{"class":215},"}\n",[165,368,370,373,375],{"class":167,"line":369},14,[165,371,372],{"class":175},"headers ",[165,374,290],{"class":215},[165,376,293],{"class":215},[165,378,380,382,385,387,389,391,394,396],{"class":167,"line":379},15,[165,381,299],{"class":215},[165,383,384],{"class":229},"Content-Type",[165,386,226],{"class":215},[165,388,307],{"class":215},[165,390,241],{"class":215},[165,392,393],{"class":229},"application\u002Fjson",[165,395,226],{"class":215},[165,397,317],{"class":215},[165,399,401,403,406,408,410,414,417,421,423,425,427,429,432,434,436,438,441],{"class":167,"line":400},16,[165,402,299],{"class":215},[165,404,405],{"class":229},"Authorization",[165,407,226],{"class":215},[165,409,307],{"class":215},[165,411,413],{"class":412},"spNyl"," f",[165,415,416],{"class":229},"\"Token ",[165,418,420],{"class":419},"sbssI","{",[165,422,212],{"class":175},[165,424,216],{"class":215},[165,426,220],{"class":219},[165,428,223],{"class":215},[165,430,431],{"class":215},"'",[165,433,230],{"class":229},[165,435,431],{"class":215},[165,437,235],{"class":215},[165,439,440],{"class":419},"}",[165,442,247],{"class":229},[165,444,446],{"class":167,"line":445},17,[165,447,366],{"class":215},[165,449,451,454,456,458,460,462,464,466,468,470,472,474,476,478,480],{"class":167,"line":450},18,[165,452,453],{"class":175},"url ",[165,455,290],{"class":215},[165,457,413],{"class":412},[165,459,226],{"class":229},[165,461,420],{"class":419},[165,463,212],{"class":175},[165,465,216],{"class":215},[165,467,220],{"class":219},[165,469,223],{"class":215},[165,471,431],{"class":215},[165,473,263],{"class":229},[165,475,431],{"class":215},[165,477,235],{"class":215},[165,479,440],{"class":419},[165,481,482],{"class":229},"\u002Fsearch\u002Fmemory\"\n",[165,484,486],{"class":167,"line":485},19,[165,487,199],{"emptyLinePlaceholder":198},[165,489,491,494,496,499,501,505,508,512,514,516,519,522,524,527,529,532,534,537,539,542,544,547],{"class":167,"line":490},20,[165,492,493],{"class":175},"res ",[165,495,290],{"class":215},[165,497,498],{"class":175}," requests",[165,500,216],{"class":215},[165,502,504],{"class":503},"s2Zo4","post",[165,506,507],{"class":215},"(",[165,509,511],{"class":510},"sHdIc","url",[165,513,290],{"class":215},[165,515,511],{"class":503},[165,517,518],{"class":215},",",[165,520,521],{"class":510}," headers",[165,523,290],{"class":215},[165,525,526],{"class":503},"headers",[165,528,518],{"class":215},[165,530,531],{"class":510}," data",[165,533,290],{"class":215},[165,535,536],{"class":503},"json",[165,538,216],{"class":215},[165,540,541],{"class":503},"dumps",[165,543,507],{"class":215},[165,545,546],{"class":503},"data",[165,548,549],{"class":215},"))\n",[165,551,553],{"class":167,"line":552},21,[165,554,199],{"emptyLinePlaceholder":198},[165,556,558,561,563,566,569,571,574,576,578,581,583,585],{"class":167,"line":557},22,[165,559,560],{"class":503},"print",[165,562,507],{"class":215},[165,564,565],{"class":412},"f",[165,567,568],{"class":229},"\"result: ",[165,570,420],{"class":419},[165,572,573],{"class":503},"res",[165,575,216],{"class":215},[165,577,536],{"class":503},[165,579,580],{"class":215},"()",[165,582,440],{"class":419},[165,584,226],{"class":229},[165,586,587],{"class":215},")\n",[155,589,592],{"className":157,"code":590,"filename":591,"language":160,"meta":161,"style":161},"# 示例输出（为了方便理解此处做了简化，仅供参考）\n{\n  # 事实类型的记忆\n  memory_detail_list [\n    {\n      \"memory_key\": \"暑假广州旅游计划\",\n      \"memory_value\": \"用户计划在暑假期间前往广州旅游，并选择了七天连锁酒店作为住宿选项。\",\n      \"conversation_id\": \"0610\",\n      \"tags\": [\n        \"旅游\",\n        \"广州\",\n        \"住宿\",\n        \"酒店\"\n      ]\n    }\n  ],\n  # 偏好类型的记忆\n  preference_detail_list [\n    {\n      \"preference_type\": \"implicit_preference\",  #隐性偏好\n      \"preference\": \"用户可能偏好性价比较高的酒店选择。\",\n      \"reasoning\": \"七天酒店通常以经济实惠著称，而用户选择七天酒店可能表明其在住宿方面倾向于选择性价比较高的选项。虽然用户没有明确提到预算限制或具体酒店偏好，但在提供的选项中选择七天可能反映了对价格和实用性的重视。\",\n      \"conversation_id\": \"0610\"\n    }\n  ]\n}\n","输出",[141,593,594,599,604,609,617,622,643,663,682,696,708,719,730,739,744,749,754,759,766,770,793,813,833,850,855,861],{"__ignoreMap":161},[165,595,596],{"class":167,"line":168},[165,597,598],{"class":205},"# 示例输出（为了方便理解此处做了简化，仅供参考）\n",[165,600,601],{"class":167,"line":179},[165,602,603],{"class":215},"{\n",[165,605,606],{"class":167,"line":187},[165,607,608],{"class":205},"  # 事实类型的记忆\n",[165,610,611,614],{"class":167,"line":195},[165,612,613],{"class":175},"  memory_detail_list ",[165,615,616],{"class":215},"[\n",[165,618,619],{"class":167,"line":202},[165,620,621],{"class":215},"    {\n",[165,623,624,627,630,632,634,636,639,641],{"class":167,"line":209},[165,625,626],{"class":215},"      \"",[165,628,629],{"class":229},"memory_key",[165,631,226],{"class":215},[165,633,307],{"class":215},[165,635,241],{"class":215},[165,637,638],{"class":229},"暑假广州旅游计划",[165,640,226],{"class":215},[165,642,317],{"class":215},[165,644,645,647,650,652,654,656,659,661],{"class":167,"line":250},[165,646,626],{"class":215},[165,648,649],{"class":229},"memory_value",[165,651,226],{"class":215},[165,653,307],{"class":215},[165,655,241],{"class":215},[165,657,658],{"class":229},"用户计划在暑假期间前往广州旅游，并选择了七天连锁酒店作为住宿选项。",[165,660,226],{"class":215},[165,662,317],{"class":215},[165,664,665,667,669,671,673,675,678,680],{"class":167,"line":279},[165,666,626],{"class":215},[165,668,346],{"class":229},[165,670,226],{"class":215},[165,672,307],{"class":215},[165,674,241],{"class":215},[165,676,677],{"class":229},"0610",[165,679,226],{"class":215},[165,681,317],{"class":215},[165,683,684,686,689,691,693],{"class":167,"line":284},[165,685,626],{"class":215},[165,687,688],{"class":229},"tags",[165,690,226],{"class":215},[165,692,307],{"class":215},[165,694,695],{"class":215}," [\n",[165,697,698,701,704,706],{"class":167,"line":296},[165,699,700],{"class":215},"        \"",[165,702,703],{"class":229},"旅游",[165,705,226],{"class":215},[165,707,317],{"class":215},[165,709,710,712,715,717],{"class":167,"line":320},[165,711,700],{"class":215},[165,713,714],{"class":229},"广州",[165,716,226],{"class":215},[165,718,317],{"class":215},[165,720,721,723,726,728],{"class":167,"line":341},[165,722,700],{"class":215},[165,724,725],{"class":229},"住宿",[165,727,226],{"class":215},[165,729,317],{"class":215},[165,731,732,734,737],{"class":167,"line":363},[165,733,700],{"class":215},[165,735,736],{"class":229},"酒店",[165,738,247],{"class":215},[165,740,741],{"class":167,"line":369},[165,742,743],{"class":215},"      ]\n",[165,745,746],{"class":167,"line":379},[165,747,748],{"class":215},"    }\n",[165,750,751],{"class":167,"line":400},[165,752,753],{"class":215},"  ],\n",[165,755,756],{"class":167,"line":445},[165,757,758],{"class":205},"  # 偏好类型的记忆\n",[165,760,761,764],{"class":167,"line":450},[165,762,763],{"class":175},"  preference_detail_list ",[165,765,616],{"class":215},[165,767,768],{"class":167,"line":485},[165,769,621],{"class":215},[165,771,772,774,777,779,781,783,786,788,790],{"class":167,"line":490},[165,773,626],{"class":215},[165,775,776],{"class":229},"preference_type",[165,778,226],{"class":215},[165,780,307],{"class":215},[165,782,241],{"class":215},[165,784,785],{"class":229},"implicit_preference",[165,787,226],{"class":215},[165,789,518],{"class":215},[165,791,792],{"class":205},"  #隐性偏好\n",[165,794,795,797,800,802,804,806,809,811],{"class":167,"line":552},[165,796,626],{"class":215},[165,798,799],{"class":229},"preference",[165,801,226],{"class":215},[165,803,307],{"class":215},[165,805,241],{"class":215},[165,807,808],{"class":229},"用户可能偏好性价比较高的酒店选择。",[165,810,226],{"class":215},[165,812,317],{"class":215},[165,814,815,817,820,822,824,826,829,831],{"class":167,"line":557},[165,816,626],{"class":215},[165,818,819],{"class":229},"reasoning",[165,821,226],{"class":215},[165,823,307],{"class":215},[165,825,241],{"class":215},[165,827,828],{"class":229},"七天酒店通常以经济实惠著称，而用户选择七天酒店可能表明其在住宿方面倾向于选择性价比较高的选项。虽然用户没有明确提到预算限制或具体酒店偏好，但在提供的选项中选择七天可能反映了对价格和实用性的重视。",[165,830,226],{"class":215},[165,832,317],{"class":215},[165,834,836,838,840,842,844,846,848],{"class":167,"line":835},23,[165,837,626],{"class":215},[165,839,346],{"class":229},[165,841,226],{"class":215},[165,843,307],{"class":215},[165,845,241],{"class":215},[165,847,677],{"class":229},[165,849,247],{"class":215},[165,851,853],{"class":167,"line":852},24,[165,854,748],{"class":215},[165,856,858],{"class":167,"line":857},25,[165,859,860],{"class":215},"  ]\n",[165,862,864],{"class":167,"line":863},26,[165,865,366],{"class":215},[45,867,868],{},[14,869,870,871,873],{}," 请注意，",[141,872,325],{},"为必填项，当前每次检索记忆必须指定单个用户。",[25,875],{},[37,877,879],{"id":878},"_5-记忆拼装到prompt示例","5. 记忆拼装到Prompt示例",[45,881,882,889],{},[14,883,884,887],{},[17,885,886],{},"记忆拼装",[25,888],{},[14,890,891],{},"使用召回的记忆需要一定的技巧，下面是拼装示例",[155,893,898],{"className":894,"code":896,"language":897,"meta":161},[895],"language-text","# Role\n你是一个拥有长期记忆能力的智能助手 (MemOS Assistant)。你的目标是结合检索到的记忆片段，为用户提供高度个性化、准确且逻辑严密的回答。\n\n# System Context\n- 当前时间: 2026-01-06 15:05 (请以此作为判断记忆时效性的基准)\n\n# Memory Data\n以下是 MemOS 检索到的相关信息，分为“事实”和“偏好”。\n- **事实 (Facts)**：可能包含用户属性、历史对话记录或第三方信息。\n- **特别注意**：其中标记为 '[assistant观点]'、'[模型总结]' 的内容代表 **AI 过去的推断**，**并非**用户的原话。\n- **偏好 (Preferences)**：用户对回答风格、格式或逻辑的显式\u002F隐式要求。\n\n\u003Cmemories>\n  \u003Cfacts>\n    -[2025-12-26 21:45] 用户计划在暑假期间前往广州旅游，并选择了七天连锁酒店作为住宿选项。\n    -[2025-12-26 14:26] 用户的名字是Grace。\n  \u003C\u002Ffacts>\n\n  \u003Cpreferences>\n    -[2026-01-04 20:41] [显式偏好] 用户喜欢去南方旅游\n    -[2025-12-26 21:45] [隐式偏好] 用户可能偏好性价比较高的酒店选择。\n  \u003C\u002Fpreferences>\n\u003C\u002Fmemories>\n\n# Critical Protocol: Memory Safety (记忆安全协议)\n检索到的记忆可能包含**AI 自身的推测**、**无关噪音**或**主体错误**。你必须严格执行以下**“四步判决”**，只要有一步不通过，就**丢弃**该条记忆：\n\n1. **来源真值检查 (Source Verification)**：\n   - **核心**：区分“用户原话”与“AI 推测”。\n   - 如果记忆带有 '[assistant观点]' 等标签，这仅代表AI过去的**假设**，**不可**将其视为用户的绝对事实。\n   - *反例*：记忆显示 '[assistant观点] 用户酷爱芒果'。如果用户没提，不要主动假设用户喜欢芒果，防止循环幻觉。\n   - **原则：AI 的总结仅供参考，权重大幅低于用户的直接陈述。**\n\n2. **主语归因检查 (Attribution Check)**：\n   - 记忆中的行为主体是“用户本人”吗？\n   - 如果记忆描述的是**第三方**（如“候选人”、“面试者”、“虚构角色”、“案例数据”），**严禁**将其属性归因于用户。\n\n3. **强相关性检查 (Relevance Check)**：\n   - 记忆是否直接有助于回答当前的 'Original Query'？\n   - 如果记忆仅仅是关键词匹配（如：都提到了“代码”）但语境完全不同，**必须忽略**。\n\n4. **时效性检查 (Freshness Check)**：\n   - 记忆内容是否与用户的最新意图冲突？以当前的 'Original Query' 为最高事实标准。\n\n# Instructions\n1. **审视**：先阅读 '\u003Cfacts>'，执行“四步判决”，剔除噪音和不可靠的 AI 观点。\n2. **执行**：\n   - 仅使用通过筛选的记忆补充背景。\n   - 严格遵守 '\u003Cpreferences>' 中的风格要求。\n3. **输出**：直接回答问题，**严禁**提及“记忆库”、“检索”或“AI 观点”等系统内部术语。\n\n# Original Query\n我国庆想出去玩，帮我推荐个没去过的城市，以及没住过的酒店品牌\n\n","text",[141,899,896],{"__ignoreMap":161},[25,901],{},[37,903,905],{"id":904},"_6-更多使用方法","6. 更多使用方法",[907,908,909],"h3",{"id":909},"获取用户整体画像",[14,911,912,913,915],{},"如果你需要对自己开发的应用进行用户分析，或者希望在 AI 应用中向用户实时展示他们的“个人关键印象”，可以调用 MemOS 全局检索用户的记忆，帮助大模型生成用户的个性化画像。此时可以不填写",[141,914,346],{},"哦～",[14,917,918,919,923,924,926],{},"如下示例所示，如果你已经尝试",[20,920,922],{"href":921},"\u002Fmemos_cloud\u002Fmem_operations\u002Fadd_message","添加消息","，添加过用户",[141,925,334],{},"的历史对话消息，你可以一键复制该示例检索用户记忆。",[152,928,929,1274],{},[155,930,932],{"className":157,"code":931,"filename":159,"language":160,"meta":161,"style":161},"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 和 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\n# 直接询问人物画像，作为 query\nquery_text = \"我的人物关键词是什么？\"\n\ndata = {\n    \"user_id\": \"memos_user_123\",\n    \"query\": query_text,\n}\n\n# 调用 \u002Fsearch\u002Fmemory 查询相关记忆\nres = requests.post(f\"{BASE_URL}\u002Fsearch\u002Fmemory\", headers=headers, data=json.dumps(data))\n\nprint(f\"result: {res.json()}\")\n",[141,933,934,940,946,952,956,982,1008,1012,1017,1025,1063,1079,1083,1108,1112,1117,1131,1135,1143,1162,1177,1181,1185,1190,1244,1248],{"__ignoreMap":161},[165,935,936,938],{"class":167,"line":168},[165,937,172],{"class":171},[165,939,176],{"class":175},[165,941,942,944],{"class":167,"line":179},[165,943,172],{"class":171},[165,945,192],{"class":175},[165,947,948,950],{"class":167,"line":187},[165,949,172],{"class":171},[165,951,184],{"class":175},[165,953,954],{"class":167,"line":195},[165,955,199],{"emptyLinePlaceholder":198},[165,957,958,960,962,964,966,968,970,972,974,976,978,980],{"class":167,"line":202},[165,959,212],{"class":175},[165,961,216],{"class":215},[165,963,220],{"class":219},[165,965,223],{"class":215},[165,967,226],{"class":215},[165,969,230],{"class":229},[165,971,226],{"class":215},[165,973,235],{"class":215},[165,975,238],{"class":215},[165,977,241],{"class":215},[165,979,244],{"class":229},[165,981,247],{"class":215},[165,983,984,986,988,990,992,994,996,998,1000,1002,1004,1006],{"class":167,"line":209},[165,985,212],{"class":175},[165,987,216],{"class":215},[165,989,220],{"class":219},[165,991,223],{"class":215},[165,993,226],{"class":215},[165,995,263],{"class":229},[165,997,226],{"class":215},[165,999,235],{"class":215},[165,1001,238],{"class":215},[165,1003,241],{"class":215},[165,1005,274],{"class":229},[165,1007,247],{"class":215},[165,1009,1010],{"class":167,"line":250},[165,1011,199],{"emptyLinePlaceholder":198},[165,1013,1014],{"class":167,"line":279},[165,1015,1016],{"class":205},"# headers 和 base URL\n",[165,1018,1019,1021,1023],{"class":167,"line":284},[165,1020,372],{"class":175},[165,1022,290],{"class":215},[165,1024,293],{"class":215},[165,1026,1027,1029,1031,1033,1035,1037,1039,1041,1043,1045,1047,1049,1051,1053,1055,1057,1059,1061],{"class":167,"line":296},[165,1028,299],{"class":215},[165,1030,405],{"class":229},[165,1032,226],{"class":215},[165,1034,307],{"class":215},[165,1036,413],{"class":412},[165,1038,416],{"class":229},[165,1040,420],{"class":419},[165,1042,212],{"class":175},[165,1044,216],{"class":215},[165,1046,220],{"class":219},[165,1048,223],{"class":215},[165,1050,431],{"class":215},[165,1052,230],{"class":229},[165,1054,431],{"class":215},[165,1056,235],{"class":215},[165,1058,440],{"class":419},[165,1060,226],{"class":229},[165,1062,317],{"class":215},[165,1064,1065,1067,1069,1071,1073,1075,1077],{"class":167,"line":320},[165,1066,299],{"class":215},[165,1068,384],{"class":229},[165,1070,226],{"class":215},[165,1072,307],{"class":215},[165,1074,241],{"class":215},[165,1076,393],{"class":229},[165,1078,247],{"class":215},[165,1080,1081],{"class":167,"line":341},[165,1082,366],{"class":215},[165,1084,1085,1088,1090,1093,1095,1097,1099,1101,1103,1105],{"class":167,"line":363},[165,1086,1087],{"class":175},"BASE_URL ",[165,1089,290],{"class":215},[165,1091,1092],{"class":175}," os",[165,1094,216],{"class":215},[165,1096,220],{"class":219},[165,1098,223],{"class":215},[165,1100,431],{"class":215},[165,1102,263],{"class":229},[165,1104,431],{"class":215},[165,1106,1107],{"class":215},"]\n",[165,1109,1110],{"class":167,"line":369},[165,1111,199],{"emptyLinePlaceholder":198},[165,1113,1114],{"class":167,"line":379},[165,1115,1116],{"class":205},"# 直接询问人物画像，作为 query\n",[165,1118,1119,1122,1124,1126,1129],{"class":167,"line":400},[165,1120,1121],{"class":175},"query_text ",[165,1123,290],{"class":215},[165,1125,241],{"class":215},[165,1127,1128],{"class":229},"我的人物关键词是什么？",[165,1130,247],{"class":215},[165,1132,1133],{"class":167,"line":445},[165,1134,199],{"emptyLinePlaceholder":198},[165,1136,1137,1139,1141],{"class":167,"line":450},[165,1138,287],{"class":175},[165,1140,290],{"class":215},[165,1142,293],{"class":215},[165,1144,1145,1148,1150,1152,1154,1156,1158,1160],{"class":167,"line":485},[165,1146,1147],{"class":215},"    \"",[165,1149,325],{"class":229},[165,1151,226],{"class":215},[165,1153,307],{"class":215},[165,1155,241],{"class":215},[165,1157,334],{"class":229},[165,1159,226],{"class":215},[165,1161,317],{"class":215},[165,1163,1164,1166,1168,1170,1172,1175],{"class":167,"line":490},[165,1165,1147],{"class":215},[165,1167,302],{"class":229},[165,1169,226],{"class":215},[165,1171,307],{"class":215},[165,1173,1174],{"class":175}," query_text",[165,1176,317],{"class":215},[165,1178,1179],{"class":167,"line":552},[165,1180,366],{"class":215},[165,1182,1183],{"class":167,"line":557},[165,1184,199],{"emptyLinePlaceholder":198},[165,1186,1187],{"class":167,"line":835},[165,1188,1189],{"class":205},"# 调用 \u002Fsearch\u002Fmemory 查询相关记忆\n",[165,1191,1192,1194,1196,1198,1200,1202,1204,1206,1208,1210,1213,1215,1218,1220,1222,1224,1226,1228,1230,1232,1234,1236,1238,1240,1242],{"class":167,"line":852},[165,1193,493],{"class":175},[165,1195,290],{"class":215},[165,1197,498],{"class":175},[165,1199,216],{"class":215},[165,1201,504],{"class":503},[165,1203,507],{"class":215},[165,1205,565],{"class":412},[165,1207,226],{"class":229},[165,1209,420],{"class":419},[165,1211,1212],{"class":503},"BASE_URL",[165,1214,440],{"class":419},[165,1216,1217],{"class":229},"\u002Fsearch\u002Fmemory\"",[165,1219,518],{"class":215},[165,1221,521],{"class":510},[165,1223,290],{"class":215},[165,1225,526],{"class":503},[165,1227,518],{"class":215},[165,1229,531],{"class":510},[165,1231,290],{"class":215},[165,1233,536],{"class":503},[165,1235,216],{"class":215},[165,1237,541],{"class":503},[165,1239,507],{"class":215},[165,1241,546],{"class":503},[165,1243,549],{"class":215},[165,1245,1246],{"class":167,"line":857},[165,1247,199],{"emptyLinePlaceholder":198},[165,1249,1250,1252,1254,1256,1258,1260,1262,1264,1266,1268,1270,1272],{"class":167,"line":863},[165,1251,560],{"class":503},[165,1253,507],{"class":215},[165,1255,565],{"class":412},[165,1257,568],{"class":229},[165,1259,420],{"class":419},[165,1261,573],{"class":503},[165,1263,216],{"class":215},[165,1265,536],{"class":503},[165,1267,580],{"class":215},[165,1269,440],{"class":419},[165,1271,226],{"class":229},[165,1273,587],{"class":215},[155,1275,1277],{"className":157,"code":1276,"filename":591,"language":160,"meta":161,"style":161},"# 示例输出（为了方便理解此处做了简化，仅供参考）\n\n{\n  # 事实类型的记忆\n  memory_detail_list [\n    {\n      \"memory_key\": \"希望AI帮助的事项\",\n      \"memory_value\": \"用户希望AI帮助规划日常学习计划、推荐电影和书籍，以及提供心情陪伴。\",\n      \"conversation_id\": \"0610\",\n      \"tags\": [\n        \"帮助\",\n        \"学习计划\",\n        \"推荐\",\n        \"陪伴\"\n      ]\n    },\n    {\n      \"memory_key\": \"希望AI提供的帮助类型\",\n      \"memory_value\": \"用户希望AI提供建议、信息查询和灵感。\",\n      \"conversation_id\": \"0610\",\n      \"tags\": [\n        \"AI\",\n        \"帮助\",\n        \"类型\"\n      ]\n    }\n  ]\n}\n",[141,1278,1279,1283,1287,1291,1295,1301,1305,1324,1343,1361,1373,1384,1395,1406,1415,1419,1424,1428,1447,1466,1484,1496,1507,1517,1526,1530,1534,1539],{"__ignoreMap":161},[165,1280,1281],{"class":167,"line":168},[165,1282,598],{"class":205},[165,1284,1285],{"class":167,"line":179},[165,1286,199],{"emptyLinePlaceholder":198},[165,1288,1289],{"class":167,"line":187},[165,1290,603],{"class":215},[165,1292,1293],{"class":167,"line":195},[165,1294,608],{"class":205},[165,1296,1297,1299],{"class":167,"line":202},[165,1298,613],{"class":175},[165,1300,616],{"class":215},[165,1302,1303],{"class":167,"line":209},[165,1304,621],{"class":215},[165,1306,1307,1309,1311,1313,1315,1317,1320,1322],{"class":167,"line":250},[165,1308,626],{"class":215},[165,1310,629],{"class":229},[165,1312,226],{"class":215},[165,1314,307],{"class":215},[165,1316,241],{"class":215},[165,1318,1319],{"class":229},"希望AI帮助的事项",[165,1321,226],{"class":215},[165,1323,317],{"class":215},[165,1325,1326,1328,1330,1332,1334,1336,1339,1341],{"class":167,"line":279},[165,1327,626],{"class":215},[165,1329,649],{"class":229},[165,1331,226],{"class":215},[165,1333,307],{"class":215},[165,1335,241],{"class":215},[165,1337,1338],{"class":229},"用户希望AI帮助规划日常学习计划、推荐电影和书籍，以及提供心情陪伴。",[165,1340,226],{"class":215},[165,1342,317],{"class":215},[165,1344,1345,1347,1349,1351,1353,1355,1357,1359],{"class":167,"line":284},[165,1346,626],{"class":215},[165,1348,346],{"class":229},[165,1350,226],{"class":215},[165,1352,307],{"class":215},[165,1354,241],{"class":215},[165,1356,677],{"class":229},[165,1358,226],{"class":215},[165,1360,317],{"class":215},[165,1362,1363,1365,1367,1369,1371],{"class":167,"line":296},[165,1364,626],{"class":215},[165,1366,688],{"class":229},[165,1368,226],{"class":215},[165,1370,307],{"class":215},[165,1372,695],{"class":215},[165,1374,1375,1377,1380,1382],{"class":167,"line":320},[165,1376,700],{"class":215},[165,1378,1379],{"class":229},"帮助",[165,1381,226],{"class":215},[165,1383,317],{"class":215},[165,1385,1386,1388,1391,1393],{"class":167,"line":341},[165,1387,700],{"class":215},[165,1389,1390],{"class":229},"学习计划",[165,1392,226],{"class":215},[165,1394,317],{"class":215},[165,1396,1397,1399,1402,1404],{"class":167,"line":363},[165,1398,700],{"class":215},[165,1400,1401],{"class":229},"推荐",[165,1403,226],{"class":215},[165,1405,317],{"class":215},[165,1407,1408,1410,1413],{"class":167,"line":369},[165,1409,700],{"class":215},[165,1411,1412],{"class":229},"陪伴",[165,1414,247],{"class":215},[165,1416,1417],{"class":167,"line":379},[165,1418,743],{"class":215},[165,1420,1421],{"class":167,"line":400},[165,1422,1423],{"class":215},"    },\n",[165,1425,1426],{"class":167,"line":445},[165,1427,621],{"class":215},[165,1429,1430,1432,1434,1436,1438,1440,1443,1445],{"class":167,"line":450},[165,1431,626],{"class":215},[165,1433,629],{"class":229},[165,1435,226],{"class":215},[165,1437,307],{"class":215},[165,1439,241],{"class":215},[165,1441,1442],{"class":229},"希望AI提供的帮助类型",[165,1444,226],{"class":215},[165,1446,317],{"class":215},[165,1448,1449,1451,1453,1455,1457,1459,1462,1464],{"class":167,"line":485},[165,1450,626],{"class":215},[165,1452,649],{"class":229},[165,1454,226],{"class":215},[165,1456,307],{"class":215},[165,1458,241],{"class":215},[165,1460,1461],{"class":229},"用户希望AI提供建议、信息查询和灵感。",[165,1463,226],{"class":215},[165,1465,317],{"class":215},[165,1467,1468,1470,1472,1474,1476,1478,1480,1482],{"class":167,"line":490},[165,1469,626],{"class":215},[165,1471,346],{"class":229},[165,1473,226],{"class":215},[165,1475,307],{"class":215},[165,1477,241],{"class":215},[165,1479,677],{"class":229},[165,1481,226],{"class":215},[165,1483,317],{"class":215},[165,1485,1486,1488,1490,1492,1494],{"class":167,"line":552},[165,1487,626],{"class":215},[165,1489,688],{"class":229},[165,1491,226],{"class":215},[165,1493,307],{"class":215},[165,1495,695],{"class":215},[165,1497,1498,1500,1503,1505],{"class":167,"line":557},[165,1499,700],{"class":215},[165,1501,1502],{"class":229},"AI",[165,1504,226],{"class":215},[165,1506,317],{"class":215},[165,1508,1509,1511,1513,1515],{"class":167,"line":835},[165,1510,700],{"class":215},[165,1512,1379],{"class":229},[165,1514,226],{"class":215},[165,1516,317],{"class":215},[165,1518,1519,1521,1524],{"class":167,"line":852},[165,1520,700],{"class":215},[165,1522,1523],{"class":229},"类型",[165,1525,247],{"class":215},[165,1527,1528],{"class":167,"line":857},[165,1529,743],{"class":215},[165,1531,1532],{"class":167,"line":863},[165,1533,748],{"class":215},[165,1535,1537],{"class":167,"line":1536},27,[165,1538,860],{"class":215},[165,1540,1542],{"class":167,"line":1541},28,[165,1543,366],{"class":215},[25,1545],{},[907,1547,1548],{"id":1548},"精确过滤检索的记忆范围",[14,1550,1551],{},"MemOS 提供了强大的记忆过滤器功能，允许开发者根据检索的记忆进行精确过滤。这一功能在需要根据记忆的特定特征进行检索时尤为有用，例如根据记忆的创建时间、标签、元信息等。",[45,1553,1554],{},[14,1555,1556],{},"以下是一个使用记忆过滤器的示例，假设用户希望对今年所有有关“阅读”的“对话”做出年终总结，那么可以通过过滤出所有标签中包含\"阅读\"、创建时间为2025年、且场景为“对话”的记忆：",[152,1558,1559],{},[155,1560,1562],{"className":157,"code":1561,"filename":159,"language":160,"meta":161,"style":161},"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 和 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\nquery_text = \"我的阅读年终总结\"\n\ndata = {\n    \"user_id\": \"memos_user_123\",\n    \"query\": query_text,\n    \"filter\": {\n        \"and\": [\n            {\"tags\": {\"contains\": \"阅读\"}}, # MemOS 提炼的标签\n            {\"create_time\": {\"gte\": \"2025-01-01\"}}, # MemOS 创建记忆的时间\n            {\"create_time\": {\"gte\": \"2025-12-31\"}}, # MemOS 创建记忆的时间\n            {\"info\":{\"scene\":\"chat\"}} #add message时由开发者自定义传入\n        ]\n    } # 通过传入filter字段，过滤所有标签中包含\"阅读\"、创建时间为2025年、且场景为“对话”的记忆。\n}\n\n# 调用 \u002Fsearch\u002Fmemory 查询相关记忆\nres = requests.post(f\"{BASE_URL}\u002Fsearch\u002Fmemory\", headers=headers, data=json.dumps(data))\n\nprint(f\"result: {res.json()}\")\n",[141,1563,1564,1570,1576,1582,1586,1612,1638,1642,1646,1654,1692,1708,1712,1734,1738,1751,1755,1763,1781,1795,1808,1821,1859,1895,1928,1964,1969,1977,1981,1986,1991,2044,2049],{"__ignoreMap":161},[165,1565,1566,1568],{"class":167,"line":168},[165,1567,172],{"class":171},[165,1569,176],{"class":175},[165,1571,1572,1574],{"class":167,"line":179},[165,1573,172],{"class":171},[165,1575,192],{"class":175},[165,1577,1578,1580],{"class":167,"line":187},[165,1579,172],{"class":171},[165,1581,184],{"class":175},[165,1583,1584],{"class":167,"line":195},[165,1585,199],{"emptyLinePlaceholder":198},[165,1587,1588,1590,1592,1594,1596,1598,1600,1602,1604,1606,1608,1610],{"class":167,"line":202},[165,1589,212],{"class":175},[165,1591,216],{"class":215},[165,1593,220],{"class":219},[165,1595,223],{"class":215},[165,1597,226],{"class":215},[165,1599,230],{"class":229},[165,1601,226],{"class":215},[165,1603,235],{"class":215},[165,1605,238],{"class":215},[165,1607,241],{"class":215},[165,1609,244],{"class":229},[165,1611,247],{"class":215},[165,1613,1614,1616,1618,1620,1622,1624,1626,1628,1630,1632,1634,1636],{"class":167,"line":209},[165,1615,212],{"class":175},[165,1617,216],{"class":215},[165,1619,220],{"class":219},[165,1621,223],{"class":215},[165,1623,226],{"class":215},[165,1625,263],{"class":229},[165,1627,226],{"class":215},[165,1629,235],{"class":215},[165,1631,238],{"class":215},[165,1633,241],{"class":215},[165,1635,274],{"class":229},[165,1637,247],{"class":215},[165,1639,1640],{"class":167,"line":250},[165,1641,199],{"emptyLinePlaceholder":198},[165,1643,1644],{"class":167,"line":279},[165,1645,1016],{"class":205},[165,1647,1648,1650,1652],{"class":167,"line":284},[165,1649,372],{"class":175},[165,1651,290],{"class":215},[165,1653,293],{"class":215},[165,1655,1656,1658,1660,1662,1664,1666,1668,1670,1672,1674,1676,1678,1680,1682,1684,1686,1688,1690],{"class":167,"line":296},[165,1657,299],{"class":215},[165,1659,405],{"class":229},[165,1661,226],{"class":215},[165,1663,307],{"class":215},[165,1665,413],{"class":412},[165,1667,416],{"class":229},[165,1669,420],{"class":419},[165,1671,212],{"class":175},[165,1673,216],{"class":215},[165,1675,220],{"class":219},[165,1677,223],{"class":215},[165,1679,431],{"class":215},[165,1681,230],{"class":229},[165,1683,431],{"class":215},[165,1685,235],{"class":215},[165,1687,440],{"class":419},[165,1689,226],{"class":229},[165,1691,317],{"class":215},[165,1693,1694,1696,1698,1700,1702,1704,1706],{"class":167,"line":320},[165,1695,299],{"class":215},[165,1697,384],{"class":229},[165,1699,226],{"class":215},[165,1701,307],{"class":215},[165,1703,241],{"class":215},[165,1705,393],{"class":229},[165,1707,247],{"class":215},[165,1709,1710],{"class":167,"line":341},[165,1711,366],{"class":215},[165,1713,1714,1716,1718,1720,1722,1724,1726,1728,1730,1732],{"class":167,"line":363},[165,1715,1087],{"class":175},[165,1717,290],{"class":215},[165,1719,1092],{"class":175},[165,1721,216],{"class":215},[165,1723,220],{"class":219},[165,1725,223],{"class":215},[165,1727,431],{"class":215},[165,1729,263],{"class":229},[165,1731,431],{"class":215},[165,1733,1107],{"class":215},[165,1735,1736],{"class":167,"line":369},[165,1737,199],{"emptyLinePlaceholder":198},[165,1739,1740,1742,1744,1746,1749],{"class":167,"line":379},[165,1741,1121],{"class":175},[165,1743,290],{"class":215},[165,1745,241],{"class":215},[165,1747,1748],{"class":229},"我的阅读年终总结",[165,1750,247],{"class":215},[165,1752,1753],{"class":167,"line":400},[165,1754,199],{"emptyLinePlaceholder":198},[165,1756,1757,1759,1761],{"class":167,"line":445},[165,1758,287],{"class":175},[165,1760,290],{"class":215},[165,1762,293],{"class":215},[165,1764,1765,1767,1769,1771,1773,1775,1777,1779],{"class":167,"line":450},[165,1766,1147],{"class":215},[165,1768,325],{"class":229},[165,1770,226],{"class":215},[165,1772,307],{"class":215},[165,1774,241],{"class":215},[165,1776,334],{"class":229},[165,1778,226],{"class":215},[165,1780,317],{"class":215},[165,1782,1783,1785,1787,1789,1791,1793],{"class":167,"line":485},[165,1784,1147],{"class":215},[165,1786,302],{"class":229},[165,1788,226],{"class":215},[165,1790,307],{"class":215},[165,1792,1174],{"class":175},[165,1794,317],{"class":215},[165,1796,1797,1799,1802,1804,1806],{"class":167,"line":490},[165,1798,1147],{"class":215},[165,1800,1801],{"class":229},"filter",[165,1803,226],{"class":215},[165,1805,307],{"class":215},[165,1807,293],{"class":215},[165,1809,1810,1812,1815,1817,1819],{"class":167,"line":552},[165,1811,700],{"class":215},[165,1813,1814],{"class":229},"and",[165,1816,226],{"class":215},[165,1818,307],{"class":215},[165,1820,695],{"class":215},[165,1822,1823,1826,1828,1830,1832,1834,1837,1839,1842,1844,1846,1848,1851,1853,1856],{"class":167,"line":557},[165,1824,1825],{"class":215},"            {",[165,1827,226],{"class":215},[165,1829,688],{"class":229},[165,1831,226],{"class":215},[165,1833,307],{"class":215},[165,1835,1836],{"class":215}," {",[165,1838,226],{"class":215},[165,1840,1841],{"class":229},"contains",[165,1843,226],{"class":215},[165,1845,307],{"class":215},[165,1847,241],{"class":215},[165,1849,1850],{"class":229},"阅读",[165,1852,226],{"class":215},[165,1854,1855],{"class":215},"}},",[165,1857,1858],{"class":205}," # MemOS 提炼的标签\n",[165,1860,1861,1863,1865,1868,1870,1872,1874,1876,1879,1881,1883,1885,1888,1890,1892],{"class":167,"line":835},[165,1862,1825],{"class":215},[165,1864,226],{"class":215},[165,1866,1867],{"class":229},"create_time",[165,1869,226],{"class":215},[165,1871,307],{"class":215},[165,1873,1836],{"class":215},[165,1875,226],{"class":215},[165,1877,1878],{"class":229},"gte",[165,1880,226],{"class":215},[165,1882,307],{"class":215},[165,1884,241],{"class":215},[165,1886,1887],{"class":229},"2025-01-01",[165,1889,226],{"class":215},[165,1891,1855],{"class":215},[165,1893,1894],{"class":205}," # MemOS 创建记忆的时间\n",[165,1896,1897,1899,1901,1903,1905,1907,1909,1911,1913,1915,1917,1919,1922,1924,1926],{"class":167,"line":852},[165,1898,1825],{"class":215},[165,1900,226],{"class":215},[165,1902,1867],{"class":229},[165,1904,226],{"class":215},[165,1906,307],{"class":215},[165,1908,1836],{"class":215},[165,1910,226],{"class":215},[165,1912,1878],{"class":229},[165,1914,226],{"class":215},[165,1916,307],{"class":215},[165,1918,241],{"class":215},[165,1920,1921],{"class":229},"2025-12-31",[165,1923,226],{"class":215},[165,1925,1855],{"class":215},[165,1927,1894],{"class":205},[165,1929,1930,1932,1934,1937,1939,1942,1944,1947,1949,1951,1953,1956,1958,1961],{"class":167,"line":857},[165,1931,1825],{"class":215},[165,1933,226],{"class":215},[165,1935,1936],{"class":229},"info",[165,1938,226],{"class":215},[165,1940,1941],{"class":215},":{",[165,1943,226],{"class":215},[165,1945,1946],{"class":229},"scene",[165,1948,226],{"class":215},[165,1950,307],{"class":215},[165,1952,226],{"class":215},[165,1954,1955],{"class":229},"chat",[165,1957,226],{"class":215},[165,1959,1960],{"class":215},"}}",[165,1962,1963],{"class":205}," #add message时由开发者自定义传入\n",[165,1965,1966],{"class":167,"line":863},[165,1967,1968],{"class":215},"        ]\n",[165,1970,1971,1974],{"class":167,"line":1536},[165,1972,1973],{"class":215},"    }",[165,1975,1976],{"class":205}," # 通过传入filter字段，过滤所有标签中包含\"阅读\"、创建时间为2025年、且场景为“对话”的记忆。\n",[165,1978,1979],{"class":167,"line":1541},[165,1980,366],{"class":215},[165,1982,1984],{"class":167,"line":1983},29,[165,1985,199],{"emptyLinePlaceholder":198},[165,1987,1989],{"class":167,"line":1988},30,[165,1990,1189],{"class":205},[165,1992,1994,1996,1998,2000,2002,2004,2006,2008,2010,2012,2014,2016,2018,2020,2022,2024,2026,2028,2030,2032,2034,2036,2038,2040,2042],{"class":167,"line":1993},31,[165,1995,493],{"class":175},[165,1997,290],{"class":215},[165,1999,498],{"class":175},[165,2001,216],{"class":215},[165,2003,504],{"class":503},[165,2005,507],{"class":215},[165,2007,565],{"class":412},[165,2009,226],{"class":229},[165,2011,420],{"class":419},[165,2013,1212],{"class":503},[165,2015,440],{"class":419},[165,2017,1217],{"class":229},[165,2019,518],{"class":215},[165,2021,521],{"class":510},[165,2023,290],{"class":215},[165,2025,526],{"class":503},[165,2027,518],{"class":215},[165,2029,531],{"class":510},[165,2031,290],{"class":215},[165,2033,536],{"class":503},[165,2035,216],{"class":215},[165,2037,541],{"class":503},[165,2039,507],{"class":215},[165,2041,546],{"class":503},[165,2043,549],{"class":215},[165,2045,2047],{"class":167,"line":2046},32,[165,2048,199],{"emptyLinePlaceholder":198},[165,2050,2052,2054,2056,2058,2060,2062,2064,2066,2068,2070,2072,2074],{"class":167,"line":2051},33,[165,2053,560],{"class":503},[165,2055,507],{"class":215},[165,2057,565],{"class":412},[165,2059,568],{"class":229},[165,2061,420],{"class":419},[165,2063,573],{"class":503},[165,2065,216],{"class":215},[165,2067,536],{"class":503},[165,2069,580],{"class":215},[165,2071,440],{"class":419},[165,2073,226],{"class":229},[165,2075,587],{"class":215},[45,2077,2078],{},[14,2079,2080,2081,2085],{},"有关过滤器中更多筛选选项，请参考",[20,2082,2084],{"href":2083},"\u002Fmemos_cloud\u002Ffeatures\u002Fbasic\u002Ffilters","记忆过滤器","。",[25,2087],{},[907,2089,2091],{"id":2090},"token更少的记忆召回策略","Token更少的记忆召回策略",[14,2093,2094,2095,2085],{},"为了帮助模型获取更高质量、更节省Token的记忆内容，从而减少注入模型的Token消耗数，MemOS支持开发者传入自定义的",[17,2096,90,2097,2100],{},[17,2098,2099],{},"与","召回的记忆条数上限（memory_limit_number等）",[14,2102,2103,2104,2107,2108,2111],{},"如下所示，开发者传入",[141,2105,2106],{},"relativity = 0.8"," ",[141,2109,2110],{},"memory_limit_number = 9","，最终返回小于9条且相关性均高于0.8的记忆。",[155,2113,2115],{"className":157,"code":2114,"language":160,"meta":161,"style":161},"data = {\n    \"user_id\": \"memos_user_123\",\n    \"query\": \"为我规划5天的成都游。\",\n    \"relativity\": 0.8, # 相关性阈值，不传则默认为0，表示限制返回的记忆相关性。\n    \"memory_limit_number\" = 9 # 召回的记忆上限条数，不传则默认为9，表示默认召回9条最相关的记忆。\n}\n",[141,2116,2117,2125,2143,2162,2181,2199],{"__ignoreMap":161},[165,2118,2119,2121,2123],{"class":167,"line":168},[165,2120,287],{"class":175},[165,2122,290],{"class":215},[165,2124,293],{"class":215},[165,2126,2127,2129,2131,2133,2135,2137,2139,2141],{"class":167,"line":179},[165,2128,1147],{"class":215},[165,2130,325],{"class":229},[165,2132,226],{"class":215},[165,2134,307],{"class":215},[165,2136,241],{"class":215},[165,2138,334],{"class":229},[165,2140,226],{"class":215},[165,2142,317],{"class":215},[165,2144,2145,2147,2149,2151,2153,2155,2158,2160],{"class":167,"line":187},[165,2146,1147],{"class":215},[165,2148,302],{"class":229},[165,2150,226],{"class":215},[165,2152,307],{"class":215},[165,2154,241],{"class":215},[165,2156,2157],{"class":229},"为我规划5天的成都游。",[165,2159,226],{"class":215},[165,2161,317],{"class":215},[165,2163,2164,2166,2169,2171,2173,2176,2178],{"class":167,"line":195},[165,2165,1147],{"class":215},[165,2167,2168],{"class":229},"relativity",[165,2170,226],{"class":215},[165,2172,307],{"class":215},[165,2174,2175],{"class":419}," 0.8",[165,2177,518],{"class":215},[165,2179,2180],{"class":205}," # 相关性阈值，不传则默认为0，表示限制返回的记忆相关性。\n",[165,2182,2183,2185,2188,2190,2193,2196],{"class":167,"line":202},[165,2184,1147],{"class":215},[165,2186,2187],{"class":229},"memory_limit_number",[165,2189,226],{"class":215},[165,2191,2192],{"class":175}," = ",[165,2194,2195],{"class":419},"9",[165,2197,2198],{"class":205}," # 召回的记忆上限条数，不传则默认为9，表示默认召回9条最相关的记忆。\n",[165,2200,2201],{"class":167,"line":209},[165,2202,366],{"class":215},[14,2204,2205,2206,2208],{},"请注意，当前",[141,2207,2168],{},"仅对事实、偏好记忆生效。",[25,2210],{},[37,2212,2214],{"id":2213},"_7-更多功能","7. 更多功能",[45,2216,2217],{},[14,2218,2219,2220,2085],{}," 有关 API 字段、格式等信息的完整列表，详见",[20,2221,2222],{"href":22},"Search Memory接口文档",[2224,2225,2226,2248],"table",{},[2227,2228,2229],"thead",{},[2230,2231,2232,2238,2243],"tr",{},[2233,2234,2235],"th",{},[17,2236,2237],{},"功能",[2233,2239,2240],{},[17,2241,2242],{},"相关字段",[2233,2244,2245],{},[17,2246,2247],{},"说明",[2249,2250,2251,2276,2302,2328],"tbody",{},[2230,2252,2253,2257,2273],{},[2254,2255,2256],"td",{},"召回偏好记忆",[2254,2258,2259,2262,2264,2268,2270],{},[141,2260,2261],{},"include_preference",[25,2263],{},[165,2265,2267],{"style":2266},"line-height:0.6;"," ",[25,2269],{},[141,2271,2272],{},"preference_limit_number",[2254,2274,2275],{},"偏好记忆是 MemOS 基于用户历史消息分析生成的用户偏好信息。开启后，可在检索结果中召回用户偏好记忆。",[2230,2277,2278,2281,2295],{},[2254,2279,2280],{},"召回工具记忆",[2254,2282,2283,2286,2288,2290,2292],{},[141,2284,2285],{},"include_tool_memory",[25,2287],{},[165,2289,2267],{"style":2266},[25,2291],{},[141,2293,2294],{},"tool_memory_limit_number",[2254,2296,2297,2298,2085],{},"工具记忆是 MemOS 对已添加的工具调用信息进行分析后生成的记忆。开启后，可在检索结果中召回工具记忆，详见",[20,2299,2301],{"href":2300},"\u002Fmemos_cloud\u002Ffeatures\u002Fadvanced\u002Ftool_calling","工具调用",[2230,2303,2304,2307,2321],{},[2254,2305,2306],{},"召回技能",[2254,2308,2309,2312,2314,2316,2318],{},[141,2310,2311],{},"include_skill",[25,2313],{},[165,2315,2267],{"style":2266},[25,2317],{},[141,2319,2320],{},"skill_limit_number",[2254,2322,2323,2324,2085],{},"技能是 MemOS 基于用户记忆生成的 Agent 可复用的执行能力。开启后，可在检索结果中召回技能，详见",[20,2325,2327],{"href":2326},"\u002Fmemos_cloud\u002Ffeatures\u002Fadvanced\u002Fskill","技能",[2230,2329,2330,2333,2338],{},[2254,2331,2332],{},"检索指定知识库",[2254,2334,2335],{},[141,2336,2337],{},"knowledgebase_ids",[2254,2339,2340,2341,2085],{},"用于指定本次检索可访问的项目关联知识库范围。开发者可借此实现精细的权限控制，灵活定义不同终端用户可访问的知识库集合，详见",[20,2342,2344],{"href":2343},"\u002Fmemos_cloud\u002Ffeatures\u002Fadvanced\u002Fknowledge_base","知识库",[2346,2347,2348],"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":161,"searchDepth":179,"depth":179,"links":2350},[2351,2352,2353,2354,2355,2356,2361],{"id":39,"depth":179,"text":40},{"id":70,"depth":179,"text":71},{"id":96,"depth":179,"text":97},{"id":149,"depth":179,"text":150},{"id":878,"depth":179,"text":879},{"id":904,"depth":179,"text":905,"children":2357},[2358,2359,2360],{"id":909,"depth":187,"text":909},{"id":1548,"depth":187,"text":1548},{"id":2090,"depth":187,"text":2091},{"id":2213,"depth":179,"text":2214},"通过语义检索和过滤功能，MemOS召回相关记忆。","md",{},"\u002Fcn\u002Fmemos_cloud\u002Fmem_operations\u002Fsearch_memory",{"title":5,"description":161},"cn\u002Fmemos_cloud\u002Fmem_operations\u002Fsearch_memory","huZg80yQCygNaGyEXlgOcM8WBjlKENmUXmraG3So2nU",[2370,2378],{"title":2371,"path":2372,"stem":2373,"icon":2374,"framework":6,"module":6,"class":2375,"target":-1,"active":2376,"defaultOpen":2376,"children":-1,"description":2377},"Add Message","\u002Fcn\u002Fmemos_cloud\u002Fmem_operations\u002Fadd_message","memos_cloud\u002Fmem_operations\u002Fadd_message","i-ri-message-3-line",[],false,"MemOS 会将您添加的多模态内容如文本、文件、图片等，自动处理为可检索的个人记忆。",{"title":2379,"path":2380,"stem":2381,"icon":2382,"framework":6,"module":6,"class":2383,"target":-1,"active":2376,"defaultOpen":2376,"children":-1,"description":2384},"Delete Memory","\u002Fcn\u002Fmemos_cloud\u002Fmem_operations\u002Fdelete_memory","memos_cloud\u002Fmem_operations\u002Fdelete_memory","i-ri-delete-bin-line",[],"从 MemOS 删除记忆,支持批量删除。",1774339745437]