Update Memory API

출처: 문서

본문

메모리 업데이트 API

Introduced 3.3 {: .label .label-purple }

이 API를 사용하여 특정 메모리를 유형과 ID로 업데이트할 수 있습니다. 이 통합 API는 sessions, working, long-term 메모리 유형 업데이트를 지원합니다. history 메모리는 업데이트를 지원하지 않습니다.

엔드포인트

PUT /_plugins/_ml/memory_containers/{memory_container_id}/memories/{type}/{id}

경로 매개변수

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

요청 필드

요청 필드는 업데이트되는 메모리 유형에 따라 다릅니다. 모든 요청 필드는 선택 사항입니다.

세션 메모리 요청 필드

다음 표는 모든 세션 메모리 요청 본문 필드를 보여줍니다.

작업 메모리 요청 필드

다음 표는 모든 작업 메모리 요청 본문 필드를 보여줍니다.

장기 메모리 요청 필드

다음 표는 모든 장기 메모리 요청 본문 필드를 보여줍니다.

예제 요청: 세션 업데이트

PUT /_plugins/_ml/memory_containers/HudqiJkB1SltqOcZusVU/memories/sessions/N2CDipkB2Mtr6INFFcX8
{
  "additional_info": {
    "key1": "value1",
    "last_activity": "2025-09-15T17:30:00Z"
  }
}

{% include copy-curl.html %}

예제 요청: 작업 메모리 업데이트

PUT /_plugins/_ml/memory_containers/HudqiJkB1SltqOcZusVU/memories/working/XyEuiJkBeh2gPPwzjYWM
{
  "tags": {
    "topic": "updated_topic",
    "priority": "high"
  }
}

{% include copy-curl.html %}

예제 요청: 장기 메모리 업데이트

PUT /_plugins/_ml/memory_containers/HudqiJkB1SltqOcZusVU/memories/long-term/DcxjTpkBvwXRq366C1Zz
{
  "memory": "User's name is Bob Smith",
  "tags": {
    "topic": "personal info",
    "updated": "true"
  }
}

{% include copy-curl.html %}

예제 응답

{
  "result": "updated",
  "_id": "N2CDipkB2Mtr6INFFcX8",
  "_version": 2,
  "_shards": {
    "total": 2,
    "successful": 1,
    "failed": 0
  }
}

응답 필드

다음 표는 모든 응답 본문 필드를 보여줍니다.

더 알아보기 (Learn more)

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