Create Or Update Memory API
출처: 문서
본문
메모리 생성 또는 업데이트 API
2.12부터 도입 {: .label .label-purple }
이 API를 사용하면 conversational search를 위한 대화형 메모리를 생성하거나 업데이트할 수 있어요. 메모리는 현재 대화의 대화 기록을 저장해요.
메모리를 한 번 생성하고 나면, 다른 API에 해당 메모리의 memory_id를 제공하게 돼요.
POST 메서드는 새 메모리를 생성하고, PUT 메서드는 기존 메모리를 업데이트해요.
Security 플러그인이 활성화되어 있으면 모든 메모리는 private 보안 모드로 존재해요. 메모리를 생성한 사용자만 해당 메모리와 그 메시지들과 상호작용할 수 있어요.
{: .important}
엔드포인트
POST /_plugins/_ml/memory/
PUT /_plugins/_ml/memory/{memory_id}
경로 파라미터
사용 가능한 경로 파라미터는 다음 표에 정리되어 있어요.
| 파라미터 | 데이터 타입 | 설명 |
|---|---|---|
memory_id |
String | 업데이트할 메모리의 ID예요. PUT 메서드에서는 필수예요. |
요청 본문 필드
사용 가능한 요청 필드는 다음 표에 정리되어 있어요.
| 필드 | 데이터 타입 | 필수/선택 | 설명 |
|---|---|---|---|
name |
String | 선택 | 메모리의 이름이에요. |
요청 예제
POST /_plugins/_ml/memory/
{
"name": "Conversation for a RAG pipeline"
}
{% include copy-curl.html %}
응답 예제
{
"memory_id": "gW8Aa40BfUsSoeNTvOKI"
}