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

# 메모리 설정

> 메모리 공간의 세부 설정

export const DocImage = ({src, alt, width, caption}) => <Frame caption={caption}>
    <img src={src} width={width} style={{
  padding: "8px",
  boxSizing: "border-box"
}} alt={alt} />
  </Frame>;

메모리 공간의 설정 탭에서 세부 항목을 조정합니다.

<DocImage src="/images/docs/memory-settings-open.png" alt="메모리 공간 상세 화면. 오른쪽 위 톱니 버튼을 누르면 설정이 열린다" width="100%" />

## 공통 항목

패러다임과 관계없이 모든 공간에 있는 설정 항목입니다. 메모리 공간 패러다임은 생성 후 변경할 수 없습니다.

### 기본

* **이름** 메모리 공간 이름을 바꿉니다.

### Flow 바인딩

해당 메모리 공간을 특정 Flow 하나에 바인딩하면 그 Flow의 모든 Agent가 자동으로 이 공간을 읽고 씁니다.

Agent마다 개별로 메모리를 연결하고 싶다면 바인딩하지 않은 채로 두고 [Agent에 연결](/ko/build/memory/attach#agent에-연결)을 참고하세요.

### 스코프

어떤 요청 파라미터로 내용을 나눌지 정합니다.

* 세션
* 유저 장기기억
* Flow 공유
* 전역
* `flow_id` / `thread_id` / `user_id` / 커스텀 키를 조합할 수 있습니다. [스코핑](/ko/build/memory/scoping)을 참고하세요.

**Access** (선택) 파티션 키(호출자 신원으로 자동 필터)와 필요 권한 게이트를 걸어 접근 자체를 통제합니다. [스코핑 → 접근 제어](/ko/build/memory/scoping#접근-제어선택)를 참고하세요.

## Wiki

**Memory agent (큐레이터)** Wiki 공간을 관리하는 에이전트입니다. 무엇을 남기고, 늘리고, 지울지 이 에이전트가 정합니다.

* **모델** 추출·통합을 수행합니다. 워크스페이스에 키를 등록한 공급자 중에서 고릅니다. 비우면 저비용 기본값을 씁니다.
* **정책 프롬프트** 무엇을 남기고 지울지 지시하는 자유 문장. 예: "고객의 안정적 선호·결정은 남기고, 잡담은 버리고, 선호가 바뀌면 기존 것을 대체."
* **멀티모달** 이미지·음성·비디오를 메모리에 어떻게 담을지 (`재사용` / `참조` / `재분석`). `재분석`은 추가 비용이 듭니다.
* **백그라운드 저장** 켜 두면 저장·삭제가 응답 경로 밖에서 처리되어 응답 지연이 없습니다. 검색은 항상 동기입니다. 켜 두기를 권합니다.

## Index

**인덱스** Index 전용 설정입니다.

* **인덱스 형태** 벡터만 또는 그래프
* **임베딩 모델** 워크스페이스에 키 등록된 공급자 중에서 선택. 비우면 저비용 기본값

**고급: 검색 튜닝** top-k 결과의 순위를 조정합니다.

* **가중치** 관련성·최근성·중요도를 어떻게 섞을지 (기본 3/1/1)
* **최근성 감쇠 반감기 (일)** 기본 14일. 옛 사실이 새 사실만큼 유효한 도메인(용어집, 자리 잡은 절차)은 반감기를 키워 최근성 영향을 줄입니다
* **시점 유효성 필터** 켜면 현재 유효한 사실만 조회하고, 대체되거나 만료된 항목은 숨깁니다. 기본은 꺼짐입니다
* **KG 그라운딩** 벡터 검색 후 그래프 관계로 연결된 이웃 사실도 함께 가져옵니다. 켜면 세 값이 뜹니다.
  * **Depth** 시드로부터 몇 홉까지 걸어갈지 (기본 1, 최대 3)
  * **Decay** 홉당 점수 감쇠 (0\~1)
  * **Cap** 가져올 이웃 최대 수

\*\*Memory agent (큐레이터)\*\*이 공간을 관리하는 에이전트입니다. 필드는 [Wiki](#wiki)와 동일합니다(모델·정책 프롬프트·멀티모달·백그라운드 저장).

## Session

스코프는 보통 `flow_id + thread_id` 조합으로 씁니다.

### Session buffer

이 공간이 어떻게 대화를 저장·유지할지 정하는 세션 전용 섹션입니다.

* **Store** 저장 백엔드를 고릅니다.
  * **`redis`** 핫·휘발성 저장소입니다. 빠르지만 재시작하면 사라져 짧은 대화에 적합합니다.
  * **`postgres`** 세션이 끝난 뒤에도 남는 영구 저장소입니다.
  * **`both`(기본)** Redis에서 빠르게 읽고 Postgres에 영구 저장합니다.
* **Recent window** 마지막 몇 턴 (또는 몇 토큰) 을 요약 없이 그대로 유지할지.
  * **기준** `turns`(턴 수) 또는 `tokens`(토큰 수)
  * **Size** 유지할 개수
* **Summarize** 켜면 오래된 턴을 롤링 요약으로 접습니다. 창이 다 차기 전에 트리거되어 컨텍스트가 안 넘칩니다.
  * **Trigger** 창 예산의 몇 비율에서 요약이 발동할지 (0\~1, 기본 0.8 = 80% 찼을 때)
  * **Recursive summary** 요약 자체가 다시 넘치면 요약의 요약을 만듭니다. 초장기 대화에 씀
* **Trigger message** (선택) 요약이 실행될 때 대화에 남길 안내 문구. 예: "이전 맥락은 요약되었어요."

### Summarizer

Summarize 를 켜면 이 섹션이 뜹니다. 롤링 요약을 만드는 에이전트 설정입니다.

* **Model** 요약을 수행하는 모델. 워크스페이스 프로바이더 중에서. 비우면 저비용 기본값.
* **Summarize prompt** (선택) 요약 방식을 커스터마이즈. 예: "모든 결정과 열린 질문을 남기고 잡담은 버려."

Wiki/Index 와 달리 Session 에는 **정책 프롬프트·멀티모달·백그라운드 저장 옵션이 없습니다.** Session 은 큐레이션을 하지 않고 요약만 하기 때문입니다.

## Evolution

Evolution은 자동 관리 공간이라 조정할 것이 적습니다. 스코프는 워크스페이스·테넌트 단위로 나눌지 결정합니다.

Wiki/Index처럼 정책 프롬프트나 검색 튜닝 필드는 없습니다. 채우기·감쇠·검증이 개선 플로우와 카나리 시스템에서 자동으로 이루어지기 때문입니다.