Skip to main content
POST
메모리 생성

Authorizations

Authorization
string
header
required

조직 API 키를 Authorization: Bearer <token> 형식으로 보냅니다.

Body

application/json

생성할 메모리 fact입니다.

메모리 fact를 직접 생성하는 요청입니다.

쓰기 엔진의 LLM diff와 달리 요청자가 tier를 선택합니다. ID, 상태, 보관 한도 백스톱은 같은 불변 조건에 따라 코드가 관리합니다. 과거 observed_at 값은 created_at으로 저장합니다. tier가 보관 한도를 넘으면 쓰기 엔진과 마찬가지로 오래된 항목부터 처리하는 백스톱이 새 fact를 즉시 만료할 수 있습니다. 응답의 status에 결과를 active 또는 expired로 표시합니다.

content는 앞뒤 공백을 제거합니다. 공백만 있거나 비어 있으면 400을 반환하며, 정규화한 값을 저장합니다. observed_at은 현재 시각보다 늦지 않은 유효한 밀리초 단위 unix timestamp여야 합니다. 음수, 미래 시각, 범위를 벗어난 값은 400을 반환하므로 datetime 변환 오버플로를 방지합니다.

customer_id
string<uuid>
required

고객 UUID입니다.

agent_id
string<uuid>
required

에이전트 UUID입니다.

tier
enum<string>
required

메모리 tier입니다. static은 영속 메모리이고 dynamic은 최근 메모리입니다.

Available options:
static,
dynamic
content
string
required

메모리 한 문장입니다. 공백을 제외한 내용이 비어 있으면 400을 반환합니다. 저장 전에 앞뒤 공백을 제거합니다.

Minimum string length: 1
observed_at
integer | null

과거 관측 시각입니다. 밀리초 단위 unix timestamp입니다. 생략하거나 null이면 현재 생성 시각을 사용합니다. 과거 값을 전달하면 created_at으로 저장합니다. tier가 보관 한도를 넘으면 오래된 항목부터 처리하는 백스톱이 새 fact를 즉시 만료할 수 있습니다. 음수, 미래 시각, 범위를 벗어난 값은 400을 반환합니다.

Response

성공 응답

직접 생성한 fact와 상태를 담은 응답입니다.

MemoryFactResponse는 활성 fact만 다루므로 상태를 포함하지 않습니다. 생성 응답은 새 fact가 active 상태인지, 보관 한도 백스톱으로 즉시 expired 상태가 되었는지 표시합니다. 과거 observed_at 값 때문에 tier가 보관 한도를 넘으면 오래된 항목부터 처리하는 백스톱이 새 fact를 만료할 수 있습니다. 다른 오래된 fact의 만료 여부는 이 응답에 표시하지 않으며 목록 조회로 확인할 수 있습니다.

id
string
required

메모리 UUID입니다.

customer_id
string
required

고객 UUID입니다.

agent_id
string
required

에이전트 UUID입니다.

tier
string
required

메모리 tier입니다. 값은 static 또는 dynamic입니다.

content
string
required

한 문장으로 구성된 메모리 fact 내용입니다.

created_at
integer
required

리소스 생성 시각입니다. 밀리초 단위 unix timestamp입니다.

status
enum<string>
required

새로 생성한 fact의 상태입니다. 보관 한도 백스톱이 fact를 즉시 만료했으면 expired이고, 그렇지 않으면 active입니다.

Available options:
active,
expired
source_call_id
string | null

이 fact의 출처인 통화 UUID입니다. 직접 생성한 경우 null입니다.

source_chat_id
string | null

이 fact의 출처인 채팅 UUID입니다. 직접 생성한 경우 null입니다.