> ## 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.

# 메모리

> AI가 사용자를 기억하게 하는 메모리 기능 — 대화가 쌓일수록 더 맞춤화된 응답을 받을 수 있습니다

AI와 대화할 때마다 매번 같은 맥락을 반복 설명해야 했던 경험이 있으신가요?

메모리 기능을 활성화하면, AI가 이전 대화에서 학습한 정보를 **자동으로 기억**하고 이후 대화에 활용합니다.

### 예시

> "우리 팀은 Python 3.11 + FastAPI를 사용하고, 배포는 Azure AKS로 합니다"

| 상태      | 동작               | 결과                                 |
| ------- | ---------------- | ---------------------------------- |
| 메모리 OFF | 매번 새로운 대화        | "어떤 프레임워크를 쓰시나요?" 반복 질문            |
| 메모리 ON  | 이전 대화에서 기술 스택 기억 | FastAPI 기반 코드 제안, AKS 배포 가이드 바로 제공 |

<Warning>
  메모리는 현재 **Experimental(실험적)** 기능입니다. 향후 동작이 변경될 수 있습니다.
</Warning>

***

## 메모리 활성화

<Steps>
  <Step title="설정 열기">
    화면 우상단 또는 사이드바에서 **설정** 아이콘을 클릭합니다.
  </Step>

  <Step title="개인화 탭 선택">
    설정 모달에서 **개인화** 탭으로 이동합니다.
  </Step>

  <Step title="메모리 토글 ON">
    메모리 섹션의 토글 스위치를 켭니다.

    <Columns cols={2}>
      <Frame caption="메모리 토글 OFF (1/2)">
        <img src="https://mintcdn.com/cloocus/MivNrc0d7ePIC5or/images/chat/memory-toggle.png?fit=max&auto=format&n=MivNrc0d7ePIC5or&q=85&s=c90b025efef0f123aa7c6b8ae2ef81e2" alt="메모리 토글 끄기" width="1103" height="595" data-path="images/chat/memory-toggle.png" />
      </Frame>

      <Frame caption="메모리 토글 ON (2/2)">
        <img src="https://mintcdn.com/cloocus/MivNrc0d7ePIC5or/images/chat/memory-toggle-on.png?fit=max&auto=format&n=MivNrc0d7ePIC5or&q=85&s=e5551c8133dca3bd8df1fd2a081ebf19" alt="메모리 토글 켜기" width="1106" height="598" data-path="images/chat/memory-toggle-on.png" />
      </Frame>
    </Columns>
  </Step>
</Steps>

<Tip>
  메모리를 끄면 자동 추출과 대화 주입이 **모두** 비활성화됩니다. 기존에 저장된 메모리는 삭제되지 않고 보존됩니다.
</Tip>

***

## 메모리가 저장되는 3가지 방식

메모리는 출처에 따라 세 가지 유형으로 나뉘며, 각각 보존 기간이 다릅니다.

| 유형                | 생성 방식             | 보존 기간 |   목록에서 표시  |
| ----------------- | ----------------- | ----- | :--------: |
| **수동 (Manual)**   | 사용자가 직접 입력        | 180일  |    뱃지 없음   |
| **자동 (Auto)**     | AI가 대화에서 자동 추출    | 30일   |   `자동` 뱃지  |
| **프로필 (Profile)** | AI가 전체 메모리를 요약·통합 | 영구    | `자동 생성` 뱃지 |

### 수동 메모리

사용자가 직접 AI에게 기억시키고 싶은 정보를 입력합니다.

**입력 예시:**

* "사용자는 데이터 엔지니어이고 Snowflake를 주로 사용합니다"
* "사용자는 코드 리뷰 시 변수명에 camelCase를 선호합니다"
* "사용자의 팀은 매주 수요일에 스프린트 리뷰를 합니다"

<Note>
  메모리는 3인칭으로 작성하는 것이 효과적입니다. "나는 \~" 대신 **"사용자는 \~"** 형식을 사용하세요.
</Note>

### 자동 메모리

메모리가 활성화된 상태에서 대화하면, AI가 응답 완료 후 **백그라운드에서 자동으로** 핵심 사실(fact)을 추출하여 저장합니다.

```mermaid theme={null}
flowchart LR
    A[대화 완료] --> B[AI가 최근 메시지 분석]
    B --> C{신뢰도 충분?}
    C -->|Yes| D{기존 메모리와 중복?}
    C -->|No| E[저장 안 함]
    D -->|중복| F[기존 메모리 업데이트]
    D -->|신규| G[새 메모리 저장]
```

* 사용자당 **최대 100개**의 자동 메모리가 저장됩니다
* 중복된 내용은 자동으로 병합되어 메모리가 불필요하게 쌓이지 않습니다
* 같은 채팅에서 **5분 이내** 연속 메시지는 추출을 건너뜁니다

