Create session
출처: 문서
본문
세션 생성
3.3부터 도입됨 {: .label .label-purple }
이 API를 사용하면 메모리 컨테이너에 새 세션을 생성할 수 있어요. 세션은 사용자와 에이전트 간의 개별적인 상호작용 컨텍스트를 나타내요.
경로 및 HTTP 메서드
POST /_plugins/_ml/memory_containers/{memory_container_id}/memories/sessions
경로 파라미터
다음 표에서 사용 가능한 경로 파라미터를 확인할 수 있어요.
| 파라미터 | 데이터 타입 | 필수/선택 | 설명 |
|---|---|---|---|
memory_container_id |
String | 필수 | 세션이 생성될 메모리 컨테이너의 ID예요. |
요청 필드
다음 표에서 사용 가능한 요청 본문 필드를 확인할 수 있어요.
| 필드 | 데이터 타입 | 필수/선택 | 설명 |
|---|---|---|---|
session_id |
String | 선택 | 사용자 지정 세션 ID예요. 제공하면 이 ID가 세션에 사용되고, 제공하지 않으면 무작위 ID가 생성돼요. |
summary |
String | 선택 | 세션 요약 또는 설명이에요. |
metadata |
Object | 선택 | 키-값 쌍으로 제공되는 세션의 추가 메타데이터예요. |
namespace |
Object | 선택 | 세션을 구성하기 위한 네임스페이스 정보예요. |
예제 요청: 사용자 지정 ID로 세션 생성하기
POST /_plugins/_ml/memory_containers/SdjmmpgBOh0h20Y9kWuN/memories/sessions
{
"session_id": "abc123",
"metadata": {
"key1": "value1"
}
}
예제 응답: 사용자 지정 세션 ID
{
"session_id": "abc123",
"status": "created"
}
예제 요청: 자동 생성된 ID로 세션 생성하기
POST /_plugins/_ml/memory_containers/SdjmmpgBOh0h20Y9kWuN/memories/sessions
{
"summary": "This is a test session",
"metadata": {
"key1": "value1"
},
"namespace": {
"user_id": "bob"
}
}
{% include copy-curl.html %}
예제 응답: 자동 생성된 세션 ID
{
"session_id": "jTYm35kBt8CyICnjxJl9",
"status": "created"
}
응답 필드
다음 표에서 모든 응답 본문 필드를 확인할 수 있어요.
| 필드 | 데이터 타입 | 설명 |
|---|---|---|
session_id |
String | 생성된 세션의 ID예요(제공된 값 또는 자동 생성된 값). |
status |
String | 생성 작업의 상태예요. |