메모리
메모리 목록 조회
인증된 조직의 활성 메모리를 고객과 에이전트 쌍으로 묶어 조회합니다. customer_id와 agent_id 중 하나 이상을 전달해야 합니다. 둘 다 생략하면 400 VALIDATION_ERROR를 반환합니다. 각 그룹은 활성 fact를 static과 dynamic tier로 나눕니다. 각 tier는 created_at 내림차순입니다. 그룹은 페이지 사이에서 나뉘지 않으며 total_count는 그룹 수입니다. 에이전트가 없으면 404 AGENT_NOT_FOUND를 반환합니다.
GET
메모리 목록 조회
Authorizations
조직 API 키를 Authorization: Bearer <token> 형식으로 보냅니다.
Query Parameters
고객 UUID 필터입니다. customer_id와 agent_id 중 하나 이상이 필요합니다.
에이전트 UUID 필터입니다. 여러 에이전트를 조회하려면 쿼리 매개변수를 반복해서 전달합니다.
이전 응답의 next_cursor 값입니다. 다음 페이지를 조회할 때 그대로 전달합니다.
반환할 최대 항목 수입니다. v3 목록 endpoint는 1~100을 허용합니다.
Required range:
1 <= x <= 10Previous
메모리 생성인증된 조직에서 고객과 에이전트 쌍에 메모리 fact 하나를 직접 추가합니다. 요청자가 `tier`를 선택하지만 ID, 상태, 보관 한도는 시스템이 관리합니다. 에이전트가 없으면 404 `AGENT_NOT_FOUND`를 반환합니다. 고객이 없거나 다른 조직에 속하면 404 `CUSTOMER_NOT_FOUND`를 반환합니다. 생성된 fact의 `status`는 `active`입니다. 과거 `observed_at` 때문에 보관 한도를 넘으면 생성 직후 `expired`가 될 수 있습니다. 쓰기 작업이 같은 고객과 에이전트 쌍을 잠그고 있으면 5초 후 409 `MEMORY_LOCKED`를 반환합니다.
Next
메모리 목록 조회