### 프로필 요약

자동/수동 메모리가 일정 수 이상 쌓이면, AI가 이를 종합하여 **구조화된 프로필 문서**로 통합합니다.

프로필에 포함되는 내용:

* 역할 및 업무 영역
* 기술 스택 선호도
* 진행 중인 프로젝트
* 커뮤니케이션 스타일

프로필은 **1개만 유지**되며, 새 메모리가 쌓일 때마다 자동으로 갱신됩니다.

***

## 메모리가 대화에 반영되는 방식

메모리가 ON인 상태에서 질문을 보내면, AI는 답변 전에 관련 메모리를 자동으로 참고합니다.

```mermaid theme={null}
flowchart LR
    A[사용자 질문] --> B[관련 메모리 검색]
    B --> C[프로필 + 관련 사실 선별]
    C --> D[AI에게 컨텍스트로 전달]
    D --> E[맞춤화된 응답]
```

AI는 메모리 양에 따라 **자동으로 전략을 조절**합니다:

| 메모리 수       | 동작                         |
| ----------- | -------------------------- |
| 없음          | 일반 대화 (메모리 주입 없음)          |
| 소량 (20개 미만) | 모든 메모리를 참고                 |
| 다량 (20개 이상) | 프로필 + 질문과 관련된 메모리만 선별하여 참고 |

<Tip>
  메모리가 20개 이상 쌓이면, AI가 질문 내용에 따라 **관련성 높은 메모리만 골라** 참고합니다.
  예를 들어 Python 관련 질문을 하면, Python 관련 메모리가 우선적으로 선택됩니다.
</Tip>

***

## 메모리 관리

설정 > **개인화** 항목을 클릭하면 메모리 관리 화면이 열립니다.

<Frame caption="메모리 관리 모달 — 저장된 메모리 목록과 프로필 요약을 확인할 수 있습니다">
  <img src="https://mintcdn.com/cloocus/T-uIm14J0Tjpsr6L/images/chat/memory-manage.png?fit=max&auto=format&n=T-uIm14J0Tjpsr6L&q=85&s=ab95a1c25ad725401c98b10665848da6" alt="메모리 관리 화면" width="1912" height="905" data-path="images/chat/memory-manage.png" />
</Frame>

### 메모리 추가

<Frame caption="3인칭으로 작성하세요 — '사용자는 ~' 형식이 가장 효과적입니다">
  <img src="https://mintcdn.com/cloocus/T-uIm14J0Tjpsr6L/images/chat/memory-add.png?fit=max&auto=format&n=T-uIm14J0Tjpsr6L&q=85&s=159c1b3b8c25b6e99d21d352fe9b0c7d" alt="메모리 추가 모달" width="1911" height="903" data-path="images/chat/memory-add.png" />
</Frame>

1. **메모리 추가** 버튼 클릭
2. 텍스트 입력 (예: "사용자는 한국어로 코드 주석을 작성합니다")
3. **추가** 클릭

### 메모리 수정

각 메모리 항목의 **연필 아이콘**을 클릭하여 내용을 수정할 수 있습니다.
자동 추출된 메모리도 수정 가능합니다.

### 메모리 삭제

* **개별 삭제**: 각 항목의 **휴지통 아이콘** 클릭
* **전체 삭제**: 하단 **메모리 초기화** 버튼 (확인 다이얼로그 표시)

<Note>
  삭제된 메모리는 즉시 사라지지 않고 **30일간 유예 기간** 후 완전히 제거됩니다. 이 기간 동안에는 대화에 반영되지 않습니다.
</Note>

### 프로필 요약 확인

메모리 관리 화면 상단에 **프로필 요약** 섹션이 표시됩니다 (프로필이 생성된 경우).

클릭하면 AI가 자동 생성한 사용자 프로필 내용을 확인할 수 있습니다.

<Frame caption="AI가 자동 생성한 프로필 요약 — 역할, 기술 스택, 프로젝트 등이 정리됩니다">
  <img src="https://mintcdn.com/cloocus/T-uIm14J0Tjpsr6L/images/chat/memory-profile.png?fit=max&auto=format&n=T-uIm14J0Tjpsr6L&q=85&s=3c4281dcf07b11478eccb30c4116ca90" alt="프로필 요약 화면" width="1914" height="907" data-path="images/chat/memory-profile.png" />
</Frame>

***

## 조직 메모리 (관리자 전용)

관리자는 **조직 전체에 공유되는 메모리**를 설정할 수 있습니다.

**진입 경로**: 관리자 패널 > 설정 > 메모리 탭 > 조직 메모리

조직 메모리는 **해당 조직의 모든 사용자** 대화에 자동으로 주입됩니다.

### 활용 예시

