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