Skip to main content
POST
메모리 생성

Authorizations

Authorization
string
header
required

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

Body

application/json

생성할 메모리 fact입니다.

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

통화와 채팅이 끝난 뒤 실행되는 자동 추출은 tier를 스스로 정하지만, 이 직접 생성 요청에서는 요청자가 tier를 선택합니다. ID와 상태는 서버가 부여합니다. tier마다 보관 한도가 있으며, 한도를 넘으면 오래된 fact부터 만료합니다. 과거 observed_at 값은 created_at으로 저장하므로, 방금 만든 fact가 한도를 넘은 tier에서 가장 오래된 fact이면 즉시 만료될 수 있습니다. 결과는 응답의 statusactive 또는 expired로 표시합니다.

content는 앞뒤 공백을 제거합니다. 공백만 있거나 비어 있으면 400을 반환하며, 정규화한 값을 저장합니다. observed_at은 현재 시각보다 늦지 않은 유효한 밀리초 단위 unix timestamp여야 합니다. 음수, 미래 시각, 범위를 벗어난 값은 400을 반환하므로 datetime 변환 오버플로를 방지합니다. 중복을 비교할 때만 연속된 공백을 하나로 합치고 문장 부호를 제거합니다. 같은 고객, 에이전트, tier에 정규화 결과가 같은 활성 fact가 있으면 새 행을 만들지 않고 기존 fact를 반환합니다.

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

메모리 한 문장입니다. 최대 512개의 유니코드 코드 포인트를 허용합니다. 공백을 제외한 내용이 비어 있으면 400을 반환합니다. 저장 전에 앞뒤 공백을 제거합니다.

Required string length: 1 - 512
observed_at
integer | null

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

Response

성공 응답

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

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

id
string
required

메모리 fact 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의 상태입니다. tier가 보관 한도를 넘어 이 fact가 먼저 만료되었으면 expired, 그렇지 않으면 active입니다.

Available options:
active,
expired
source_call_id
string | null

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

source_chat_id
string | null

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