[{"data":1,"prerenderedAt":1763},["ShallowReactive",2],{"docs-page-en-\u002Fmemos_cloud\u002Ffeatures\u002Ffilters":3,"surround-en-\u002Fmemos_cloud\u002Ffeatures\u002Ffilters":1747},{"id":4,"title":5,"avatar":6,"banner":6,"body":7,"category":6,"desc":1740,"description":138,"extension":1741,"links":6,"meta":1742,"navigation":6,"path":1743,"seo":1744,"stem":1745,"__hash__":1746},"docs\u002Fen\u002Fmemos_cloud\u002Ffeatures\u002Ffilters.md","Memory Filters",null,{"type":8,"value":9,"toc":1720},"minimark",[10,34,37,42,45,48,79,81,85,112,115,117,121,126,132,323,325,329,345,392,398,707,713,715,719,736,738,742,749,807,809,813,826,911,984,986,990,1024,1026,1030,1095,1097,1101,1105,1184,1186,1190,1311,1313,1317,1446,1448,1452,1459,1716],[11,12,13,17,31],"warning",{},[14,15,16],"p",{},"Note",[14,18,19,20,25,26,30],{},"You need to pass the relevant fields when calling the ",[21,22,24],"a",{"href":23},"\u002Fapi_docs\u002Fcore\u002Fadd_message","Add Message API"," before you can use them as filter conditions in the ",[21,27,29],{"href":28},"\u002Fapi_docs\u002Fcore\u002Fsearch_memory","Search Memory API",".",[14,32,33],{},"This page focuses on the feature behavior. For complete API fields and limits, see the API documentation above.",[35,36],"br",{},[38,39,41],"h2",{"id":40},"_1-when-to-use-memory-filters","1. When to Use Memory Filters",[14,43,44],{},"When the memory set grows large, or when a single retrieval request accesses user memories, public memories, and Knowledge Base memories at the same time, you often need to narrow the candidate scope before MemOS performs semantic retrieval. Memory Filters are used for this precise pre-retrieval filtering step.",[14,46,47],{},"Common scenarios include:",[49,50,51,55,58,61,76],"ul",{},[52,53,54],"li",{},"Retrieve only memories generated by a specific Agent or App.",[52,56,57],{},"Retrieve only memories created or updated within a specific time range.",[52,59,60],{},"Retrieve only memories that contain specific tags.",[52,62,63,64,68,69,72,73,30],{},"Filter by business fields written when adding messages, such as ",[65,66,67],"code",{},"scene",", ",[65,70,71],{},"biz_id",", or ",[65,74,75],{},"business_type",[52,77,78],{},"Apply different filters to user memories, public memories, and Knowledge Base memories.",[35,80],{},[38,82,84],{"id":83},"_2-how-it-works","2. How It Works",[86,87,88,98],"ol",{},[52,89,90,94,95,30],{},[91,92,93],"strong",{},"Filter the scope first",": MemOS strictly filters candidate memories based on the conditions in ",[65,96,97],{},"filter",[52,99,100,103,104,108,109,30],{},[91,101,102],{},"Then perform semantic retrieval",": Within the filtered candidates, MemOS runs ",[21,105,107],{"href":106},"\u002Fmemos_cloud\u002Fmem_operations\u002Fsearch_memory","memory retrieval"," and returns the fragments most relevant to ",[65,110,111],{},"query",[14,113,114],{},"This means Filter is not keyword search. It is a scope control mechanism before retrieval. The stricter the filter, the fewer candidate memories enter semantic retrieval.",[35,116],{},[38,118,120],{"id":119},"_3-two-filtering-modes","3. Two Filtering Modes",[122,123,125],"h3",{"id":124},"global-filter","Global Filter",[14,127,128,129,131],{},"If you do not need to distinguish memory sources, you can put logical conditions directly at the root of ",[65,130,97],{},". The condition applies to the memory scope involved in the current retrieval.",[133,134,139],"pre",{"className":135,"code":136,"language":137,"meta":138,"style":138},"language-json shiki shiki-themes material-theme-lighter github-light-high-contrast github-dark-default","\"filter\": {\n    \"and\": [\n        {\"tags\": {\"contains\": \"reading\"}},\n        {\"create_time\": {\"gte\": \"2025-01-01\"}},\n        {\"create_time\": {\"lte\": \"2025-12-31\"}},\n        {\"scene\": \"chat\"}\n    ]\n}\n","json","",[65,140,141,163,182,222,256,289,312,318],{"__ignoreMap":138},[142,143,146,150,153,155,159],"span",{"class":144,"line":145},"line",1,[142,147,149],{"class":148},"sjUum","\"",[142,151,97],{"class":152},"sp1uZ",[142,154,149],{"class":148},[142,156,158],{"class":157},"s5ojA",": ",[142,160,162],{"class":161},"suWxN","{\n",[142,164,166,170,174,176,179],{"class":144,"line":165},2,[142,167,169],{"class":168},"sfJrv","    \"",[142,171,173],{"class":172},"skH7o","and",[142,175,149],{"class":168},[142,177,178],{"class":161},":",[142,180,181],{"class":161}," [\n",[142,183,185,188,190,194,196,198,201,203,207,209,211,214,217,219],{"class":144,"line":184},3,[142,186,187],{"class":161},"        {",[142,189,149],{"class":168},[142,191,193],{"class":192},"smon8","tags",[142,195,149],{"class":168},[142,197,178],{"class":161},[142,199,200],{"class":161}," {",[142,202,149],{"class":168},[142,204,206],{"class":205},"s_fzf","contains",[142,208,149],{"class":168},[142,210,178],{"class":161},[142,212,213],{"class":148}," \"",[142,215,216],{"class":152},"reading",[142,218,149],{"class":148},[142,220,221],{"class":161},"}},\n",[142,223,225,227,229,232,234,236,238,240,243,245,247,249,252,254],{"class":144,"line":224},4,[142,226,187],{"class":161},[142,228,149],{"class":168},[142,230,231],{"class":192},"create_time",[142,233,149],{"class":168},[142,235,178],{"class":161},[142,237,200],{"class":161},[142,239,149],{"class":168},[142,241,242],{"class":205},"gte",[142,244,149],{"class":168},[142,246,178],{"class":161},[142,248,213],{"class":148},[142,250,251],{"class":152},"2025-01-01",[142,253,149],{"class":148},[142,255,221],{"class":161},[142,257,259,261,263,265,267,269,271,273,276,278,280,282,285,287],{"class":144,"line":258},5,[142,260,187],{"class":161},[142,262,149],{"class":168},[142,264,231],{"class":192},[142,266,149],{"class":168},[142,268,178],{"class":161},[142,270,200],{"class":161},[142,272,149],{"class":168},[142,274,275],{"class":205},"lte",[142,277,149],{"class":168},[142,279,178],{"class":161},[142,281,213],{"class":148},[142,283,284],{"class":152},"2025-12-31",[142,286,149],{"class":148},[142,288,221],{"class":161},[142,290,292,294,296,298,300,302,304,307,309],{"class":144,"line":291},6,[142,293,187],{"class":161},[142,295,149],{"class":168},[142,297,67],{"class":192},[142,299,149],{"class":168},[142,301,178],{"class":161},[142,303,213],{"class":148},[142,305,306],{"class":152},"chat",[142,308,149],{"class":148},[142,310,311],{"class":161},"}\n",[142,313,315],{"class":144,"line":314},7,[142,316,317],{"class":161},"    ]\n",[142,319,321],{"class":144,"line":320},8,[142,322,311],{"class":161},[35,324],{},[122,326,328],{"id":327},"source-specific-filter","Source-Specific Filter",[14,330,331,332,68,335,338,339,342,343,30],{},"If one retrieval request accesses multiple memory types, you can set separate filter conditions for ",[65,333,334],{},"user",[65,336,337],{},"public",", and ",[65,340,341],{},"knowledgebase"," inside ",[65,344,97],{},[346,347,348,361],"table",{},[349,350,351],"thead",{},[352,353,354,358],"tr",{},[355,356,357],"th",{},"Source",[355,359,360],{},"Description",[362,363,364,374,383],"tbody",{},[352,365,366,371],{},[367,368,369],"td",{},[65,370,334],{},[367,372,373],{},"User-specific memories accumulated from the user's conversation history",[352,375,376,380],{},[367,377,378],{},[65,379,337],{},[367,381,382],{},"Project-level public memories shared across users in the project",[352,384,385,389],{},[367,386,387],{},[65,388,341],{},[367,390,391],{},"Knowledge Base memories created from uploaded documents or Skills",[14,393,394,395,397],{},"Source-specific filters are useful for more precise retrieval strategies, such as filtering user memories by recency, filtering Knowledge Base memories by tags, and leaving public memories unfiltered. Sources not included in ",[65,396,97],{}," will not receive extra filter conditions.",[133,399,401],{"className":135,"code":400,"language":137,"meta":138,"style":138},"\"filter\": {\n    \"knowledgebase\": {\n        \"and\": [\n            {\"tags\": {\"contains\": \"reading\"}},\n            {\"create_time\": {\"gte\": \"2025-01-01\"}},\n            {\"create_time\": {\"lte\": \"2025-12-31\"}}\n        ]\n    },\n    \"user\": {\n        \"and\": [\n            {\"scene\": \"chat\"},\n            {\"create_time\": {\"gte\": \"2025-01-01\"}}\n        ]\n    },\n    \"public\": {\n        \"and\": [\n            {\"tags\": {\"contains\": \"announcement\"}}\n        ]\n    }\n}\n",[65,402,403,415,428,441,473,503,534,539,544,557,570,592,623,628,633,646,659,691,696,702],{"__ignoreMap":138},[142,404,405,407,409,411,413],{"class":144,"line":145},[142,406,149],{"class":148},[142,408,97],{"class":152},[142,410,149],{"class":148},[142,412,158],{"class":157},[142,414,162],{"class":161},[142,416,417,419,421,423,425],{"class":144,"line":165},[142,418,169],{"class":168},[142,420,341],{"class":172},[142,422,149],{"class":168},[142,424,178],{"class":161},[142,426,427],{"class":161}," {\n",[142,429,430,433,435,437,439],{"class":144,"line":184},[142,431,432],{"class":168},"        \"",[142,434,173],{"class":192},[142,436,149],{"class":168},[142,438,178],{"class":161},[142,440,181],{"class":161},[142,442,443,446,448,450,452,454,456,458,461,463,465,467,469,471],{"class":144,"line":224},[142,444,445],{"class":161},"            {",[142,447,149],{"class":168},[142,449,193],{"class":205},[142,451,149],{"class":168},[142,453,178],{"class":161},[142,455,200],{"class":161},[142,457,149],{"class":168},[142,459,206],{"class":460},"sw4Oa",[142,462,149],{"class":168},[142,464,178],{"class":161},[142,466,213],{"class":148},[142,468,216],{"class":152},[142,470,149],{"class":148},[142,472,221],{"class":161},[142,474,475,477,479,481,483,485,487,489,491,493,495,497,499,501],{"class":144,"line":258},[142,476,445],{"class":161},[142,478,149],{"class":168},[142,480,231],{"class":205},[142,482,149],{"class":168},[142,484,178],{"class":161},[142,486,200],{"class":161},[142,488,149],{"class":168},[142,490,242],{"class":460},[142,492,149],{"class":168},[142,494,178],{"class":161},[142,496,213],{"class":148},[142,498,251],{"class":152},[142,500,149],{"class":148},[142,502,221],{"class":161},[142,504,505,507,509,511,513,515,517,519,521,523,525,527,529,531],{"class":144,"line":291},[142,506,445],{"class":161},[142,508,149],{"class":168},[142,510,231],{"class":205},[142,512,149],{"class":168},[142,514,178],{"class":161},[142,516,200],{"class":161},[142,518,149],{"class":168},[142,520,275],{"class":460},[142,522,149],{"class":168},[142,524,178],{"class":161},[142,526,213],{"class":148},[142,528,284],{"class":152},[142,530,149],{"class":148},[142,532,533],{"class":161},"}}\n",[142,535,536],{"class":144,"line":314},[142,537,538],{"class":161},"        ]\n",[142,540,541],{"class":144,"line":320},[142,542,543],{"class":161},"    },\n",[142,545,547,549,551,553,555],{"class":144,"line":546},9,[142,548,169],{"class":168},[142,550,334],{"class":172},[142,552,149],{"class":168},[142,554,178],{"class":161},[142,556,427],{"class":161},[142,558,560,562,564,566,568],{"class":144,"line":559},10,[142,561,432],{"class":168},[142,563,173],{"class":192},[142,565,149],{"class":168},[142,567,178],{"class":161},[142,569,181],{"class":161},[142,571,573,575,577,579,581,583,585,587,589],{"class":144,"line":572},11,[142,574,445],{"class":161},[142,576,149],{"class":168},[142,578,67],{"class":205},[142,580,149],{"class":168},[142,582,178],{"class":161},[142,584,213],{"class":148},[142,586,306],{"class":152},[142,588,149],{"class":148},[142,590,591],{"class":161},"},\n",[142,593,595,597,599,601,603,605,607,609,611,613,615,617,619,621],{"class":144,"line":594},12,[142,596,445],{"class":161},[142,598,149],{"class":168},[142,600,231],{"class":205},[142,602,149],{"class":168},[142,604,178],{"class":161},[142,606,200],{"class":161},[142,608,149],{"class":168},[142,610,242],{"class":460},[142,612,149],{"class":168},[142,614,178],{"class":161},[142,616,213],{"class":148},[142,618,251],{"class":152},[142,620,149],{"class":148},[142,622,533],{"class":161},[142,624,626],{"class":144,"line":625},13,[142,627,538],{"class":161},[142,629,631],{"class":144,"line":630},14,[142,632,543],{"class":161},[142,634,636,638,640,642,644],{"class":144,"line":635},15,[142,637,169],{"class":168},[142,639,337],{"class":172},[142,641,149],{"class":168},[142,643,178],{"class":161},[142,645,427],{"class":161},[142,647,649,651,653,655,657],{"class":144,"line":648},16,[142,650,432],{"class":168},[142,652,173],{"class":192},[142,654,149],{"class":168},[142,656,178],{"class":161},[142,658,181],{"class":161},[142,660,662,664,666,668,670,672,674,676,678,680,682,684,687,689],{"class":144,"line":661},17,[142,663,445],{"class":161},[142,665,149],{"class":168},[142,667,193],{"class":205},[142,669,149],{"class":168},[142,671,178],{"class":161},[142,673,200],{"class":161},[142,675,149],{"class":168},[142,677,206],{"class":460},[142,679,149],{"class":168},[142,681,178],{"class":161},[142,683,213],{"class":148},[142,685,686],{"class":152},"announcement",[142,688,149],{"class":148},[142,690,533],{"class":161},[142,692,694],{"class":144,"line":693},18,[142,695,538],{"class":161},[142,697,699],{"class":144,"line":698},19,[142,700,701],{"class":161},"    }\n",[142,703,705],{"class":144,"line":704},20,[142,706,311],{"class":161},[708,709,710],"note",{},[14,711,712],{},"Use either a global filter or a source-specific filter. If different memory sources need different conditions, prefer source-specific filtering.",[35,714],{},[38,716,718],{"id":717},"_4-available-fields-and-operators","4. Available Fields and Operators",[14,720,721,722,724,725,728,729,732,733,735],{},"The root of each filter group must be ",[65,723,173],{}," or ",[65,726,727],{},"or",", followed by a list of field conditions. Specifying ",[65,730,731],{},"user_id"," in ",[65,734,97],{}," is not supported.",[35,737],{},[122,739,741],{"id":740},"instance-fields","Instance Fields",[14,743,744,745,30],{},"For more details about these fields, see the advanced usage section in ",[21,746,748],{"href":747},"\u002Fmemos_cloud\u002Fmem_operations\u002Fadd_message","Add Message",[346,750,751,767],{},[349,752,753],{},[352,754,755,758,761,764],{},[355,756,757],{},"Field",[355,759,760],{},"Type",[355,762,763],{},"Operator",[355,765,766],{},"Example",[362,768,769,789],{},[352,770,771,776,779,784],{},[367,772,773],{},[65,774,775],{},"agent_id",[367,777,778],{},"string",[367,780,781],{},[65,782,783],{},"=",[367,785,786],{},[65,787,788],{},"{\"agent_id\":\"agent_123\"}",[352,790,791,796,798,802],{},[367,792,793],{},[65,794,795],{},"app_id",[367,797,778],{},[367,799,800],{},[65,801,783],{},[367,803,804],{},[65,805,806],{},"{\"app_id\":\"app_123\"}",[35,808],{},[122,810,812],{"id":811},"metadata-fields","Metadata Fields",[14,814,815,816,819,820,822,823,825],{},"When adding messages, you can write business metadata through ",[65,817,818],{},"info",". During retrieval, use those fields directly by name in ",[65,821,97],{},"; do not wrap them in another ",[65,824,818],{}," object.",[346,827,828,840],{},[349,829,830],{},[352,831,832,834,836,838],{},[355,833,757],{},[355,835,760],{},[355,837,763],{},[355,839,766],{},[362,841,842,859,876,893],{},[352,843,844,848,850,854],{},[367,845,846],{},[65,847,75],{},[367,849,778],{},[367,851,852],{},[65,853,783],{},[367,855,856],{},[65,857,858],{},"{\"business_type\":\"shopping\"}",[352,860,861,865,867,871],{},[367,862,863],{},[65,864,71],{},[367,866,778],{},[367,868,869],{},[65,870,783],{},[367,872,873],{},[65,874,875],{},"{\"biz_id\":\"order_123456\"}",[352,877,878,882,884,888],{},[367,879,880],{},[65,881,67],{},[367,883,778],{},[367,885,886],{},[65,887,783],{},[367,889,890],{},[65,891,892],{},"{\"scene\":\"payment\"}",[352,894,895,900,902,906],{},[367,896,897],{},[65,898,899],{},"custom_status",[367,901,778],{},[367,903,904],{},[65,905,783],{},[367,907,908],{},[65,909,910],{},"{\"custom_status\":\"VIP3\"}",[133,912,914],{"className":135,"code":913,"language":137,"meta":138,"style":138},"\u002F\u002F Recommended\n{\"scene\": \"chat\"}\n\n\u002F\u002F Do not write it like this\n{\"info\": {\"scene\": \"chat\"}}\n",[65,915,916,922,943,949,954],{"__ignoreMap":138},[142,917,918],{"class":144,"line":145},[142,919,921],{"class":920},"sfVK4","\u002F\u002F Recommended\n",[142,923,924,927,929,931,933,935,937,939,941],{"class":144,"line":165},[142,925,926],{"class":161},"{",[142,928,149],{"class":168},[142,930,67],{"class":172},[142,932,149],{"class":168},[142,934,178],{"class":161},[142,936,213],{"class":148},[142,938,306],{"class":152},[142,940,149],{"class":148},[142,942,311],{"class":161},[142,944,945],{"class":144,"line":184},[142,946,948],{"emptyLinePlaceholder":947},true,"\n",[142,950,951],{"class":144,"line":224},[142,952,953],{"class":920},"\u002F\u002F Do not write it like this\n",[142,955,956,958,960,962,964,966,968,970,972,974,976,978,980,982],{"class":144,"line":258},[142,957,926],{"class":161},[142,959,149],{"class":168},[142,961,818],{"class":172},[142,963,149],{"class":168},[142,965,178],{"class":161},[142,967,200],{"class":161},[142,969,149],{"class":168},[142,971,67],{"class":192},[142,973,149],{"class":168},[142,975,178],{"class":161},[142,977,213],{"class":148},[142,979,306],{"class":152},[142,981,149],{"class":148},[142,983,533],{"class":161},[35,985],{},[122,987,989],{"id":988},"tag-fields","Tag Fields",[346,991,992,1004],{},[349,993,994],{},[352,995,996,998,1000,1002],{},[355,997,757],{},[355,999,760],{},[355,1001,763],{},[355,1003,766],{},[362,1005,1006],{},[352,1007,1008,1012,1015,1019],{},[367,1009,1010],{},[65,1011,193],{},[367,1013,1014],{},"list",[367,1016,1017],{},[65,1018,206],{},[367,1020,1021],{},[65,1022,1023],{},"{\"tags\": {\"contains\": \"finance\"}}",[35,1025],{},[122,1027,1029],{"id":1028},"time-fields","Time Fields",[346,1031,1032,1044],{},[349,1033,1034],{},[352,1035,1036,1038,1040,1042],{},[355,1037,757],{},[355,1039,760],{},[355,1041,763],{},[355,1043,766],{},[362,1045,1046,1071],{},[352,1047,1048,1052,1054,1066],{},[367,1049,1050],{},[65,1051,231],{},[367,1053,778],{},[367,1055,1056,68,1059,68,1062,68,1064],{},[65,1057,1058],{},"lt",[65,1060,1061],{},"gt",[65,1063,275],{},[65,1065,242],{},[367,1067,1068],{},[65,1069,1070],{},"{\"create_time\": {\"gte\": \"2025-12-10\"}}",[352,1072,1073,1078,1080,1090],{},[367,1074,1075],{},[65,1076,1077],{},"update_time",[367,1079,778],{},[367,1081,1082,68,1084,68,1086,68,1088],{},[65,1083,1058],{},[65,1085,1061],{},[65,1087,275],{},[65,1089,242],{},[367,1091,1092],{},[65,1093,1094],{},"{\"update_time\": {\"lte\": \"2025-12-10\"}}",[35,1096],{},[38,1098,1100],{"id":1099},"_5-usage-examples","5. Usage Examples",[122,1102,1104],{"id":1103},"filter-memories-by-agent","Filter Memories by Agent",[133,1106,1108],{"className":135,"code":1107,"language":137,"meta":138,"style":138},"\"filter\": {\n    \"or\": [\n        {\"agent_id\": \"agent_123\"},\n        {\"agent_id\": \"agent_456\"}\n    ]\n}\n",[65,1109,1110,1122,1134,1155,1176,1180],{"__ignoreMap":138},[142,1111,1112,1114,1116,1118,1120],{"class":144,"line":145},[142,1113,149],{"class":148},[142,1115,97],{"class":152},[142,1117,149],{"class":148},[142,1119,158],{"class":157},[142,1121,162],{"class":161},[142,1123,1124,1126,1128,1130,1132],{"class":144,"line":165},[142,1125,169],{"class":168},[142,1127,727],{"class":172},[142,1129,149],{"class":168},[142,1131,178],{"class":161},[142,1133,181],{"class":161},[142,1135,1136,1138,1140,1142,1144,1146,1148,1151,1153],{"class":144,"line":184},[142,1137,187],{"class":161},[142,1139,149],{"class":168},[142,1141,775],{"class":192},[142,1143,149],{"class":168},[142,1145,178],{"class":161},[142,1147,213],{"class":148},[142,1149,1150],{"class":152},"agent_123",[142,1152,149],{"class":148},[142,1154,591],{"class":161},[142,1156,1157,1159,1161,1163,1165,1167,1169,1172,1174],{"class":144,"line":224},[142,1158,187],{"class":161},[142,1160,149],{"class":168},[142,1162,775],{"class":192},[142,1164,149],{"class":168},[142,1166,178],{"class":161},[142,1168,213],{"class":148},[142,1170,1171],{"class":152},"agent_456",[142,1173,149],{"class":148},[142,1175,311],{"class":161},[142,1177,1178],{"class":144,"line":258},[142,1179,317],{"class":161},[142,1181,1182],{"class":144,"line":291},[142,1183,311],{"class":161},[35,1185],{},[122,1187,1189],{"id":1188},"filter-memories-by-business-scenario","Filter Memories by Business Scenario",[133,1191,1193],{"className":135,"code":1192,"language":137,"meta":138,"style":138},"\"filter\": {\n    \"and\": [\n        {\"business_type\": \"travel\"},\n        {\"biz_id\": \"travel_001\"},\n        {\"scene\": \"payment\"},\n        {\"custom_status\": \"v1\"}\n    ]\n}\n",[65,1194,1195,1207,1219,1240,1261,1282,1303,1307],{"__ignoreMap":138},[142,1196,1197,1199,1201,1203,1205],{"class":144,"line":145},[142,1198,149],{"class":148},[142,1200,97],{"class":152},[142,1202,149],{"class":148},[142,1204,158],{"class":157},[142,1206,162],{"class":161},[142,1208,1209,1211,1213,1215,1217],{"class":144,"line":165},[142,1210,169],{"class":168},[142,1212,173],{"class":172},[142,1214,149],{"class":168},[142,1216,178],{"class":161},[142,1218,181],{"class":161},[142,1220,1221,1223,1225,1227,1229,1231,1233,1236,1238],{"class":144,"line":184},[142,1222,187],{"class":161},[142,1224,149],{"class":168},[142,1226,75],{"class":192},[142,1228,149],{"class":168},[142,1230,178],{"class":161},[142,1232,213],{"class":148},[142,1234,1235],{"class":152},"travel",[142,1237,149],{"class":148},[142,1239,591],{"class":161},[142,1241,1242,1244,1246,1248,1250,1252,1254,1257,1259],{"class":144,"line":224},[142,1243,187],{"class":161},[142,1245,149],{"class":168},[142,1247,71],{"class":192},[142,1249,149],{"class":168},[142,1251,178],{"class":161},[142,1253,213],{"class":148},[142,1255,1256],{"class":152},"travel_001",[142,1258,149],{"class":148},[142,1260,591],{"class":161},[142,1262,1263,1265,1267,1269,1271,1273,1275,1278,1280],{"class":144,"line":258},[142,1264,187],{"class":161},[142,1266,149],{"class":168},[142,1268,67],{"class":192},[142,1270,149],{"class":168},[142,1272,178],{"class":161},[142,1274,213],{"class":148},[142,1276,1277],{"class":152},"payment",[142,1279,149],{"class":148},[142,1281,591],{"class":161},[142,1283,1284,1286,1288,1290,1292,1294,1296,1299,1301],{"class":144,"line":291},[142,1285,187],{"class":161},[142,1287,149],{"class":168},[142,1289,899],{"class":192},[142,1291,149],{"class":168},[142,1293,178],{"class":161},[142,1295,213],{"class":148},[142,1297,1298],{"class":152},"v1",[142,1300,149],{"class":148},[142,1302,311],{"class":161},[142,1304,1305],{"class":144,"line":314},[142,1306,317],{"class":161},[142,1308,1309],{"class":144,"line":320},[142,1310,311],{"class":161},[35,1312],{},[122,1314,1316],{"id":1315},"filter-by-tag-and-date-range","Filter by Tag and Date Range",[133,1318,1320],{"className":135,"code":1319,"language":137,"meta":138,"style":138},"\"filter\": {\n    \"and\": [\n        {\"tags\": {\"contains\": \"weather\"}},\n        {\"create_time\": {\"gte\": \"2025-12-01\"}},\n        {\"create_time\": {\"lte\": \"2025-12-31\"}}\n    ]\n}\n",[65,1321,1322,1334,1346,1377,1408,1438,1442],{"__ignoreMap":138},[142,1323,1324,1326,1328,1330,1332],{"class":144,"line":145},[142,1325,149],{"class":148},[142,1327,97],{"class":152},[142,1329,149],{"class":148},[142,1331,158],{"class":157},[142,1333,162],{"class":161},[142,1335,1336,1338,1340,1342,1344],{"class":144,"line":165},[142,1337,169],{"class":168},[142,1339,173],{"class":172},[142,1341,149],{"class":168},[142,1343,178],{"class":161},[142,1345,181],{"class":161},[142,1347,1348,1350,1352,1354,1356,1358,1360,1362,1364,1366,1368,1370,1373,1375],{"class":144,"line":184},[142,1349,187],{"class":161},[142,1351,149],{"class":168},[142,1353,193],{"class":192},[142,1355,149],{"class":168},[142,1357,178],{"class":161},[142,1359,200],{"class":161},[142,1361,149],{"class":168},[142,1363,206],{"class":205},[142,1365,149],{"class":168},[142,1367,178],{"class":161},[142,1369,213],{"class":148},[142,1371,1372],{"class":152},"weather",[142,1374,149],{"class":148},[142,1376,221],{"class":161},[142,1378,1379,1381,1383,1385,1387,1389,1391,1393,1395,1397,1399,1401,1404,1406],{"class":144,"line":224},[142,1380,187],{"class":161},[142,1382,149],{"class":168},[142,1384,231],{"class":192},[142,1386,149],{"class":168},[142,1388,178],{"class":161},[142,1390,200],{"class":161},[142,1392,149],{"class":168},[142,1394,242],{"class":205},[142,1396,149],{"class":168},[142,1398,178],{"class":161},[142,1400,213],{"class":148},[142,1402,1403],{"class":152},"2025-12-01",[142,1405,149],{"class":148},[142,1407,221],{"class":161},[142,1409,1410,1412,1414,1416,1418,1420,1422,1424,1426,1428,1430,1432,1434,1436],{"class":144,"line":258},[142,1411,187],{"class":161},[142,1413,149],{"class":168},[142,1415,231],{"class":192},[142,1417,149],{"class":168},[142,1419,178],{"class":161},[142,1421,200],{"class":161},[142,1423,149],{"class":168},[142,1425,275],{"class":205},[142,1427,149],{"class":168},[142,1429,178],{"class":161},[142,1431,213],{"class":148},[142,1433,284],{"class":152},[142,1435,149],{"class":148},[142,1437,533],{"class":161},[142,1439,1440],{"class":144,"line":291},[142,1441,317],{"class":161},[142,1443,1444],{"class":144,"line":314},[142,1445,311],{"class":161},[35,1447],{},[122,1449,1451],{"id":1450},"filter-different-memory-sources-separately","Filter Different Memory Sources Separately",[14,1453,1454,1455,1458],{},"The following example retrieves Knowledge Base memories tagged with \"reading\" and created in 2025, user memories where ",[65,1456,1457],{},"scene=chat",", and public memories tagged with \"announcement\".",[133,1460,1462],{"className":135,"code":1461,"language":137,"meta":138,"style":138},"\"filter\": {\n    \"knowledgebase\": {\n        \"and\": [\n            {\"tags\": {\"contains\": \"reading\"}},\n            {\"create_time\": {\"gte\": \"2025-01-01\"}},\n            {\"create_time\": {\"lte\": \"2025-12-31\"}}\n        ]\n    },\n    \"user\": {\n        \"and\": [\n            {\"scene\": \"chat\"}\n        ]\n    },\n    \"public\": {\n        \"and\": [\n            {\"tags\": {\"contains\": \"announcement\"}}\n        ]\n    }\n}\n",[65,1463,1464,1476,1488,1500,1530,1560,1590,1594,1598,1610,1622,1642,1646,1650,1662,1674,1704,1708,1712],{"__ignoreMap":138},[142,1465,1466,1468,1470,1472,1474],{"class":144,"line":145},[142,1467,149],{"class":148},[142,1469,97],{"class":152},[142,1471,149],{"class":148},[142,1473,158],{"class":157},[142,1475,162],{"class":161},[142,1477,1478,1480,1482,1484,1486],{"class":144,"line":165},[142,1479,169],{"class":168},[142,1481,341],{"class":172},[142,1483,149],{"class":168},[142,1485,178],{"class":161},[142,1487,427],{"class":161},[142,1489,1490,1492,1494,1496,1498],{"class":144,"line":184},[142,1491,432],{"class":168},[142,1493,173],{"class":192},[142,1495,149],{"class":168},[142,1497,178],{"class":161},[142,1499,181],{"class":161},[142,1501,1502,1504,1506,1508,1510,1512,1514,1516,1518,1520,1522,1524,1526,1528],{"class":144,"line":224},[142,1503,445],{"class":161},[142,1505,149],{"class":168},[142,1507,193],{"class":205},[142,1509,149],{"class":168},[142,1511,178],{"class":161},[142,1513,200],{"class":161},[142,1515,149],{"class":168},[142,1517,206],{"class":460},[142,1519,149],{"class":168},[142,1521,178],{"class":161},[142,1523,213],{"class":148},[142,1525,216],{"class":152},[142,1527,149],{"class":148},[142,1529,221],{"class":161},[142,1531,1532,1534,1536,1538,1540,1542,1544,1546,1548,1550,1552,1554,1556,1558],{"class":144,"line":258},[142,1533,445],{"class":161},[142,1535,149],{"class":168},[142,1537,231],{"class":205},[142,1539,149],{"class":168},[142,1541,178],{"class":161},[142,1543,200],{"class":161},[142,1545,149],{"class":168},[142,1547,242],{"class":460},[142,1549,149],{"class":168},[142,1551,178],{"class":161},[142,1553,213],{"class":148},[142,1555,251],{"class":152},[142,1557,149],{"class":148},[142,1559,221],{"class":161},[142,1561,1562,1564,1566,1568,1570,1572,1574,1576,1578,1580,1582,1584,1586,1588],{"class":144,"line":291},[142,1563,445],{"class":161},[142,1565,149],{"class":168},[142,1567,231],{"class":205},[142,1569,149],{"class":168},[142,1571,178],{"class":161},[142,1573,200],{"class":161},[142,1575,149],{"class":168},[142,1577,275],{"class":460},[142,1579,149],{"class":168},[142,1581,178],{"class":161},[142,1583,213],{"class":148},[142,1585,284],{"class":152},[142,1587,149],{"class":148},[142,1589,533],{"class":161},[142,1591,1592],{"class":144,"line":314},[142,1593,538],{"class":161},[142,1595,1596],{"class":144,"line":320},[142,1597,543],{"class":161},[142,1599,1600,1602,1604,1606,1608],{"class":144,"line":546},[142,1601,169],{"class":168},[142,1603,334],{"class":172},[142,1605,149],{"class":168},[142,1607,178],{"class":161},[142,1609,427],{"class":161},[142,1611,1612,1614,1616,1618,1620],{"class":144,"line":559},[142,1613,432],{"class":168},[142,1615,173],{"class":192},[142,1617,149],{"class":168},[142,1619,178],{"class":161},[142,1621,181],{"class":161},[142,1623,1624,1626,1628,1630,1632,1634,1636,1638,1640],{"class":144,"line":572},[142,1625,445],{"class":161},[142,1627,149],{"class":168},[142,1629,67],{"class":205},[142,1631,149],{"class":168},[142,1633,178],{"class":161},[142,1635,213],{"class":148},[142,1637,306],{"class":152},[142,1639,149],{"class":148},[142,1641,311],{"class":161},[142,1643,1644],{"class":144,"line":594},[142,1645,538],{"class":161},[142,1647,1648],{"class":144,"line":625},[142,1649,543],{"class":161},[142,1651,1652,1654,1656,1658,1660],{"class":144,"line":630},[142,1653,169],{"class":168},[142,1655,337],{"class":172},[142,1657,149],{"class":168},[142,1659,178],{"class":161},[142,1661,427],{"class":161},[142,1663,1664,1666,1668,1670,1672],{"class":144,"line":635},[142,1665,432],{"class":168},[142,1667,173],{"class":192},[142,1669,149],{"class":168},[142,1671,178],{"class":161},[142,1673,181],{"class":161},[142,1675,1676,1678,1680,1682,1684,1686,1688,1690,1692,1694,1696,1698,1700,1702],{"class":144,"line":648},[142,1677,445],{"class":161},[142,1679,149],{"class":168},[142,1681,193],{"class":205},[142,1683,149],{"class":168},[142,1685,178],{"class":161},[142,1687,200],{"class":161},[142,1689,149],{"class":168},[142,1691,206],{"class":460},[142,1693,149],{"class":168},[142,1695,178],{"class":161},[142,1697,213],{"class":148},[142,1699,686],{"class":152},[142,1701,149],{"class":148},[142,1703,533],{"class":161},[142,1705,1706],{"class":144,"line":661},[142,1707,538],{"class":161},[142,1709,1710],{"class":144,"line":693},[142,1711,701],{"class":161},[142,1713,1714],{"class":144,"line":698},[142,1715,311],{"class":161},[1717,1718,1719],"style",{},"html pre.shiki code .sjUum, html code.shiki .sjUum{--shiki-light:#39ADB5;--shiki-default:#032563;--shiki-dark:#A5D6FF}html pre.shiki code .sp1uZ, html code.shiki .sp1uZ{--shiki-light:#91B859;--shiki-default:#032563;--shiki-dark:#A5D6FF}html pre.shiki code .s5ojA, html code.shiki .s5ojA{--shiki-light:#90A4AE;--shiki-default:#0E1116;--shiki-dark:#E6EDF3}html pre.shiki code .suWxN, html code.shiki .suWxN{--shiki-light:#39ADB5;--shiki-default:#0E1116;--shiki-dark:#E6EDF3}html pre.shiki code .sfJrv, html code.shiki .sfJrv{--shiki-light:#39ADB5;--shiki-default:#024C1A;--shiki-dark:#7EE787}html pre.shiki code .skH7o, html code.shiki .skH7o{--shiki-light:#9C3EDA;--shiki-default:#024C1A;--shiki-dark:#7EE787}html pre.shiki code .smon8, html code.shiki .smon8{--shiki-light:#E2931D;--shiki-default:#024C1A;--shiki-dark:#7EE787}html pre.shiki code .s_fzf, html code.shiki .s_fzf{--shiki-light:#F76D47;--shiki-default:#024C1A;--shiki-dark:#7EE787}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);}html pre.shiki code .sw4Oa, html code.shiki .sw4Oa{--shiki-light:#E53935;--shiki-default:#024C1A;--shiki-dark:#7EE787}html pre.shiki code .sfVK4, html code.shiki .sfVK4{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#66707B;--shiki-default-font-style:inherit;--shiki-dark:#8B949E;--shiki-dark-font-style:inherit}",{"title":138,"searchDepth":165,"depth":165,"links":1721},[1722,1723,1724,1728,1734],{"id":40,"depth":165,"text":41},{"id":83,"depth":165,"text":84},{"id":119,"depth":165,"text":120,"children":1725},[1726,1727],{"id":124,"depth":184,"text":125},{"id":327,"depth":184,"text":328},{"id":717,"depth":165,"text":718,"children":1729},[1730,1731,1732,1733],{"id":740,"depth":184,"text":741},{"id":811,"depth":184,"text":812},{"id":988,"depth":184,"text":989},{"id":1028,"depth":184,"text":1029},{"id":1099,"depth":165,"text":1100,"children":1735},[1736,1737,1738,1739],{"id":1103,"depth":184,"text":1104},{"id":1188,"depth":184,"text":1189},{"id":1315,"depth":184,"text":1316},{"id":1450,"depth":184,"text":1451},"Use memory filters during retrieval to filter by memory source, tags, metadata, time range, and other conditions.","md",{},"\u002Fen\u002Fmemos_cloud\u002Ffeatures\u002Ffilters",{"title":5,"description":138},"en\u002Fmemos_cloud\u002Ffeatures\u002Ffilters","hTe_6y4qidRsPj9dHvi4rgoBaBRqjorRCUGDDGfO8P8",[1748,1756],{"title":1749,"path":1750,"stem":1751,"icon":1752,"framework":6,"module":6,"class":1753,"target":-1,"active":1754,"defaultOpen":1754,"children":-1,"description":1755},"Chat","\u002Fmemos_cloud\u002Fmem_operations\u002Fchat","memos_cloud\u002Fmem_operations\u002Fchat","i-ri-chat-history-line",[],false,"MemOS provides a conversation API with built-in memory management, so you do not need to manually assemble context.",{"title":1757,"path":1758,"stem":1759,"icon":1760,"framework":6,"module":6,"class":1761,"target":-1,"active":1754,"defaultOpen":1754,"children":-1,"description":1762},"Async Mode","\u002Fmemos_cloud\u002Ffeatures\u002Fasync_mode","memos_cloud\u002Ffeatures\u002Fasync_mode","i-ri-timer-flash-line",[],"Use async mode when adding messages; the interface returns immediately while actual processing is queued in the background by MemOS.",1779709039505]