[{"data":1,"prerenderedAt":4204},["ShallowReactive",2],{"docs-page-en-\u002Fapi_docs\u002Fcore\u002Fedit_profile":3,"openapi-data-dashboardApi-dashboard\u002Fapi-en":21,"surround-en-\u002Fapi_docs\u002Fcore\u002Fedit_profile":3332,"snippet-en-edit_profile":3343},{"id":4,"title":5,"avatar":6,"banner":6,"body":7,"category":6,"desc":6,"description":11,"extension":14,"links":6,"meta":15,"navigation":6,"path":17,"seo":18,"stem":19,"__hash__":20},"docs\u002Fen\u002Fapi_docs\u002Fcore\u002Fedit_profile.md","Edit Profile",null,{"type":8,"value":9,"toc":10},"minimark",[],{"title":11,"searchDepth":12,"depth":12,"links":13},"",2,[],"md",{"openapi":16},"POST \u002Fedit\u002Fprofile","\u002Fen\u002Fapi_docs\u002Fcore\u002Fedit_profile",{"title":5,"description":11},"en\u002Fapi_docs\u002Fcore\u002Fedit_profile","g2YyaRbeZdWJIKR5TYT835IHlQp6qJGt4BseOjas4js",[22,1871],{"id":23,"extension":24,"meta":25,"stem":1869,"__hash__":1870},"dashboardApi\u002Fcn\u002Fapi_docs\u002Fapi.json","json",{"openapi":26,"info":27,"servers":31,"security":35,"paths":38,"components":484},"3.1.0",{"title":28,"description":29,"version":30},"MemOS Dashboard APIs","Dashboard API for managing messages and searching memories in MemOS.","1.0.0",[32],{"url":33,"description":34},"https:\u002F\u002Fmemos.memtensor.cn\u002Fapi\u002Fopenmem\u002Fv1","Production server",[36],{"TokenAuth":37},[],{"\u002Fadd\u002Fmessage":39,"\u002Fget\u002Fmessage":75,"\u002Fsearch\u002Fmemory":94,"\u002Fchat":130,"\u002Fget\u002Fmemory":168,"\u002Fdelete\u002Fmemory":184,"\u002Fadd\u002Ffeedback":200,"\u002Fextract\u002Fmemory":216,"\u002Frerank":245,"\u002Fget\u002Fstatus":270,"\u002Fcreate\u002Fknowledgebase":311,"\u002Fdelete\u002Fknowledgebase":327,"\u002Fadd\u002Fknowledgebase-file":343,"\u002Fget\u002Fknowledgebase-file":359,"\u002Fdelete\u002Fknowledgebase-file":375,"\u002Fbind\u002Fprofile_template":391,"\u002Fedit\u002Fprofile":411,"\u002Fdelete\u002Fprofile":431,"\u002Fupdate\u002Fmemory":447,"\u002Fget\u002Fmemory\u002F{memory_id}":466},{"post":40},{"summary":41,"description":42,"operationId":43,"requestBody":44,"responses":68},"Add Message","该接口用于添加会话消息，支持多类型内容、批量添加。MemOS 会自动解析消息并处理记忆，用于后续对话时召回参考。","add_message",{"required":45,"content":46},true,{"application\u002Fjson":47},{"schema":48,"example":50},{"$ref":49},"#\u002Fcomponents\u002Fschemas\u002FAddMessageRequest",{"user_id":51,"conversation_id":52,"messages":53},"memos_user_123","0610",[54,57,60,62,64,66],{"role":55,"content":56},"user","我想暑假出去玩，你能帮我推荐下吗？",{"role":58,"content":59},"assistant","好的！是自己出行还是和家人朋友一起呢？",{"role":55,"content":61},"肯定要带孩子啊，我们家出门都是全家一起。",{"role":58,"content":63},"明白了，所以你们是父母带孩子一块儿旅行，对吗？",{"role":55,"content":65},"对，带上孩子和老人，一般都是全家行动。",{"role":58,"content":67},"收到，那我会帮你推荐适合家庭出游的目的地。",{"200":69},{"description":70,"content":71},"Successful Response",{"application\u002Fjson":72},{"schema":73},{"$ref":74},"#\u002Fcomponents\u002Fschemas\u002FAddMessageResponse",{"post":76},{"summary":77,"description":78,"operationId":79,"requestBody":80,"responses":88},"Get Message","该接口用于获取指定会话的用户与助手历史对话记录，可按数量限制返回结果。","get_message",{"required":45,"content":81},{"application\u002Fjson":82},{"schema":83,"example":85},{"$ref":84},"#\u002Fcomponents\u002Fschemas\u002FGetMessageRequest",{"user_id":51,"conversation_id":86,"message_limit_number":87},"0928",6,{"200":89},{"description":70,"content":90},{"application\u002Fjson":91},{"schema":92},{"$ref":93},"#\u002Fcomponents\u002Fschemas\u002FGetMessageResponse",{"post":95},{"summary":96,"description":97,"operationId":98,"requestBody":99,"responses":124},"Search Memory","该接口用于检索指定用户或 Agent 的记忆，返回与查询内容最相关的记忆片段。","search_memory",{"required":45,"content":100},{"application\u002Fjson":101},{"schema":102,"example":104},{"$ref":103},"#\u002Fcomponents\u002Fschemas\u002FSearchMemoryRequest",{"query":105,"user_id":51,"conversation_id":86,"knowledgebase_ids":106,"filter":108},"帮我总结今年和阅读相关的记忆",[107],"kb_xxx",{"knowledgebase":109,"user":120},{"and":110},[111,114,117],{"tags":112},{"contains":113},"阅读",{"create_time":115},{"gte":116},"2025-01-01",{"create_time":118},{"lte":119},"2025-12-31",{"and":121},[122],{"scene":123},"chat",{"200":125},{"description":70,"content":126},{"application\u002Fjson":127},{"schema":128},{"$ref":129},"#\u002Fcomponents\u002Fschemas\u002FSearchMemoryResponse",{"post":131},{"summary":132,"description":11,"operationId":123,"requestBody":133,"responses":159},"Chat",{"required":45,"content":134},{"application\u002Fjson":135},{"schema":136,"example":138},{"$ref":137},"#\u002Fcomponents\u002Fschemas\u002FChatRequest",{"user_id":51,"stream":139,"query":140,"model_name":141,"conversation_id":142,"knowledgebase_ids":143,"filter":145,"system_prompt":150,"add_message_on_answer":139,"allow_public":139,"allow_knowledgebase_ids":151,"agent_id":152,"app_id":153,"tags":154,"info":155,"max_tokens":156,"temperature":157,"top_p":158},false,"上海有哪些好玩的","deepseek-r1","23006762-a064-456e-a33b-d2452bdfa09f",[144],"2448808afa784cc5f7595da21ae5a3fd",{"and":146},[147],{"create_time":148},{"gt":149},"2025-09-19","推荐公园",[],"agent_id_2025-12-15-01","app_id_2025-12-15-01",[],{},8192,0.7,0.95,{"200":160},{"description":70,"content":161},{"application\u002Fjson":162,"text\u002Fevent-stream":165},{"schema":163},{"$ref":164},"#\u002Fcomponents\u002Fschemas\u002FChatResponse",{"schema":166},{"$ref":167},"#\u002Fcomponents\u002Fschemas\u002FChatStreamResponse",{"post":169},{"summary":170,"description":171,"operationId":172,"requestBody":173,"responses":178},"Get Memories","分页获取某个用户或 Agent 的记忆。","get_memory",{"required":45,"content":174},{"application\u002Fjson":175},{"schema":176},{"$ref":177},"#\u002Fcomponents\u002Fschemas\u002FGetMemoryRequest",{"200":179},{"description":70,"content":180},{"application\u002Fjson":181},{"schema":182},{"$ref":183},"#\u002Fcomponents\u002Fschemas\u002FGetMemoryResponse",{"post":185},{"summary":186,"description":187,"operationId":188,"requestBody":189,"responses":194},"Delete Memory","删除指定用户或 Agent 的记忆，支持按 memory_ids 精确删除，或按 user_id\u002Fagent_id 清空全部记忆。","delete_memory",{"required":45,"content":190},{"application\u002Fjson":191},{"schema":192},{"$ref":193},"#\u002Fcomponents\u002Fschemas\u002FDeleteMemoryRequest",{"200":195},{"description":70,"content":196},{"application\u002Fjson":197},{"schema":198},{"$ref":199},"#\u002Fcomponents\u002Fschemas\u002FDeleteMemoryResponse",{"post":201},{"summary":202,"description":203,"operationId":204,"requestBody":205,"responses":210},"Add Feedback","该接口用于添加对当前会话消息的反馈，MemOS能够基于用户的反馈更正记忆。","add_feedback",{"required":45,"content":206},{"application\u002Fjson":207},{"schema":208},{"$ref":209},"#\u002Fcomponents\u002Fschemas\u002FAddFeedbackRequest",{"200":211},{"description":70,"content":212},{"application\u002Fjson":213},{"schema":214},{"$ref":215},"#\u002Fcomponents\u002Fschemas\u002FAddFeedbackResponse",{"post":217},{"summary":218,"description":219,"operationId":220,"requestBody":221,"responses":239},"Extract Memory","基于 MemOS 自研抽取模型，从对话消息中直接抽取并返回事实与偏好记忆。","extract_memory",{"required":45,"content":222},{"application\u002Fjson":223},{"schema":224,"example":226},{"$ref":225},"#\u002Fcomponents\u002Fschemas\u002FExtractMemoryRequest",{"messages":227,"extraction_types":236},[228,230,232,234],{"role":55,"content":229},"我暑假定好去广州旅游，住宿的话有哪些连锁酒店可选？",{"role":58,"content":231},"您可以考虑【七天、全季、希尔顿】等等",{"role":55,"content":233},"我选七天",{"role":58,"content":235},"好的，有其他问题再问我。",[237,238],"memory","preference",{"200":240},{"description":70,"content":241},{"application\u002Fjson":242},{"schema":243},{"$ref":244},"#\u002Fcomponents\u002Fschemas\u002FExtractMemoryResponse",{"post":246},{"summary":247,"description":248,"operationId":249,"requestBody":250,"responses":264},"Rerank Memory","提供记忆重排接口，基于 memos-reranker 小模型，传入用户查询与候选记忆列表，一键完成记忆相关性重排。","rerank",{"required":45,"content":251},{"application\u002Fjson":252},{"schema":253,"example":255},{"$ref":254},"#\u002Fcomponents\u002Fschemas\u002FRerankRequest",{"model":256,"query":257,"documents":258},"memos-reranker-0.6b","用户有什么兴趣爱好",[259,260,261,262,263],"用户喜欢打羽毛球","用户在杭州做后端开发","用户偏好简洁的回复风格","用户比较喜欢酱香型白酒","用户下周三要去北京出差",{"200":265},{"description":70,"content":266},{"application\u002Fjson":267},{"schema":268},{"$ref":269},"#\u002Fcomponents\u002Fschemas\u002FRerankResponse",{"post":271},{"summary":272,"description":273,"operationId":274,"requestBody":275,"responses":282},"Get Task Status","查询 add\u002Fmessage、add\u002Ffeedback 等异步任务的处理状态。任务完成后返回 memory_views，汇总本次任务新增\u002F更新\u002F删除数量，以及各\u003Ca href=\"\u002Fcn\u002Fmemos_cloud\u002Fintroduction\u002Fmemory_types\">记忆种类\u003C\u002Fa>下触达的记忆 ID。","get_status",{"required":45,"content":276},{"application\u002Fjson":277},{"schema":278,"example":280},{"$ref":279},"#\u002Fcomponents\u002Fschemas\u002FGetStatusRequest",{"task_id":281},"c464e17e-f2ff-4e9a-a2c2-41cc55ab43b9",{"200":283},{"description":70,"content":284},{"application\u002Fjson":285},{"schema":286,"examples":288},{"$ref":287},"#\u002Fcomponents\u002Fschemas\u002FGetStatusResponse",{"completed":289,"running":303,"failed":307},{"summary":290,"value":291},"completed",{"code":292,"message":293,"data":294},0,"ok",{"task_id":281,"status":290,"memory_views":295},{"added":296,"updated":296,"deleted":292,"detail_factual":297,"preference":300},1,{"memory_ids":298},[299],"memos_mem_001",{"memory_ids":301},[302],"memos_mem_002",{"summary":304,"value":305},"running",{"code":292,"message":293,"data":306},{"task_id":281,"status":304},{"summary":308,"value":309},"failed",{"code":292,"message":293,"data":310},{"task_id":281,"status":308},{"post":312},{"summary":313,"description":314,"operationId":315,"requestBody":316,"responses":321},"创建知识库","创建与项目关联的知识库","create_knowledgebase",{"required":45,"content":317},{"application\u002Fjson":318},{"schema":319},{"$ref":320},"#\u002Fcomponents\u002Fschemas\u002FCreateKnowledgebaseRequest",{"200":322},{"description":70,"content":323},{"application\u002Fjson":324},{"schema":325},{"$ref":326},"#\u002Fcomponents\u002Fschemas\u002FCreateKnowledgebaseResponse",{"post":328},{"summary":329,"description":330,"operationId":331,"requestBody":332,"responses":337},"移除知识库","从当前项目中移除知识库，彻底删除知识库需从控制台-知识库页面操作。","delete_knowledgebase",{"required":45,"content":333},{"application\u002Fjson":334},{"schema":335},{"$ref":336},"#\u002Fcomponents\u002Fschemas\u002FDeleteKnowledgebaseRequest",{"200":338},{"description":70,"content":339},{"application\u002Fjson":340},{"schema":341},{"$ref":342},"#\u002Fcomponents\u002Fschemas\u002FDeleteKnowledgebaseResponse",{"post":344},{"summary":345,"description":346,"operationId":347,"requestBody":348,"responses":353},"添加知识库文件","向指定知识库上传文件。默认上传普通文档；当 file[].type 为 skill 时，上传 Markdown Skill 文件或 ZIP 技能包。","add_knowledgebase-file",{"required":45,"content":349},{"application\u002Fjson":350},{"schema":351},{"$ref":352},"#\u002Fcomponents\u002Fschemas\u002FUploadFileRequest",{"200":354},{"description":70,"content":355},{"application\u002Fjson":356},{"schema":357},{"$ref":358},"#\u002Fcomponents\u002Fschemas\u002FUploadFileResponse",{"post":360},{"summary":361,"description":362,"operationId":363,"requestBody":364,"responses":369},"获取知识库文件","通过两种方式获取文件信息：传 file_ids 获取指定文件详情，或传 knowledgebase_id 获取某个知识库下的文件列表。两种方式只能选择一种；同时传 knowledgebase_id 和 file_ids 会报错。","get_knowledgebase-file",{"required":45,"content":365},{"application\u002Fjson":366},{"schema":367},{"$ref":368},"#\u002Fcomponents\u002Fschemas\u002FGetFileRequest",{"200":370},{"description":70,"content":371},{"application\u002Fjson":372},{"schema":373},{"$ref":374},"#\u002Fcomponents\u002Fschemas\u002FGetFileResponse",{"post":376},{"summary":377,"description":378,"operationId":379,"requestBody":380,"responses":385},"删除知识库文件","从指定知识库中删除文件。删除 Skill 文件时，与该文件关联的 Skill 会同步删除。","delete_knowledgebase-file",{"required":45,"content":381},{"application\u002Fjson":382},{"schema":383},{"$ref":384},"#\u002Fcomponents\u002Fschemas\u002FDeleteFileRequest",{"200":386},{"description":70,"content":387},{"application\u002Fjson":388},{"schema":389},{"$ref":390},"#\u002Fcomponents\u002Fschemas\u002FDeleteFileResponse",{"post":392},{"summary":393,"description":394,"operationId":395,"requestBody":396,"responses":405},"绑定属性记忆模板","为用户或 Agent 绑定属性记忆模板，创建属性记忆实例。绑定后，后续添加消息时自动更新对应的属性字段值。","bind_profile_template",{"required":45,"content":397},{"application\u002Fjson":398},{"schema":399,"example":401},{"$ref":400},"#\u002Fcomponents\u002Fschemas\u002FBindProfileTemplateRequest",{"bind_list":402},[403],{"user_id":51,"profile_template_id":404},"tpl_user_001",{"200":406},{"description":70,"content":407},{"application\u002Fjson":408},{"schema":409},{"$ref":410},"#\u002Fcomponents\u002Fschemas\u002FSuccessResponse",{"post":412},{"summary":413,"description":414,"operationId":415,"requestBody":416,"responses":426},"编辑属性记忆实例","编辑属性记忆实例，支持新增字段、更新字段值、删除字段、锁定字段不被算法自动更新。只影响当前实例，不修改模板也不影响其他实例。","edit_profile",{"required":45,"content":417},{"application\u002Fjson":418},{"schema":419,"example":421},{"$ref":420},"#\u002Fcomponents\u002Fschemas\u002FEditProfileRequest",{"user_id":51,"profile_template_id":404,"metadata":422},{"基础信息":423},{"居住地":424},{"value":425,"algorithm_updatable":139},"上海",{"200":427},{"description":70,"content":428},{"application\u002Fjson":429},{"schema":430},{"$ref":410},{"post":432},{"summary":433,"description":434,"operationId":435,"requestBody":436,"responses":442},"删除属性记忆实例","删除某个用户或 Agent 的属性记忆实例，该实例的所有字段值和绑定关系一并清除。不影响模板本身，也不影响其他主体的实例。","delete_profile",{"required":45,"content":437},{"application\u002Fjson":438},{"schema":439,"example":441},{"$ref":440},"#\u002Fcomponents\u002Fschemas\u002FDeleteProfileRequest",{"user_id":51,"profile_template_id":404},{"200":443},{"description":70,"content":444},{"application\u002Fjson":445},{"schema":446},{"$ref":410},{"post":448},{"summary":449,"description":450,"operationId":451,"requestBody":452,"responses":461},"修改记忆","手动修改一条已有记忆的内容、标题或状态。支持所有记忆种类，包括事实记忆、偏好记忆、事件记忆、属性记忆的属性值等。","update_memory",{"required":45,"content":453},{"application\u002Fjson":454},{"schema":455,"example":457},{"$ref":456},"#\u002Fcomponents\u002Fschemas\u002FUpdateMemoryRequest",{"memory_id":458,"title":459,"content":460},"mem_event_001","和陈默去西湖露营","上周六和好友陈默去西湖边露营，天气很好，晚上一起看了星星。",{"200":462},{"description":70,"content":463},{"application\u002Fjson":464},{"schema":465},{"$ref":410},{"get":467},{"summary":468,"description":469,"operationId":470,"parameters":471,"responses":478},"获取单条记忆详情","查询单条记忆信息。","get_memory_by_id",[472],{"name":473,"in":474,"required":45,"schema":475,"description":477},"memory_id","path",{"type":476},"string","记忆 ID",{"200":479},{"description":70,"content":480},{"application\u002Fjson":481},{"schema":482},{"$ref":483},"#\u002Fcomponents\u002Fschemas\u002FGetMemoryByIdResponse",{"securitySchemes":485,"schemas":491},{"TokenAuth":486},{"type":487,"name":488,"in":489,"description":490},"apiKey","Authorization","header","Token API_key，可在 \u003Ca href=\"https:\u002F\u002Fmemos-dashboard.openmem.net\u002Fapikeys\u002F\" class=\"text-primary border-b border-transparent hover:border-primary font-medium focus-visible:outline-primary [&>code]:border-dashed hover:[&>code]:border-primary hover:[&>code]:text-primary transition-colors [&>code]:transition-colors\" target=\"_blank\">API 控制台>接口密钥\u003C\u002Fa> 中查看",{"ChatRequest":492,"ChatResponseData":581,"ChatResponse":587,"ChatStreamResponse":601,"MessageInput":617,"AddMessageRequest":685,"OpenMemAddMessageResponse":739,"AddMessageResponse":752,"GetMessageRequest":762,"MessageDetail":773,"GetMessageResponseData":787,"GetMessageResponse":795,"SearchMemoryRequest":803,"MemoryDetail":868,"PreferenceDetail":906,"ToolUsedStatus":934,"ToolMemoryDetail":949,"SkillValue":982,"SkillDetail":1009,"SearchProfileDetail":1041,"SearchEventDetail":1081,"SearchMemoryResponseData":1118,"SearchMemoryResponse":1154,"GetMemoryRequest":1162,"GetProfileMemoryDetail":1182,"GetEventMemoryDetail":1200,"GetMemoryDetail":1225,"GetPreferenceDetail":1257,"GetToolMemoryDetail":1282,"GetMemoryResponseData":1305,"GetMemoryResponse":1333,"DeleteMemoryRequest":1342,"DeleteMemoryResponse":1353,"AddFeedbackRequest":1365,"AddFeedbackResponse":1389,"TaskStatusMemoryViewIds":1404,"TaskStatusMemoryViews":1410,"OpenMemGetStatusData":1430,"GetStatusRequest":1441,"GetStatusResponse":1448,"CreateKnowledgebaseRequest":1456,"CreateKnowledgebaseResponse":1467,"DeleteKnowledgebaseRequest":1478,"DeleteKnowledgebaseResponse":1486,"UploadFileRequest":1496,"UploadFileResponse":1516,"GetFileRequest":1540,"GetFileResponse":1559,"DeleteFileRequest":1587,"DeleteFileResponse":1595,"ExtractMemoryItem":1604,"ExtractPreferenceItem":1622,"ExtractMemoryResponseData":1634,"ExtractMemoryMessage":1647,"RerankRequest":1654,"RerankResult":1673,"RerankResponse":1693,"ExtractMemoryRequest":1724,"ExtractMemoryResponse":1737,"BindProfileTemplateRequest":1745,"ProfileFieldValue":1763,"EditProfileRequest":1772,"DeleteProfileRequest":1795,"UpdateMemoryRequest":1804,"GetMemoryByIdResponse":1816,"SuccessResponse":1859},{"type":493,"required":494,"properties":498,"title":580},"object",[495,496,497],"user_id","conversation_id","query",{"user_id":499,"conversation_id":502,"query":505,"filter":508,"knowledgebase_ids":512,"memory_limit_number":517,"include_preference":522,"preference_limit_number":526,"relativity":529,"model_name":534,"system_prompt":541,"stream":544,"max_tokens":547,"temperature":550,"top_p":553,"add_message_on_answer":556,"app_id":559,"agent_id":562,"tags":565,"info":569,"allow_public":573,"allow_knowledgebase_ids":576},{"type":476,"title":500,"description":501},"User ID","对话内容所关联的用户唯一标识符。",{"type":476,"title":503,"description":504},"Conversation ID","对话内容所在会话的唯一标识符，传入可明确当前会话，本会话的记忆应当比其他历史会话的权重高；不传可跨会话检索相关记忆，得到相关性更高的模型回答。",{"type":476,"title":506,"description":507},"Query","用户输入的对话内容。",{"type":493,"title":509,"description":510,"example":511},"Filter","记忆过滤的条件，用于在检索记忆前精确限定记忆范围。可用字段包括：\"agent_id\", \"app_id\", \"create_time\", \"update_time\"与\"info\"中的字段。支持逻辑运算符（and，or）和比较运算符（gte、lte、gt、lt）。对于\"info\"字段，支持过滤传入的\"business_type\", \"biz_id\", \"scene\"和其他自定义字段。","{\"and\": [{\"create_time\":{\"gte\":\"...\"}}]}",{"type":513,"items":514,"title":515,"description":516},"array",{"type":476},"Knowledgebase IDs","该字段用于限制当次搜索可访问的知识库范围，默认为空（即不检索任何知识库）。传入具体知识库 ID，则可检索指定知识库中的普通文档和已上传的 Skill；传入 all，则可检索该项目下所有关联知识库。",{"type":518,"title":519,"description":520,"default":521},"integer","Memory Limit Number","召回的事实记忆条数上限，在满足相关性阈值（relativity）的前提下最多返回该数量的记忆，不保证返回固定条数。默认值 9，最大值 25。",9,{"type":523,"title":524,"description":525,"default":45},"boolean","Include Preference","是否要召回偏好记忆，开启后系统会根据查询内容智能召回与用户偏好相关的记忆。默认 =true",{"type":518,"title":527,"description":528,"default":521},"Preference Limit Number","召回的偏好记忆条数上限，在满足相关性阈值（relativity）的前提下最多返回该数量的记忆，不保证返回固定条数。默认值 9，最大值 25。",{"type":530,"minimum":292,"maximum":296,"title":531,"description":532,"default":533},"number","Relativity","召回记忆的相关性阈值（0~1）。用于过滤低相关记忆，并与限定返回的事实、偏好记忆最大条数，共同约束最终返回结果。不传时使用系统默认阈值，取值为0时表示不进行相关性过滤。",0.45,{"type":476,"enum":535,"title":538,"description":539,"default":540},[536,141,537],"qwen3-32b","qwen2.5-72b-instruct","Model Name","指定具体对话模型。","qwen2.5-72B-Instruct",{"type":476,"title":542,"description":543},"System Prompt","自定义系统指令。",{"type":523,"title":545,"description":546,"default":139},"Stream","是否启用流式返回。",{"type":518,"title":548,"description":549,"default":156},"Max Tokens","表示最大生成 token 数。",{"type":530,"title":551,"description":552,"default":157},"Temperature","控制生成随机性。取值范围：0 ≤ x ≤ 2",{"type":530,"title":554,"description":555,"default":158},"Top P","Nucleus 采样参数。取值范围：0 ≤ x ≤ 1",{"type":523,"title":557,"description":558,"default":45},"Add Message On Answer","是否自动将用户与助手的会话内容写入记忆。启用后，开发者无需再调用add\u002Fmessage接口添加消息为记忆。",{"type":476,"title":560,"description":561},"App ID","对话内容所关联的应用唯一标识符。",{"type":476,"title":563,"description":564},"Agent ID","对话内容所关联的Agent唯一标识符。",{"type":513,"items":566,"title":567,"description":568},{"type":476},"Tags","自定义标签列表，用于标记对话内容的主题或分类。",{"type":493,"additionalProperties":570,"title":571,"description":572},{"type":476},"Info","自定义元信息字段，能够存储任意与对话内容相关的结构化数据，例如位置、来源、版本等，主要用于在检索时精确过滤或追踪来源。",{"type":523,"title":574,"description":575,"default":139},"Allow Public","是否允许加入公共记忆。",{"type":513,"items":577,"title":578,"description":579},{"type":476},"Allow Knowledgebase IDs","添加的消息产生的记忆允许被写入的知识库列表。","ChatRequest",{"type":493,"title":582,"properties":583},"ChatResponseData",{"response":584},{"type":476,"title":585,"description":586},"Response","回答的具体内容。",{"type":493,"required":588,"properties":591,"title":600},[589,590],"code","message",{"code":592,"data":595,"message":597},{"type":518,"title":593,"description":594},"Code","接口状态码，更多内容可查阅\u003Ca href=\"\u002Fapi_docs\u002Fhelp\u002Ferror_codes\" class=\"text-primary border-b border-transparent hover:border-primary font-medium focus-visible:outline-primary [&>code]:border-dashed hover:[&>code]:border-primary hover:[&>code]:text-primary transition-colors [&>code]:transition-colors\">错误码列表\u003C\u002Fa>了解详情。",{"$ref":596},"#\u002Fcomponents\u002Fschemas\u002FChatResponseData",{"type":476,"title":598,"description":599},"Message","提示信息","ChatResponse",{"type":493,"properties":602,"title":616},{"event":603,"data":605},{"type":476,"description":604,"default":590},"流式事件名称，当前默认为 message。",{"type":493,"description":606,"properties":607},"流式返回的数据内容。",{"type":608,"data":614},{"type":476,"description":609,"enum":610},"流式消息类型，用于标识当前数据的语义类别。\u003Cbr>reasoning：推理内容\u003Cbr>text：正常文本内容\u003Cbr>end：流式结束标识",[611,612,613],"reasoning","text","end",{"type":476,"description":615},"流式返回的文本内容。","ChatStreamResponse",{"type":493,"required":618,"properties":621,"title":684},[619,620],"role","content",{"chat_time":622,"role":625,"role_id":631,"role_name":634,"content":637,"tool_call_id":665,"tool_calls":667},{"type":476,"title":623,"description":624},"Chat Time","对话发生的时间，可传入结构化时间或中文时间描述。传入该参数能够让记忆携带时间信息。",{"type":476,"enum":626,"title":629,"description":630},[55,58,627,628],"system","tool","Role","消息创建者的角色。",{"type":476,"title":632,"description":633},"Role ID","具体发言人的 ID，群聊场景建议传入。",{"type":476,"title":635,"description":636},"Role Name","发言人名称。传入后，抽取的记忆会标识发言人的名称。需与 role_id 同时传入。",{"oneOf":638,"description":664},[639,641],{"type":476,"description":640},"消息文本内容",{"type":513,"items":642,"description":663},{"type":493,"properties":643,"required":661},{"type":644,"text":649,"image_url":651,"file":656},{"type":476,"enum":645,"description":648},[612,646,647],"image_url","file","发送的消息类型",{"type":476,"description":650},"文本消息内容。type为text时必填。",{"type":493,"description":652,"properties":653},"图片消息内容对象。",{"url":654},{"type":476,"description":655},"图片消息URL。type为image_url时必填。",{"type":493,"description":657,"properties":658},"文件消息内容对象。",{"file_data":659},{"type":476,"description":660},"可访问的文件URL或者base64, 只支持七种类型txt \u002F pdf \u002F doc \u002F docx \u002F json \u002F md \u002F xml， 单文件不超过100MB、500页，总数不超过20个。type为file时必填。注意：该接口的总输入上限为40,000 Tokens。",[662],"type","多模态内容列表","消息内容文本。",{"type":476,"description":666},"role为tool时，工具调用消息的唯一标识。",{"type":513,"items":668,"description":683},{"type":493,"properties":669},{"id":670,"type":672,"function":676},{"type":476,"description":671},"工具调用的唯一标识，用于关联本次工具调用。tool_calls中必填。",{"type":476,"description":673,"enum":674},"工具调用类型，当前仅支持 function。tool_calls中必填。",[675],"function",{"type":493,"description":677,"properties":678},"被调用的工具定义，tool_calls中必填。",{"name":679,"arguments":681},{"type":476,"description":680},"工具（函数）名称，tool_calls中必填。",{"type":476,"description":682},"工具调用参数，需为 JSON 格式的字符串，tool_calls中必填。","role为assistant时，工具调用信息列表，用于在触发工具调用时传递。","MessageInput",{"type":493,"required":686,"properties":688,"title":738},[687],"messages",{"user_id":689,"agent_id":695,"conversation_id":701,"messages":703,"app_id":708,"allow_memory_view":710,"tags":720,"info":723,"allow_public":731,"allow_knowledgebase_ids":733,"async_mode":736},{"oneOf":690,"title":500,"description":694},[691,692],{"type":476},{"type":513,"items":693},{"type":476},"添加消息所关联的用户唯一标识符。支持传入字符串（单用户）或字符串数组（群聊多用户，上限 20 个）。",{"oneOf":696,"description":700},[697,698],{"type":476},{"type":513,"items":699},{"type":476},"添加的消息所关联的 Agent 唯一标识符。支持传入字符串（单 Agent）或字符串数组（群聊多 Agent）。开启「为 Agent 创建独立记忆」后，Agent 作为独立主体拥有记忆。",{"type":476,"title":503,"description":702},"添加的消息所关联的会话唯一标识符，相同 conversation_id 下的多轮消息会被识别为同一上下文。",{"type":513,"title":704,"description":705,"items":706},"Messages","添加的消息对象数组，数组中所有消息的总 token 数上限为 40k。",{"$ref":707},"#\u002Fcomponents\u002Fschemas\u002FMessageInput",{"type":476,"description":709},"添加的消息所关联的应用唯一标识符，主要用于在检索记忆时查询某用户在该 App 下的专属记忆。",{"type":513,"items":711,"description":718,"default":719},{"type":476,"enum":712},[713,238,714,715,716,717],"detail_factual","skill","profile","event","tool_memory","允许抽取的记忆种类，不传时默认抽取所有种类。全部种类及取值说明见 \u003Ca href=\"\u002Fcn\u002Fmemos_cloud\u002Fintroduction\u002Fmemory_types\">记忆种类\u003C\u002Fa>。",[713,238,714,715,716,717],{"type":513,"items":721,"description":722},{"type":476},"自定义标签列表，用于标记添加消息的主题或分类。",{"type":493,"additionalProperties":724,"description":730},{"oneOf":725},[726,727,729],{"type":476},{"type":513,"items":728},{"type":476},{"type":530},"自定义元信息字段，能够存储任意与添加信息相关的结构化数据，例如位置、来源、版本等，主要用于在检索时精确过滤或追踪来源。",{"type":523,"description":732,"default":139},"添加的消息产生的记忆是否允许写入公共记忆库。开启后，生成的记忆可被项目下的其他用户检索。",{"type":513,"items":734,"description":735},{"type":476},"添加的消息，产生的记忆允许被写入的知识库范围。",{"type":523,"description":737,"default":45},"是否启用异步添加记忆。开启后，记忆将在后台异步添加，避免阻塞调用链。","AddMessageRequest",{"type":493,"properties":740,"title":751},{"success":741,"task_id":744,"status":747},{"type":523,"title":742,"description":743,"example":45},"Success","是否添加成功。true表示成功，false表示失败。",{"type":476,"title":745,"description":746},"Task ID","记忆处理任务的唯一标识。请调用 \u003Ca href=\"\u002Fcn\u002Fapi_docs\u002Fmessage\u002Fget_status\">Get Task Status\u003C\u002Fa> 接口查询任务处理结果。",{"type":476,"title":748,"enum":749,"description":750},"Status",[304,290,308],"记忆处理任务当前的状态。","OpenMemAddMessageResponse",{"type":493,"required":753,"properties":754,"title":761},[589,590],{"code":755,"data":757,"message":759},{"type":518,"format":756,"title":593,"description":594,"example":292},"int32",{"$ref":758},"#\u002Fcomponents\u002Fschemas\u002FOpenMemAddMessageResponse",{"type":476,"title":598,"description":760,"example":293},"接口提示信息。","AddMessageResponse",{"type":493,"required":763,"properties":764,"title":772},[495,496],{"user_id":765,"conversation_id":767,"message_limit_number":769},{"type":476,"title":500,"description":766},"与获取消息关联的用户的唯一标识符。",{"type":476,"title":503,"description":768},"与获取消息关联的会话的唯一标识符。",{"type":518,"format":756,"title":770,"description":771,"default":87},"Message Limit Number","限定返回的消息条数，用于控制消息列表的长度，不传时使用系统默认值6，最大值为50","GetMessageRequest",{"type":493,"properties":774,"title":786},{"role":775,"content":778,"create_time":780,"update_time":783},{"type":476,"enum":776,"title":629,"description":777,"example":55},[55,58],"消息发送者的角色。",{"type":476,"title":779,"description":664},"Content",{"type":476,"title":781,"description":782},"Create Time","消息创建时间。",{"type":476,"title":784,"description":785},"Update Time","消息最近一次更新时间。","MessageDetail",{"type":493,"properties":788,"title":794},{"message_detail_list":789},{"type":513,"title":790,"description":791,"items":792},"Message Detail List","消息添加结果对象。",{"$ref":793},"#\u002Fcomponents\u002Fschemas\u002FMessageDetail","GetMessageResponseData",{"type":493,"required":796,"properties":797,"title":802},[589,590],{"code":798,"data":799,"message":801},{"type":518,"format":756,"title":593,"description":594,"example":292},{"$ref":800},"#\u002Fcomponents\u002Fschemas\u002FGetMessageResponseData",{"type":476,"title":598,"description":760},"GetMessageResponse",{"type":493,"required":804,"properties":805,"title":867},[497],{"user_id":806,"agent_id":808,"conversation_id":810,"query":812,"filter":814,"knowledgebase_ids":855,"include_memory_view":858,"memory_limit_number":864,"relativity":866},{"type":476,"title":500,"description":807},"查询的记忆所关联用户的唯一标识符。",{"type":476,"title":563,"description":809},"查询的记忆所关联 Agent 的唯一标识符。仅开启「为 Agent 创建独立记忆」时可用，与 user_id 二选一。",{"type":476,"title":503,"description":811},"查询内容所在会话的唯一标识符，传入可以明确当前会话，本会话的记忆应当比其他历史会话的权重高。",{"type":476,"title":506,"description":813},"要在记忆中查询的文本内容，单次查询文本的token上限为40k。",{"type":493,"title":509,"description":815,"properties":816},"记忆过滤条件，用于在语义召回前缩小候选范围。可以直接用 \u003Ccode>and\u003C\u002Fcode> \u002F \u003Ccode>or\u003C\u002Fcode> 做全局过滤，也可以按 \u003Ccode>user\u003C\u002Fcode>、\u003Ccode>public\u003C\u002Fcode>、\u003Ccode>knowledgebase\u003C\u002Fcode> 分来源过滤。完整字段和示例见 \u003Ca href=\"\u002Fcn\u002Fmemos_cloud\u002Ffeatures\u002Ffilters\">记忆过滤\u003C\u002Fa>。",{"and":817,"or":821,"user":825,"public":835,"knowledgebase":845},{"type":513,"title":818,"description":819,"items":820},"And","全局 AND 条件数组。数组内所有条件都满足时，候选记忆才会进入语义召回。常用字段包括 \u003Ccode>agent_id\u003C\u002Fcode>、\u003Ccode>app_id\u003C\u002Fcode>、\u003Ccode>tags.contains\u003C\u002Fcode>、\u003Ccode>create_time\u003C\u002Fcode>、\u003Ccode>update_time\u003C\u002Fcode> 和 \u003Ccode>info\u003C\u002Fcode> 中的自定义字段。",{"type":493,"additionalProperties":45},{"type":513,"title":822,"description":823,"items":824},"Or","全局 OR 条件数组。数组内任一条件满足时，候选记忆即可进入语义召回。",{"type":493,"additionalProperties":45},{"type":493,"title":826,"description":827,"properties":828},"User","用户个人记忆的过滤条件。",{"and":829,"or":832},{"type":513,"description":830,"items":831},"用户记忆的 AND 条件数组。",{"type":493,"additionalProperties":45},{"type":513,"description":833,"items":834},"用户记忆的 OR 条件数组。",{"type":493,"additionalProperties":45},{"type":493,"title":836,"description":837,"properties":838},"Public","项目级公共记忆的过滤条件。",{"and":839,"or":842},{"type":513,"description":840,"items":841},"公共记忆的 AND 条件数组。",{"type":493,"additionalProperties":45},{"type":513,"description":843,"items":844},"公共记忆的 OR 条件数组。",{"type":493,"additionalProperties":45},{"type":493,"title":846,"description":847,"properties":848},"Knowledgebase","知识库记忆的过滤条件，仅作用于本次 \u003Ccode>knowledgebase_ids\u003C\u002Fcode> 允许访问的知识库范围。",{"and":849,"or":852},{"type":513,"description":850,"items":851},"知识库记忆的 AND 条件数组。",{"type":493,"additionalProperties":45},{"type":513,"description":853,"items":854},"知识库记忆的 OR 条件数组。",{"type":493,"additionalProperties":45},{"type":513,"items":856,"description":857},{"type":476},"该字段用于限制当次搜索可访问的知识库范围，默认为空（即不检索任何知识库）。传入具体知识库 ID，则可检索指定的知识库；传入all，则可检索该项目下所有关联知识库。",{"type":513,"items":859,"title":861,"description":862,"default":863},{"type":476,"enum":860},[713,238,714,715,716,717],"Include Memory View","允许检索的记忆种类。不传时默认召回事实记忆（detail_factual）和偏好记忆（preference）。详细说明见 \u003Ca href=\"\u002Fcn\u002Fmemos_cloud\u002Fintroduction\u002Fmemory_types\">记忆种类\u003C\u002Fa>。",[713,238],{"type":518,"format":756,"title":519,"description":865,"default":521},"召回的记忆条数上限，在满足相关性阈值（relativity）的前提下最多返回该数量的记忆，不保证返回固定条数。默认值 9，最大值 25。",{"type":530,"minimum":292,"maximum":296,"title":531,"description":532,"default":533},"SearchMemoryRequest",{"type":493,"properties":869,"title":905},{"id":870,"memory_key":873,"memory_value":876,"memory_type":879,"create_time":886,"conversation_id":888,"status":890,"confidence":894,"tags":897,"update_time":900,"relativity":902},{"type":476,"title":871,"description":872},"ID","事实记忆的唯一标识符，系统内部用于区分不同的记忆条目。",{"type":476,"title":874,"description":875},"Memory Key","事实记忆的标题或关键词，用于概括该事实记忆的主要内容。",{"type":476,"title":877,"description":878},"Memory Value","事实记忆的具体内容。",{"type":476,"enum":880,"title":884,"description":885,"example":882},[881,882,883],"WorkingMemory","LongTermMemory","UserMemory","Memory Type","事实记忆类型。\u003Cbr>WorkingMemory：工作记忆，临时存储的短期信息。\u003Cbr>LongTermMemory：长期记忆，持久保存的重要信息或事实。\u003Cbr>UserMemory：用户记忆，与特定用户相关的个性化信息。",{"type":476,"title":781,"description":887},"事实记忆内容创建的时间，通常为 ISO 8601 格式。",{"type":476,"title":503,"description":889},"与该事实记忆关联的会话的唯一标识符。",{"type":476,"enum":891,"title":748,"description":893,"example":892},[892],"activated","事实记忆的状态，当前所有检索到的事实记忆都是activated。\u003Cbr>activated：激活状态，当前可检索和使用的事实记忆。",{"type":530,"minimum":292,"maximum":296,"title":895,"description":896,"example":158},"Confidence","事实记忆的置信度分数，范围 0~1，数值越接近 1 表示该事实记忆越准确可靠。\u003Cbr>置信度分数会随着模型对该事实记忆的推理次数增加而逐渐衰减，用于反映事实记忆随着时间或使用频率可能产生的不确定性。",{"type":513,"title":567,"description":898,"items":899},"与事实记忆相关的标签列表，用于分类、检索或主题标记。数组中的每个元素都是string，例如 [\"人物\", \"事件\", \"工作\"]。",{"type":476},{"type":476,"title":784,"description":901},"事实记忆最后一次被修改或更新的时间，通常为 ISO 8601 格式。",{"type":530,"minimum":292,"maximum":296,"title":531,"description":903,"example":904},"查询内容与该事实记忆的相关性分数，范围 0~1，数值越接近 1 表示越相关。",0.87,"MemoryDetail",{"type":493,"properties":907,"title":933},{"id":908,"preference_type":910,"preference":916,"reasoning":919,"create_time":922,"conversation_id":924,"status":926,"update_time":929,"relativity":931},{"type":476,"title":871,"description":909},"偏好记忆的唯一标识符，系统内部用于区分不同的记忆条目。",{"type":476,"enum":911,"title":914,"description":915,"example":912},[912,913],"explicit_preference","implicit_preference","Preference Type","偏好记忆类型。\u003Cbr>explicit_preference：显式偏好记忆。\u003Cbr>implicit_preference：隐式偏好记忆。",{"type":476,"title":917,"description":918},"Preference","偏好记忆的具体内容。",{"type":476,"title":920,"description":921},"Reasoning","偏好记忆提取的原因。",{"type":476,"title":781,"description":923},"偏好记忆内容创建的时间，通常为 ISO 8601 格式。",{"type":476,"title":503,"description":925},"与该偏好记忆关联的会话的唯一标识符。",{"type":476,"enum":927,"title":748,"description":928,"example":892},[892],"偏好记忆的状态，当前所有检索到的偏好记忆都是activated。\u003Cbr>activated：激活状态，当前可检索和使用的事实记忆。",{"type":476,"title":784,"description":930},"偏好记忆最后一次被修改或更新的时间，通常为 ISO 8601 格式。",{"type":530,"minimum":292,"maximum":296,"title":531,"description":932,"example":904},"查询内容与该偏好记忆的相关性分数，范围 0~1，数值越接近 1 表示越相关。","PreferenceDetail",{"type":493,"properties":935,"title":948},{"used_tool":936,"error_type":939,"success_rate":942,"tool_experience":945},{"type":476,"title":937,"description":938},"Used Tool","使用的工具名称。",{"type":476,"title":940,"description":941},"Error Type","调用失败时的错误描述。",{"type":530,"title":943,"description":944},"Success Rate","本次工具轨迹的成功率。",{"type":476,"title":946,"description":947},"Tool Experience","当前轨迹中该工具的经验。","ToolUsedStatus",{"type":493,"properties":950,"title":981},{"id":951,"tool_type":953,"tool_value":959,"tool_used_status":962,"create_time":967,"conversation_id":969,"status":971,"update_time":974,"relativity":976,"experience":978},{"type":476,"title":871,"description":952},"工具记忆片段的唯一标识符。",{"type":476,"title":954,"description":955,"enum":956},"Tool Type","工具记忆类型。ToolTrajectoryMemory 表示工具轨迹记忆；ToolSchema 表示工具信息记忆。",[957,958],"ToolTrajectoryMemory","ToolSchema",{"type":476,"title":960,"description":961},"Tool Value","工具记忆的具体内容。",{"type":513,"title":963,"description":964,"items":965},"Tool Used Status","工具轨迹记忆列表，每条记录包含使用的工具及经验信息。",{"$ref":966},"#\u002Fcomponents\u002Fschemas\u002FToolUsedStatus",{"type":476,"title":781,"description":968},"工具记忆创建时间（ISO 8601 格式）。",{"type":476,"title":503,"description":970},"与该工具记忆关联的会话唯一标识符。",{"type":476,"title":748,"description":972,"enum":973},"工具记忆状态，当前为 activated。",[892],{"type":476,"title":784,"description":975},"工具记忆最后一次更新的时间（ISO 8601 格式）。",{"type":530,"title":531,"description":977},"工具记忆与查询内容的相关性分数。",{"type":476,"title":979,"description":980},"Experience","整个轨迹的程序性经验，作为指导任务完成的总体经验。","ToolMemoryDetail",{"type":493,"properties":983},{"name":984,"description":987,"procedure":990,"experience":993,"preference":996,"examples":999,"script":1003,"others":1006},{"type":476,"title":985,"description":986},"Name","技能 Skill 的名称，用于展示与识别该能力。",{"type":476,"title":988,"description":989},"Description","技能 Skill 的描述。",{"type":476,"title":991,"description":992},"Procedure","完成该任务的推荐流程或操作步骤。",{"type":513,"title":979,"items":994,"description":995},{"type":476},"来自历史任务的经验沉淀，包括最佳实践、常见误区与避坑建议。",{"type":513,"title":917,"items":997,"description":998},{"type":476},"用户在该类任务中的偏好设定，例如风格、约束条件或优先级。",{"type":513,"title":1000,"items":1001,"description":1002},"Examples",{"type":476},"该技能 Skill 的典型使用示例，帮助 Agent 理解输入输出形式与使用边界。",{"type":493,"title":1004,"description":1005},"Script","用于完成该 Skill 的可复用代码脚本或逻辑实现。",{"type":493,"title":1007,"description":1008},"Others","其他补充信息。",{"type":493,"properties":1010,"title":1040},{"id":1011,"skill_value":1013,"skill_url":1018,"skill_type":1021,"create_time":1024,"conversation_id":1026,"status":1028,"confidence":1031,"tags":1033,"update_time":1036,"relativity":1038},{"type":476,"title":871,"description":1012},"技能 Skill 的唯一标识符，系统内部用于区分不同的记忆条目。",{"type":493,"title":1014,"description":1015,"items":1016},"Skill Value","技能 Skill 的结构化内容，可直接转为字符串后注入 Agent 的 prompt。",{"$ref":1017},"#\u002Fcomponents\u002Fschemas\u002FSkillValue",{"type":476,"title":1019,"description":1020},"Skill Url","技能 Skill 的下载链接。Markdown Skill 可下载为 SKILL.md；ZIP 技能包可下载后获取 SKILL.md、脚本、参考资料等附件。",{"type":476,"title":1022,"description":1023},"Skill Type","技能 Skill 的类型。",{"type":476,"title":781,"description":1025},"技能 Skill 内容创建的时间，通常为 ISO 8601 格式。",{"type":476,"title":503,"description":1027},"与该技能 Skill 关联的会话的唯一标识符。",{"type":476,"title":748,"description":1029,"enum":1030},"技能 Skill 的状态，当前所有检索到的技能 Skill 都是 activated。activated：激活状态，当前可检索和使用的技能 Skill 。",[892],{"type":530,"title":895,"description":1032},"技能 Skill 的置信度分数，范围 0~1，数值越接近 1 表示该技能 Skill 越准确可靠。\n置信度分数会随着模型对该技能 Skill 的推理次数增加而逐渐衰减，用于反映技能 Skill 随着时间或使用频率可能产生的不确定性。",{"type":513,"items":1034,"description":1035},{"type":476},"与技能 Skill 相关的标签列表，用于分类、检索或主题标记。数组中的每个元素都是string，例如 [\"人物\", \"事件\", \"工作\"]。",{"type":476,"title":784,"description":1037},"技能 Skill 最后一次被修改或更新的时间，通常为 ISO 8601 格式",{"type":476,"title":531,"description":1039},"查询内容与该技能 Skill 的相关性分数，范围 0~1，数值越接近 1 表示越相关。","SkillDetail",{"type":493,"title":1042,"properties":1043},"SearchProfileDetail",{"id":1044,"memory":1046,"memory_type":1049,"template_id":1053,"profile_category":1056,"profile_field":1059,"profile_path":1062,"status":1065,"created_at":1068,"updated_at":1071,"confidence":1074,"relativity":1076,"algorithm_updatable":1078},{"type":476,"title":871,"description":1045},"属性记忆的唯一标识符。",{"type":476,"title":1047,"description":1048},"Memory","属性记忆内容。",{"type":476,"title":884,"description":1050,"enum":1051},"记忆类型，属性记忆为 ProfileMemory。",[1052],"ProfileMemory",{"type":476,"title":1054,"description":1055},"Template ID","属性模板 ID。",{"type":476,"title":1057,"description":1058},"Profile Category","属性分类，例如「基础信息」。",{"type":476,"title":1060,"description":1061},"Profile Field","属性字段名，例如「职业」。",{"type":476,"title":1063,"description":1064},"Profile Path","属性路径，例如「基础信息.职业」。",{"type":476,"title":748,"description":1066,"enum":1067},"属性记忆状态，当前检索结果均为 activated。",[892],{"type":476,"title":1069,"description":1070},"Created At","属性记忆创建时间，ISO 8601 格式。",{"type":476,"title":1072,"description":1073},"Updated At","属性记忆最后一次更新时间，ISO 8601 格式。",{"type":530,"minimum":292,"maximum":296,"title":895,"description":1075},"属性记忆的置信度分数，范围 0~1。",{"type":530,"minimum":292,"maximum":296,"title":531,"description":1077},"查询内容与该属性字段的相关性分数，范围 0~1。",{"type":523,"title":1079,"description":1080},"Algorithm Updatable","该属性字段是否允许算法自动更新。",{"type":493,"title":1082,"properties":1083},"SearchEventDetail",{"id":1084,"event_key":1086,"event_value":1089,"event_type":1092,"create_time":1095,"conversation_id":1097,"status":1099,"update_time":1102,"relativity":1104,"event_time":1106,"event_location":1110,"event_roles":1114},{"type":476,"title":871,"description":1085},"事件记忆的唯一标识符。",{"type":476,"title":1087,"description":1088},"Event Key","事件记忆的标题或关键词。",{"type":476,"title":1090,"description":1091},"Event Value","事件记忆的具体内容。",{"type":476,"title":1093,"description":1094},"Event Type","事件记忆类型，通常为 EventMemory。",{"type":476,"title":781,"description":1096},"事件记忆创建时间，ISO 8601 格式。",{"type":476,"title":503,"description":1098},"与该事件记忆关联的会话唯一标识符。",{"type":476,"title":748,"description":1100,"enum":1101},"事件记忆状态，当前检索结果均为 activated。",[892],{"type":476,"title":784,"description":1103},"事件记忆最后一次更新时间，ISO 8601 格式。",{"type":530,"minimum":292,"maximum":296,"title":531,"description":1105},"查询内容与该事件记忆的相关性分数，范围 0~1。",{"type":513,"title":1107,"description":1108,"items":1109},"Event Time","事件时间列表。",{"type":476},{"type":513,"title":1111,"description":1112,"items":1113},"Event Location","事件地点列表。",{"type":476},{"type":513,"title":1115,"description":1116,"items":1117},"Event Roles","事件参与者列表。",{"type":476},{"type":493,"title":1119,"properties":1120},"SearchMemoryResponseData",{"memory_detail_list":1121,"preference_detail_list":1126,"profile_detail_list":1131,"event_detail_list":1136,"tool_memory_detail_list":1141,"preference_note":1146,"skill_detail_list":1149},{"type":513,"title":1122,"description":1123,"items":1124},"Memory Detail List","返回的事实记忆片段详情列表。",{"$ref":1125},"#\u002Fcomponents\u002Fschemas\u002FMemoryDetail",{"type":513,"title":1127,"description":1128,"items":1129},"Preference Detail List","返回的偏好记忆片段详情列表。",{"$ref":1130},"#\u002Fcomponents\u002Fschemas\u002FPreferenceDetail",{"type":513,"title":1132,"description":1133,"items":1134},"Profile Detail List","返回的属性记忆片段详情列表。",{"$ref":1135},"#\u002Fcomponents\u002Fschemas\u002FSearchProfileDetail",{"type":513,"title":1137,"description":1138,"items":1139},"Event Detail List","返回的事件记忆片段详情列表。",{"$ref":1140},"#\u002Fcomponents\u002Fschemas\u002FSearchEventDetail",{"type":513,"title":1142,"description":1143,"items":1144},"Tool Memory Detail List","返回的工具记忆片段详情列表。",{"$ref":1145},"#\u002Fcomponents\u002Fschemas\u002FToolMemoryDetail",{"type":476,"title":1147,"description":1148},"Preference Note","召回偏好记忆时，返回的偏好使用说明。",{"type":513,"title":1150,"description":1151,"items":1152},"Skill Detail List","返回的技能 Skill 详情列表。",{"$ref":1153},"#\u002Fcomponents\u002Fschemas\u002FSkillDetail",{"type":493,"required":1155,"properties":1156,"title":1161},[589,590],{"code":1157,"data":1158,"message":1160},{"type":518,"format":756,"title":593,"description":594,"example":292},{"$ref":1159},"#\u002Fcomponents\u002Fschemas\u002FSearchMemoryResponseData",{"type":476,"title":598,"description":760},"SearchMemoryResponse",{"type":493,"properties":1163,"title":1181},{"user_id":1164,"agent_id":1166,"page":1168,"size":1171,"filter":1175,"include_memory_view":1177},{"type":476,"title":500,"description":1165},"获取的记忆所关联用户的唯一标识符。",{"type":476,"title":563,"description":1167},"获取的记忆所关联 Agent 的唯一标识符。仅开启「为 Agent 创建独立记忆」时可用，与 user_id 二选一。",{"type":518,"title":1169,"description":1170,"default":296},"Page","分页页码，用于在返回结果较多时进行分页控制。",{"type":518,"title":1172,"description":1173,"default":1174},"Size","指定每一类记忆在当前页返回的条目数量，最大值为50。",10,{"type":493,"title":509,"description":1176,"example":511},"记忆过滤的条件，用于在获取记忆前精确限定记忆范围。可用字段包括：\"agent_id\", \"app_id\", \"create_time\", \"update_time\"以及\"info\"中的字段。支持逻辑运算符（and，or）和比较运算符（gte、lte、gt、lt）。对于\"info\"字段，支持过滤传入的\"business_type\", \"biz_id\", \"scene\"和其他自定义字段。",{"type":513,"items":1178,"title":861,"description":1180},{"type":476,"enum":1179},[713,238,714,715,716,717],"允许获取的记忆种类，不传时默认获取所有种类的记忆。全部种类及取值说明见 \u003Ca href=\"\u002Fcn\u002Fmemos_cloud\u002Fintroduction\u002Fmemory_types\">记忆种类\u003C\u002Fa>。","GetMemoryRequest",{"type":493,"title":1183,"properties":1184},"GetProfileMemoryDetail",{"id":1185,"project_id":1187,"profile_template_id":1190,"properties":1192,"status":1195,"created_at":1198,"updated_at":1199},{"type":476,"title":871,"description":1186},"属性记忆实例的唯一标识符。",{"type":476,"title":1188,"description":1189},"Project ID","项目 ID。",{"type":476,"title":1191,"description":1055},"Profile Template ID",{"type":493,"title":1193,"description":1194,"additionalProperties":45},"Properties","属性记忆的结构化字段树。",{"type":476,"title":748,"description":1196,"enum":1197},"属性记忆状态，当前仅返回 activated。",[892],{"type":476,"title":1069,"description":1070},{"type":476,"title":1072,"description":1073},{"type":493,"title":1201,"properties":1202},"GetEventMemoryDetail",{"id":1203,"event_key":1204,"event_value":1205,"event_type":1206,"create_time":1207,"conversation_id":1208,"status":1209,"update_time":1212,"info":1213,"sources":1215,"event_time":1219,"event_location":1221,"event_roles":1223},{"type":476,"title":871,"description":1085},{"type":476,"title":1087,"description":1088},{"type":476,"title":1090,"description":1091},{"type":476,"title":1093,"description":1094},{"type":476,"title":781,"description":1096},{"type":476,"title":503,"description":1098},{"type":476,"title":748,"description":1210,"enum":1211},"事件记忆状态，当前仅返回 activated。",[892],{"type":476,"title":784,"description":1103},{"type":493,"title":571,"description":1214,"additionalProperties":45},"事件记忆的扩展信息。",{"type":513,"title":1216,"description":1217,"items":1218},"Sources","事件记忆的来源消息列表。",{"type":493,"additionalProperties":45},{"type":513,"title":1107,"description":1108,"items":1220},{"type":476},{"type":513,"title":1111,"description":1112,"items":1222},{"type":476},{"type":513,"title":1115,"description":1116,"items":1224},{"type":476},{"type":493,"title":1226,"properties":1227},"GetMemoryDetail",{"id":1228,"memory_key":1230,"memory_value":1232,"memory_type":1233,"create_time":1236,"conversation_id":1238,"status":1240,"confidence":1243,"tags":1245,"update_time":1248,"relativity":1250,"sources":1252,"info":1255},{"type":476,"title":871,"description":1229},"事实记忆的唯一标识符。",{"type":476,"title":874,"description":1231},"事实记忆的标题或关键词。",{"type":476,"title":877,"description":878},{"type":476,"title":884,"description":1234,"enum":1235},"事实记忆类型。",[881,882,883],{"type":476,"title":781,"description":1237},"事实记忆创建时间，ISO 8601 格式。",{"type":476,"title":503,"description":1239},"与该事实记忆关联的会话唯一标识符。",{"type":476,"title":748,"description":1241,"enum":1242},"事实记忆状态，当前仅返回 activated。",[892],{"type":530,"minimum":292,"maximum":296,"title":895,"description":1244},"事实记忆的置信度分数，范围 0~1。",{"type":513,"title":567,"description":1246,"items":1247},"与事实记忆相关的标签列表。",{"type":476},{"type":476,"title":784,"description":1249},"事实记忆最后一次更新时间，ISO 8601 格式。",{"type":530,"minimum":292,"maximum":296,"title":531,"description":1251},"事实记忆的相关性分数，范围 0~1。",{"type":513,"title":1216,"description":1253,"items":1254},"事实记忆的来源消息列表。",{"type":493,"additionalProperties":45},{"type":493,"title":571,"description":1256,"additionalProperties":45},"添加消息时自定义的元信息字段。",{"type":493,"title":1258,"properties":1259},"GetPreferenceDetail",{"id":1260,"preference_type":1262,"preference":1265,"reasoning":1266,"create_time":1267,"conversation_id":1269,"status":1271,"update_time":1274,"relativity":1276,"sources":1278,"info":1281},{"type":476,"title":871,"description":1261},"偏好记忆的唯一标识符。",{"type":476,"title":914,"description":1263,"enum":1264},"偏好记忆类型。",[912,913],{"type":476,"title":917,"description":918},{"type":476,"title":920,"description":921},{"type":476,"title":781,"description":1268},"偏好记忆创建时间，ISO 8601 格式。",{"type":476,"title":503,"description":1270},"与该偏好记忆关联的会话唯一标识符。",{"type":476,"title":748,"description":1272,"enum":1273},"偏好记忆状态，当前仅返回 activated。",[892],{"type":476,"title":784,"description":1275},"偏好记忆最后一次更新时间，ISO 8601 格式。",{"type":530,"minimum":292,"maximum":296,"title":531,"description":1277},"偏好记忆的相关性分数，范围 0~1。",{"type":513,"title":1216,"description":1279,"items":1280},"偏好记忆的来源消息列表。",{"type":493,"additionalProperties":45},{"type":493,"title":571,"description":1256,"additionalProperties":45},{"type":493,"title":1283,"properties":1284},"GetToolMemoryDetail",{"id":1285,"tool_type":1286,"tool_value":1288,"tool_used_status":1289,"create_time":1291,"conversation_id":1293,"status":1294,"update_time":1296,"relativity":1298,"source":1300,"experience":1303,"info":1304},{"type":476,"title":871,"description":952},{"type":476,"title":954,"description":955,"enum":1287},[957,958],{"type":476,"title":960,"description":961},{"type":513,"title":963,"description":964,"items":1290},{"$ref":966},{"type":476,"title":781,"description":1292},"工具记忆创建时间，ISO 8601 格式。",{"type":476,"title":503,"description":970},{"type":476,"title":748,"description":972,"enum":1295},[892],{"type":476,"title":784,"description":1297},"工具记忆最后一次更新时间，ISO 8601 格式。",{"type":530,"minimum":292,"maximum":296,"title":531,"description":1299},"工具记忆的相关性分数，范围 0~1。",{"type":476,"title":1301,"description":1302},"Source","工具记忆的来源信息。",{"type":476,"title":979,"description":980},{"type":493,"title":571,"description":1256,"additionalProperties":45},{"type":493,"title":1306,"properties":1307},"GetMemoryResponseData",{"memory_detail_list":1308,"preference_detail_list":1311,"profile_detail_list":1314,"event_detail_list":1317,"tool_memory_detail_list":1320,"skill_detail_list":1323,"total":1325,"size":1327,"current":1329,"pages":1331},{"type":513,"title":1122,"description":1123,"items":1309},{"$ref":1310},"#\u002Fcomponents\u002Fschemas\u002FGetMemoryDetail",{"type":513,"title":1127,"description":1128,"items":1312},{"$ref":1313},"#\u002Fcomponents\u002Fschemas\u002FGetPreferenceDetail",{"type":513,"title":1132,"description":1133,"items":1315},{"$ref":1316},"#\u002Fcomponents\u002Fschemas\u002FGetProfileMemoryDetail",{"type":513,"title":1137,"description":1138,"items":1318},{"$ref":1319},"#\u002Fcomponents\u002Fschemas\u002FGetEventMemoryDetail",{"type":513,"title":1142,"description":1143,"items":1321},{"$ref":1322},"#\u002Fcomponents\u002Fschemas\u002FGetToolMemoryDetail",{"type":513,"title":1150,"description":1151,"items":1324},{"$ref":1153},{"type":518,"description":1326},"获取的各类记忆总数中的最大值，用于判断是否存在下一页。",{"type":518,"description":1328},"每一类记忆在当前页返回的条目数量。",{"type":518,"description":1330},"当前获取的记忆所在页数。",{"type":518,"description":1332},"获取记忆的总页数。",{"type":493,"required":1334,"title":1335,"properties":1336},[589,590],"GetMemoryResponse",{"code":1337,"data":1339,"message":1341},{"type":530,"title":593,"description":1338},"接口状态码，更多内容可查阅错误码列表了解详情。",{"$ref":1340},"#\u002Fcomponents\u002Fschemas\u002FGetMemoryResponseData",{"type":476,"title":598,"description":760},{"type":493,"properties":1343,"title":1352},{"memory_ids":1344,"user_id":1348,"agent_id":1350},{"type":513,"items":1345,"title":1346,"description":1347},{"type":476},"Memory IDs","需要删除的记忆 ID 列表。",{"type":476,"title":500,"description":1349},"删除该用户在当前项目下的全部记忆。与 memory_ids、agent_id 互斥。",{"type":476,"title":563,"description":1351},"删除该 Agent 在当前项目下的全部记忆。仅开启「为 Agent 创建独立记忆」时可用。与 memory_ids、user_id 互斥。","DeleteMemoryRequest",{"type":493,"properties":1354,"title":1364},{"code":1355,"data":1356,"message":1362},{"type":518,"title":593,"description":594},{"type":493,"title":1357,"properties":1358,"description":1361},"Data",{"success":1359},{"type":523,"title":742,"description":1360,"example":45},"是否删除成功。true 表示成功，false 表示失败。","返回删除信息",{"type":476,"title":598,"description":1363},"删除提示信息","DeleteMemoryResponse",{"type":493,"required":1366,"properties":1368,"title":1388},[495,496,1367],"feedback_content",{"user_id":1369,"conversation_id":1371,"feedback_content":1373,"agent_id":1376,"app_id":1378,"feedback_time":1380,"allow_public":1383,"allow_knowledgebase_ids":1385},{"type":476,"title":500,"description":1370},"反馈内容所关联的用户唯一标识符。",{"type":476,"title":503,"description":1372},"反馈内容所关联的会话唯一标识符。",{"type":476,"title":1374,"description":1375},"Feedback Content","反馈内容文本。",{"type":476,"title":563,"description":1377},"反馈内容所关联的Agent唯一标识符，主要用于在检索记忆时查询某用户与该Agent的专属记忆。",{"type":476,"title":560,"description":1379},"反馈内容所关联的应用唯一标识符，主要用于在检索记忆时查询某用户在该App下的专属记忆。",{"type":476,"title":1381,"description":1382},"Feedback Time","反馈发生的时间，可传入结构化时间或自然语言时间描述。传入该参数能够让记忆携带时间信息。",{"type":523,"title":574,"description":1384,"default":139},"反馈内容，产生的记忆，是否允许写入公共记忆库。开启后，生成的记忆可被项目下的其他用户检索。 ",{"type":513,"items":1386,"title":578,"description":1387},{"type":476},"反馈内容产生的记忆，允许被写入的知识库列表。","AddFeedbackRequest",{"type":493,"required":1390,"properties":1391,"title":1403},[589,590],{"code":1392,"data":1393,"message":1401},{"type":518,"title":593,"description":594},{"type":493,"title":1357,"properties":1394},{"success":1395,"status":1397,"task_id":1399},{"type":523,"title":742,"description":1396},"是否添加成功。true 表示成功，false 表示失败。",{"type":476,"title":748,"description":1398},"任务状态：running（运行中），completed（完成）",{"type":476,"title":745,"description":1400},"任务id",{"type":476,"title":598,"description":1402},"接口提示信息","AddFeedbackResponse",{"type":493,"title":1405,"properties":1406},"Task Status Memory View IDs",{"memory_ids":1407},{"type":513,"items":1408,"title":1346,"description":1409},{"type":476},"本次任务在该\u003Ca href=\"\u002Fcn\u002Fmemos_cloud\u002Fintroduction\u002Fmemory_types\">记忆种类\u003C\u002Fa>下触达的记忆 ID 列表。",{"type":493,"title":1411,"description":1412,"properties":1413},"Task Status Memory Views","任务完成后返回的本轮记忆变更汇总。",{"added":1414,"updated":1417,"deleted":1420,"detail_factual":1423,"preference":1425,"event":1426,"profile":1427,"skill":1428,"tool_memory":1429},{"type":518,"title":1415,"description":1416},"Added","本次任务新增的记忆数量。",{"type":518,"title":1418,"description":1419},"Updated","本次任务更新的记忆数量。",{"type":518,"title":1421,"description":1422},"Deleted","本次任务删除或归档的记忆数量。",{"$ref":1424},"#\u002Fcomponents\u002Fschemas\u002FTaskStatusMemoryViewIds",{"$ref":1424},{"$ref":1424},{"$ref":1424},{"$ref":1424},{"$ref":1424},{"type":493,"title":1431,"properties":1432},"OpenMem Get Status Data",{"task_id":1433,"status":1435,"memory_views":1438},{"type":476,"title":745,"description":1434},"异步任务 ID，与请求中的 task_id 一致。",{"type":476,"title":748,"enum":1436,"description":1437},[304,290,308],"任务当前状态：`running` 处理中，`completed` 已完成，`failed` 失败。",{"$ref":1439,"description":1440},"#\u002Fcomponents\u002Fschemas\u002FTaskStatusMemoryViews","仅当 status 为 completed 且存在记忆变更明细时返回；running \u002F failed 时不返回。",{"type":493,"required":1442,"properties":1444,"title":1447},[1443],"task_id",{"task_id":1445},{"type":476,"title":745,"description":1446},"异步任务 ID，来自 add\u002Fmessage、add\u002Ffeedback 等接口响应中的 task_id。","GetStatusRequest",{"type":493,"required":1449,"properties":1450,"title":1455},[589,590],{"code":1451,"data":1452,"message":1454},{"type":518,"title":593,"description":594},{"$ref":1453},"#\u002Fcomponents\u002Fschemas\u002FOpenMemGetStatusData",{"type":476,"title":598,"description":1402},"GetStatusResponse",{"type":493,"required":1457,"properties":1459,"title":1466},[1458],"knowledgebase_name",{"knowledgebase_name":1460,"knowledgebase_description":1463},{"type":476,"title":1461,"description":1462},"Knowledgebase Name","知识库名称",{"type":476,"title":1464,"description":1465},"Knowledgebase Description","描述信息","CreateKnowledgebaseRequest",{"type":493,"required":1468,"properties":1469,"title":1477},[589,590],{"code":1470,"data":1471,"message":1476},{"type":518,"title":593,"description":594},{"type":493,"title":1357,"properties":1472},{"id":1473},{"type":476,"title":1474,"description":1475},"KNOWLEDGEBASE ID","创建成功后返回的知识库 ID",{"type":476,"title":598,"description":1402},"CreateKnowledgebaseResponse",{"type":493,"required":1479,"properties":1481,"title":1485},[1480],"knowledgebase_id",{"knowledgebase_id":1482},{"type":476,"title":1483,"description":1484},"Knowledgebase ID","要移除的知识库ID","DeleteKnowledgebaseRequest",{"type":493,"required":1487,"properties":1488,"title":1495},[589,590],{"code":1489,"data":1490,"message":1494},{"type":518,"title":593,"description":594},{"type":493,"title":1357,"properties":1491},{"success":1492},{"type":523,"title":742,"description":1493},"是否移除成功。true 表示成功，false 表示失败。",{"type":476,"title":598,"description":1402},"DeleteKnowledgebaseResponse",{"type":493,"required":1497,"properties":1498,"title":1515},[1480,647],{"knowledgebase_id":1499,"file":1501},{"type":476,"title":1483,"description":1500},"目标知识库ID",{"type":513,"title":1502,"description":1503,"items":1504},"File","上传文件列表。普通文档按文档解析流程处理；Skill 文件按 Skill 校验和解析流程处理。",{"type":493,"properties":1505},{"name":1506,"type":1508,"content":1513},{"type":476,"title":985,"description":1507},"上传的文件名称。上传 Base64 内容时建议填写；上传 URL 时可不填。",{"type":476,"title":1509,"enum":1510,"default":1511,"description":1512},"Type",[1511,714],"document","上传文件类型。document 表示普通知识库文档；skill 表示 Skill 文件，支持 .md 单文件或 .zip 技能包。",{"type":476,"title":779,"description":1514},"文件内容，支持 URL 或 Base64 编码。普通文档和 Skill 文件的支持格式、大小与数量限制，请查看\u003Ca href=\"\u002Fmemos_cloud\u002Ffeatures\u002Fknowledge_base\" class=\"text-primary border-b border-transparent hover:border-primary font-medium focus-visible:outline-primary [&>code]:border-dashed hover:[&>code]:border-primary hover:[&>code]:text-primary transition-colors [&>code]:transition-colors\">知识库要求\u003C\u002Fa>。","UploadFileRequest",{"type":493,"required":1517,"properties":1518,"title":1539},[589,590],{"code":1519,"data":1520,"message":1537},{"type":518,"title":593,"description":594},{"type":513,"title":1357,"description":1521,"items":1522},"上传文件的处理结果列表。",{"type":493,"properties":1523},{"id":1524,"type":1526,"name":1529,"sizeMB":1531,"status":1534},{"type":476,"title":871,"description":1525},"文件 ID",{"type":476,"title":1509,"enum":1527,"description":1528},[1511,714],"文件类型。document 表示普通文档；skill 表示 Skill 文件。",{"type":476,"title":985,"description":1530},"文件名称",{"type":530,"title":1532,"description":1533},"Size MB","文件大小，单位 MB",{"type":476,"title":748,"description":1535,"enum":1536},"文件处理状态",[304,290,308],{"type":476,"title":598,"description":1538},"接口信息","UploadFileResponse",{"type":493,"description":1541,"properties":1542,"title":1558},"获取指定文件列表或指定知识库下的文件列表信息",{"knowledgebase_id":1543,"type":1545,"page":1548,"page_size":1550,"file_ids":1554},{"type":476,"title":1483,"description":1544},"目标知识库 ID，不能与 file_ids 同时传。",{"type":476,"title":1509,"enum":1546,"description":1547},[1511,714],"文件类型筛选，仅在使用 knowledgebase_id 查询时生效。document 仅返回普通文档；skill 仅返回技能文件；不传则返回全部文件。",{"type":518,"format":756,"title":1169,"description":1549,"default":296},"分页页码，仅在使用 knowledgebase_id 查询时生效。",{"type":518,"format":756,"title":1551,"description":1552,"default":1553},"Page Size","每页条数，仅在使用 knowledgebase_id 查询时生效。",20,{"type":513,"items":1555,"title":1556,"description":1557},{"type":476},"File IDs","目标文件 ID 列表，传入后返回指定文件详情。","GetFileRequest",{"type":493,"required":1560,"properties":1561,"title":1586},[589,590],{"code":1562,"data":1563,"message":1585},{"type":518,"title":593,"description":594},{"type":493,"title":1357,"properties":1564},{"total":1565,"page":1568,"page_size":1570,"file_detail_list":1572},{"type":518,"format":756,"title":1566,"description":1567},"Total","符合条件的文件总数",{"type":518,"format":756,"title":1169,"description":1569},"当前页码",{"type":518,"format":756,"title":1551,"description":1571},"每页条数",{"type":513,"items":1573,"title":1584},{"type":493,"properties":1574},{"id":1575,"type":1576,"name":1579,"size":1580,"status":1582},{"type":476,"title":871,"description":1525},{"type":476,"title":1509,"enum":1577,"description":1578},[1511,714],"文件类型。document 表示知识文档；skill 表示技能文件。",{"type":476,"title":985,"description":1530},{"type":476,"title":1172,"description":1581},"文件大小",{"type":476,"title":748,"description":1535,"enum":1583},[304,290,308],"File Detail List",{"type":476,"title":598,"description":1402},"GetFileResponse",{"type":493,"required":1588,"properties":1590,"title":1594},[1589],"file_ids",{"file_ids":1591},{"type":513,"items":1592,"title":1556,"description":1593},{"type":476},"要删除的文件 ID 列表。可传入普通文档 ID 或 Skill 文件 ID。","DeleteFileRequest",{"type":493,"required":1596,"properties":1597,"title":1603},[589,590],{"code":1598,"data":1599,"message":1602},{"type":518,"title":593,"description":594},{"type":493,"title":1357,"properties":1600},{"success":1601},{"type":523,"title":742,"description":1360},{"type":476,"title":598,"description":1402},"DeleteFileResponse",{"type":493,"title":1605,"properties":1606},"ExtractMemoryItem",{"memory_key":1607,"memory_value":1610,"memory_type":1613,"tags":1615},{"type":476,"title":874,"description":1608,"example":1609},"记忆主题，对抽取到的事实记忆的概括性描述。","用户基本信息",{"type":476,"title":877,"description":1611,"example":1612},"记忆内容，对抽取到的事实记忆的详细描述。","用户张三，28岁，在杭州从事后端开发，喜欢打羽毛球。",{"type":476,"title":884,"description":1614,"example":883},"记忆类型分类标识。\u003Cbr>示例：UserMemory、LongTermMemory。",{"type":513,"items":1616,"title":567,"description":1617,"example":1618},{"type":476},"记忆标签列表，用于对记忆内容进行分类标注。",[1619,1620,1621],"人物","职业","爱好",{"type":493,"title":1623,"properties":1624},"ExtractPreferenceItem",{"preference":1625,"reasoning":1628,"preference_type":1631},{"type":476,"title":917,"description":1626,"example":1627},"偏好描述，对抽取到的用户偏好的具体内容。","用户明确表示希望回复尽量简洁。",{"type":476,"title":920,"description":1629,"example":1630},"推理依据，说明该偏好是如何从对话中推断得出的。","对话中用户直接说明偏好。",{"type":476,"title":914,"description":1632,"enum":1633,"example":912},"偏好类型：显性偏好为用户明确表达，隐性偏好为从行为或语境推断。",[912,913],{"type":493,"title":1635,"properties":1636},"ExtractMemoryResponseData",{"success":1637,"memory_detail_list":1639,"preference_detail_list":1643},{"type":523,"title":742,"description":1638},"是否抽取成功。",{"type":513,"title":1122,"description":1640,"items":1641},"事实记忆列表。当请求中 extraction_types 包含 memory，或未传 extraction_types 时返回。",{"$ref":1642},"#\u002Fcomponents\u002Fschemas\u002FExtractMemoryItem",{"type":513,"title":1127,"description":1644,"items":1645},"偏好记忆列表。当请求中 extraction_types 包含 preference，或未传 extraction_types 时返回；结果中可包含显性偏好与隐性偏好。",{"$ref":1646},"#\u002Fcomponents\u002Fschemas\u002FExtractPreferenceItem",{"type":493,"required":1648,"title":1649,"properties":1650},[619,620],"ExtractMemoryMessage",{"role":1651,"content":1653},{"type":476,"title":629,"enum":1652,"description":630},[55,58,627],{"type":476,"title":779,"description":664},{"type":493,"required":1655,"title":1657,"properties":1658},[497,1656],"documents","RerankRequest",{"model":1659,"query":1664,"documents":1666,"top_n":1670},{"type":476,"title":1660,"description":1661,"enum":1662},"Model","模型名称。",[256,1663],"memos-reranker-4b",{"type":476,"title":506,"description":1665},"用户查询文本，用于与候选文档进行相关性匹配。",{"type":513,"title":1667,"description":1668,"items":1669},"Documents","候选记忆\u002F文档列表，每条为一段文本。数组中所有文档的总 token 数上限为 8k。",{"type":476},{"type":518,"title":1671,"description":1672},"Top N","返回前 N 条最相关的结果。不传时默认返回全部结果。",{"type":493,"required":1674,"title":1677,"properties":1678},[1675,1511,1676],"index","relevance_score","RerankResult",{"index":1679,"document":1682,"relevance_score":1690},{"type":518,"title":1680,"description":1681},"Index","该文档在原始 documents 列表中的索引位置。",{"type":493,"title":1683,"description":1684,"required":1685,"properties":1686},"Document","文档对象。",[612],{"text":1687},{"type":476,"title":1688,"description":1689},"Text","文档原文内容。",{"type":530,"title":1691,"description":1692},"Relevance Score","相关性分数，范围 0~1，越高表示与 query 越相关。",{"type":493,"required":1694,"title":1699,"properties":1700},[1695,1696,1697,1698],"id","model","usage","results","RerankResponse",{"id":1701,"model":1704,"usage":1706,"results":1719},{"type":476,"title":1702,"description":1703},"Id","本次请求的唯一标识。",{"type":476,"title":1660,"description":1705},"使用的模型名称。",{"type":493,"title":1707,"description":1708,"required":1709,"properties":1712},"Usage","token 用量统计。",[1710,1711],"prompt_tokens","total_tokens",{"prompt_tokens":1713,"total_tokens":1716},{"type":518,"title":1714,"description":1715},"Prompt Tokens","输入消耗的 token 数。",{"type":518,"title":1717,"description":1718},"Total Tokens","总消耗 token 数。",{"type":513,"title":1720,"description":1721,"items":1722},"Results","重排结果列表，按 relevance_score 降序排列。",{"$ref":1723},"#\u002Fcomponents\u002Fschemas\u002FRerankResult",{"type":493,"required":1725,"title":1726,"properties":1727},[687],"ExtractMemoryRequest",{"messages":1728,"extraction_types":1732},{"type":513,"title":704,"description":1729,"items":1730},"需要抽取记忆的消息对象数组，数组中所有消息的总 Token 数上限为8k。",{"$ref":1731},"#\u002Fcomponents\u002Fschemas\u002FExtractMemoryMessage",{"type":513,"title":1733,"description":1734,"items":1735},"Extraction Types","\u003Cp>限定抽取的记忆类型；不传则抽取全部支持的类型。\u003C\u002Fp>\u003Cul>\u003Cli>\u003Ccode>memory\u003C\u002Fcode>：事实记忆，从对话中提取用户相关的事实性信息。\u003C\u002Fli>\u003Cli>\u003Ccode>preference\u003C\u002Fcode>：偏好记忆，从对话中提取用户的偏好信息，包含显性偏好（用户明确表达）和隐性偏好（从行为推断）。\u003C\u002Fli>\u003C\u002Ful>",{"type":476,"enum":1736},[237,238],{"type":493,"required":1738,"title":1739,"properties":1740},[589,590],"ExtractMemoryResponse",{"code":1741,"data":1742,"message":1744},{"type":518,"format":756,"title":593,"description":594,"example":292},{"$ref":1743},"#\u002Fcomponents\u002Fschemas\u002FExtractMemoryResponseData",{"type":476,"title":598,"description":760,"example":293},{"type":493,"required":1746,"properties":1748,"title":1762},[1747],"bind_list",{"bind_list":1749},{"type":513,"title":1750,"description":1751,"items":1752},"Bind List","批量绑定列表，单次上限 20 条。",{"type":493,"required":1753,"properties":1755},[1754],"profile_template_id",{"user_id":1756,"agent_id":1758,"profile_template_id":1760},{"type":476,"description":1757},"需要绑定到属性树模版的用户 ID。",{"type":476,"description":1759},"需要绑定到属性树模版的 Agent ID，仅开启「为 Agent 创建独立记忆」时，可与 user_id 二选一传入。",{"type":476,"description":1761},"需绑定的属性记忆模板 ID。","BindProfileTemplateRequest",{"type":493,"title":1764,"description":1765,"properties":1766},"字段值对象","metadata 嵌套最内层的叶子节点。",{"value":1767,"algorithm_updatable":1770},{"type":476,"title":1768,"description":1769},"Value","属性字段值。",{"type":523,"title":1079,"description":1771,"default":45},"是否允许算法自动更新该字段，默认为 true。",{"type":493,"required":1773,"properties":1774,"title":1794},[1754],{"user_id":1775,"agent_id":1777,"profile_template_id":1779,"metadata":1781,"remove_fields":1790},{"type":476,"title":500,"description":1776},"用户 ID，与 agent_id 二选一。单视角项目必传。",{"type":476,"title":563,"description":1778},"Agent ID，仅开启「为 Agent 创建独立记忆」时可用，与 user_id 二选一。",{"type":476,"title":1191,"description":1780},"目标属性记忆模板 ID。",{"type":493,"title":1782,"description":1783,"properties":1784},"Metadata","要更新的字段。传入已有字段则更新值；传入新字段则添加到当前实例。",{"{分类名}":1785},{"type":493,"description":1786,"properties":1787},"属性分类（可选的中间层），键名为用户自定义的分类名称。如无需分类可跳过此层，直接在 metadata 下传字段值对象。",{"{字段名}":1788},{"$ref":1789},"#\u002Fcomponents\u002Fschemas\u002FProfileFieldValue",{"type":513,"items":1791,"title":1792,"description":1793},{"type":476},"Remove Fields","要删除的字段路径列表，如 \u003Ccode>[\"基础信息.职业\"]\u003C\u002Fcode>。","EditProfileRequest",{"type":493,"required":1796,"properties":1797,"title":1803},[1754],{"user_id":1798,"agent_id":1800,"profile_template_id":1802},{"type":476,"title":500,"description":1799},"用户 ID，与 agent_id 二选一。",{"type":476,"title":563,"description":1801},"Agent ID，与 user_id 二选一。",{"type":476,"title":1191,"description":1780},"DeleteProfileRequest",{"type":493,"required":1805,"properties":1806,"title":1815},[473],{"memory_id":1807,"content":1810,"title":1812},{"type":476,"title":1808,"description":1809},"Memory ID","记忆 ID，来自 search\u002Fmemory 或 get\u002Fmemory 返回结果中的 id。",{"type":476,"title":779,"description":1811},"更新后的记忆内容。",{"type":476,"title":1813,"description":1814},"Title","更新后的记忆标题。","UpdateMemoryRequest",{"type":493,"required":1817,"properties":1818,"title":1858},[589,590],{"code":1819,"data":1821,"message":1857},{"type":518,"title":593,"description":1820,"example":292},"接口状态码。",{"type":493,"properties":1822},{"id":1823,"memory_view":1824,"title":1827,"content":1829,"conversation_id":1831,"message_ids":1833,"status":1836,"algorithm_updatable":1842,"created_at":1844,"updated_at":1846,"user_id":1848,"agent_id":1850,"tags":1852,"info":1855},{"type":476,"description":477},{"type":476,"enum":1825,"description":1826},[713,238,716,715,714,717],"记忆种类",{"type":476,"description":1828},"记忆标题",{"description":1830},"记忆内容",{"type":476,"description":1832},"来源会话 ID",{"type":513,"items":1834,"description":1835},{"type":476},"来源消息 ID 列表",{"type":476,"enum":1837,"description":1841},[892,1838,1839,1840],"resolving","archived","deleted","记忆状态",{"type":523,"description":1843},"算法是否可更新",{"type":476,"description":1845},"创建时间",{"type":476,"description":1847},"最后更新时间",{"type":476,"description":1849},"所属 user 主体",{"type":476,"description":1851},"所属 agent 主体",{"type":513,"items":1853,"description":1854},{"type":476},"自定义标签",{"type":493,"description":1856},"自定义元信息",{"type":476,"title":598,"description":760,"example":293},"GetMemoryByIdResponse",{"type":493,"required":1860,"properties":1861,"title":1868},[589,590],{"code":1862,"data":1863,"message":1867},{"type":518,"title":593,"description":1820,"example":292},{"type":493,"properties":1864},{"success":1865},{"type":523,"description":1866,"example":45},"是否操作成功。",{"type":476,"title":598,"description":760,"example":293},"SuccessResponse","cn\u002Fapi_docs\u002Fapi","JdZxs76dgkWegfFiNz_5KZ3taF-Dj421KHlGF2lFAnY",{"id":1872,"extension":24,"meta":1873,"stem":3330,"__hash__":3331},"dashboardApi\u002Fen\u002Fapi_docs\u002Fapi.json",{"openapi":26,"info":1874,"servers":1875,"security":1877,"paths":1880,"components":2224},{"title":28,"description":29,"version":30},[1876],{"url":33,"description":34},[1878],{"TokenAuth":1879},[],{"\u002Fadd\u002Fmessage":1881,"\u002Fget\u002Fmessage":1907,"\u002Fsearch\u002Fmemory":1920,"\u002Fchat":1948,"\u002Fget\u002Fmemory":1972,"\u002Fdelete\u002Fmemory":1984,"\u002Fadd\u002Ffeedback":1996,"\u002Fextract\u002Fmemory":2008,"\u002Frerank":2031,"\u002Fget\u002Fstatus":2051,"\u002Fcreate\u002Fknowledgebase":2079,"\u002Fdelete\u002Fknowledgebase":2092,"\u002Fadd\u002Fknowledgebase-file":2105,"\u002Fget\u002Fknowledgebase-file":2118,"\u002Fdelete\u002Fknowledgebase-file":2131,"\u002Fbind\u002Fprofile_template":2144,"\u002Fedit\u002Fprofile":2161,"\u002Fdelete\u002Fprofile":2179,"\u002Fupdate\u002Fmemory":2194,"\u002Fget\u002Fmemory\u002F{memory_id}":2211},{"post":1882},{"summary":41,"description":1883,"operationId":43,"requestBody":1884,"responses":1902},"This API allows you to add one or more messages to a specific conversation. As illustrated in the examples bellow, you can add messages in real time during a user-assistant interaction, import historical messages in bulk, or enrich the conversation with user preferences and behavior data. All added messages are transformed into memories by MemOS, enabling their retrieval in future conversations to support chat history management, user behavior tracking, and personalized interactions.",{"required":45,"content":1885},{"application\u002Fjson":1886},{"schema":1887,"example":1888},{"$ref":49},{"user_id":51,"conversation_id":52,"messages":1889},[1890,1892,1894,1896,1898,1900],{"role":55,"content":1891},"I want to travel during summer vacation, can you recommend something?",{"role":58,"content":1893},"Sure! Are you traveling alone, with family or with friends?",{"role":55,"content":1895},"I'm bringing my kid. My family always travels together.",{"role":58,"content":1897},"Got it, so you're traveling with your children as a family, right?",{"role":55,"content":1899},"Yes, with both kids and elderly, we usually travel as a whole family.",{"role":58,"content":1901},"Understood, I'll recommend destinations suitable for family trips.",{"200":1903},{"description":70,"content":1904},{"application\u002Fjson":1905},{"schema":1906},{"$ref":74},{"post":1908},{"summary":77,"description":1909,"operationId":79,"requestBody":1910,"responses":1915},"This API retrieves the historical conversation records between a user and the assistant for a specified session, with the option to limit the number of results. As shown in the examples bellow, you can use the returned recent messages as references for the model when generating responses, maintaining dialogue coherence and contextual understanding. It can also be used to restore chat context when a user refreshes or reopens the app, ensuring a seamless user experience and supporting personalized interactions.",{"required":45,"content":1911},{"application\u002Fjson":1912},{"schema":1913,"example":1914},{"$ref":84},{"user_id":51,"conversation_id":86,"message_limit_number":87},{"200":1916},{"description":70,"content":1917},{"application\u002Fjson":1918},{"schema":1919},{"$ref":93},{"post":1921},{"summary":96,"description":1922,"operationId":98,"requestBody":1923,"responses":1943},"This API retrieves memories for a specified user or Agent and returns the fragments most relevant to the query.",{"required":45,"content":1924},{"application\u002Fjson":1925},{"schema":1926,"example":1927},{"$ref":103},{"query":1928,"user_id":51,"conversation_id":86,"knowledgebase_ids":1929,"filter":1930},"Summarize my memories related to reading this year",[107],{"knowledgebase":1931,"user":1940},{"and":1932},[1933,1936,1938],{"tags":1934},{"contains":1935},"reading",{"create_time":1937},{"gte":116},{"create_time":1939},{"lte":119},{"and":1941},[1942],{"scene":123},{"200":1944},{"description":70,"content":1945},{"application\u002Fjson":1946},{"schema":1947},{"$ref":129},{"post":1949},{"summary":132,"description":11,"operationId":123,"requestBody":1950,"responses":1965},{"required":45,"content":1951},{"application\u002Fjson":1952},{"schema":1953,"example":1954},{"$ref":137},{"user_id":51,"stream":139,"query":1955,"model_name":141,"conversation_id":142,"knowledgebase_ids":1956,"filter":1957,"system_prompt":1961,"add_message_on_answer":139,"allow_public":139,"allow_knowledgebase_ids":1962,"agent_id":152,"app_id":153,"tags":1963,"info":1964,"max_tokens":156,"temperature":157,"top_p":158},"What fun places are in Shanghai?",[144],{"and":1958},[1959],{"create_time":1960},{"gt":149},"Recommend parks",[],[],{},{"200":1966},{"description":70,"content":1967},{"application\u002Fjson":1968,"text\u002Fevent-stream":1970},{"schema":1969},{"$ref":164},{"schema":1971},{"$ref":167},{"post":1973},{"summary":170,"description":1974,"operationId":172,"requestBody":1975,"responses":1979},"Retrieve paginated memories for a user or Agent.",{"required":45,"content":1976},{"application\u002Fjson":1977},{"schema":1978},{"$ref":177},{"200":1980},{"description":70,"content":1981},{"application\u002Fjson":1982},{"schema":1983},{"$ref":183},{"post":1985},{"summary":186,"description":1986,"operationId":188,"requestBody":1987,"responses":1991},"Delete memories for a user or Agent. Supports deletion by memory_ids or clearing all memories by user_id\u002Fagent_id.",{"required":45,"content":1988},{"application\u002Fjson":1989},{"schema":1990},{"$ref":193},{"200":1992},{"description":70,"content":1993},{"application\u002Fjson":1994},{"schema":1995},{"$ref":199},{"post":1997},{"summary":202,"description":1998,"operationId":204,"requestBody":1999,"responses":2003},"This API is used to add feedback to current session messages, allowing MemOS to correct memories based on user feedback.",{"required":45,"content":2000},{"application\u002Fjson":2001},{"schema":2002},{"$ref":209},{"200":2004},{"description":70,"content":2005},{"application\u002Fjson":2006},{"schema":2007},{"$ref":215},{"post":2009},{"summary":218,"description":2010,"operationId":220,"requestBody":2011,"responses":2026},"Uses MemOS’s self-developed extraction model to extract and return fact and preference memories directly from conversation messages.",{"required":45,"content":2012},{"application\u002Fjson":2013},{"schema":2014,"example":2015},{"$ref":225},{"messages":2016,"extraction_types":2025},[2017,2019,2021,2023],{"role":55,"content":2018},"I’ve planned a summer trip to Guangzhou. What chain hotels can you recommend for accommodation?",{"role":58,"content":2020},"You can consider options like 7 Days Inn, All Seasons, Hilton, and others.",{"role":55,"content":2022},"I’ll go with 7 Days Inn.",{"role":58,"content":2024},"Alright—ask me anytime if you have more questions.",[237,238],{"200":2027},{"description":70,"content":2028},{"application\u002Fjson":2029},{"schema":2030},{"$ref":244},{"post":2032},{"summary":247,"description":2033,"operationId":249,"requestBody":2034,"responses":2046},"Provides a memory reranking API based on the memos-reranker small model. It takes a user query and a list of candidate memories and completes memory relevance reranking with a single call.",{"required":45,"content":2035},{"application\u002Fjson":2036},{"schema":2037,"example":2038},{"$ref":254},{"model":256,"query":2039,"documents":2040},"What are the user's hobbies?",[2041,2042,2043,2044,2045],"User likes playing badminton.","User is a backend developer in Hangzhou.","User prefers concise replies.","User prefers Jiangxiang-flavored baijiu.","User is going on a business trip to Beijing next Wednesday.",{"200":2047},{"description":70,"content":2048},{"application\u002Fjson":2049},{"schema":2050},{"$ref":269},{"post":2052},{"summary":272,"description":2053,"operationId":274,"requestBody":2054,"responses":2059},"Query the processing status of async tasks such as add\u002Fmessage and add\u002Ffeedback. When a task completes, the response includes memory_views with added\u002Fupdated\u002Fdeleted counts and memory IDs grouped by \u003Ca href=\"\u002Fmemos_cloud\u002Fintroduction\u002Fmemory_types\">memory category\u003C\u002Fa>.",{"required":45,"content":2055},{"application\u002Fjson":2056},{"schema":2057,"example":2058},{"$ref":279},{"task_id":281},{"200":2060},{"description":70,"content":2061},{"application\u002Fjson":2062},{"schema":2063,"examples":2064},{"$ref":287},{"completed":2065,"running":2073,"failed":2076},{"summary":290,"value":2066},{"code":292,"message":293,"data":2067},{"task_id":281,"status":290,"memory_views":2068},{"added":296,"updated":296,"deleted":292,"detail_factual":2069,"preference":2071},{"memory_ids":2070},[299],{"memory_ids":2072},[302],{"summary":304,"value":2074},{"code":292,"message":293,"data":2075},{"task_id":281,"status":304},{"summary":308,"value":2077},{"code":292,"message":293,"data":2078},{"task_id":281,"status":308},{"post":2080},{"summary":2081,"description":2082,"operationId":315,"requestBody":2083,"responses":2087},"Create Knowledgebase","Create a knowledgebase associated with the project.",{"required":45,"content":2084},{"application\u002Fjson":2085},{"schema":2086},{"$ref":320},{"200":2088},{"description":70,"content":2089},{"application\u002Fjson":2090},{"schema":2091},{"$ref":326},{"post":2093},{"summary":2094,"description":2095,"operationId":331,"requestBody":2096,"responses":2100},"Delete Knowledgebase","Delete a knowledgebase from the current project. To permanently delete it, please operate from the Console - Knowledgebase page.",{"required":45,"content":2097},{"application\u002Fjson":2098},{"schema":2099},{"$ref":336},{"200":2101},{"description":70,"content":2102},{"application\u002Fjson":2103},{"schema":2104},{"$ref":342},{"post":2106},{"summary":2107,"description":2108,"operationId":347,"requestBody":2109,"responses":2113},"Create Knowledgebase File","Upload files to a specified Knowledge Base. By default, files are uploaded as documents. When file[].type is skill, upload a Markdown Skill file or ZIP Skill package.",{"required":45,"content":2110},{"application\u002Fjson":2111},{"schema":2112},{"$ref":352},{"200":2114},{"description":70,"content":2115},{"application\u002Fjson":2116},{"schema":2117},{"$ref":358},{"post":2119},{"summary":2120,"description":2121,"operationId":363,"requestBody":2122,"responses":2126},"Get Knowledgebase File","Get file information in one of two ways: pass file_ids to retrieve specific file details, or pass knowledgebase_id to list files under a Knowledge Base. Choose only one mode; passing both knowledgebase_id and file_ids returns an error.",{"required":45,"content":2123},{"application\u002Fjson":2124},{"schema":2125},{"$ref":368},{"200":2127},{"description":70,"content":2128},{"application\u002Fjson":2129},{"schema":2130},{"$ref":374},{"post":2132},{"summary":2133,"description":2134,"operationId":379,"requestBody":2135,"responses":2139},"Delete Knowledgebase File","Delete files from a specified Knowledge Base. When a Skill file is deleted, the associated Skill is deleted as well.",{"required":45,"content":2136},{"application\u002Fjson":2137},{"schema":2138},{"$ref":384},{"200":2140},{"description":70,"content":2141},{"application\u002Fjson":2142},{"schema":2143},{"$ref":390},{"post":2145},{"summary":2146,"description":2147,"operationId":395,"requestBody":2148,"responses":2155},"Bind Profile Template","Bind a Profile template to a user or Agent, creating a Profile memory instance. After binding, the corresponding attribute fields are automatically updated whenever new messages are added.",{"required":45,"content":2149},{"application\u002Fjson":2150},{"schema":2151,"example":2152},{"$ref":400},{"bind_list":2153},[2154],{"user_id":51,"profile_template_id":404},{"200":2156},{"description":70,"content":2157},{"application\u002Fjson":2158},{"schema":2159},{"$ref":2160},"#\u002Fcomponents\u002Fschemas\u002FBindProfileTemplateResponse",{"post":2162},{"summary":5,"description":2163,"operationId":415,"requestBody":2164,"responses":2173},"Edit a Profile memory instance: add fields, update field values, remove fields, or lock fields against automatic updates by the algorithm. Only the target instance is affected; the template and other instances are not changed.",{"required":45,"content":2165},{"application\u002Fjson":2166},{"schema":2167,"example":2168},{"$ref":420},{"user_id":51,"profile_template_id":404,"metadata":2169},{"Basic Info":2170},{"Location":2171},{"value":2172,"algorithm_updatable":139},"Shanghai",{"200":2174},{"description":70,"content":2175},{"application\u002Fjson":2176},{"schema":2177},{"$ref":2178},"#\u002Fcomponents\u002Fschemas\u002FEditProfileResponse",{"post":2180},{"summary":2181,"description":2182,"operationId":435,"requestBody":2183,"responses":2188},"Delete Profile","Delete a user's or Agent's Profile memory instance. All field values and bindings for that instance are removed. This does not affect the template itself or other instances.",{"required":45,"content":2184},{"application\u002Fjson":2185},{"schema":2186,"example":2187},{"$ref":440},{"user_id":51,"profile_template_id":404},{"200":2189},{"description":70,"content":2190},{"application\u002Fjson":2191},{"schema":2192},{"$ref":2193},"#\u002Fcomponents\u002Fschemas\u002FDeleteProfileResponse",{"post":2195},{"summary":2196,"description":2197,"operationId":451,"requestBody":2198,"responses":2205},"Update Memory","Manually update the content, title, or status of an existing memory. Supports all memory categories, including fact memories, preference memories, Event Memory, and Profile attribute values.",{"required":45,"content":2199},{"application\u002Fjson":2200},{"schema":2201,"example":2202},{"$ref":456},{"memory_id":458,"title":2203,"content":2204},"Camping at West Lake with Chen Mo","Last Saturday I went camping by West Lake with my friend Chen Mo. The weather was great and we watched the stars together at night.",{"200":2206},{"description":70,"content":2207},{"application\u002Fjson":2208},{"schema":2209},{"$ref":2210},"#\u002Fcomponents\u002Fschemas\u002FUpdateMemoryResponse",{"get":2212},{"summary":2213,"description":2214,"operationId":470,"parameters":2215,"responses":2219},"Get Memory","Retrieve the details of a single memory by its ID.",[2216],{"name":473,"in":474,"required":45,"schema":2217,"description":2218},{"type":476},"Memory ID.",{"200":2220},{"description":70,"content":2221},{"application\u002Fjson":2222},{"schema":2223},{"$ref":483},{"securitySchemes":2225,"schemas":2228},{"TokenAuth":2226},{"type":487,"name":488,"in":489,"description":2227},"Token API_key, available in \u003Ca href=\"https:\u002F\u002Fmemos-dashboard.openmem.net\u002Fapikeys\u002F\" class=\"text-primary border-b border-transparent hover:border-primary font-medium focus-visible:outline-primary [&>code]:border-dashed hover:[&>code]:border-primary hover:[&>code]:text-primary transition-colors [&>code]:transition-colors\" target=\"_blank\">API Console > API Keys\u003C\u002Fa>",{"ChatRequest":2229,"ChatResponseData":2281,"ChatResponse":2285,"ChatStreamResponse":2292,"AddMessageRequest":2304,"MessageInput":2336,"AddMessageResponse":2391,"OpenMemAddMessageResponse":2399,"GetMessageRequest":2409,"GetMessageResponse":2418,"GetMessageResponseData":2426,"MessageDetail":2432,"SearchMemoryRequest":2443,"SearchMemoryResponse":2498,"SearchMemoryResponseData":2505,"MemoryDetail":2528,"PreferenceDetail":2555,"ToolUsedStatus":2577,"ToolMemoryDetail":2587,"SkillValue":2612,"SkillDetail":2633,"SearchProfileDetail":2660,"SearchEventDetail":2690,"GetMemoryRequest":2720,"GetProfileMemoryDetail":2735,"GetEventMemoryDetail":2749,"GetMemoryResponseData":2772,"GetMemoryResponse":2796,"DeleteMemoryRequest":2804,"DeleteMemoryResponse":2813,"AddFeedbackRequest":2823,"AddFeedbackResponse":2843,"TaskStatusMemoryViewIds":2855,"TaskStatusMemoryViews":2860,"OpenMemGetStatusData":2875,"GetStatusRequest":2884,"GetStatusResponse":2889,"CreateKnowledgebaseRequest":2895,"CreateKnowledgebaseResponse":2901,"DeleteKnowledgebaseRequest":2910,"DeleteKnowledgebaseResponse":2915,"UploadFileRequest":2924,"UploadFileResponse":2940,"GetFileRequest":2961,"GetFileResponse":2976,"DeleteFileRequest":3000,"DeleteFileResponse":3006,"ExtractMemoryItem":3014,"ExtractPreferenceItem":3031,"ExtractMemoryResponseData":3042,"RerankRequest":3052,"RerankResult":3065,"RerankResponse":3078,"ExtractMemoryMessage":3096,"ExtractMemoryRequest":3104,"ExtractMemoryResponse":3114,"GetMemoryDetail":3120,"GetPreferenceDetail":3152,"GetToolMemoryDetail":3174,"BindProfileTemplateRequest":3197,"BindProfileTemplateResponse":3211,"ProfileFieldValue":3221,"EditProfileRequest":3229,"EditProfileResponse":3248,"DeleteProfileRequest":3257,"DeleteProfileResponse":3265,"UpdateMemoryRequest":3274,"UpdateMemoryResponse":3283,"GetMemoryByIdResponse":3292},{"type":493,"required":2230,"properties":2231,"title":580},[495,496,497],{"user_id":2232,"conversation_id":2234,"query":2236,"filter":2238,"knowledgebase_ids":2240,"memory_limit_number":2243,"include_preference":2245,"preference_limit_number":2247,"relativity":2249,"model_name":2251,"system_prompt":2254,"stream":2256,"max_tokens":2258,"temperature":2260,"top_p":2262,"add_message_on_answer":2264,"app_id":2266,"agent_id":2268,"tags":2270,"info":2273,"allow_public":2276,"allow_knowledgebase_ids":2278},{"type":476,"title":500,"description":2233},"Unique identifier of the user associated with the conversation.",{"type":476,"title":503,"description":2235},"Unique identifier of the conversation. Providing this clarifies the current session, prioritizing its memory over historical sessions. If omitted, cross-session memory retrieval is performed for more relevant responses.",{"type":476,"title":506,"description":2237},"User input content.",{"type":493,"title":509,"description":2239,"example":511},"Filter conditions, used to precisely limit the memory scope before retrieval. Available fields include: \"agent_id\", \"app_id\", \"create_time\", \"update_time\", and specific fields in \"info\". Supports logical operators (and, or) and comparison operators (gte, lte, gt, lt). For the \"info\" field, supports filtering by \"business_type\", \"biz_id\", \"scene\", and other custom fields.",{"type":513,"items":2241,"title":515,"description":2242},{"type":476},"Specifies the scope of Knowledge Bases accessible for the current search. Defaults to empty, meaning no Knowledge Bases are searched. Pass specific Knowledge Base IDs to search ordinary documents and uploaded Skills in those Knowledge Bases; pass \"all\" to search across all associated Knowledge Bases within the project.",{"type":518,"title":519,"description":2244,"default":521},"Maximum number of memories that can be recalled: as long as the relevance threshold (relativity) is met, up to this many memories may be returned. Default is 9, maximum is 25.",{"type":523,"title":524,"description":2246,"default":45},"Whether to recall preference memories. When enabled, the system intelligently recalls memories related to user preferences based on the query. Default = true.",{"type":518,"title":527,"description":2248,"default":521},"Maximum number of preferred memories that can be recalled: as long as the relevance threshold (relativity) is met, up to this many preference memories may be returned. Default is 9, maximum is 25.",{"type":530,"minimum":292,"maximum":296,"title":531,"description":2250,"default":533},"Relevance threshold (0–1) for recalled memories. Filters out low-relevance memories and, together with the maximum counts for factual and preferred recalls, constrains the final results. When omitted, the system default threshold is used. A value of 0 disables relevance filtering.",{"type":476,"enum":2252,"title":538,"description":2253,"default":537},[536,141,537],"Specifies the concrete conversation model.",{"type":476,"title":542,"description":2255},"Custom system instructions.",{"type":523,"title":545,"description":2257,"default":139},"Whether to enable streaming response.",{"type":518,"title":548,"description":2259,"default":156},"Indicates the maximum number of generated tokens.",{"type":530,"title":551,"description":2261,"default":157},"Controls generation randomness. Range: 0 ≤ x ≤ 2.",{"type":530,"title":554,"description":2263,"default":158},"Nucleus sampling parameter. Range: 0 ≤ x ≤ 1.",{"type":523,"title":557,"description":2265,"default":45},"Whether to automatically write user and assistant conversation content into memory. When enabled, developers do not need to call the add\u002Fmessage API to add messages as memory.",{"type":476,"title":560,"description":2267},"Unique identifier of the application associated with the conversation.",{"type":476,"title":563,"description":2269},"Unique identifier of the Agent associated with the conversation.",{"type":513,"items":2271,"title":567,"description":2272},{"type":476},"List of custom tags used to mark the topic or category of the conversation.",{"type":493,"additionalProperties":2274,"title":571,"description":2275},{"type":476},"Custom metadata field capable of storing any structured data related to the conversation, such as location, source, version, etc., primarily for precise filtering or source tracking during retrieval.",{"type":523,"title":574,"description":2277,"default":139},"Whether to allow adding to public memory.",{"type":513,"items":2279,"title":578,"description":2280},{"type":476},"List of knowledgebases where memories generated from added messages are allowed to be written.",{"type":493,"title":582,"properties":2282},{"response":2283},{"type":476,"title":585,"description":2284},"Specific content of the answer.",{"type":493,"required":2286,"properties":2287,"title":600},[589,590],{"code":2288,"data":2290,"message":2291},{"type":518,"title":593,"description":2289},"API status code. See \u003Ca href=\"\u002Fapi_docs\u002Fhelp\u002Ferror_codes\" class=\"text-primary border-b border-transparent hover:border-primary font-medium focus-visible:outline-primary [&>code]:border-dashed hover:[&>code]:border-primary hover:[&>code]:text-primary transition-colors [&>code]:transition-colors\">Error Code List\u003C\u002Fa> for details.",{"$ref":596},{"type":476,"title":598,"description":598},{"type":493,"properties":2293,"title":616},{"event":2294,"data":2296},{"type":476,"description":2295,"default":590},"Stream event name, currently defaults to message.",{"type":493,"description":2297,"properties":2298},"Streamed data content.",{"type":2299,"data":2302},{"type":476,"description":2300,"enum":2301},"Stream message type, used to identify the semantic category of the current data.\u003Cbr>reasoning: Reasoning content\u003Cbr>text: Normal text content\u003Cbr>end: End of stream indicator",[611,612,613],{"type":476,"description":2303},"Streamed text content.",{"type":493,"required":2305,"properties":2306,"title":738},[687],{"user_id":2307,"conversation_id":2309,"messages":2311,"agent_id":2314,"app_id":2316,"tags":2318,"info":2321,"allow_public":2329,"allow_knowledgebase_ids":2331,"async_mode":2334},{"type":476,"title":500,"description":2308},"Unique identifier of the user associated with the message.",{"type":476,"title":503,"description":2310},"Unique identifier of the conversation associated with the added message. Messages under the same conversation_id are treated as the same context. If omitted, the system generates one automatically.",{"type":513,"title":704,"description":2312,"items":2313},"Array of message objects representing the memory content. The total token limit for the message array is 40k. Each object contains:",{"$ref":707},{"type":476,"description":2315},"Unique identifier of the Agent associated with the added message, primarily used to query exclusive memories between a user and that Agent during retrieval.",{"type":476,"description":2317},"Unique identifier of the App associated with the added message, primarily used to query exclusive memories of a user under that App during retrieval.",{"type":513,"items":2319,"description":2320},{"type":476},"List of custom tags used to mark the topic or category of the added message.",{"type":493,"additionalProperties":2322,"description":2328},{"oneOf":2323},[2324,2325,2327],{"type":476},{"type":513,"items":2326},{"type":476},{"type":530},"Custom metadata field capable of storing any structured data related to the added message, such as location, source, version, etc., primarily for precise filtering or source tracking during retrieval.",{"type":523,"description":2330,"default":139},"Whether memories generated from the added message are allowed to be written to the public memory store. When enabled, generated memories can be retrieved by other users in the project.",{"type":513,"items":2332,"description":2333},{"type":476},"Scope of knowledgebases where memories generated from the added message are allowed to be written.",{"type":523,"description":2335,"default":45},"Whether to enable asynchronous memory addition. When enabled, memory will be added asynchronously in the background to avoid blocking the call chain.",{"type":493,"required":2337,"properties":2338,"title":684},[619,620],{"chat_time":2339,"role":2341,"role_id":2344,"role_name":2346,"content":2348,"tool_call_id":2373,"tool_calls":2375},{"type":476,"title":623,"description":2340},"Time of the conversation, as a structured timestamp or Chinese text. Providing this parameter allows memory to include time information.",{"type":476,"enum":2342,"title":629,"description":2343},[55,58,627,628],"Sender role.",{"type":476,"title":632,"description":2345},"Speaker ID. Recommended in group chats.",{"type":476,"title":635,"description":2347},"Speaker display name. When passed, extracted memories can include the speaker name. Must be passed together with role_id.",{"title":779,"description":2349,"oneOf":2350},"Content of the message.",[2351,2353],{"type":476,"description":2352},"Message text content",{"type":513,"items":2354,"description":2372},{"type":493,"properties":2355,"required":2371},{"type":2356,"text":2359,"image_url":2361,"file":2366},{"type":476,"enum":2357,"description":2358},[612,646,647],"Type of the message sent",{"type":476,"description":2360},"Text message content. Required when type is text.",{"type":493,"description":2362,"properties":2363},"Image message content object.",{"url":2364},{"type":476,"description":2365},"Image message URL. Required when type is image_url.",{"type":493,"description":2367,"properties":2368},"File message content object.",{"file_data":2369},{"type":476,"description":2370},"Accessible file URL or base64. Supports txt \u002F pdf \u002F doc \u002F docx \u002F json \u002F md \u002F xml. Single file max 100MB, 500 pages, total max 20 files. Required when type is file.",[662],"List of multi-modal content",{"type":476,"description":2374},"Unique identifier for the tool call message when role is tool.",{"type":513,"items":2376,"description":2390},{"type":493,"properties":2377},{"id":2378,"type":2380,"function":2383},{"type":476,"description":2379},"Unique identifier for the tool call, used to associate with this tool call. Required in tool_calls.",{"type":476,"description":2381,"enum":2382},"Tool call type, currently only supports function. Required in tool_calls.",[675],{"type":493,"description":2384,"properties":2385},"Defined tool to be called. Required in tool_calls.",{"name":2386,"arguments":2388},{"type":476,"description":2387},"Tool (function) name. Required in tool_calls.",{"type":476,"description":2389},"Tool call arguments, must be a JSON formatted string. Required in tool_calls.","List of tool call information when role is assistant, used to pass when triggering tool calls.",{"type":493,"required":2392,"properties":2393,"title":761},[589,590],{"code":2394,"data":2396,"message":2397},{"type":518,"format":756,"title":593,"description":2395,"example":292},"API status code. See \u003Ca href=\"https:\u002F\u002Fmemos-dashboard.openmem.net\u002Fapikeys\u002F\" class=\"text-primary border-b border-transparent hover:border-primary font-medium focus-visible:outline-primary [&>code]:border-dashed hover:[&>code]:border-primary hover:[&>code]:text-primary transition-colors [&>code]:transition-colors\">Error Code\u003C\u002Fa> for details",{"$ref":758},{"type":476,"title":598,"description":2398,"example":293},"API response message, e.g., \"Message added successfully\".",{"type":493,"properties":2400,"title":751,"description":2408},{"success":2401,"task_id":2403,"status":2405},{"type":523,"title":742,"description":2402,"example":45},"Indicates if the message was added successfully. true = success, false = failure.",{"type":476,"title":745,"description":2404},"Unique identifier of the memory processing task. Use the \u003Ca href=\"\u002Fapi_docs\u002Fmessage\u002Fget_status\">Get Task Status\u003C\u002Fa> endpoint to query task results.",{"type":476,"title":748,"enum":2406,"description":2407},[304,290,308],"Current status of the memory processing task.","Object representing the result of adding the message.",{"type":493,"required":2410,"properties":2411,"title":772},[495,496],{"user_id":2412,"conversation_id":2414,"message_limit_number":2416},{"type":476,"title":500,"description":2413},"Unique identifier of the user associated with the messages being retrieved.",{"type":476,"title":503,"description":2415},"Unique identifier of the conversation associated with the messages.",{"type":518,"format":756,"title":770,"description":2417,"default":87},"Limits the number of messages returned, controlling the length of the message list. Defaults to 6 if not provided. The maximum allowed value is 50.",{"type":493,"required":2419,"properties":2420,"title":802},[589,590],{"code":2421,"data":2423,"message":2424},{"type":518,"format":756,"title":593,"description":2422,"example":292},"API status code. See \u003Ca href=\"https:\u002F\u002Fmemos-dashboard.openmem.net\u002Fapikeys\u002F\" class=\"text-primary border-b border-transparent hover:border-primary font-medium focus-visible:outline-primary [&>code]:border-dashed hover:[&>code]:border-primary hover:[&>code]:text-primary transition-colors [&>code]:transition-colors\">Error Code\u003C\u002Fa> for details.",{"$ref":800},{"type":476,"title":598,"description":2425},"API response message.",{"type":493,"properties":2427,"title":794,"description":2431},{"message_detail_list":2428},{"type":513,"title":790,"description":2429,"items":2430},"List of retrieved message details. Each item includes:",{"$ref":793},"Object containing the retrieved messages.",{"type":493,"properties":2433,"title":786,"description":2429},{"role":2434,"content":2437,"create_time":2439,"update_time":2441},{"type":476,"enum":2435,"title":629,"description":2436,"example":55},[55,58],"Role of the message sender.",{"type":476,"title":779,"description":2438},"Text content of the message.",{"type":476,"title":781,"description":2440},"Creation time of the message.",{"type":476,"title":784,"description":2442},"Last update time of the message.",{"type":493,"required":2444,"properties":2445,"title":867},[495,497],{"user_id":2446,"conversation_id":2448,"query":2450,"filter":2452,"knowledgebase_ids":2488,"include_memory_view":2491,"memory_limit_number":2496,"relativity":2497},{"type":476,"title":500,"description":2447},"Unique identifier of the user associated with the memory being queried.",{"type":476,"title":503,"description":2449},"Unique identifier of the conversation containing the memory. Providing this ensures the current conversation’s memories have higher priority over other historical.",{"type":476,"title":506,"description":2451},"Text content to search within the memories.The token limit for a single query is 4k.",{"type":493,"title":509,"description":2453,"properties":2454},"Memory filter conditions used to narrow candidate memories before semantic recall. You can use \u003Ccode>and\u003C\u002Fcode> \u002F \u003Ccode>or\u003C\u002Fcode> at the root for global filtering, or filter by source under \u003Ccode>user\u003C\u002Fcode>, \u003Ccode>public\u003C\u002Fcode>, and \u003Ccode>knowledgebase\u003C\u002Fcode>. For complete fields and examples, see \u003Ca href=\"\u002Fmemos_cloud\u002Ffeatures\u002Ffilters\">Memory Filters\u003C\u002Fa>.",{"and":2455,"or":2458,"user":2461,"public":2470,"knowledgebase":2479},{"type":513,"title":818,"description":2456,"items":2457},"Global AND condition array. Candidate memories enter semantic recall only when all conditions are satisfied. Common fields include \u003Ccode>agent_id\u003C\u002Fcode>, \u003Ccode>app_id\u003C\u002Fcode>, \u003Ccode>tags.contains\u003C\u002Fcode>, \u003Ccode>create_time\u003C\u002Fcode>, \u003Ccode>update_time\u003C\u002Fcode>, and custom fields from \u003Ccode>info\u003C\u002Fcode>.",{"type":493,"additionalProperties":45},{"type":513,"title":822,"description":2459,"items":2460},"Global OR condition array. Candidate memories enter semantic recall when any condition is satisfied.",{"type":493,"additionalProperties":45},{"type":493,"title":826,"description":2462,"properties":2463},"Filter conditions for user personal memories.",{"and":2464,"or":2467},{"type":513,"description":2465,"items":2466},"AND condition array for user memories.",{"type":493,"additionalProperties":45},{"type":513,"description":2468,"items":2469},"OR condition array for user memories.",{"type":493,"additionalProperties":45},{"type":493,"title":836,"description":2471,"properties":2472},"Filter conditions for project-level public memories.",{"and":2473,"or":2476},{"type":513,"description":2474,"items":2475},"AND condition array for public memories.",{"type":493,"additionalProperties":45},{"type":513,"description":2477,"items":2478},"OR condition array for public memories.",{"type":493,"additionalProperties":45},{"type":493,"title":846,"description":2480,"properties":2481},"Filter conditions for knowledge base memories. Only applies within the knowledge base scope allowed by \u003Ccode>knowledgebase_ids\u003C\u002Fcode>.",{"and":2482,"or":2485},{"type":513,"description":2483,"items":2484},"AND condition array for knowledge base memories.",{"type":493,"additionalProperties":45},{"type":513,"description":2486,"items":2487},"OR condition array for knowledge base memories.",{"type":493,"additionalProperties":45},{"type":513,"items":2489,"description":2490},{"type":476},"Specifies the scope of knowledge bases accessible for the current search. Defaults to empty, meaning no knowledge bases are searched.Pass specific Knowledgebase IDs to search within that designated repository; pass \"all\" to search across all associated knowledgebases within the project.",{"type":513,"items":2492,"title":861,"description":2494,"default":2495},{"type":476,"enum":2493},[713,238,714,715,716,717],"Allowed memory types to retrieve. When omitted, fact memories (detail_factual) and preference memories (preference) are recalled by default. See \u003Ca href=\"\u002Fmemos_cloud\u002Fintroduction\u002Fmemory_types\">Memory Categories\u003C\u002Fa> for details.",[713,238],{"type":518,"format":756,"title":519,"description":2244,"default":521},{"type":530,"minimum":292,"maximum":296,"title":531,"description":2250,"default":533},{"type":493,"required":2499,"properties":2500,"title":1161},[589,590],{"code":2501,"data":2503,"message":2504},{"type":518,"format":756,"title":593,"description":2502,"example":292},"API status code. See \u003Ca href=\"\u002Fapi_docs\u002Fhelp\u002Ferror_codes\" class=\"text-primary border-b border-transparent hover:border-primary font-medium focus-visible:outline-primary [&>code]:border-dashed hover:[&>code]:border-primary hover:[&>code]:text-primary transition-colors [&>code]:transition-colors\">Error Code\u003C\u002Fa> for details.",{"$ref":1159},{"type":476,"title":598,"description":2425},{"type":493,"title":1119,"properties":2506,"description":2527},{"memory_detail_list":2507,"preference_detail_list":2510,"profile_detail_list":2513,"event_detail_list":2516,"tool_memory_detail_list":2519,"preference_note":2522,"skill_detail_list":2524},{"type":513,"title":1122,"description":2508,"items":2509},"List of memory fragment details returned. Each item includes:",{"$ref":1125},{"type":513,"title":1127,"description":2511,"items":2512},"List of preference memory details returned. Each item includes:",{"$ref":1130},{"type":513,"title":1132,"description":2514,"items":2515},"List of profile memory fragment details returned.",{"$ref":1135},{"type":513,"title":1137,"description":2517,"items":2518},"List of event memory fragment details returned.",{"$ref":1140},{"type":513,"title":1142,"description":2520,"items":2521},"List of tool memory fragment details returned.",{"$ref":1145},{"type":476,"title":1147,"description":2523},"Preference memory usage note when it is retrieved.",{"type":513,"title":1150,"description":2525,"items":2526},"List of Skill details returned.",{"$ref":1153},"Object containing the query result.",{"type":493,"properties":2529,"title":905,"description":2508},{"id":2530,"memory_key":2532,"memory_value":2534,"memory_type":2536,"create_time":2539,"conversation_id":2541,"status":2543,"confidence":2546,"tags":2548,"update_time":2551,"relativity":2553},{"type":476,"title":871,"description":2531},"Unique identifier of fact memory, used internally by the system.",{"type":476,"title":874,"description":2533},"Title or keyword summarizing fact memory.",{"type":476,"title":877,"description":2535},"Detailed content of fact memory.",{"type":476,"enum":2537,"title":884,"description":2538,"example":882},[881,882,883],"WorkingMemory: short-term working memory, temporarily stored.\u003Cbr>LongTermMemory: long-term memory, important information or facts stored persistently.\u003Cbr>UserMemory: user-specific memory, personalized information related to a specific user.",{"type":476,"title":781,"description":2540},"Creation time of fact memory, usually in ISO 8601 format.",{"type":476,"title":503,"description":2542},"Unique identifier of the conversation associated with fact memory.",{"type":476,"enum":2544,"title":748,"description":2545,"example":892},[892],"Fact memory status. All retrieved fact memories are currently activated.\u003Cbr>activated: active fact memory, available for retrieval and use.",{"type":530,"minimum":292,"maximum":296,"title":895,"description":2547,"example":158},"Confidence score of fact memory, ranging from 0 to 1. Values closer to 1 indicate higher reliability. \u003Cbr>The score may gradually decay over time or with repeated model reasoning to reflect uncertainty.",{"type":513,"title":567,"description":2549,"items":2550},"List of tags associated with fact memory for categorization or retrieval. Each element is a string, e.g., [\"person\", \"event\", \"work\"].",{"type":476},{"type":476,"title":784,"description":2552},"Last modification or update time of fact memory, usually in ISO 8601 format.",{"type":530,"minimum":292,"maximum":296,"title":531,"description":2554,"example":904},"Relevance score of fact memory to the query, ranging from 0 to 1. Higher values indicate stronger relevance.",{"type":493,"properties":2556,"title":933},{"id":2557,"preference":2559,"preference_type":2561,"reasoning":2564,"create_time":2566,"conversation_id":2568,"status":2570,"update_time":2573,"relativity":2575},{"type":476,"title":871,"description":2558},"Unique identifier of preference memory, used internally by the system.",{"type":476,"title":917,"description":2560},"Detailed content of preference memory.",{"type":476,"enum":2562,"title":914,"description":2563,"example":912},[912,913],"explicit_preference: Explicit preference memory.\u003Cbr>implicit_preference: Implicit preference memory.",{"type":476,"title":920,"description":2565},"The reason why preference memory was extracted.",{"type":476,"title":781,"description":2567},"Creation time of preference memory, usually in ISO 8601 format.",{"type":476,"title":503,"description":2569},"Unique identifier of the conversation associated with preference memory.",{"type":476,"enum":2571,"title":748,"description":2572,"example":892},[892],"Preference memory status. All retrieved preference memories are currently activated.\u003Cbr>activated: active preference memory, available for retrieval and use.",{"type":476,"title":784,"description":2574},"Last modification or update time of preference memory, usually in ISO 8601 format.",{"type":530,"minimum":292,"maximum":296,"title":531,"description":2576,"example":904},"Relevance score of preference memory to the query, ranging from 0 to 1. Higher values indicate stronger relevance.",{"type":493,"properties":2578,"title":948},{"used_tool":2579,"error_type":2581,"success_rate":2583,"tool_experience":2585},{"type":476,"title":937,"description":2580},"Name of the tool used.",{"type":476,"title":940,"description":2582},"Error description when call fails.",{"type":530,"title":943,"description":2584},"Success rate of this tool trajectory.",{"type":476,"title":946,"description":2586},"Experience with this tool in the current trajectory.",{"type":493,"properties":2588,"title":981},{"id":2589,"tool_type":2591,"tool_value":2594,"tool_used_status":2596,"create_time":2599,"conversation_id":2601,"status":2603,"update_time":2606,"relativity":2608,"experience":2610},{"type":476,"title":871,"description":2590},"Unique identifier of the tool memory fragment.",{"type":476,"title":954,"description":2592,"enum":2593},"Tool memory type. ToolTrajectoryMemory: tool trajectory memory; ToolSchema: tool info memory.",[957,958],{"type":476,"title":960,"description":2595},"Specific content of the tool memory.",{"type":513,"title":963,"description":2597,"items":2598},"List of tool trajectory memories, each record contains tool used and experience info.",{"$ref":966},{"type":476,"title":781,"description":2600},"Tool memory creation time (ISO 8601 format).",{"type":476,"title":503,"description":2602},"Unique identifier of the conversation associated with the tool memory.",{"type":476,"title":748,"description":2604,"enum":2605},"Tool memory status, currently activated.",[892],{"type":476,"title":784,"description":2607},"Last update time of the tool memory (ISO 8601 format).",{"type":530,"title":531,"description":2609},"Relevance score of the tool memory to the query content.",{"type":476,"title":979,"description":2611},"Procedural experience of the entire trajectory, serving as overall guidance for task completion.",{"type":493,"properties":2613},{"name":2614,"description":2616,"procedure":2618,"experience":2620,"preference":2623,"examples":2626,"script":2629,"others":2631},{"type":476,"title":985,"description":2615},"The name of the Skill, used for display and identification of the capability.",{"type":476,"title":988,"description":2617},"The description of the Skill.",{"type":476,"title":991,"description":2619},"Recommended procedures or operational steps to complete the task.",{"type":513,"title":979,"items":2621,"description":2622},{"type":476},"Experience accumulated from historical tasks, including best practices, common pitfalls, and avoidance suggestions.",{"type":513,"title":917,"items":2624,"description":2625},{"type":476},"User preference settings for this type of task, such as style, constraints, or priorities.",{"type":513,"title":1000,"items":2627,"description":2628},{"type":476},"Typical usage examples of the Skill, helping the Agent understand input\u002Foutput formats and usage boundaries.",{"type":493,"title":1004,"description":2630},"Reusable code scripts or logic implementations used to complete the Skill.",{"type":493,"title":1007,"description":2632},"Other supplementary information.",{"type":493,"properties":2634,"title":1040},{"id":2635,"skill_value":2637,"skill_url":2640,"skill_type":2642,"create_time":2644,"conversation_id":2646,"status":2648,"confidence":2651,"tags":2653,"update_time":2656,"relativity":2658},{"type":476,"title":871,"description":2636},"The unique identifier of the Skill, used internally by the system to distinguish different memory entries.",{"type":493,"title":1014,"description":2638,"items":2639},"Structured Skill content. You can convert it to a string and inject it into the Agent prompt.",{"$ref":1017},{"type":476,"title":1019,"description":2641},"Download link for the Skill. A Markdown Skill can be downloaded as SKILL.md; a ZIP Skill package can include SKILL.md, scripts, references, assets, and other attachments.",{"type":476,"title":1022,"description":2643},"The type of the Skill.",{"type":476,"title":781,"description":2645},"The creation time of the Skill content, usually in ISO 8601 format.",{"type":476,"title":503,"description":2647},"The unique identifier of the conversation associated with the Skill.",{"type":476,"title":748,"description":2649,"enum":2650},"The status of the Skill. Currently, all retrieved Skills are 'activated'. activated: Active status, the Skill is currently retrievable and usable.",[892],{"type":530,"title":895,"description":2652},"The confidence score of the Skill, ranging from 0 to 1. A value closer to 1 indicates the Skill is more accurate and reliable.\nThe confidence score gradually decays as the model infers this Skill more times, reflecting the uncertainty that may arise over time or usage frequency.",{"type":513,"items":2654,"description":2655},{"type":476},"A list of tags associated with the Skill, used for classification, retrieval, or topic marking. Each element in the array is a string, e.g., [\"Person\", \"Event\", \"Work\"].",{"type":476,"title":784,"description":2657},"The time when the Skill was last modified or updated, usually in ISO 8601 format.",{"type":476,"title":531,"description":2659},"The relevance score between the query content and the Skill, ranging from 0 to 1. A value closer to 1 indicates higher relevance.",{"type":493,"title":1042,"properties":2661},{"id":2662,"memory":2664,"memory_type":2666,"template_id":2669,"profile_category":2671,"profile_field":2673,"profile_path":2675,"status":2677,"created_at":2680,"updated_at":2682,"confidence":2684,"relativity":2686,"algorithm_updatable":2688},{"type":476,"title":871,"description":2663},"Unique identifier of the profile memory.",{"type":476,"title":1047,"description":2665},"Profile memory content.",{"type":476,"title":884,"description":2667,"enum":2668},"Memory type. Profile memories use ProfileMemory.",[1052],{"type":476,"title":1054,"description":2670},"Profile template ID.",{"type":476,"title":1057,"description":2672},"Profile category, for example \"Basic Info\".",{"type":476,"title":1060,"description":2674},"Profile field name, for example \"Occupation\".",{"type":476,"title":1063,"description":2676},"Profile field path, for example \"Basic Info.Occupation\".",{"type":476,"title":748,"description":2678,"enum":2679},"Profile memory status. Search results currently return activated only.",[892],{"type":476,"title":1069,"description":2681},"Profile memory creation time in ISO 8601 format.",{"type":476,"title":1072,"description":2683},"Last update time of the profile memory in ISO 8601 format.",{"type":530,"minimum":292,"maximum":296,"title":895,"description":2685},"Confidence score of the profile memory, ranging from 0 to 1.",{"type":530,"minimum":292,"maximum":296,"title":531,"description":2687},"Relevance score between the query and this profile field, ranging from 0 to 1.",{"type":523,"title":1079,"description":2689},"Whether this profile field can be updated automatically by the algorithm.",{"type":493,"title":1082,"properties":2691},{"id":2692,"event_key":2694,"event_value":2696,"event_type":2698,"create_time":2700,"conversation_id":2702,"status":2704,"update_time":2707,"relativity":2709,"event_time":2711,"event_location":2714,"event_roles":2717},{"type":476,"title":871,"description":2693},"Unique identifier of the event memory.",{"type":476,"title":1087,"description":2695},"Title or keyword of the event memory.",{"type":476,"title":1090,"description":2697},"Detailed content of the event memory.",{"type":476,"title":1093,"description":2699},"Event memory type, usually EventMemory.",{"type":476,"title":781,"description":2701},"Event memory creation time in ISO 8601 format.",{"type":476,"title":503,"description":2703},"Unique identifier of the conversation associated with the event memory.",{"type":476,"title":748,"description":2705,"enum":2706},"Event memory status. Search results currently return activated only.",[892],{"type":476,"title":784,"description":2708},"Last update time of the event memory in ISO 8601 format.",{"type":530,"minimum":292,"maximum":296,"title":531,"description":2710},"Relevance score between the query and the event memory, ranging from 0 to 1.",{"type":513,"title":1107,"description":2712,"items":2713},"List of event times.",{"type":476},{"type":513,"title":1111,"description":2715,"items":2716},"List of event locations.",{"type":476},{"type":513,"title":1115,"description":2718,"items":2719},"List of event participants.",{"type":476},{"type":493,"properties":2721,"title":1181},{"user_id":2722,"agent_id":2724,"page":2726,"size":2728,"filter":2730,"include_memory_view":2731},{"type":476,"title":500,"description":2723},"Unique identifier of the user whose memories are being retrieved.",{"type":476,"title":563,"description":2725},"Unique identifier of the Agent whose memories are being retrieved. Available only when independent Agent memory is enabled. Use either user_id or agent_id.",{"type":518,"title":1169,"description":2727,"default":296},"Page number for pagination when many results are returned.",{"type":518,"title":1172,"description":2729,"default":1174},"Number of entries returned per memory category on the current page, up to 50.",{"type":493,"title":509,"description":2239,"example":511},{"type":513,"items":2732,"title":861,"description":2734},{"type":476,"enum":2733},[713,238,714,715,716,717],"Allowed memory types to retrieve. When omitted, all memory types are returned by default. See \u003Ca href=\"\u002Fmemos_cloud\u002Fintroduction\u002Fmemory_types\">Memory Types\u003C\u002Fa> for values.",{"type":493,"title":1183,"properties":2736},{"id":2737,"project_id":2739,"profile_template_id":2741,"properties":2742,"status":2744,"created_at":2747,"updated_at":2748},{"type":476,"title":871,"description":2738},"Unique identifier of the profile memory instance.",{"type":476,"title":1188,"description":2740},"Project ID.",{"type":476,"title":1191,"description":2670},{"type":493,"title":1193,"description":2743,"additionalProperties":45},"Structured profile field tree.",{"type":476,"title":748,"description":2745,"enum":2746},"Profile memory status. Currently only activated is returned.",[892],{"type":476,"title":1069,"description":2681},{"type":476,"title":1072,"description":2683},{"type":493,"title":1201,"properties":2750},{"id":2751,"event_key":2752,"event_value":2753,"event_type":2754,"create_time":2755,"conversation_id":2756,"status":2757,"update_time":2760,"info":2761,"sources":2763,"event_time":2766,"event_location":2768,"event_roles":2770},{"type":476,"title":871,"description":2693},{"type":476,"title":1087,"description":2695},{"type":476,"title":1090,"description":2697},{"type":476,"title":1093,"description":2699},{"type":476,"title":781,"description":2701},{"type":476,"title":503,"description":2703},{"type":476,"title":748,"description":2758,"enum":2759},"Event memory status. Currently only activated is returned.",[892],{"type":476,"title":784,"description":2708},{"type":493,"title":571,"description":2762,"additionalProperties":45},"Extended information of the event memory.",{"type":513,"title":1216,"description":2764,"items":2765},"Source messages of the event memory.",{"type":493,"additionalProperties":45},{"type":513,"title":1107,"description":2712,"items":2767},{"type":476},{"type":513,"title":1111,"description":2715,"items":2769},{"type":476},{"type":513,"title":1115,"description":2718,"items":2771},{"type":476},{"type":493,"title":1306,"properties":2773},{"memory_detail_list":2774,"preference_detail_list":2777,"profile_detail_list":2780,"event_detail_list":2782,"tool_memory_detail_list":2784,"skill_detail_list":2786,"total":2788,"size":2790,"current":2792,"pages":2794},{"type":513,"title":1122,"description":2775,"items":2776},"List of factual memory fragment details returned.",{"$ref":1310},{"type":513,"title":1127,"description":2778,"items":2779},"List of preference memory fragment details returned.",{"$ref":1313},{"type":513,"title":1132,"description":2514,"items":2781},{"$ref":1316},{"type":513,"title":1137,"description":2517,"items":2783},{"$ref":1319},{"type":513,"title":1142,"description":2520,"items":2785},{"$ref":1322},{"type":513,"title":1150,"description":2525,"items":2787},{"$ref":1153},{"type":518,"description":2789},"Maximum count across memory types, used to check if another page exists.",{"type":518,"description":2791},"Number of entries per memory type on the current page.",{"type":518,"description":2793},"Index of the current page.",{"type":518,"description":2795},"Total number of pages.",{"type":493,"required":2797,"title":1335,"properties":2798},[589,590],{"code":2799,"data":2801,"message":2802},{"type":530,"title":593,"description":2800},"API status code; refer to the error-code list for details.",{"$ref":1340},{"type":476,"title":598,"description":2803},"API message.",{"type":493,"properties":2805,"title":1352},{"memory_ids":2806,"user_id":2809,"agent_id":2811},{"type":513,"items":2807,"title":1346,"description":2808},{"type":476},"List of memory IDs to delete.",{"type":476,"title":500,"description":2810},"Delete all memories of this user in the current project. Mutually exclusive with memory_ids and agent_id.",{"type":476,"title":563,"description":2812},"Delete all memories of this Agent in the current project. Available only when independent Agent memory is enabled. Mutually exclusive with memory_ids and user_id.",{"type":493,"properties":2814,"title":1364},{"code":2815,"data":2816,"message":2821},{"type":518,"title":593,"description":2502},{"type":493,"title":1357,"properties":2817,"description":2820},{"success":2818},{"type":523,"title":742,"description":2819,"example":45},"Whether deletion was successful. true for success, false for failure.","Returned deletion information",{"type":476,"title":598,"description":2822},"API response message",{"type":493,"required":2824,"properties":2825,"title":1388},[495,496,1367],{"user_id":2826,"conversation_id":2828,"feedback_content":2830,"agent_id":2832,"app_id":2834,"feedback_time":2836,"allow_public":2838,"allow_knowledgebase_ids":2840},{"type":476,"title":500,"description":2827},"Unique identifier of the user associated with the feedback content.",{"type":476,"title":503,"description":2829},"Unique identifier of the conversation associated with the feedback content.",{"type":476,"title":1374,"description":2831},"Feedback content text.",{"type":476,"title":563,"description":2833},"Unique identifier of the Agent associated with the feedback content, primarily used to query exclusive memories between a user and that Agent during retrieval.",{"type":476,"title":560,"description":2835},"Unique identifier of the App associated with the feedback content, primarily used to query exclusive memories of a user under that App during retrieval.",{"type":476,"title":1381,"description":2837},"Time when the feedback occurred, can be a structured timestamp or natural language time description. Providing this parameter allows memory to include time information.",{"type":523,"title":574,"description":2839,"default":139},"Whether memories generated from the feedback content are allowed to be written to the public memory store. When enabled, generated memories can be retrieved by other users in the project.",{"type":513,"items":2841,"title":578,"description":2842},{"type":476},"List of knowledgebases where memories generated from the feedback content are allowed to be written.",{"type":493,"required":2844,"properties":2845,"title":1403},[589,590],{"code":2846,"data":2847,"message":2854},{"type":518,"title":593,"description":2502},{"type":493,"title":1357,"properties":2848},{"success":2849,"status":2851,"task_id":2853},{"type":523,"title":742,"description":2850},"Whether addition was successful. true for success, false for failure.",{"type":476,"title":748,"description":2852},"Task status: running, completed",{"type":476,"title":745,"description":745},{"type":476,"title":598,"description":2822},{"type":493,"title":1405,"properties":2856},{"memory_ids":2857},{"type":513,"items":2858,"title":1346,"description":2859},{"type":476},"Memory IDs touched by this task under the given \u003Ca href=\"\u002Fmemos_cloud\u002Fintroduction\u002Fmemory_types\">memory category\u003C\u002Fa>.",{"type":493,"title":1411,"description":2861,"properties":2862},"Summary of memory changes produced by the completed task.",{"added":2863,"updated":2865,"deleted":2867,"detail_factual":2869,"preference":2870,"event":2871,"profile":2872,"skill":2873,"tool_memory":2874},{"type":518,"title":1415,"description":2864},"Number of memories added in this task.",{"type":518,"title":1418,"description":2866},"Number of memories updated in this task.",{"type":518,"title":1421,"description":2868},"Number of memories deleted or archived in this task.",{"$ref":1424},{"$ref":1424},{"$ref":1424},{"$ref":1424},{"$ref":1424},{"$ref":1424},{"type":493,"title":1431,"properties":2876},{"task_id":2877,"status":2879,"memory_views":2882},{"type":476,"title":745,"description":2878},"Async task ID, matching the task_id in the request.",{"type":476,"title":748,"enum":2880,"description":2881},[304,290,308],"Current task status: running, completed, or failed.",{"$ref":1439,"description":2883},"Returned only when status is completed and memory change details exist. Omitted for running or failed tasks.",{"type":493,"required":2885,"properties":2886,"title":1447},[1443],{"task_id":2887},{"type":476,"title":745,"description":2888},"Async task ID returned by add\u002Fmessage, add\u002Ffeedback, and other async endpoints.",{"type":493,"required":2890,"properties":2891,"title":1455},[589,590],{"code":2892,"data":2893,"message":2894},{"type":518,"title":593,"description":2502},{"$ref":1453},{"type":476,"title":598,"description":2822},{"type":493,"required":2896,"properties":2897,"title":1466},[1458],{"knowledgebase_name":2898,"knowledgebase_description":2899},{"type":476,"title":1461,"description":1461},{"type":476,"title":1464,"description":2900},"Description information",{"type":493,"required":2902,"properties":2903,"title":1477},[589,590],{"code":2904,"data":2905,"message":2909},{"type":518,"title":593,"description":2502},{"type":493,"title":1357,"properties":2906},{"id":2907},{"type":476,"title":1474,"description":2908},"Knowledgebase ID returned after successful creation",{"type":476,"title":598,"description":2822},{"type":493,"required":2911,"properties":2912,"title":1485},[1480],{"knowledgebase_id":2913},{"type":476,"title":1483,"description":2914},"Knowledgebase ID to be deleted",{"type":493,"required":2916,"properties":2917,"title":1495},[589,590],{"code":2918,"data":2919,"message":2923},{"type":518,"title":593,"description":2502},{"type":493,"title":1357,"properties":2920},{"success":2921},{"type":523,"title":742,"description":2922},"Whether removal was successful. true for success, false for failure.",{"type":476,"title":598,"description":2822},{"type":493,"required":2925,"properties":2926,"title":1515},[1480,647],{"knowledgebase_id":2927,"file":2929},{"type":476,"title":1483,"description":2928},"Target Knowledgebase ID",{"type":513,"title":1502,"description":2930,"items":2931},"List of files to upload. Ordinary documents follow the document parsing pipeline; Skill files follow the Skill validation and parsing pipeline.",{"type":493,"properties":2932},{"name":2933,"type":2935,"content":2938},{"type":476,"title":985,"description":2934},"File name. Recommended when uploading Base64 content; optional when uploading by URL.",{"type":476,"title":1509,"enum":2936,"default":1511,"description":2937},[1511,714],"Uploaded file type. document means ordinary Knowledge Base document; skill means Skill file, supporting a .md single file or .zip Skill package.",{"type":476,"title":779,"description":2939},"File content. Supports URL or Base64 encoding. For supported formats, size limits, and quantity limits for ordinary documents and Skill files, see \u003Ca href=\"\u002Fmemos_cloud\u002Ffeatures\u002Fknowledge_base\" class=\"text-primary border-b border-transparent hover:border-primary font-medium focus-visible:outline-primary [&>code]:border-dashed hover:[&>code]:border-primary hover:[&>code]:text-primary transition-colors [&>code]:transition-colors\">Knowledge Base requirements\u003C\u002Fa>.",{"type":493,"required":2941,"properties":2942,"title":1539},[589,590],{"code":2943,"data":2944,"message":2960},{"type":518,"title":593,"description":2502},{"type":513,"title":1357,"description":2945,"items":2946},"Processing results for uploaded files.",{"type":493,"properties":2947},{"id":2948,"type":2950,"name":2953,"sizeMB":2955,"status":2957},{"type":476,"title":871,"description":2949},"File ID",{"type":476,"title":1509,"enum":2951,"description":2952},[1511,714],"File type. document means ordinary document; skill means Skill file.",{"type":476,"title":985,"description":2954},"File name",{"type":530,"title":1532,"description":2956},"File size in MB",{"type":476,"title":748,"description":2958,"enum":2959},"File processing status",[304,290,308],{"type":476,"title":598,"description":2822},{"type":493,"description":2962,"properties":2963,"title":1558},"Supports two query modes: pass file_ids to retrieve specific file details; or pass knowledgebase_id to list files under a Knowledge Base, optionally with type, page, and page_size for filtering and pagination. Choose exactly one mode. Passing both knowledgebase_id and file_ids returns an error; passing neither also returns an error.",{"knowledgebase_id":2964,"type":2966,"page":2969,"page_size":2971,"file_ids":2973},{"type":476,"title":1483,"description":2965},"Query mode 1: target Knowledge Base ID. Returns files under the Knowledge Base and can be used with type, page, and page_size. Do not pass it together with file_ids.",{"type":476,"title":1509,"enum":2967,"description":2968},[1511,714],"File type filter, effective only when querying by knowledgebase_id. document returns only ordinary documents; skill returns only Skill files; omit this field to return all files. Do not use it with the file_ids query mode.",{"type":518,"format":756,"title":1169,"description":2970,"default":296},"Page number, effective only when querying by knowledgebase_id. Do not use it with the file_ids query mode.",{"type":518,"format":756,"title":1551,"description":2972,"default":1553},"Items per page, effective only when querying by knowledgebase_id. Do not use it with the file_ids query mode.",{"type":513,"items":2974,"title":1556,"description":2975},{"type":476},"Query mode 2: file ID list. Returns details for the specified files. When using this mode, pass only file_ids and do not pass knowledgebase_id, type, page, or page_size.",{"type":493,"required":2977,"properties":2978,"title":1586},[589,590],{"code":2979,"data":2980,"message":2999},{"type":518,"title":593,"description":2502},{"type":493,"title":1357,"properties":2981},{"total":2982,"page":2984,"page_size":2986,"file_detail_list":2988},{"type":518,"format":756,"title":1566,"description":2983},"Total number of matched files",{"type":518,"format":756,"title":1169,"description":2985},"Current page number",{"type":518,"format":756,"title":1551,"description":2987},"Items per page",{"type":513,"items":2989,"title":1584},{"type":493,"properties":2990},{"id":2991,"type":2992,"name":2994,"size":2995,"status":2997},{"type":476,"title":871,"description":2949},{"type":476,"title":1509,"enum":2993,"description":2952},[1511,714],{"type":476,"title":985,"description":2954},{"type":476,"title":1172,"description":2996},"File size",{"type":476,"title":748,"description":2958,"enum":2998},[304,290,308],{"type":476,"title":598,"description":2822},{"type":493,"required":3001,"properties":3002,"title":1594},[1589],{"file_ids":3003},{"type":513,"items":3004,"title":1556,"description":3005},{"type":476},"List of file IDs to delete. You can pass ordinary document IDs or Skill file IDs.",{"type":493,"required":3007,"properties":3008,"title":1603},[589,590],{"code":3009,"data":3010,"message":3013},{"type":518,"title":593,"description":2502},{"type":493,"title":1357,"properties":3011},{"success":3012},{"type":523,"title":742,"description":2819},{"type":476,"title":598,"description":2822},{"type":493,"title":1605,"properties":3015},{"memory_key":3016,"memory_value":3019,"memory_type":3022,"tags":3024},{"type":476,"title":874,"description":3017,"example":3018},"High-level topic or title summarizing the extracted factual memory.","User profile basics",{"type":476,"title":877,"description":3020,"example":3021},"Detailed content of the extracted factual memory.","User Zhang San, 28, backend developer in Hangzhou, enjoys badminton.",{"type":476,"title":884,"description":3023,"example":883},"Memory type classifier.\u003Cbr>Examples: UserMemory, LongTermMemory.",{"type":513,"items":3025,"title":567,"description":3026,"example":3027},{"type":476},"Tags for categorizing the memory content.",[3028,3029,3030],"person","job","hobby",{"type":493,"title":1623,"properties":3032},{"preference":3033,"reasoning":3036,"preference_type":3039},{"type":476,"title":917,"description":3034,"example":3035},"Concrete preference text extracted from the dialogue.","The user asked for replies to stay concise.",{"type":476,"title":920,"description":3037,"example":3038},"How this preference was inferred from the conversation.","The user stated this preference explicitly in the chat.",{"type":476,"title":914,"description":3040,"enum":3041,"example":912},"explicit_preference: clearly stated by the user; implicit_preference: inferred from behavior or context.",[912,913],{"type":493,"title":1635,"properties":3043},{"success":3044,"memory_detail_list":3046,"preference_detail_list":3049},{"type":523,"title":742,"description":3045},"Whether extraction succeeded.",{"type":513,"title":1122,"description":3047,"items":3048},"Factual memories. Returned when the request includes memory in extraction_types, or when extraction_types is omitted.",{"$ref":1642},{"type":513,"title":1127,"description":3050,"items":3051},"Preference memories. Returned when the request includes preference in extraction_types, or when extraction_types is omitted; may mix explicit and implicit preferences.",{"$ref":1646},{"type":493,"required":3053,"title":1657,"properties":3054},[497,1656],{"model":3055,"query":3058,"documents":3060,"top_n":3063},{"type":476,"title":1660,"description":3056,"enum":3057},"Model name to use.",[256,1663],{"type":476,"title":506,"description":3059},"The user query.",{"type":513,"title":1667,"description":3061,"items":3062},"A list of document texts to rerank.",{"type":476},{"type":518,"title":1671,"description":3064},"Return the top N most relevant results. If omitted, returns all results by default.",{"type":493,"required":3066,"title":1677,"properties":3067},[1675,1511,1676],{"index":3068,"document":3070,"relevance_score":3076},{"type":518,"title":1680,"description":3069},"The index position of this document in the original documents list.",{"type":493,"title":1683,"description":3071,"required":3072,"properties":3073},"Document object.",[612],{"text":3074},{"type":476,"title":1688,"description":3075},"The original text content of the document.",{"type":530,"title":1691,"description":3077},"Relevance score, ranging from 0 to 1, higher indicates more relevant to the query.",{"type":493,"required":3079,"title":1699,"properties":3080},[1695,1696,1697,1698],{"id":3081,"model":3083,"usage":3085,"results":3093},{"type":476,"title":1702,"description":3082},"Unique identifier for this request.",{"type":476,"title":1660,"description":3084},"Model name used.",{"type":493,"title":1707,"description":3086,"required":3087,"properties":3088},"Token usage statistics.",[1710,1711],{"prompt_tokens":3089,"total_tokens":3091},{"type":518,"title":1714,"description":3090},"Number of tokens consumed by the prompt.",{"type":518,"title":1717,"description":3092},"Total number of tokens consumed.",{"type":513,"title":1720,"description":3094,"items":3095},"List of reranked results, sorted in descending order by relevance_score.",{"$ref":1723},{"type":493,"required":3097,"title":1649,"properties":3098},[619,620],{"role":3099,"content":3102},{"type":476,"title":629,"enum":3100,"description":3101},[55,58,627],"Creator role of the message.",{"type":476,"title":779,"description":3103},"Message body text.",{"type":493,"required":3105,"title":1726,"properties":3106},[687],{"messages":3107,"extraction_types":3110},{"type":513,"title":704,"description":3108,"items":3109},"Array of message objects from which to extract memories. The combined Token count of all messages must not exceed 8k.",{"$ref":1731},{"type":513,"title":1733,"description":3111,"items":3112},"\u003Cp>Limits which memory types to extract; omit to extract all supported types.\u003C\u002Fp>\u003Cul>\u003Cli>\u003Ccode>memory\u003C\u002Fcode>: factual memories—user-related factual information extracted from the dialogue.\u003C\u002Fli>\u003Cli>\u003Ccode>preference\u003C\u002Fcode>: preference memories—user preferences from the dialogue, including explicit preferences (clearly stated) and implicit preferences (inferred from behavior).\u003C\u002Fli>\u003C\u002Ful>",{"type":476,"enum":3113},[237,238],{"type":493,"required":3115,"title":1739,"properties":3116},[589,590],{"code":3117,"data":3118,"message":3119},{"type":518,"format":756,"title":593,"description":2502,"example":292},{"$ref":1743},{"type":476,"title":598,"description":2425,"example":293},{"type":493,"title":1226,"properties":3121},{"id":3122,"memory_key":3124,"memory_value":3126,"memory_type":3128,"create_time":3131,"conversation_id":3133,"status":3135,"confidence":3138,"tags":3140,"update_time":3143,"relativity":3145,"sources":3147,"info":3150},{"type":476,"title":871,"description":3123},"Unique identifier of the factual memory.",{"type":476,"title":874,"description":3125},"Title or keyword of the factual memory.",{"type":476,"title":877,"description":3127},"Detailed content of the factual memory.",{"type":476,"title":884,"description":3129,"enum":3130},"Type of factual memory.",[881,882,883],{"type":476,"title":781,"description":3132},"Creation time in ISO 8601 format.",{"type":476,"title":503,"description":3134},"Conversation identifier linked to this memory.",{"type":476,"title":748,"description":3136,"enum":3137},"Factual memory status. Currently only activated is returned.",[892],{"type":530,"minimum":292,"maximum":296,"title":895,"description":3139},"Confidence score between 0 and 1.",{"type":513,"title":567,"description":3141,"items":3142},"Tag list associated with the factual memory.",{"type":476},{"type":476,"title":784,"description":3144},"Last update time in ISO 8601 format.",{"type":530,"minimum":292,"maximum":296,"title":531,"description":3146},"Relevance score between 0 and 1.",{"type":513,"title":1216,"description":3148,"items":3149},"Source messages of the factual memory.",{"type":493,"additionalProperties":45},{"type":493,"title":571,"description":3151,"additionalProperties":45},"Custom metadata provided when adding the message.",{"type":493,"title":1258,"properties":3153},{"id":3154,"preference_type":3156,"preference":3159,"reasoning":3161,"create_time":3163,"conversation_id":3164,"status":3165,"update_time":3168,"relativity":3169,"sources":3170,"info":3173},{"type":476,"title":871,"description":3155},"Unique identifier of the preference memory.",{"type":476,"title":914,"description":3157,"enum":3158},"Type of preference memory.",[912,913],{"type":476,"title":917,"description":3160},"Detailed content of the preference memory.",{"type":476,"title":920,"description":3162},"Reason why the preference memory was extracted.",{"type":476,"title":781,"description":3132},{"type":476,"title":503,"description":3134},{"type":476,"title":748,"description":3166,"enum":3167},"Preference memory status. Currently only activated is returned.",[892],{"type":476,"title":784,"description":3144},{"type":530,"minimum":292,"maximum":296,"title":531,"description":3146},{"type":513,"title":1216,"description":3171,"items":3172},"Source messages of the preference memory.",{"type":493,"additionalProperties":45},{"type":493,"title":571,"description":3151,"additionalProperties":45},{"type":493,"title":1283,"properties":3175},{"id":3176,"tool_type":3177,"tool_value":3180,"tool_used_status":3182,"create_time":3185,"conversation_id":3186,"status":3187,"update_time":3190,"relativity":3191,"source":3192,"experience":3194,"info":3196},{"type":476,"title":871,"description":2590},{"type":476,"title":954,"description":3178,"enum":3179},"Tool memory type. ToolTrajectoryMemory means tool trajectory memory; ToolSchema means tool schema memory.",[957,958],{"type":476,"title":960,"description":3181},"Detailed content of the tool memory.",{"type":513,"title":963,"description":3183,"items":3184},"Tool trajectory records, each containing the used tool and experience.",{"$ref":966},{"type":476,"title":781,"description":3132},{"type":476,"title":503,"description":3134},{"type":476,"title":748,"description":3188,"enum":3189},"Tool memory status. Currently activated only.",[892],{"type":476,"title":784,"description":3144},{"type":530,"minimum":292,"maximum":296,"title":531,"description":3146},{"type":476,"title":1301,"description":3193},"Source information of the tool memory.",{"type":476,"title":979,"description":3195},"Procedural experience of the entire trajectory.",{"type":493,"title":571,"description":3151,"additionalProperties":45},{"type":493,"required":3198,"properties":3199,"title":1762},[1747],{"bind_list":3200},{"type":513,"title":1750,"description":3201,"items":3202},"List of bindings to create in a single call, up to 20 per request.",{"type":493,"required":3203,"properties":3204},[1754],{"user_id":3205,"agent_id":3207,"profile_template_id":3209},{"type":476,"description":3206},"User ID to bind to the Profile template.",{"type":476,"description":3208},"Agent ID to bind to the Profile template. Available only when independent Agent memory is enabled; use either user_id or agent_id.",{"type":476,"description":3210},"ID of the Profile template to bind.",{"type":493,"properties":3212,"title":3220},{"code":3213,"data":3215,"message":3219},{"type":518,"title":593,"description":3214},"API status code.",{"type":493,"title":1357,"properties":3216},{"success":3217},{"type":523,"title":742,"description":3218,"example":45},"Whether the binding succeeded.",{"type":476,"title":598,"description":2425},"BindProfileTemplateResponse",{"type":493,"title":3222,"description":3223,"properties":3224},"ProfileFieldValue","A leaf field-value node inside the metadata tree.",{"value":3225,"algorithm_updatable":3227},{"type":476,"title":1768,"description":3226},"The attribute field value.",{"type":523,"title":1079,"description":3228,"default":45},"Whether this field can be automatically updated by the algorithm. Defaults to true.",{"type":493,"required":3230,"properties":3231,"title":1794},[1754],{"user_id":3232,"agent_id":3234,"profile_template_id":3236,"metadata":3238,"remove_fields":3245},{"type":476,"title":500,"description":3233},"User ID. Use either user_id or agent_id. Required for single-perspective projects.",{"type":476,"title":563,"description":3235},"Agent ID. Available only when independent Agent memory is enabled; use either user_id or agent_id.",{"type":476,"title":1191,"description":3237},"ID of the target Profile template.",{"type":493,"title":1782,"description":3239,"properties":3240},"Fields to update. Existing fields are updated with the new value; new fields are added to the current instance.",{"{category_name}":3241},{"type":493,"description":3242,"properties":3243},"An optional grouping layer for attribute fields, keyed by a custom category name. Skip this layer and pass field values directly under metadata if categories are not needed.",{"{field_name}":3244},{"$ref":1789},{"type":513,"items":3246,"title":1792,"description":3247},{"type":476},"List of field paths to remove, e.g. [\"Basic Info.Occupation\"].",{"type":493,"properties":3249,"title":3256},{"code":3250,"data":3251,"message":3255},{"type":518,"title":593,"description":3214},{"type":493,"title":1357,"properties":3252},{"success":3253},{"type":523,"title":742,"description":3254,"example":45},"Whether the edit succeeded.",{"type":476,"title":598,"description":2425},"EditProfileResponse",{"type":493,"required":3258,"properties":3259,"title":1803},[1754],{"user_id":3260,"agent_id":3262,"profile_template_id":3264},{"type":476,"title":500,"description":3261},"User ID. Use either user_id or agent_id.",{"type":476,"title":563,"description":3263},"Agent ID. Use either user_id or agent_id.",{"type":476,"title":1191,"description":3237},{"type":493,"properties":3266,"title":3273},{"code":3267,"data":3268,"message":3272},{"type":518,"title":593,"description":3214},{"type":493,"title":1357,"properties":3269},{"success":3270},{"type":523,"title":742,"description":3271,"example":45},"Whether the deletion succeeded.",{"type":476,"title":598,"description":2425},"DeleteProfileResponse",{"type":493,"required":3275,"properties":3276,"title":1815},[473],{"memory_id":3277,"content":3279,"title":3281},{"type":476,"title":1808,"description":3278},"Memory ID, from the id field returned by search\u002Fmemory or get\u002Fmemory.",{"type":476,"title":779,"description":3280},"The updated memory content.",{"type":476,"title":1813,"description":3282},"The updated memory title.",{"type":493,"properties":3284,"title":3291},{"code":3285,"data":3286,"message":3290},{"type":518,"title":593,"description":3214},{"type":493,"title":1357,"properties":3287},{"success":3288},{"type":523,"title":742,"description":3289,"example":45},"Whether the update succeeded.",{"type":476,"title":598,"description":2425},"UpdateMemoryResponse",{"type":493,"required":3293,"properties":3294,"title":1858},[589,590],{"code":3295,"data":3296,"message":3329},{"type":518,"title":593,"description":3214,"example":292},{"type":493,"properties":3297},{"id":3298,"memory_view":3299,"title":3302,"content":3304,"conversation_id":3306,"message_ids":3308,"status":3311,"algorithm_updatable":3314,"created_at":3316,"updated_at":3318,"user_id":3320,"agent_id":3322,"tags":3324,"info":3327},{"type":476,"description":2218},{"type":476,"enum":3300,"description":3301},[713,238,716,715,714,717],"Memory category.",{"type":476,"description":3303},"Memory title.",{"description":3305},"Memory content.",{"type":476,"description":3307},"Source conversation ID.",{"type":513,"items":3309,"description":3310},{"type":476},"List of source message IDs.",{"type":476,"enum":3312,"description":3313},[892,1838,1839,1840],"Memory status.",{"type":523,"description":3315},"Whether the algorithm can update this memory automatically.",{"type":476,"description":3317},"Creation time.",{"type":476,"description":3319},"Last update time.",{"type":476,"description":3321},"Owning user.",{"type":476,"description":3323},"Owning Agent.",{"type":513,"items":3325,"description":3326},{"type":476},"Custom tags.",{"type":493,"description":3328},"Custom metadata.",{"type":476,"title":598,"description":2425,"example":293},"en\u002Fapi_docs\u002Fapi","hpqsy7r5P6QzBV5ynofrlwsWjeg9Se-r-pd8dUInV1Q",[3333,3338],{"title":2146,"path":3334,"stem":3335,"icon":3336,"framework":6,"module":6,"class":3337,"target":-1,"active":139,"defaultOpen":139,"children":-1,"description":-1},"\u002Fapi_docs\u002Fcore\u002Fbind_profile_template","api_docs\u002Fcore\u002Fbind_profile_template","i-ri-link",[],{"title":2181,"path":3339,"stem":3340,"icon":3341,"framework":6,"module":6,"class":3342,"target":-1,"active":139,"defaultOpen":139,"children":-1,"description":-1},"\u002Fapi_docs\u002Fcore\u002Fdelete_profile","api_docs\u002Fcore\u002Fdelete_profile","i-ri-delete-bin-2-line",[],{"id":3344,"title":3345,"avatar":6,"banner":6,"body":3346,"category":6,"desc":6,"description":11,"extension":14,"links":6,"meta":4199,"navigation":6,"path":4200,"seo":4201,"stem":4202,"__hash__":4203},"docs\u002Fen\u002Fapi_docs\u002Fsnippets\u002Fedit_profile.md","EditProfile",{"type":8,"value":3347,"toc":4197},[3348,4193],[3349,3350,3351,3850,4066],"code-group",{},[3352,3353,3358],"pre",{"className":3354,"code":3355,"filename":3356,"language":3357,"meta":11,"style":11},"language-python shiki shiki-themes material-theme-lighter github-light-high-contrast github-dark-default","import os\nimport requests\nimport json\n\n# Replace with your API Key\nos.environ[\"MEMOS_API_KEY\"] = \"YOUR_API_KEY\"\nos.environ[\"MEMOS_BASE_URL\"] = \"https:\u002F\u002Fmemos.memtensor.cn\u002Fapi\u002Fopenmem\u002Fv1\"\n\ndata = {\n  \"user_id\": \"memos_user_123\",\n  \"profile_template_id\": \"tpl_user_001\",\n  \"metadata\": {\n    \"Basic Info\": {\n      \"Location\": {\n        \"value\": \"Shanghai\",\n        \"algorithm_updatable\": False\n      }\n    }\n  }\n}\nheaders = {\n  \"Content-Type\": \"application\u002Fjson\",\n  \"Authorization\": f\"Token {os.environ['MEMOS_API_KEY']}\"\n}\nurl = f\"{os.environ['MEMOS_BASE_URL']}\u002Fedit\u002Fprofile\"\n\nres = requests.post(url=url, headers=headers, data=json.dumps(data))\n\nprint(f\"result: {res.json()}\")\n","Python (HTTP)","python",[589,3359,3360,3372,3379,3387,3393,3400,3442,3470,3475,3486,3507,3526,3540,3555,3570,3591,3607,3613,3619,3625,3630,3640,3661,3705,3710,3745,3750,3811,3816],{"__ignoreMap":11},[3361,3362,3364,3368],"span",{"class":3363,"line":296},"line",[3361,3365,3367],{"class":3366},"sBMTB","import",[3361,3369,3371],{"class":3370},"s5ojA"," os\n",[3361,3373,3374,3376],{"class":3363,"line":12},[3361,3375,3367],{"class":3366},[3361,3377,3378],{"class":3370}," requests\n",[3361,3380,3382,3384],{"class":3363,"line":3381},3,[3361,3383,3367],{"class":3366},[3361,3385,3386],{"class":3370}," json\n",[3361,3388,3390],{"class":3363,"line":3389},4,[3361,3391,3392],{"emptyLinePlaceholder":45},"\n",[3361,3394,3396],{"class":3363,"line":3395},5,[3361,3397,3399],{"class":3398},"sfVK4","# Replace with your API Key\n",[3361,3401,3402,3405,3409,3413,3416,3420,3424,3426,3429,3433,3436,3439],{"class":3363,"line":87},[3361,3403,3404],{"class":3370},"os",[3361,3406,3408],{"class":3407},"suWxN",".",[3361,3410,3412],{"class":3411},"s5qkx","environ",[3361,3414,3415],{"class":3407},"[",[3361,3417,3419],{"class":3418},"sjUum","\"",[3361,3421,3423],{"class":3422},"sp1uZ","MEMOS_API_KEY",[3361,3425,3419],{"class":3418},[3361,3427,3428],{"class":3407},"]",[3361,3430,3432],{"class":3431},"saN0X"," =",[3361,3434,3435],{"class":3418}," \"",[3361,3437,3438],{"class":3422},"YOUR_API_KEY",[3361,3440,3441],{"class":3418},"\"\n",[3361,3443,3445,3447,3449,3451,3453,3455,3458,3460,3462,3464,3466,3468],{"class":3363,"line":3444},7,[3361,3446,3404],{"class":3370},[3361,3448,3408],{"class":3407},[3361,3450,3412],{"class":3411},[3361,3452,3415],{"class":3407},[3361,3454,3419],{"class":3418},[3361,3456,3457],{"class":3422},"MEMOS_BASE_URL",[3361,3459,3419],{"class":3418},[3361,3461,3428],{"class":3407},[3361,3463,3432],{"class":3431},[3361,3465,3435],{"class":3418},[3361,3467,33],{"class":3422},[3361,3469,3441],{"class":3418},[3361,3471,3473],{"class":3363,"line":3472},8,[3361,3474,3392],{"emptyLinePlaceholder":45},[3361,3476,3477,3480,3483],{"class":3363,"line":521},[3361,3478,3479],{"class":3370},"data ",[3361,3481,3482],{"class":3431},"=",[3361,3484,3485],{"class":3407}," {\n",[3361,3487,3488,3491,3493,3495,3498,3500,3502,3504],{"class":3363,"line":1174},[3361,3489,3490],{"class":3418},"  \"",[3361,3492,495],{"class":3422},[3361,3494,3419],{"class":3418},[3361,3496,3497],{"class":3407},":",[3361,3499,3435],{"class":3418},[3361,3501,51],{"class":3422},[3361,3503,3419],{"class":3418},[3361,3505,3506],{"class":3407},",\n",[3361,3508,3510,3512,3514,3516,3518,3520,3522,3524],{"class":3363,"line":3509},11,[3361,3511,3490],{"class":3418},[3361,3513,1754],{"class":3422},[3361,3515,3419],{"class":3418},[3361,3517,3497],{"class":3407},[3361,3519,3435],{"class":3418},[3361,3521,404],{"class":3422},[3361,3523,3419],{"class":3418},[3361,3525,3506],{"class":3407},[3361,3527,3529,3531,3534,3536,3538],{"class":3363,"line":3528},12,[3361,3530,3490],{"class":3418},[3361,3532,3533],{"class":3422},"metadata",[3361,3535,3419],{"class":3418},[3361,3537,3497],{"class":3407},[3361,3539,3485],{"class":3407},[3361,3541,3543,3546,3549,3551,3553],{"class":3363,"line":3542},13,[3361,3544,3545],{"class":3418},"    \"",[3361,3547,3548],{"class":3422},"Basic Info",[3361,3550,3419],{"class":3418},[3361,3552,3497],{"class":3407},[3361,3554,3485],{"class":3407},[3361,3556,3558,3561,3564,3566,3568],{"class":3363,"line":3557},14,[3361,3559,3560],{"class":3418},"      \"",[3361,3562,3563],{"class":3422},"Location",[3361,3565,3419],{"class":3418},[3361,3567,3497],{"class":3407},[3361,3569,3485],{"class":3407},[3361,3571,3573,3576,3579,3581,3583,3585,3587,3589],{"class":3363,"line":3572},15,[3361,3574,3575],{"class":3418},"        \"",[3361,3577,3578],{"class":3422},"value",[3361,3580,3419],{"class":3418},[3361,3582,3497],{"class":3407},[3361,3584,3435],{"class":3418},[3361,3586,2172],{"class":3422},[3361,3588,3419],{"class":3418},[3361,3590,3506],{"class":3407},[3361,3592,3594,3596,3599,3601,3603],{"class":3363,"line":3593},16,[3361,3595,3575],{"class":3418},[3361,3597,3598],{"class":3422},"algorithm_updatable",[3361,3600,3419],{"class":3418},[3361,3602,3497],{"class":3407},[3361,3604,3606],{"class":3605},"smHB8"," False\n",[3361,3608,3610],{"class":3363,"line":3609},17,[3361,3611,3612],{"class":3407},"      }\n",[3361,3614,3616],{"class":3363,"line":3615},18,[3361,3617,3618],{"class":3407},"    }\n",[3361,3620,3622],{"class":3363,"line":3621},19,[3361,3623,3624],{"class":3407},"  }\n",[3361,3626,3627],{"class":3363,"line":1553},[3361,3628,3629],{"class":3407},"}\n",[3361,3631,3633,3636,3638],{"class":3363,"line":3632},21,[3361,3634,3635],{"class":3370},"headers ",[3361,3637,3482],{"class":3431},[3361,3639,3485],{"class":3407},[3361,3641,3643,3645,3648,3650,3652,3654,3657,3659],{"class":3363,"line":3642},22,[3361,3644,3490],{"class":3418},[3361,3646,3647],{"class":3422},"Content-Type",[3361,3649,3419],{"class":3418},[3361,3651,3497],{"class":3407},[3361,3653,3435],{"class":3418},[3361,3655,3656],{"class":3422},"application\u002Fjson",[3361,3658,3419],{"class":3418},[3361,3660,3506],{"class":3407},[3361,3662,3664,3666,3668,3670,3672,3676,3679,3683,3685,3687,3689,3691,3694,3696,3698,3700,3703],{"class":3363,"line":3663},23,[3361,3665,3490],{"class":3418},[3361,3667,488],{"class":3422},[3361,3669,3419],{"class":3418},[3361,3671,3497],{"class":3407},[3361,3673,3675],{"class":3674},"sZ6T4"," f",[3361,3677,3678],{"class":3422},"\"Token ",[3361,3680,3682],{"class":3681},"scyET","{",[3361,3684,3404],{"class":3370},[3361,3686,3408],{"class":3407},[3361,3688,3412],{"class":3411},[3361,3690,3415],{"class":3407},[3361,3692,3693],{"class":3418},"'",[3361,3695,3423],{"class":3422},[3361,3697,3693],{"class":3418},[3361,3699,3428],{"class":3407},[3361,3701,3702],{"class":3681},"}",[3361,3704,3441],{"class":3422},[3361,3706,3708],{"class":3363,"line":3707},24,[3361,3709,3629],{"class":3407},[3361,3711,3713,3716,3718,3720,3722,3724,3726,3728,3730,3732,3734,3736,3738,3740,3742],{"class":3363,"line":3712},25,[3361,3714,3715],{"class":3370},"url ",[3361,3717,3482],{"class":3431},[3361,3719,3675],{"class":3674},[3361,3721,3419],{"class":3422},[3361,3723,3682],{"class":3681},[3361,3725,3404],{"class":3370},[3361,3727,3408],{"class":3407},[3361,3729,3412],{"class":3411},[3361,3731,3415],{"class":3407},[3361,3733,3693],{"class":3418},[3361,3735,3457],{"class":3422},[3361,3737,3693],{"class":3418},[3361,3739,3428],{"class":3407},[3361,3741,3702],{"class":3681},[3361,3743,3744],{"class":3422},"\u002Fedit\u002Fprofile\"\n",[3361,3746,3748],{"class":3363,"line":3747},26,[3361,3749,3392],{"emptyLinePlaceholder":45},[3361,3751,3753,3756,3758,3761,3763,3767,3770,3774,3776,3778,3781,3784,3786,3789,3791,3794,3796,3798,3800,3803,3805,3808],{"class":3363,"line":3752},27,[3361,3754,3755],{"class":3370},"res ",[3361,3757,3482],{"class":3431},[3361,3759,3760],{"class":3370}," requests",[3361,3762,3408],{"class":3407},[3361,3764,3766],{"class":3765},"sa-2m","post",[3361,3768,3769],{"class":3407},"(",[3361,3771,3773],{"class":3772},"sp4zP","url",[3361,3775,3482],{"class":3431},[3361,3777,3773],{"class":3765},[3361,3779,3780],{"class":3407},",",[3361,3782,3783],{"class":3772}," headers",[3361,3785,3482],{"class":3431},[3361,3787,3788],{"class":3765},"headers",[3361,3790,3780],{"class":3407},[3361,3792,3793],{"class":3772}," data",[3361,3795,3482],{"class":3431},[3361,3797,24],{"class":3765},[3361,3799,3408],{"class":3407},[3361,3801,3802],{"class":3765},"dumps",[3361,3804,3769],{"class":3407},[3361,3806,3807],{"class":3765},"data",[3361,3809,3810],{"class":3407},"))\n",[3361,3812,3814],{"class":3363,"line":3813},28,[3361,3815,3392],{"emptyLinePlaceholder":45},[3361,3817,3819,3823,3825,3828,3831,3833,3836,3838,3840,3843,3845,3847],{"class":3363,"line":3818},29,[3361,3820,3822],{"class":3821},"svxCd","print",[3361,3824,3769],{"class":3407},[3361,3826,3827],{"class":3674},"f",[3361,3829,3830],{"class":3422},"\"result: ",[3361,3832,3682],{"class":3681},[3361,3834,3835],{"class":3765},"res",[3361,3837,3408],{"class":3407},[3361,3839,24],{"class":3765},[3361,3841,3842],{"class":3407},"()",[3361,3844,3702],{"class":3681},[3361,3846,3419],{"class":3422},[3361,3848,3849],{"class":3407},")\n",[3352,3851,3854],{"className":3354,"code":3852,"filename":3853,"language":3357,"meta":11,"style":11},"# Ensure MemOS is installed (pip install MemoryOS -U)\nfrom memos.api.client import MemOSClient\n\nclient = MemOSClient(api_key=\"YOUR_API_KEY\")\n\nres = client.edit_profile(\n    user_id=\"memos_user_123\",\n    profile_template_id=\"tpl_user_001\",\n    metadata={\n        \"Basic Info\": {\n            \"Location\": {\n                \"value\": \"Shanghai\",\n                \"algorithm_updatable\": False\n            }\n        }\n    }\n)\nprint(f\"result: {res}\")\n","Python (SDK)",[589,3855,3856,3861,3884,3888,3912,3916,3932,3947,3962,3972,3984,3997,4016,4028,4033,4038,4042,4046],{"__ignoreMap":11},[3361,3857,3858],{"class":3363,"line":296},[3361,3859,3860],{"class":3398},"# Ensure MemOS is installed (pip install MemoryOS -U)\n",[3361,3862,3863,3866,3869,3871,3874,3876,3879,3881],{"class":3363,"line":12},[3361,3864,3865],{"class":3366},"from",[3361,3867,3868],{"class":3370}," memos",[3361,3870,3408],{"class":3407},[3361,3872,3873],{"class":3370},"api",[3361,3875,3408],{"class":3407},[3361,3877,3878],{"class":3370},"client ",[3361,3880,3367],{"class":3366},[3361,3882,3883],{"class":3370}," MemOSClient\n",[3361,3885,3886],{"class":3363,"line":3381},[3361,3887,3392],{"emptyLinePlaceholder":45},[3361,3889,3890,3892,3894,3897,3899,3902,3904,3906,3908,3910],{"class":3363,"line":3389},[3361,3891,3878],{"class":3370},[3361,3893,3482],{"class":3431},[3361,3895,3896],{"class":3765}," MemOSClient",[3361,3898,3769],{"class":3407},[3361,3900,3901],{"class":3772},"api_key",[3361,3903,3482],{"class":3431},[3361,3905,3419],{"class":3418},[3361,3907,3438],{"class":3422},[3361,3909,3419],{"class":3418},[3361,3911,3849],{"class":3407},[3361,3913,3914],{"class":3363,"line":3395},[3361,3915,3392],{"emptyLinePlaceholder":45},[3361,3917,3918,3920,3922,3925,3927,3929],{"class":3363,"line":87},[3361,3919,3755],{"class":3370},[3361,3921,3482],{"class":3431},[3361,3923,3924],{"class":3370}," client",[3361,3926,3408],{"class":3407},[3361,3928,415],{"class":3765},[3361,3930,3931],{"class":3407},"(\n",[3361,3933,3934,3937,3939,3941,3943,3945],{"class":3363,"line":3444},[3361,3935,3936],{"class":3772},"    user_id",[3361,3938,3482],{"class":3431},[3361,3940,3419],{"class":3418},[3361,3942,51],{"class":3422},[3361,3944,3419],{"class":3418},[3361,3946,3506],{"class":3407},[3361,3948,3949,3952,3954,3956,3958,3960],{"class":3363,"line":3472},[3361,3950,3951],{"class":3772},"    profile_template_id",[3361,3953,3482],{"class":3431},[3361,3955,3419],{"class":3418},[3361,3957,404],{"class":3422},[3361,3959,3419],{"class":3418},[3361,3961,3506],{"class":3407},[3361,3963,3964,3967,3969],{"class":3363,"line":521},[3361,3965,3966],{"class":3772},"    metadata",[3361,3968,3482],{"class":3431},[3361,3970,3971],{"class":3407},"{\n",[3361,3973,3974,3976,3978,3980,3982],{"class":3363,"line":1174},[3361,3975,3575],{"class":3418},[3361,3977,3548],{"class":3422},[3361,3979,3419],{"class":3418},[3361,3981,3497],{"class":3407},[3361,3983,3485],{"class":3407},[3361,3985,3986,3989,3991,3993,3995],{"class":3363,"line":3509},[3361,3987,3988],{"class":3418},"            \"",[3361,3990,3563],{"class":3422},[3361,3992,3419],{"class":3418},[3361,3994,3497],{"class":3407},[3361,3996,3485],{"class":3407},[3361,3998,3999,4002,4004,4006,4008,4010,4012,4014],{"class":3363,"line":3528},[3361,4000,4001],{"class":3418},"                \"",[3361,4003,3578],{"class":3422},[3361,4005,3419],{"class":3418},[3361,4007,3497],{"class":3407},[3361,4009,3435],{"class":3418},[3361,4011,2172],{"class":3422},[3361,4013,3419],{"class":3418},[3361,4015,3506],{"class":3407},[3361,4017,4018,4020,4022,4024,4026],{"class":3363,"line":3542},[3361,4019,4001],{"class":3418},[3361,4021,3598],{"class":3422},[3361,4023,3419],{"class":3418},[3361,4025,3497],{"class":3407},[3361,4027,3606],{"class":3605},[3361,4029,4030],{"class":3363,"line":3557},[3361,4031,4032],{"class":3407},"            }\n",[3361,4034,4035],{"class":3363,"line":3572},[3361,4036,4037],{"class":3407},"        }\n",[3361,4039,4040],{"class":3363,"line":3593},[3361,4041,3618],{"class":3407},[3361,4043,4044],{"class":3363,"line":3609},[3361,4045,3849],{"class":3407},[3361,4047,4048,4050,4052,4054,4056,4058,4060,4062,4064],{"class":3363,"line":3615},[3361,4049,3822],{"class":3821},[3361,4051,3769],{"class":3407},[3361,4053,3827],{"class":3674},[3361,4055,3830],{"class":3422},[3361,4057,3682],{"class":3681},[3361,4059,3835],{"class":3765},[3361,4061,3702],{"class":3681},[3361,4063,3419],{"class":3422},[3361,4065,3849],{"class":3407},[3352,4067,4072],{"className":4068,"code":4069,"filename":4070,"language":4071,"meta":11,"style":11},"language-bash shiki shiki-themes material-theme-lighter github-light-high-contrast github-dark-default","curl --request POST \\\n  --url https:\u002F\u002Fmemos.memtensor.cn\u002Fapi\u002Fopenmem\u002Fv1\u002Fedit\u002Fprofile \\\n  --header 'Authorization: Token YOUR_API_KEY' \\\n  --header 'Content-Type: application\u002Fjson' \\\n  --data '{\n    \"user_id\": \"memos_user_123\",\n    \"profile_template_id\": \"tpl_user_001\",\n    \"metadata\": {\n      \"Basic Info\": {\n        \"Location\": {\n          \"value\": \"Shanghai\",\n          \"algorithm_updatable\": false\n        }\n      }\n    }\n  }'\n","Curl","bash",[589,4073,4074,4091,4101,4116,4129,4138,4143,4148,4153,4158,4163,4168,4173,4177,4181,4185],{"__ignoreMap":11},[3361,4075,4076,4080,4084,4087],{"class":3363,"line":296},[3361,4077,4079],{"class":4078},"saonL","curl",[3361,4081,4083],{"class":4082},"sp2SP"," --request",[3361,4085,4086],{"class":3422}," POST",[3361,4088,4090],{"class":4089},"seOsA"," \\\n",[3361,4092,4093,4096,4099],{"class":3363,"line":12},[3361,4094,4095],{"class":4082},"  --url",[3361,4097,4098],{"class":3422}," https:\u002F\u002Fmemos.memtensor.cn\u002Fapi\u002Fopenmem\u002Fv1\u002Fedit\u002Fprofile",[3361,4100,4090],{"class":4089},[3361,4102,4103,4106,4109,4112,4114],{"class":3363,"line":3381},[3361,4104,4105],{"class":4082},"  --header",[3361,4107,4108],{"class":3418}," '",[3361,4110,4111],{"class":3422},"Authorization: Token YOUR_API_KEY",[3361,4113,3693],{"class":3418},[3361,4115,4090],{"class":4089},[3361,4117,4118,4120,4122,4125,4127],{"class":3363,"line":3389},[3361,4119,4105],{"class":4082},[3361,4121,4108],{"class":3418},[3361,4123,4124],{"class":3422},"Content-Type: application\u002Fjson",[3361,4126,3693],{"class":3418},[3361,4128,4090],{"class":4089},[3361,4130,4131,4134,4136],{"class":3363,"line":3395},[3361,4132,4133],{"class":4082},"  --data",[3361,4135,4108],{"class":3418},[3361,4137,3971],{"class":3422},[3361,4139,4140],{"class":3363,"line":87},[3361,4141,4142],{"class":3422},"    \"user_id\": \"memos_user_123\",\n",[3361,4144,4145],{"class":3363,"line":3444},[3361,4146,4147],{"class":3422},"    \"profile_template_id\": \"tpl_user_001\",\n",[3361,4149,4150],{"class":3363,"line":3472},[3361,4151,4152],{"class":3422},"    \"metadata\": {\n",[3361,4154,4155],{"class":3363,"line":521},[3361,4156,4157],{"class":3422},"      \"Basic Info\": {\n",[3361,4159,4160],{"class":3363,"line":1174},[3361,4161,4162],{"class":3422},"        \"Location\": {\n",[3361,4164,4165],{"class":3363,"line":3509},[3361,4166,4167],{"class":3422},"          \"value\": \"Shanghai\",\n",[3361,4169,4170],{"class":3363,"line":3528},[3361,4171,4172],{"class":3422},"          \"algorithm_updatable\": false\n",[3361,4174,4175],{"class":3363,"line":3542},[3361,4176,4037],{"class":3422},[3361,4178,4179],{"class":3363,"line":3557},[3361,4180,3612],{"class":3422},[3361,4182,4183],{"class":3363,"line":3572},[3361,4184,3618],{"class":3422},[3361,4186,4187,4190],{"class":3363,"line":3593},[3361,4188,4189],{"class":3422},"  }",[3361,4191,4192],{"class":3418},"'\n",[4194,4195,4196],"style",{},"html pre.shiki code .sBMTB, html code.shiki .sBMTB{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#A0111F;--shiki-default-font-style:inherit;--shiki-dark:#FF7B72;--shiki-dark-font-style:inherit}html pre.shiki code .s5ojA, html code.shiki .s5ojA{--shiki-light:#90A4AE;--shiki-default:#0E1116;--shiki-dark:#E6EDF3}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}html pre.shiki code .suWxN, html code.shiki .suWxN{--shiki-light:#39ADB5;--shiki-default:#0E1116;--shiki-dark:#E6EDF3}html pre.shiki code .s5qkx, html code.shiki .s5qkx{--shiki-light:#E53935;--shiki-default:#0E1116;--shiki-dark:#E6EDF3}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 .saN0X, html code.shiki .saN0X{--shiki-light:#39ADB5;--shiki-default:#A0111F;--shiki-dark:#FF7B72}html pre.shiki code .smHB8, html code.shiki .smHB8{--shiki-light:#39ADB5;--shiki-default:#023B95;--shiki-dark:#79C0FF}html pre.shiki code .sZ6T4, html code.shiki .sZ6T4{--shiki-light:#9C3EDA;--shiki-default:#A0111F;--shiki-dark:#FF7B72}html pre.shiki code .scyET, html code.shiki .scyET{--shiki-light:#F76D47;--shiki-default:#A0111F;--shiki-dark:#FF7B72}html pre.shiki code .sa-2m, html code.shiki .sa-2m{--shiki-light:#6182B8;--shiki-default:#0E1116;--shiki-dark:#E6EDF3}html pre.shiki code .sp4zP, html code.shiki .sp4zP{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#702C00;--shiki-default-font-style:inherit;--shiki-dark:#FFA657;--shiki-dark-font-style:inherit}html pre.shiki code .svxCd, html code.shiki .svxCd{--shiki-light:#6182B8;--shiki-default:#023B95;--shiki-dark:#79C0FF}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 .saonL, html code.shiki .saonL{--shiki-light:#E2931D;--shiki-default:#702C00;--shiki-dark:#FFA657}html pre.shiki code .sp2SP, html code.shiki .sp2SP{--shiki-light:#91B859;--shiki-default:#023B95;--shiki-dark:#79C0FF}html pre.shiki code .seOsA, html code.shiki .seOsA{--shiki-light:#90A4AE;--shiki-default:#A0111F;--shiki-dark:#FF7B72}",{"title":11,"searchDepth":12,"depth":12,"links":4198},[],{},"\u002Fen\u002Fapi_docs\u002Fsnippets\u002Fedit_profile",{"description":11},"en\u002Fapi_docs\u002Fsnippets\u002Fedit_profile","MxRYJ9mEKmJiqiZ6G2dE2pvLYfXQZ--Vt8t_vi2CHSA",1784807341596]