Skip to main content
记忆片段

搜索记忆

基于语义检索返回与查询最相关的历史记忆

POST
/memory_nodes/search
cURL
curl --request POST \
  --url 'https://dashscope.aliyuncs.com/api/v2/apps/memory/memory_nodes/search' \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "user_id": "<string>",
  "query": "<string>",
  "max_results": 0,
  "rewrite": false,
  "rerank": false,
  "similarity_threshold": 0,
  "plan_version": "Pro"
}
'
{
  "request_id": "<string>",
  "memory_nodes": [
    {
      "memory_node_id": "<string>",
      "content": "<string>"
    }
  ]
}
基于语义检索返回与当前查询最相关的历史记忆。支持查询改写、结果重排和相似度过滤。

请求参数

参数类型必填说明
user_idstring记忆实体 ID
querystring检索查询语句
max_resultsnumber最大返回数量(1~100)
rewriteboolean是否改写查询以提升准确率
rerankboolean是否对结果重排
similarity_thresholdnumber相似度阈值(0.01.0),建议 0.50.7
plan_versionstringProLite,不传默认 Pro。优先级高于 rerank
Pro 版开启 Rerank,检索质量更高;Lite 版关闭 Rerank,成本更低。详见计费说明

代码示例

curl -X POST https://dashscope.aliyuncs.com/api/v2/apps/memory/memory_nodes/search \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "user_id": "user_001",
    "query": "我需要做什么?",
    "max_results": 10,
    "rewrite": true,
    "rerank": true,
    "similarity_threshold": 0.6
  }'

# response
{
  "memory_nodes": [
    {"content": "用户每天上午9点需要喝水提醒", "memory_node_id": "50b46e97..."},
    {"content": "用户明天10点需要整理会议纪要", "memory_node_id": "381cc694..."}
  ],
  "request_id": "a1b2c3d4-..."
}
查看所有记忆使用 ListMemory

Authorizations

string
header
required

Body

application/json
string
required

记忆实体 ID

string
required

检索查询语句

integer

最大返回数量(1~100)

boolean

是否改写查询

boolean

是否对结果重排

number

相似度阈值(0.0~1.0),建议 0.5~0.7

enum<string>

策略版本,不传默认 Pro

Pro,Lite

Response

200-application/json
string
object[]
Managed Agent API
Sandbox API
Flow Agent API
RAG API
Connector API
框架集成
  • 框架
Assistant API(下线中)
  • 概览