Add documentation for EverOS memory API and OpenViking admin workflows
This commit is contained in:
77
docs/everos流程.txt
Normal file
77
docs/everos流程.txt
Normal file
@ -0,0 +1,77 @@
|
|||||||
|
输入user_id和session_id插入memories
|
||||||
|
curl -X POST "http://localhost:1995/api/v1/memories" \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d '{
|
||||||
|
"user_id": "user_001",
|
||||||
|
"session_id": "default",
|
||||||
|
"messages": [
|
||||||
|
{
|
||||||
|
"message_id": "msg_007",
|
||||||
|
"timestamp": 1778724000000,
|
||||||
|
"role": "user",
|
||||||
|
"content": "我喜欢喝拿铁，不喜欢美式。"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}'
|
||||||
|
|
||||||
|
{"data":{"request_id":"4535506c-26b6-4741-be62-3723db7a552c","message_count":1,"status":"accumulated","message":"Messages accepted"}
|
||||||
|
|
||||||
|
|
||||||
|
status=accumulated 表示先缓存了，等待边界检测；status=extracted 才表示已经触发记忆提取。
|
||||||
|
如果想强制触发总结/提取：调用 flush
|
||||||
|
|
||||||
|
|
||||||
|
curl -X POST "http://localhost:1995/api/v1/memories/flush" -H "Content-Type: application/json" -d '{
|
||||||
|
"user_id": "user_001",
|
||||||
|
"session_id": "default"
|
||||||
|
}'
|
||||||
|
|
||||||
|
{"data":{"request_id":"cc3e24be-9127-41aa-aefe-2ee80eacd054","status":"extracted","message":"Flush completed"}}
|
||||||
|
|
||||||
|
|
||||||
|
curl -X POST "http://localhost:1995/api/v1/memories/search" \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d '{
|
||||||
|
"query": "Tom 喜欢喝什么咖啡？",
|
||||||
|
"method": "hybrid",
|
||||||
|
"memory_types": ["episodic_memory", "profile"],
|
||||||
|
"filters": {
|
||||||
|
"user_id": "user_001"
|
||||||
|
},
|
||||||
|
"top_k": 10,
|
||||||
|
"include_original_data": true
|
||||||
|
}'
|
||||||
|
|
||||||
|
{"data":{"episodes":[],"profiles":[{"id":"6a058e72e0fcbba549ae94d8","user_id":"user_001","group_id":"gen_solo_669f08bf6134","profile_data":{"item_type":"explicit_info","embed_text":"饮食偏好: 喜欢喝拿铁，不喜欢美式咖啡"},"scenario":"solo","memcell_count":1,"score":0.7263925671577454}],"raw_messages":[],"agent_memory":null,"query":{"text":"Tom 喜欢喝什么咖啡？","method":"hybrid","filters_applied":{"user_id":"user_001"}},"original_data":{"episodes":{},"profiles":{}}}}
|
||||||
|
|
||||||
|
|
||||||
|
按用户/群组/时间拉取记忆：
|
||||||
|
curl -X POST "http://localhost:1995/api/v1/memories/get" \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d '{
|
||||||
|
"memory_type": "episodic_memory",
|
||||||
|
"filters": {
|
||||||
|
"user_id": "user_001"
|
||||||
|
},
|
||||||
|
"page": 1,
|
||||||
|
"page_size": 20,
|
||||||
|
"rank_by": "timestamp",
|
||||||
|
"rank_order": "desc"
|
||||||
|
}'
|
||||||
|
|
||||||
|
{"data":{"episodes":[{"id":"6a058e5de0fcbba549ae94d6","user_id":"user_001","group_id":"gen_solo_669f08bf6134","session_id":"default","timestamp":"2026-05-14T02:00:00Z","participants":["user_001"],"sender_ids":["user_001"],"summary":"2026年5月14日（星期四）凌晨02:00 UTC，汤姆明确表达了自己的咖啡偏好。他陈述喜爱饮用拿铁咖啡，同时明确表示不偏好美式咖啡。","subject":"汤姆于2026年5月14日凌晨表达咖啡口味偏好","episode":"2026年5月14日（星期四）凌晨02:00 UTC，汤姆明确表达了自己的咖啡偏好。他陈述喜爱饮用拿铁咖啡，同时明确表示不偏好美式咖啡。","type":"Conversation","parent_type":"memcell","parent_id":"6a058e46e0fcbba549ae94d3"}],"profiles":[],"agent_cases":[],"agent_skills":[],"total_count":1,"count":1}}
|
||||||
|
|
||||||
|
|
||||||
|
查 profile 画像：
|
||||||
|
(OpenViking) tom@tom:~$ curl -X POST "http://localhost:1995/api/v1/memories/get" \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d '{
|
||||||
|
"memory_type": "profile",
|
||||||
|
"filters": {
|
||||||
|
"user_id": "user_001"
|
||||||
|
},
|
||||||
|
"page": 1,
|
||||||
|
"page_size": 20
|
||||||
|
}'
|
||||||
|
|
||||||
|
{"data":{"episodes":[],"profiles":[{"id":"6a058e71e0fcbba549ae94d7","user_id":"user_001","group_id":"gen_solo_669f08bf6134","profile_data":{"id":null,"memory_type":"profile","user_id":"user_001","user_name":null,"timestamp":"2026-05-14T08:57:00.574433+00:00","group_id":"gen_solo_669f08bf6134","explicit_info":[{"category":"饮食偏好","description":"喜欢喝拿铁，不喜欢美式咖啡","evidence":"2026年5月14日用户明确表示“我喜欢喝拿铁，不喜欢美式。”","sources":["6a058e46e0fcbba549ae94d3"]}],"implicit_traits":[],"last_updated":"2026-05-14T08:57:21.222404+00:00","processed_episode_ids":["6a058e46e0fcbba549ae94d3"]},"scenario":"solo","memcell_count":1}],"agent_cases":[],"agent_skills":[],"total_count":1,"count":1}}
|
||||||
71
docs/memory system api.txt
Normal file
71
docs/memory system api.txt
Normal file
@ -0,0 +1,71 @@
|
|||||||
|
创建用户
|
||||||
|
curl -sS -X POST "http://localhost:1934/memory-system/users" \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d '{"user_id":"userC"}'
|
||||||
|
|
||||||
|
{"status":"success","account":{"status":"ok","result":{"account_id":"userC_account","admin_user_id":"userC","isolate_user_scope_by_agent":false,"isolate_agent_scope_by_user":false,"user_key":"dXNlckNfYWNjb3VudA.dXNlckM.ZDFlMGI2OWI0NzZkZmZiMGExOWFlNGQ2N2JjYzMxNTg4NzVjZmNhN2Q4MTYwYmU1NGE4YWZjZTdjYzliMDI3NQ"},"error":null,"telemetry":null,"profile":null},"backends":{"openviking":{"status":"success","result":{"status":"ok","result":{"account_id":"userC_account","admin_user_id":"userC","isolate_user_scope_by_agent":false,"isolate_agent_scope_by_user":false,"user_key":"dXNlckNfYWNjb3VudA.dXNlckM.ZDFlMGI2OWI0NzZkZmZiMGExOWFlNGQ2N2JjYzMxNTg4NzVjZmNhN2Q4MTYwYmU1NGE4YWZjZTdjYzliMDI3NQ"},"error":null,"telemetry":null,"profile":null},"error":null}}}
|
||||||
|
|
||||||
|
插入信息
|
||||||
|
curl -sS -X POST "http://localhost:1934/memory-system/messages" \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d '{
|
||||||
|
"user_id": "userC",
|
||||||
|
"user_key": "dXNlckNfYWNjb3VudA.dXNlckM.ZDFlMGI2OWI0NzZkZmZiMGExOWFlNGQ2N2JjYzMxNTg4NzVjZmNhN2Q4MTYwYmU1NGE4YWZjZTdjYzliMDI3NQ",
|
||||||
|
"session_id": "sessionC1",
|
||||||
|
"user_message": "我喜欢拿铁。",
|
||||||
|
"assistant_message": "好的，我记住了。"
|
||||||
|
}'
|
||||||
|
|
||||||
|
存储记忆
|
||||||
|
curl -sS -X POST "http://localhost:1934/memory-system/sessions/sessionC1/commit" \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d '{
|
||||||
|
"user_id": "userC",
|
||||||
|
"user_key": "dXNlckNfYWNjb3VudA.dXNlckM.ZDFlMGI2OWI0NzZkZmZiMGExOWFlNGQ2N2JjYzMxNTg4NzVjZmNhN2Q4MTYwYmU1NGE4YWZjZTdjYzliMDI3NQ"
|
||||||
|
}'
|
||||||
|
|
||||||
|
全局搜索
|
||||||
|
curl -sS -X POST "http://localhost:1934/memory-system/search" \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d '{
|
||||||
|
"user_id": "userC",
|
||||||
|
"user_key": "dXNlckNfYWNjb3VudA.dXNlckM.ZDFlMGI2OWI0NzZkZmZiMGExOWFlNGQ2N2JjYzMxNTg4NzVjZmNhN2Q4MTYwYmU1NGE4YWZjZTdjYzliMDI3NQ",
|
||||||
|
"session_id": "sessionC1",
|
||||||
|
"query": "大语言模型应用是什么",
|
||||||
|
"limit": 10,
|
||||||
|
"level": 2,
|
||||||
|
"score_threshold": 0.8
|
||||||
|
}' | jq .
|
||||||
|
|
||||||
|
curl -s -X POST http://localhost:1933/api/v1/search/search \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-H "Authorization: Bearer 3f7a4b4faae1e2d49583a0e45d9ba5b51f3d0f545d97c9b6c4f19171f717e8af" \
|
||||||
|
-d '{
|
||||||
|
"query": "大语言模型应用是什么",
|
||||||
|
"level": 2
|
||||||
|
}' | jq .
|
||||||
|
|
||||||
|
会话查询
|
||||||
|
curl -sS -X POST "http://localhost:1934/memory-system/sessions/sessionB1/context" \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d '{
|
||||||
|
"user_id": "userB",
|
||||||
|
"user_key": "1e5f24acba77017e7506e6df9d668aebc0ddc91c4ed9af77c6d8da5e9d4ed6c7",
|
||||||
|
"query": "我喜欢喝什么？",
|
||||||
|
"limit": 10
|
||||||
|
}' | jq .
|
||||||
|
|
||||||
|
用户画像查询
|
||||||
|
curl -sS -X POST "http://localhost:1934/memory-system/users/userB/profile" \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d '{
|
||||||
|
"user_key": "1e5f24acba77017e7506e6df9d668aebc0ddc91c4ed9af77c6d8da5e9d4ed6c7",
|
||||||
|
"query": "我想喝东西",
|
||||||
|
"limit": 10,
|
||||||
|
"level": 2
|
||||||
|
}' | jq .
|
||||||
|
|
||||||
|
上传文件
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
215
docs/openviking流程.txt
Normal file
215
docs/openviking流程.txt
Normal file
@ -0,0 +1,215 @@
|
|||||||
|
创建admin工作区
|
||||||
|
curl -X POST http://127.0.0.1:1933/api/v1/admin/accounts -H "X-API-Key: your-secret-root-key" -H "Content-Type: application/json" -d '{"account_id": "userB_account", "admin_user_id": "userB"}'
|
||||||
|
|
||||||
|
{"status":"ok","result":{"account_id":"userA_account","admin_user_id":"userA","isolate_user_scope_by_agent":false,"isolate_agent_scope_by_user":false,"user_key":"dXNlckFfYWNjb3VudA.dXNlckE.OGU4NzczZmQ2ZDExNjNhMWI4OTg2MWZkZTk5OTcyODlhNmM2ZTZjNDNmOGJkMWRiZDk2M2QyNTdhYTZmMTFlYQ"},"error":null,"telemetry":null,"profile":null}
|
||||||
|
|
||||||
|
{"status":"ok","result":{"account_id":"userB_account","admin_user_id":"userB","isolate_user_scope_by_agent":false,"isolate_agent_scope_by_user":false,"user_key":"dXNlckJfYWNjb3VudA.dXNlckI.YzZiNDZjMjJiZWMwNTM1OTBiOGEwMzAyOTFhZGMxZWQ4MTJhZDNhMmM5ZjJjZGYxMDI1YTkxZDVlMWY2M2M5MA"},"error":null,"telemetry":null,"profile":null}
|
||||||
|
|
||||||
|
创建用户
|
||||||
|
curl -X POST http://127.0.0.1:1933/api/v1/admin/accounts/admin/users -H "X-API-Key: your-secret-root-key" -H "Content-Type: application/json" -d '{"user_id": "userA", "role": "user"}'
|
||||||
|
|
||||||
|
userA
|
||||||
|
{"status":"ok","result":{"account_id":"admin","user_id":"userA","user_key":"3f7a4b4faae1e2d49583a0e45d9ba5b51f3d0f545d97c9b6c4f19171f717e8af"},"error":null,"telemetry":null}
|
||||||
|
|
||||||
|
userB
|
||||||
|
{"status":"ok","result":{"account_id":"admin","user_id":"userB","user_key":"3a017f01d1f9cddeec2b4832b4b3cb60b004ff27ec76505d72b24104412015c8"},"error":null,"telemetry":null}
|
||||||
|
|
||||||
|
|
||||||
|
创建session
|
||||||
|
userA
|
||||||
|
curl -X POST http://127.0.0.1:1933/api/v1/sessions \
|
||||||
|
-H "X-API-Key: dXNlckFfYWNjb3VudA.dXNlckE.OGU4NzczZmQ2ZDExNjNhMWI4OTg2MWZkZTk5OTcyODlhNmM2ZTZjNDNmOGJkMWRiZDk2M2QyNTdhYTZmMTFlYQ" \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d '{"session_id":"sessionA1"}'
|
||||||
|
|
||||||
|
A1
|
||||||
|
{"status":"ok","result":{"session_id":"238a22c1-a32a-4a3a-a174-2112d476173b","user":{"account_id":"admin","user_id":"userA","agent_id":"default"}},"error":null,"telemetry":null}
|
||||||
|
|
||||||
|
A2
|
||||||
|
{"status":"ok","result":{"session_id":"d20cede5-30ba-4d98-81f9-d74ee83bb071","user":{"account_id":"admin","user_id":"userA","agent_id":"default"}},"error":null,"telemetry":null}
|
||||||
|
|
||||||
|
B1
|
||||||
|
{"status":"ok","result":{"session_id":"654248bf-c36f-4a61-9fe8-de8f207d5227","user":{"account_id":"admin","user_id":"userB","agent_id":"default"}},"error":null,"telemetry":null}
|
||||||
|
|
||||||
|
B2
|
||||||
|
{"status":"ok","result":{"session_id":"c567601c-28e8-4b3d-be10-c95c909b374e","user":{"account_id":"admin","user_id":"userB","agent_id":"default"}},"error":null,"telemetry":null}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
对话session插入massage
|
||||||
|
userA A1
|
||||||
|
curl -X POST http://localhost:1933/api/v1/sessions/sessionA1/messages \
|
||||||
|
-H "X-API-Key: dXNlckFfYWNjb3VudA.dXNlckE.OGU4NzczZmQ2ZDExNjNhMWI4OTg2MWZkZTk5OTcyODlhNmM2ZTZjNDNmOGJkMWRiZDk2M2QyNTdhYTZmMTFlYQ" \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d '{
|
||||||
|
"role": "user",
|
||||||
|
"content": "我喜欢用 Python 写数据分析脚本。"
|
||||||
|
}'
|
||||||
|
|
||||||
|
{"status":"ok","result":{"session_id":"sessionA1","message_count":1},"error":null,"telemetry":null}
|
||||||
|
|
||||||
|
curl -X POST http://localhost:1933/api/v1/sessions/sessionA1/messages \
|
||||||
|
-H "X-API-Key: dXNlckFfYWNjb3VudA.dXNlckE.OGU4NzczZmQ2ZDExNjNhMWI4OTg2MWZkZTk5OTcyODlhNmM2ZTZjNDNmOGJkMWRiZDk2M2QyNTdhYTZmMTFlYQ" \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d '{
|
||||||
|
"role": "assistant",
|
||||||
|
"content": "好的，我会记住你偏好 Python 数据分析。"
|
||||||
|
}'
|
||||||
|
{"status":"ok","result":{"session_id":"sessionA1","message_count":2},"error":null,"telemetry":null}
|
||||||
|
|
||||||
|
|
||||||
|
userB B1
|
||||||
|
curl -X POST http://localhost:1933/api/v1/sessions/sessionB1/messages \
|
||||||
|
-H "Authorization: Bearer 1e5f24acba77017e7506e6df9d668aebc0ddc91c4ed9af77c6d8da5e9d4ed6c7" \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d '{
|
||||||
|
"role": "user",
|
||||||
|
"content": "我还想喝咖啡，咖啡有力气"
|
||||||
|
}'
|
||||||
|
{"status":"ok","result":{"session_id":"sessionB1","message_count":1},"error":null,"telemetry":null}
|
||||||
|
|
||||||
|
curl -X POST http://localhost:1933/api/v1/sessions/sessionB1/messages \
|
||||||
|
-H "Authorization: Bearer 1e5f24acba77017e7506e6df9d668aebc0ddc91c4ed9af77c6d8da5e9d4ed6c7" \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d '{
|
||||||
|
"role": "assistant",
|
||||||
|
"content": "黑咖啡品味很浓，很有力气。"
|
||||||
|
}'
|
||||||
|
{"status":"ok","result":{"session_id":"sessionB1","message_count":2},"error":null,"telemetry":null}
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
对话session插入memory
|
||||||
|
userA A1
|
||||||
|
curl -X POST http://localhost:1933/api/v1/sessions/sessionA1/commit \
|
||||||
|
-H "X-API-Key: dXNlckFfYWNjb3VudA.dXNlckE.OGU4NzczZmQ2ZDExNjNhMWI4OTg2MWZkZTk5OTcyODlhNmM2ZTZjNDNmOGJkMWRiZDk2M2QyNTdhYTZmMTFlYQ"
|
||||||
|
|
||||||
|
{"status":"ok","result":{"session_id":"sessionA1","status":"accepted","task_id":"1b93fcde-0944-42ad-a819-4241faf0048f","archive_uri":"viking://session/sessionA1/history/archive_001","archived":true,"trace_id":""}}
|
||||||
|
|
||||||
|
userB B1
|
||||||
|
curl -X POST http://localhost:1933/api/v1/sessions/sessionB1/commit \
|
||||||
|
-H "Authorization: Bearer 1e5f24acba77017e7506e6df9d668aebc0ddc91c4ed9af77c6d8da5e9d4ed6c7" \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d '{"keep_recent_count":0}'
|
||||||
|
{"status":"ok","result":{"session_id":"sessionB1","status":"accepted","task_id":"cd98a696-ac6f-4f0c-8187-6e824f5ebcbc","archive_uri":"viking://session/userB/sessionB1/history/archive_001","archived":true}}
|
||||||
|
|
||||||
|
查询插入结果
|
||||||
|
userA A1
|
||||||
|
curl http://localhost:1933/api/v1/tasks/1b93fcde-0944-42ad-a819-4241faf0048f \
|
||||||
|
-H "X-API-Key: dXNlckFfYWNjb3VudA.dXNlckE.OGU4NzczZmQ2ZDExNjNhMWI4OTg2MWZkZTk5OTcyODlhNmM2ZTZjNDNmOGJkMWRiZDk2M2QyNTdhYTZmMTFlYQ"
|
||||||
|
|
||||||
|
{"status":"ok","result":{"task_id":"1b93fcde-0944-42ad-a819-4241faf0048f","task_type":"session_commit","status":"completed","created_at":1779855851.700087,"updated_at":1779855866.0683796,"resource_id":"sessionA1","result":{"session_id":"sessionA1","archive_uri":"viking://session/sessionA1/history/archive_001","memories_extracted":{"memory_write":1},"session_skills_extracted":0,"session_skill_uris":[],"active_count_updated":0,"token_usage":{"llm":{"prompt_tokens":7883,"completion_tokens":437,"total_tokens":8320},"embedding":{"total_tokens":49},"total":{"total_tokens":8369}}},"error":null,"created_at_iso":"2026-05-27T04:24:11.700087+00:00","updated_at_iso":"2026-05-27T04:24:26.068380+00:00"},"error":null,"telemetry":null,"profile":null}
|
||||||
|
|
||||||
|
|
||||||
|
userB B1
|
||||||
|
curl http://localhost:1933/api/v1/tasks/cd98a696-ac6f-4f0c-8187-6e824f5ebcbc \
|
||||||
|
-H "Authorization: Bearer 3a017f01d1f9cddeec2b4832b4b3cb60b004ff27ec76505d72b24104412015c8"
|
||||||
|
{"status":"ok","result":{"task_id":"cd98a696-ac6f-4f0c-8187-6e824f5ebcbc","task_type":"session_commit","status":"running","created_at":1779418133.2990522,"updated_at":1779418133.2993288,"resource_id":"sessionB1","result":null,"error":null},"error":null,"telemetry":null}
|
||||||
|
|
||||||
|
|
||||||
|
向量搜索用户memory
|
||||||
|
curl -X POST http://localhost:1933/api/v1/search/find \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-H "X-API-Key: dXNlckFfYWNjb3VudA.dXNlckE.OGU4NzczZmQ2ZDExNjNhMWI4OTg2MWZkZTk5OTcyODlhNmM2ZTZjNDNmOGJkMWRiZDk2M2QyNTdhYTZmMTFlYQ" \
|
||||||
|
-d '{
|
||||||
|
"query": "我之前说了什么",
|
||||||
|
"limit": 3
|
||||||
|
}' | jq .
|
||||||
|
|
||||||
|
{"status":"ok","result":{"memories":[{"context_type":"memory","uri":"viking://user/userA/memories/preferences/mem_d49a95a2-8491-40bb-b0d3-4cf4c16d3de8.md","level":2,"score":0.7411142547036441,"category":"","match_reason":"","relations":[],"abstract":"Python 数据分析：偏好使用 Python 编写数据分析脚本","overview":null},{"context_type":"memory","uri":"viking://user/userA/memories/preferences/.abstract.md","level":0,"score":0.6752108627461267,"category":"","match_reason":"","relations":[],"abstract":"This directory contains a single user preference document that captures a specific behavioral attribute regarding tool choice for data analysis. The document is a lightweight, non-technical profile note intended to record that the user prefers writing d...","overview":null},{"context_type":"memory","uri":"viking://user/userA/memories/.overview.md","level":1,"score":0.6262621398392979,"category":"","match_reason":"","relations":[],"abstract":"User's long-term memory storage. Contains memory types like preferences, entities, events, managed hierarchically by type.","overview":null}],"resources":[],"skills":[],"total":3}}
|
||||||
|
|
||||||
|
|
||||||
|
LLM搜索用户session memory
|
||||||
|
|
||||||
|
curl -s -X POST http://localhost:1933/api/v1/search/search \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-H "X-API-Key: dXNlckFfYWNjb3VudA.dXNlckE.OGU4NzczZmQ2ZDExNjNhMWI4OTg2MWZkZTk5OTcyODlhNmM2ZTZjNDNmOGJkMWRiZDk2M2QyNTdhYTZmMTFlYQ" \
|
||||||
|
-d '{
|
||||||
|
"query": "我正在做什么",
|
||||||
|
"limit": 10,
|
||||||
|
"level": 2
|
||||||
|
}' | jq .
|
||||||
|
|
||||||
|
{
|
||||||
|
"status": "ok",
|
||||||
|
"result": {
|
||||||
|
"memories": [],
|
||||||
|
"resources": [],
|
||||||
|
"skills": [],
|
||||||
|
"total": 0,
|
||||||
|
"query_plan": {
|
||||||
|
"reasoning": "1. Conversational task (user asking '我正在做什么' - 'What am I doing?'); 2. This is a simple conversational query about current state/activity; 3. The session context contains the user's previous interactions about Python preferences and EverOS API questions; 4. No specific context gaps need to be filled for this conversational task, but a memory query about the user's current activity context could help provide a more personalized response",
|
||||||
|
"queries": [
|
||||||
|
{
|
||||||
|
"query": "User's current activity and task context",
|
||||||
|
"context_type": "memory",
|
||||||
|
"intent": "Understand what the user is currently working on to provide relevant context",
|
||||||
|
"priority": 3
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
curl -X GET "http://localhost:1933/api/v1/sessions/sessionA1" \
|
||||||
|
-H "X-API-Key: dXNlckFfYWNjb3VudA.dXNlckE.OGU4NzczZmQ2ZDExNjNhMWI4OTg2MWZkZTk5OTcyODlhNmM2ZTZjNDNmOGJkMWRiZDk2M2QyNTdhYTZmMTFlYQ"
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
组装 session 上下文
|
||||||
|
curl -X GET "http://localhost:1933/api/v1/sessions/{session_id}/context" \
|
||||||
|
-H "X-API-Key: user key"
|
||||||
|
|
||||||
|
curl -X GET "http://localhost:1933/api/v1/sessions/sessionA1/context" \
|
||||||
|
-H "X-API-Key: dXNlckFfYWNjb3VudA.dXNlckE.OGU4NzczZmQ2ZDExNjNhMWI4OTg2MWZkZTk5OTcyODlhNmM2ZTZjNDNmOGJkMWRiZDk2M2QyNTdhYTZmMTFlYQ" | jq .
|
||||||
|
|
||||||
|
获取指定 archive
|
||||||
|
|
||||||
|
curl -X GET "http://localhost:1933/api/v1/sessions/sessionA1/archives/archive_001" \
|
||||||
|
-H "X-API-Key: dXNlckFfYWNjb3VudA.dXNlckE.OGU4NzczZmQ2ZDExNjNhMWI4OTg2MWZkZTk5OTcyODlhNmM2ZTZjNDNmOGJkMWRiZDk2M2QyNTdhYTZmMTFlYQ" | jq .
|
||||||
|
|
||||||
|
curl -sG "http://localhost:1933/api/v1/fs/ls" \
|
||||||
|
--data-urlencode "uri=viking://user/alice1/memories/preferences/" \
|
||||||
|
--data-urlencode "recursive=true" \
|
||||||
|
-H "X-API-Key: 1d1a4d61838f67d808230b19ed1b6b4ce647f073ea33ee005ed3b9b24f35b978" | jq
|
||||||
|
|
||||||
|
|
||||||
|
上传临时文件
|
||||||
|
curl -s -X POST http://localhost:1933/api/v1/resources/temp_upload \
|
||||||
|
-H "X-API-Key: dXNlckFfYWNjb3VudA.dXNlckE.OGU4NzczZmQ2ZDExNjNhMWI4OTg2MWZkZTk5OTcyODlhNmM2ZTZjNDNmOGJkMWRiZDk2M2QyNTdhYTZmMTFlYQ" \
|
||||||
|
-F "file=@/home/tom/memory-gateway/tests/大语言模型应用.pdf" \
|
||||||
|
| jq .
|
||||||
|
|
||||||
|
{
|
||||||
|
"status": "ok",
|
||||||
|
"result": {
|
||||||
|
"temp_file_id": "upload_89b818fa75114b35a5b2c55263dee8ff.pdf"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
上传图片
|
||||||
|
curl -X POST http://localhost:1933/api/v1/resources \
|
||||||
|
-H "X-API-Key: dXNlckFfYWNjb3VudA.dXNlckE.OGU4NzczZmQ2ZDExNjNhMWI4OTg2MWZkZTk5OTcyODlhNmM2ZTZjNDNmOGJkMWRiZDk2M2QyNTdhYTZmMTFlYQ" \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d '{
|
||||||
|
"temp_file_id": "upload_89b818fa75114b35a5b2c55263dee8ff.pdf",
|
||||||
|
"to": "viking://resources/userA/files/大语言模型应用.pdf",
|
||||||
|
"reason": "userA 上传的文件",
|
||||||
|
"wait": true,
|
||||||
|
"directly_upload_media": true
|
||||||
|
}'
|
||||||
|
|
||||||
|
|
||||||
|
curl -X POST http://localhost:1933/api/v1/resources \
|
||||||
|
-H "X-API-Key: dXNlckFfYWNjb3VudA.dXNlckE.OGU4NzczZmQ2ZDExNjNhMWI4OTg2MWZkZTk5OTcyODlhNmM2ZTZjNDNmOGJkMWRiZDk2M2QyNTdhYTZmMTFlYQ" \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-d '{
|
||||||
|
"temp_file_id": "upload_89b818fa75114b35a5b2c55263dee8ff.pdf",
|
||||||
|
"to": "viking://resources/userA/files/大语言模型应用.pdf",
|
||||||
|
"reason": "userA 上传的文件",
|
||||||
|
"wait": true,
|
||||||
|
"directly_upload_media": true
|
||||||
|
}'
|
||||||
|
|
||||||
|
|
||||||
Reference in New Issue
Block a user