機能の概要
現在のスペース内でメモリとエクスペリエンスを同時に検索し、RRF（Reciprocal Rank Fusion）によってベクトル検索とFTSの結果を統合します。応答の data.memories[].metadata には、_vector_similarity や _fusion_info などの評価詳細が含まれます。
呼び出しの説明
インターフェース制約
- 呼び出し元はAPIキーを保有している必要があります。詳細については、AI APIキーの管理をご参照ください。
リクエストパス
POST {BASE_URL}/api/v1/memory/spaces/{spaceId}/memories/search
リクエストヘッダー
名前 |
必須 |
サンプル値 |
説明 |
|---|---|---|---|
| Authorization | はい | Bearer {token} | 認証情報 |
| Content-Type | いいえ | application/json | リクエストボディの形式 |
| X-OB-Project-ID | はい | - | プロジェクトID |
リクエストパラメータ
Pathパラメータ
名前 |
型 |
必須 |
サンプル値 |
説明 |
|---|---|---|---|---|
| spaceId | string | はい | space-123 | メモリースペースID。 |
Bodyパラメータ
名前 |
型 |
必須 |
サンプル値 |
説明 |
|---|---|---|---|---|
| query | string | はい | スローSQLを最適化する方法は？ | 自然言語クエリ。 |
実行結果
レスポンスパラメータ
名前 |
型 |
説明 |
|---|---|---|
| success | boolean | リクエストが成功したかどうか |
| code | string | 戻り値コード |
| message | string | 返されるメッセージ |
| data | object | ビジネスが返すデータ |
dataフィールドの説明
名前 |
型 |
説明 |
|---|---|---|
| memories | array | 検索結果のリストです。各結果項目のmetadataフィールドには、_vector_similarityや_fusion_infoなどの評価詳細が含まれます。 |
リクエスト例
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": "検索内容"
}'
レスポンス例
{
"success": true,
"code": "200",
"message": "successful",
"data": {
"memories": [
{
"id": "mem-123",
"content": "関連する記憶内容",
"metadata": {
"_vector_similarity": 0.95,
"_fusion_info": "..."
}
}
]
}
}