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

# Session 메모리

> 대화마다 자동으로 쌓이는 롤링 버퍼. 창이 차면 요약으로 접습니다

**Session 메모리**는 대화마다 자동으로 쌓이는 롤링 버퍼입니다. Agent 가 따로 아무것도 하지 않아도 채팅 메시지가 그대로 담기고, 창이 차면 오래된 턴을 롤링 요약으로 접습니다.

## 언제 쓰나

* **채팅형 Agent** "우리 아까 X 얘기했잖아"처럼 앞선 대화를 자연스럽게 이어갈 때 씁니다.
* **여러 턴에 걸친 작업** 이전 턴에서 정한 내용을 다음 턴에서도 계속 사용해야 할 때 씁니다.
* **짧게 남는 대화 이력** 세션이 끝나면 대체로 정리되는 대화 이력이 필요할 때 씁니다.

장기 사실이나 팀 지식은 Session 이 아니라 [Wiki](/ko/build/memory/wiki) 나 [Index](/ko/build/memory/index) 를 씁니다.

## 만들기

**메모리 → 새 공간 → Session (chat)** 로 즉시 생성됩니다.

## 상세 페이지

* **Conversations 탭** 왼쪽에 대화(스코프) 목록이 있습니다. 하나를 고르면 오른쪽에 두 블록이 보입니다.
  * **Rolling summary** 오래된 턴이 접힌 요약. 요약이 다시 요약된 경우 `L1`, `L2` 배지로 재귀 깊이가 표시됩니다.
  * **Recent turns** 아직 요약되지 않은 최근 턴을 시간순으로 표시합니다.
* **Settings 탭** 아래 내용을 참고하세요.

Session 에는 별도 **Log 탭이 없습니다**. 대화 자체가 이 공간의 로그이기 때문입니다. Conversations 탭은 **읽기 전용** 이라 여기서 대화를 직접 지우거나 편집하지는 않습니다.

## Settings 탭에서 정하는 것

**Basics** 공간 이름을 바꿉니다.

**Flow 바인딩** 특정 Flow 에 이 공간을 바인딩하거나, 비워 두면 Agent 마다 개별로 붙입니다.

**스코프** 어떤 요청 파라미터로 대화를 나눌지 정합니다. 세션 메모리는 보통 `flow_id + thread_id` 조합으로 씁니다. [스코핑](/ko/build/memory/scoping) 참고.

**Access** (선택) 파티션 키·필요 권한 게이트.

### 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 은 큐레이션을 하지 않고 요약만 하기 때문입니다.

## Agent 에 붙이기

Flow 빌더에서 Agent 를 열고 **메모리** 탭 → **메모리 추가**. Session 은 스코프에 `thread_id` 를 포함하는 게 보통이므로, 트리거 (API/웹훅) 에서 `threadId` 를 넘겨 주세요. 같은 `threadId` 는 같은 대화로 이어집니다.

## 대화가 쌓이는 방식

Agent 가 따로 할 일이 없습니다. 매 턴의 사용자 입력·Agent 응답·도구 호출·응답이 자동으로 이 공간에 쌓입니다. 창이 차면 위 설정에 따라 요약이 발동합니다.

## 대화 정리

Session 은 성격상 오래 남는 데이터가 아니라서 Wiki/Index 처럼 supersede·감쇠·항목별 삭제 UI 를 두지 않습니다. Store 가 `redis` (또는 `both` 의 Redis 층) 라면 세션이 끝나거나 Redis 가 재시작될 때 자연스럽게 정리됩니다. `postgres` 저장분은 관리자 도구·[`nora memory`](/ko/cli/memory) 로 스코프 단위로 정리합니다.