Search Agentic Memory API

출처: 문서

본문

Agentic Memory API 검색

3.3에 도입됨 {: .label .label-purple }

이 API를 사용하여 메모리 컨테이너 내에서 특정 유형의 메모리를 검색합니다. 이 통합 API는 sessions, working, long-term, history 메모리 유형 검색을 지원합니다.

엔드포인트

GET /_plugins/_ml/memory_containers/{memory_container_id}/memories/{type}/_search

경로 매개변수

다음 표에서는 사용 가능한 경로 매개변수를 보여줍니다.

요청 필드

요청 본문은 표준 OpenSearch 쿼리 도메인 특화 언어(DSL)를 지원합니다. 자세한 내용은 Query DSL을 참조하세요.

예제 요청: 세션 검색

GET /_plugins/_ml/memory_containers/HudqiJkB1SltqOcZusVU/memories/sessions/_search
{
  "query": {
    "match_all": {}
  },
  "sort": [
    {
      "created_time": {
        "order": "desc"
      }
    }
  ]
}

{% include copy-curl.html %}

예제 요청: 장기 메모리 검색

GET /_plugins/_ml/memory_containers/HudqiJkB1SltqOcZusVU/memories/long-term/_search
{
  "query": {
    "bool": {
      "must": [
        {
          "term": {
            "namespace.user_id": "bob"
          }
        }
      ]
    }
  },
  "sort": [
    {
      "created_time": {
        "order": "desc"
      }
    }
  ]
}

{% include copy-curl.html %}

예제 요청: 기록 메모리 검색

GET /_plugins/_ml/memory_containers/HudqiJkB1SltqOcZusVU/memories/history/_search
{
  "query": {
    "match_all": {}
  },
  "sort": [
    {
      "created_time": {
        "order": "desc"
      }
    }
  ]
}

{% include copy-curl.html %}

예제 요청: 네임스페이스 필터를 사용한 작업 메모리 검색

GET /_plugins/_ml/memory_containers/HudqiJkB1SltqOcZusVU/memories/working/_search
{
  "query": {
    "bool": {
      "must": [
        {
          "term": {
            "namespace.user_id": "bob"
          }
        }
      ],
      "must_not": [
        {
          "exists": {
            "field": "tags.parent_memory_id"
          }
        }
      ]
    }
  },
  "sort": [
    {
      "created_time": {
        "order": "desc"
      }
    }
  ]
}

{% include copy-curl.html %}

예제 요청: 세션별 추적 데이터 검색

GET /_plugins/_ml/memory_containers/HudqiJkB1SltqOcZusVU/memories/working/_search
{
  "query": {
    "term": {
      "namespace.session_id": "123"
    }
  },
  "sort": [
    {
      "created_time": {
        "order": "desc"
      }
    }
  ]
}

{% include copy-curl.html %}

예제 응답

{
  "took": 5,
  "timed_out": false,
  "_shards": {
    "total": 1,
    "successful": 1,
    "skipped": 0,
    "failed": 0
  },
  "hits": {
    "total": {
      "value": 1,
      "relation": "eq"
    },
    "max_score": null,
    "hits": [
      {
        "_index": "test1-session",
        "_id": "CcxjTpkBvwXRq366A1aE",
        "_score": null,
        "_source": {
          "memory_container_id": "HudqiJkB1SltqOcZusVU",
          "namespace": {
            "user_id": "bob"
          },
          "created_time": "2025-09-15T17:18:55.881276939Z",
          "last_updated_time": "2025-09-15T17:18:55.881276939Z"
        },
        "sort": ["2025-09-15T17:18:55.881276939Z"]
      }
    ]
  }
}

응답 필드

응답 필드는 검색 중인 메모리 유형에 따라 다릅니다. 필드 설명은 Get memory를 참조하세요.

더 알아보기 (Learn more)

• 원문 전체: https://docs.opensearch.org/latest/ml-commons-plugin/api/agentic-memory-apis/search-memory/