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

​
언제 쓰나

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

​
만들기

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

​
상세 페이지

  • Conversations 탭 왼쪽에 대화(스코프) 목록이 있습니다. 하나를 고르면 오른쪽에 두 블록이 보입니다.
    • Rolling summary 오래된 턴이 접힌 요약. 요약이 다시 요약된 경우 L1, L2 배지로 재귀 깊이가 표시됩니다.
    • Recent turns 아직 요약되지 않은 최근 턴을 시간순으로 표시합니다.
  • Settings 탭 아래 내용을 참고하세요.
Session 에는 별도 Log 탭이 없습니다. 대화 자체가 이 공간의 로그이기 때문입니다. Conversations 탭은 읽기 전용 이라 여기서 대화를 직접 지우거나 편집하지는 않습니다.

​
Settings 탭에서 정하는 것

Basics 공간 이름을 바꿉니다. Flow 바인딩 특정 Flow 에 이 공간을 바인딩하거나, 비워 두면 Agent 마다 개별로 붙입니다. 스코프 어떤 요청 파라미터로 대화를 나눌지 정합니다. 세션 메모리는 보통 flow_id + thread_id 조합으로 씁니다. 스코핑 참고. 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 로 스코프 단위로 정리합니다.