메모리 생성
인증된 조직에서 고객과 에이전트 쌍에 메모리 fact 하나를 직접 추가합니다. 통화와 채팅이 끝난 뒤 실행되는 자동 추출은 tier를 스스로 정하지만, 이 직접 생성 요청에서는 요청자가 tier를 선택합니다. ID와 상태는 서버가 부여합니다. tier마다 보관 한도가 있으며, 한도를 넘으면 오래된 fact부터 만료합니다. 저장 전에 앞뒤 공백을 제거하고, 연속된 공백을 하나로 합치며, 문장 부호를 제거해 중복을 비교합니다. 같은 고객, 에이전트, tier에 정규화 결과가 같은 활성 fact가 있으면 새 fact를 만들지 않고 기존 fact를 201 응답으로 반환합니다. 에이전트가 없으면 404 AGENT_NOT_FOUND를 반환합니다. 고객이 없거나 다른 조직에 속하면 404 CUSTOMER_NOT_FOUND를 반환합니다. 응답은 생성된 fact와 status입니다. 과거 observed_at 때문에 tier가 한도를 넘어 방금 만든 fact가 먼저 만료되면 expired, 그렇지 않으면 active입니다. 같은 고객과 에이전트 쌍의 메모리가 갱신되는 동안에는 최대 5초 기다린 뒤 409 MEMORY_LOCKED를 반환합니다.
Authorizations
조직 API 키를 Authorization: Bearer <token> 형식으로 보냅니다.
Body
생성할 메모리 fact입니다.
메모리 fact를 직접 생성하는 요청입니다.
통화와 채팅이 끝난 뒤 실행되는 자동 추출은 tier를 스스로 정하지만, 이 직접 생성 요청에서는 요청자가 tier를 선택합니다. ID와 상태는 서버가 부여합니다. tier마다 보관 한도가 있으며, 한도를 넘으면 오래된 fact부터 만료합니다. 과거 observed_at 값은 created_at으로 저장하므로, 방금 만든 fact가 한도를 넘은 tier에서 가장 오래된 fact이면 즉시 만료될 수 있습니다. 결과는 응답의 status에 active 또는 expired로 표시합니다.
content는 앞뒤 공백을 제거합니다. 공백만 있거나 비어 있으면 400을 반환하며, 정규화한 값을 저장합니다. observed_at은 현재 시각보다 늦지 않은 유효한 밀리초 단위 unix timestamp여야 합니다. 음수, 미래 시각, 범위를 벗어난 값은 400을 반환하므로 datetime 변환 오버플로를 방지합니다. 중복을 비교할 때만 연속된 공백을 하나로 합치고 문장 부호를 제거합니다. 같은 고객, 에이전트, tier에 정규화 결과가 같은 활성 fact가 있으면 새 행을 만들지 않고 기존 fact를 반환합니다.
고객 UUID입니다.
에이전트 UUID입니다.
메모리 tier입니다. static은 영속 메모리이고 dynamic은 최근 메모리입니다.
static, dynamic 메모리 한 문장입니다. 최대 512개의 유니코드 코드 포인트를 허용합니다. 공백을 제외한 내용이 비어 있으면 400을 반환합니다. 저장 전에 앞뒤 공백을 제거합니다.
1 - 512과거 관측 시각입니다. 밀리초 단위 unix timestamp입니다. 생략하거나 null이면 현재 생성 시각을 사용합니다. 과거 값을 전달하면 created_at으로 저장합니다. tier마다 보관 한도가 있으며, 한도를 넘으면 오래된 fact부터 만료하므로 방금 만든 fact가 즉시 만료될 수 있습니다. 음수, 미래 시각, 범위를 벗어난 값은 400을 반환합니다.
Response
성공 응답
직접 생성한 fact와 상태를 담은 응답입니다.
MemoryFactResponse는 활성 fact만 다루므로 상태를 포함하지 않습니다. 생성 응답은 새 fact가 active 상태로 남았는지 즉시 expired 상태가 되었는지 표시합니다. tier마다 보관 한도가 있으며, 한도를 넘으면 오래된 fact부터 만료합니다. 따라서 과거 observed_at 값 때문에 방금 만든 fact가 즉시 만료될 수 있습니다. 다른 오래된 fact의 만료 여부는 이 응답에 표시하지 않으며 목록 조회로 확인할 수 있습니다.
메모리 fact UUID입니다.
고객 UUID입니다.
에이전트 UUID입니다.
메모리 tier입니다. 값은 static 또는 dynamic입니다.
한 문장으로 구성된 메모리 fact 내용입니다.
리소스 생성 시각입니다. 밀리초 단위 unix timestamp입니다.
새로 생성한 fact의 상태입니다. tier가 보관 한도를 넘어 이 fact가 먼저 만료되었으면 expired, 그렇지 않으면 active입니다.
active, expired 이 fact의 출처인 통화 UUID입니다. 직접 생성한 경우 null입니다.
이 fact의 출처인 채팅 UUID입니다. 직접 생성한 경우 null입니다.