根据查询条件和筛选项来搜索记忆。
接口说明
本文将提供一个示例，为云服务器 ECS acs_ecs_dashboard的实例i-uf6j91r34rnwawoo****中的监控项cpu_total设置阈值报警规则。该报警规则的报警联系组为ECS_Group、报警规则名称为test123、报警规则 ID 为a151cd6023eacee2f0978e03863cc1697c89508****、Critical 级别的统计方法为Average、Critical 级别的比较符为GreaterThanOrEqualToThreshold、Critical 级别的阈值为90和 Critical 级别的报警重试次数为3。
2024-08-15 增加 Statistics 校验，统计值只能填对应指标的 Statistics。关于如何获取该参数的取值，请参见云产品监控项。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
POST /workspace/{workspace}/memorystore/{memoryStoreName}/memory/search HTTP/1.1路径参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| workspace |
string |
是 |
工作空间名称 |
workspace-test |
| memoryStoreName |
string |
是 |
内存库名称 |
qianyi_test_1 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| body |
object |
否 |
请求 body |
|
| query |
string |
否 |
查询内容 |
What I like |
| userId |
string |
否 |
用户 Id |
test_session_001 |
| topK |
integer |
否 |
返回结果的 Top-K 条目 |
1 |
| agentId |
string |
否 |
代理标识号 |
972772996913709056 |
| appId |
string |
否 |
商户分配的项目的 appkey |
mm_480d961a1b5e4efe84603f4cbc0f |
| runId |
string |
否 |
运行 id |
test_session_001 |
| rerank |
boolean |
否 |
重新排序 |
true |
| filters |
object |
否 |
过滤条件 |
|
|
any |
否 |
过滤条件 |
{"__strategy_type__":"Fact"} |
|
| threshold |
number |
否 |
相似度阈值 |
0.3 |
| retrievalOption |
string |
否 |
检索选项 |
reranker,llm_rank |
| searchType |
string |
否 |
查询类型 |
experience |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
响应数据 |
||
| results |
array<object> |
返回值 |
|
|
array<object> |
返回值 |
||
| actorId |
string |
操作者 Id |
test_session_001 |
| agentId |
string |
应用的 agentId |
972772996913709056 |
| createdAt |
string |
创建时间 |
1762773128968 |
| hash |
string |
记忆哈希值 |
d791bf27236c5532056a13279baad3517042bb8d5b1bdb02e7871fa632debffe |
| id |
string |
记忆 Id |
019ca1e5-7307-7d50-b943-5e628326a8ed |
| memory |
string |
记忆 |
My name is Zhang San and I live in Hangzhou. |
| metadata |
object |
元数据 |
{"__strategy_type__":"Fact"} |
|
any |
元数据 |
{"__strategy_type__":"Fact"} |
|
| role |
string |
消息发起角色 |
user |
| runId |
string |
运行 id |
test_session_001 |
| score |
number |
相似性分数 |
13.21 |
| updatedAt |
string |
更新时间 |
1764902557784 |
| userId |
string |
用户 Id |
test_session_001 |
| relations |
array<object> |
关系 |
|
|
object |
关系 |
||
| destination |
string |
目标 |
test |
| relationship |
string |
关系 |
test |
| source |
string |
源 |
todo_open_dingoj06pvqfeayy3lkr |
| requestId |
string |
请求 ID。 |
0CEC5375-C554-562B-A65F-9A629907C1F0 |
示例
正常返回示例
JSON格式
{
"results": [
{
"actorId": "test_session_001",
"agentId": "972772996913709056",
"createdAt": "1762773128968",
"hash": "d791bf27236c5532056a13279baad3517042bb8d5b1bdb02e7871fa632debffe",
"id": "019ca1e5-7307-7d50-b943-5e628326a8ed",
"memory": "My name is Zhang San and I live in Hangzhou.",
"metadata": {
"key": "{\"__strategy_type__\":\"Fact\"}"
},
"role": "user",
"runId": "test_session_001",
"score": 13.21,
"updatedAt": "1764902557784",
"userId": "test_session_001"
}
],
"relations": [
{
"destination": "test",
"relationship": "test",
"source": "todo_open_dingoj06pvqfeayy3lkr"
}
],
"requestId": "0CEC5375-C554-562B-A65F-9A629907C1F0"
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。