Overview
Simultaneously searches memory and experience within the current space, fusing vector retrieval and FTS results using RRF (Reciprocal Rank Fusion). The response's data.memories[].metadata field includes scoring details such as _vector_similarity and _fusion_info.
API details
Constraints
- You must have an API Key. For more information, see Manage AI API Keys.
Request path
POST {BASE_URL}/api/v1/memory/spaces/{spaceId}/memories/search
Request headers
Name |
Required |
Example Value |
Description |
|---|---|---|---|
| Authorization | Yes | Bearer {token} | Authentication Information |
| Content-Type | No | application/json | Request Body Format |
| X-OB-Project-ID | Yes | - | Project ID |
Request parameters
Path parameters
Name |
Type |
Whether required |
Example Value |
Description |
|---|---|---|---|---|
| spaceId | string | Yes | space-123 | Memory space ID. |
Body parameters
Name |
Type |
Whether required |
Example Value |
Description |
|---|---|---|---|---|
| query | string | Yes | How do I optimize slow SQL queries? | Natural language query. |
Response parameters
Response parameters
Name |
Type |
Description |
|---|---|---|
| success | boolean | Whether the request was successful |
| code | string | Response Code |
| message | string | Response parameters |
| data | object | Business response data |
Data fields
Name |
Type |
Description |
|---|---|---|
| memories | array | The retrieval result list, where each item includes themetadataThe field will contain_vector_similarity、_fusion_infoand other scoring details. |
Request example
curl --request POST '{BASE_URL}/api/v1/memory/spaces/{spaceId}/memories/search' \
--header 'Authorization: Bearer {token}' \
--header 'X-OB-Project-ID: {projectId}' \
--header 'Content-Type: application/json' \
--data '{
"query": "Search content"
}'
Response example
{
"success": true,
"code": "200",
"message": "successful",
"data": {
"memories": [
{
"id": "mem-123",
"content": "Related memory content",
"metadata": {
"_vector_similarity": 0.95,
"_fusion_info": "..."
}
}
]
}
}