> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloosphere.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 메모리

> 사용자·조직 메모리의 추출 모델, 신뢰도 임계값, 보존 정책(TTL)을 설정하고 메모리 이벤트를 감사합니다.

<Info>관리자 › 설정 › 메모리</Info>

Cloosphere는 대화에서 사용자에 관한 사실을 **메모리**로 추출·축적하여 이후 응답에 활용합니다.

* 이 페이지에서 메모리 추출에 쓰는 모델, 추출 품질 기준, 보존 기간을 관리합니다.

<Frame caption="관리자 > 설정 > 메모리 — 추출 모델 · 신뢰도 임계값 · 보존 정책">
  <img src="https://mintcdn.com/cloocus/3CYTE_uN2N3A4joq/images/admin/settings-memory.png?fit=max&auto=format&n=3CYTE_uN2N3A4joq&q=85&s=324cd0808ccf90e9ea8a273dbe001eb8" alt="메모리 설정" width="2880" height="1800" data-path="images/admin/settings-memory.png" />
</Frame>

***

## 추출 설정

`설정` 구획의 왼쪽 카드입니다. 값을 바꾼 뒤 카드 안의 **저장**을 눌러야 반영됩니다.

| 설정 항목       | 설명                                                                                |
| ----------- | --------------------------------------------------------------------------------- |
| **추출 모델**   | 메모리 추출에 사용할 모델. 화면에 표시된 우선순위는 **추출 모델 → 작업 모델 → 채팅 모델**로, 지정하지 않으면 뒤쪽 모델이 대신 쓰입니다 |
| **신뢰도 임계값** | 이 값 미만의 신뢰도로 추출된 사실은 필터링되어 저장되지 않음. 슬라이더로 조절합니다 (기본값 `0.8`)                       |

**신뢰도 임계값을 조절하면:**

* **높이면** — 확실한 사실만 저장돼 잘못된 기억이 줄지만, 유용한 정보를 놓칠 수 있습니다.
* **낮추면** — 더 많은 사실을 기억하지만, 부정확하거나 사소한 내용까지 저장될 수 있습니다.

***

## 보존 정책

`설정` 구획의 오른쪽 카드입니다. 메모리는 **보존 클래스**별로 유효 기간(TTL)이 다르며, 각 클래스 아래에 `만료 시 동작`이 함께 표시됩니다.

* 만료된 메모리는 **소프트 삭제**됩니다.

| 클래스    | TTL        | 비고                                   |
| ------ | ---------- | ------------------------------------ |
| **표준** | 설정한 일수     | 일반 메모리                               |
| **영구** | 무기한        | **수정할 수 없음** — 입력란 대신 `무기한`으로만 표시됩니다 |
| **임시** | 설정한 일수(짧게) | 단기 메모리                               |

일수를 바꾼 뒤 **정책 저장**을 눌러야 반영됩니다. 추출 설정의 저장 버튼과는 별개입니다.

***

## 메모리 관리·감사

`관리` 섹션에서 메모리 변경 이력을 조회하고, 저장된 메모리를 직접 확인·정리합니다.

<Frame caption="관리자 > 설정 > 메모리 > 관리 — 감사 로그 탭">
  <img src="https://mintcdn.com/cloocus/3CYTE_uN2N3A4joq/images/admin/settings-memory-manage.png?fit=max&auto=format&n=3CYTE_uN2N3A4joq&q=85&s=1e5eb138544f52d9e8ad0c5197350f88" alt="메모리 관리 — 감사 로그 탭" width="2880" height="1260" data-path="images/admin/settings-memory-manage.png" />
</Frame>

| 탭           | 내용                                              |
| ----------- | ----------------------------------------------- |
| **감사 로그**   | 메모리 생성·업데이트·삭제 이벤트 전체                           |
| **사용자 메모리** | 사용자를 골라 그 사용자의 메모리를 조회하고 개별 삭제                  |
| **조직 메모리**  | 조직 단위 메모리 조회 · **직접 추가** · 삭제                   |
| **지식 엔티티**  | 추출된 엔티티 유형과 유형별 개수·예시. 엔티티 유형을 직접 추가·삭제할 수 있습니다 |

### 감사 로그

| 항목            | 설명                                        |
| ------------- | ----------------------------------------- |
| **이벤트 필터**    | `전체 이벤트` · `생성` · `업데이트` · `삭제` · `설정 변경` |
| **사용자 ID 필터** | 특정 사용자의 이벤트만 남깁니다                         |
| **표 구성**      | 시간 · 이벤트 · 액터 · 사용자 이메일 · 상세              |

목록은 페이지 단위로 나뉘며 하단에 `페이지 N / M (전체 건수)`와 이전·다음 버튼이 있습니다.

\*\*액터(actor)\*\*는 이벤트 주체를 나타냅니다.

| 액터                     | 의미              |
| ---------------------- | --------------- |
| `system:extraction`    | 대화에서 메모리 자동 추출  |
| `system:consolidation` | 중복·관련 메모리 통합    |
| `system:retention`     | 보존 기간 만료로 자동 삭제 |
| `user:<id>`            | 사용자가 직접 생성·삭제   |

<Note>
  액터가 `system:*`인 행은 시스템이 수행한 작업이라 **사용자 이메일** 열이 `-`로 표시됩니다.
</Note>