* "우리 회사는 고객 데이터를 다룰 때 항상 개인정보 보호법을 준수해야 합니다"
* "사내 용어로 'Sprint'는 2주 단위 개발 주기를 의미합니다"
* "보고서 작성 시 회사 공식 양식(Template A)을 사용합니다"

<Warning>
  조직 메모리는 모든 멤버의 **모든 대화**에 포함되므로, 핵심적인 정보만 간결하게 입력하세요.
  너무 많은 조직 메모리는 AI 응답 품질에 영향을 줄 수 있습니다.
</Warning>

***

## 관리자 설정

<Frame caption="관리자 패널 > 설정 > 메모리 — 추출 모델, 신뢰도, 보존 정책을 설정합니다">
  <img src="https://mintcdn.com/cloocus/MivNrc0d7ePIC5or/images/chat/admin-memory-settings.png?fit=max&auto=format&n=MivNrc0d7ePIC5or&q=85&s=e9431ce7bddedeed696fc7c0f6faa3de" alt="관리자 메모리 설정" width="1646" height="820" data-path="images/chat/admin-memory-settings.png" />
</Frame>

관리자 패널 > 설정 > 메모리 탭에서 메모리 시스템 전체를 관리할 수 있습니다.

### 추출 설정

| 설정                 | 기본값       | 설명                                         |
| ------------------ | --------- | ------------------------------------------ |
| **메모리 추출에 사용할 모델** | 시스템 기본 모델 | 메모리 추출에 사용할 LLM 모델. 미설정 시 시스템 기본 모델 사용     |
| **신뢰도 임계값**        | 0.8       | 추출된 사실의 신뢰도 임계값 (0\~1). 낮출수록 더 많은 메모리가 저장됨 |

### 보존 정책

| 클래스 | 기본 보존 기간 | 수정 가능 |
| --- | :------: | :---: |
| 표준  |   180일   |   O   |
| 영구  |    무제한   |   X   |
| 임시  |    60일   |   O   |

### 감사 로그 (Audit Log)

메모리 생성, 수정, 삭제, 설정 변경 등 모든 이벤트가 기록됩니다.
이벤트 유형과 사용자별로 필터링할 수 있습니다.

### 사용자 메모리 관리

특정 사용자를 선택하여 해당 사용자의 메모리 목록을 조회하고, 필요 시 삭제할 수 있습니다.

***

## 효과적인 메모리 활용 팁

<AccordionGroup>
  <Accordion title="어떤 정보를 메모리에 넣으면 좋을까요?" icon="lightbulb">
    **효과적인 메모리:**

    * 역할과 전문 분야 ("사용자는 백엔드 개발자입니다")
    * 기술 스택 ("사용자의 프로젝트는 Python + FastAPI를 사용합니다")
    * 선호하는 작업 방식 ("사용자는 코드에 타입 힌트를 필수로 사용합니다")
    * 프로젝트 맥락 ("사용자는 현재 결제 시스템 마이그레이션 작업 중입니다")

    **비효율적인 메모리:**

    * 일시적인 정보 ("오늘 회의 3시에 있음") → 자동 메모리에 맡기세요
    * 너무 일반적인 정보 ("사용자는 프로그래밍을 합니다")
    * 매우 긴 텍스트 → 핵심만 간결하게 작성하세요
  </Accordion>

  <Accordion title="자동 메모리가 부정확하면 어떻게 하나요?" icon="circle-question">
    자동 추출된 메모리는 AI가 대화 내용을 분석하여 생성하므로 간혹 부정확할 수 있습니다.

    * **메모리 관리** 화면에서 `자동` 뱃지가 붙은 항목을 정기적으로 확인하세요
    * 부정확한 메모리는 **수정** 또는 **삭제**할 수 있습니다
    * 관리자가 **신뢰도 임계값**을 높이면 추출 기준이 엄격해집니다 (기본 0.8)
  </Accordion>

  <Accordion title="메모리를 끄면 기존 메모리는 어떻게 되나요?" icon="toggle-off">
    메모리 토글을 OFF로 전환하면:

    * 자동 추출이 **중단**됩니다
    * 대화에 메모리가 **주입되지 않습니다**
    * 기존에 저장된 메모리는 **삭제되지 않고 보존**됩니다
    * 다시 ON으로 전환하면 기존 메모리를 바로 활용할 수 있습니다
  </Accordion>
</AccordionGroup>

***

## 개인 메모리 vs 조직 메모리

|        | 개인 메모리         | 조직 메모리              |
| ------ | -------------- | ------------------- |
| **대상** | 본인의 대화에만 적용    | 조직 전체 사용자의 대화에 적용   |
| **생성** | 사용자 본인 (수동/자동) | 관리자만 가능             |
| **보존** | 유형에 따라 30일\~영구 | 영구                  |
| **용도** | 개인 선호도, 업무 맥락  | 회사 정책, 공통 규칙, 용어 정의 |