SearchMemories - 搜索记忆-云监控(CMS)-阿里云帮助中心

根据查询条件和筛选项来搜索记忆。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

cms:SearchMemories

list

*MemoryStore

acs:cms:{#regionId}:{#accountId}:workspace/{#WorkspaceName}/memorystore/{#MemoryStoreName}

无

请求语法

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"
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。