Skip to main content
Index 메모리는 사실을 색인해 두고 Agent 가 검색으로 찾는 공간입니다. 자유 텍스트 노트가 아니라 “레코드” 로 볼 만한 것을 담을 때 씁니다. 만들 때 Vector 와 Graph 두 형태 중 하나를 고릅니다.

​
언제 쓰나

  • 엔티티에 대한 사실 고객·제품·인시던트 프로필을 저장할 때 씁니다.
  • Wiki에 맞지 않는 레코드 트랜스크립트·이메일·채팅 로그를 저장할 때 씁니다.
  • 여러 홉 관계 질문 “Alice와 같은 회사에서 일하는 다른 사람은?”처럼 여러 관계를 거쳐 답을 찾아야 한다면 Graph 형태를 사용합니다.

​
만들기

메모리 → 새 공간 → Index (graph/vector) 로 즉시 생성됩니다. 생성 후 Settings → 인덱스 형태 에서 vector (기본) 또는 graph 를 고릅니다.

​
두 가지 형태

Vector (기본) 사실을 임베딩해 벡터로 색인하고, 의미 유사도로 검색합니다. Graph 사실을 (subject, relationship, object) 형태의 엔티티-관계 트리플로 색인합니다.
엔티티는 ID 말고도 속성(name, created_at, 커스텀 필드)을 가질 수 있습니다. Graph 형태를 쓰면 Agent 가 자동으로 순회 도구를 얻어 관계를 따라 걷습니다.

​
상세 페이지

Index 를 열면 형태에 따라 primary 탭 이름이 다릅니다.
  • Vector → Facts 탭 사실 목록입니다. 상단에 사실 검색 입력, 각 행에 요약·본문 프리뷰·종류 배지(fact·preference·profile·entity·episodic·event)·재발/재사용 횟수(×N)가 표시됩니다. 재발 횟수 내림차순으로 정렬됩니다. 각 행에 호버하면 우측에 X 버튼이 뜨고 누르면 검색에서 제외 됩니다.
  • Graph → Graph 탭 엔티티와 엣지를 클릭하거나 드래그해 탐색합니다.
  • Log 탭 이 공간의 이벤트를 시간순으로 표시합니다.
  • Settings 탭 아래 내용을 참고하세요.

​
Settings 탭에서 정하는 것

Basics 공간 이름을 바꿉니다. Flow 바인딩 특정 Flow 에 이 공간을 바인딩하거나, 비워 두면 Agent 마다 개별로 붙입니다. 스코프 어떤 요청 파라미터로 사실을 나눌지. 스코핑 참고. Access (선택) 파티션 키와 필요 권한 게이트. 인덱스 Index 전용 설정입니다.
  • 인덱스 형태 vector 또는 graph
  • 임베딩 모델 워크스페이스에 키 등록된 공급자 중에서 선택. 비우면 저비용 기본값
고급 검색 튜닝 top-k 결과의 순위를 조정합니다.
  • 가중치 관련성·최근성·중요도를 어떻게 섞을지 (기본 3/1/1)
  • τ (반감기, 일) 최근성 감쇠 반감기. 기본 14일. 옛 사실이 새 사실만큼 유효한 도메인(용어집, 자리 잡은 절차)은 τ 를 키워 최근성 영향을 줄입니다
  • Supersede on conflict 새 사실이 기존과 부딪히면 새 것이 이기고 옛것은 이력으로 남김. 꺼 두면 두 사실이 공존하며 리트리벌이 둘 다 반환
  • KG 그라운딩 벡터 검색 후 그래프 관계로 연결된 이웃 사실도 함께 가져옵니다. 켜면 세 값이 뜹니다.
    • Depth 시드로부터 몇 홉까지 걸어갈지 (기본 1, 최대 3)
    • Decay 홉당 점수 감쇠 (0~1)
    • Cap 가져올 이웃 최대 수
Memory agent (큐레이터) 이 공간을 관리하는 에이전트입니다. 필드는 Wiki 메모리와 동일합니다(모델·정책 프롬프트·멀티모달·백그라운드 저장).

​
Agent 에 붙이기

Flow 빌더에서 Agent 를 열고 메모리 탭 → 메모리 추가. Index 공간은 Retrieval preset 을 스페이스별로 지정할 수 있습니다. 기본 최근성 순으로 두거나, 워크스페이스 프리셋을 골라 벡터 top-k 검색을 씁니다.

​
사실이 쌓이는 방식

  • 메모리 에이전트가 자동으로 실행이 끝날 때 대화·문서에서 엔티티·사실·관계를 뽑아 씁니다. Graph 형태에서는 트리플로, Vector 형태에서는 콘텐츠로 저장합니다.
  • Agent가 명시적으로 Agent 프롬프트에서 사실을 저장하도록 지시할 수 있습니다.
  • 직접 또는 CLI로 nora memory를 사용해 알려진 사실을 미리 채우거나 이전할 수 있습니다.

​
엔티티 병합 (Graph 전용)

같은 엔티티를 여러 번 다르게 말한 것(예: “Alice”, “alice@company.com”) 은 같은 노드로 묶어야 합니다. Nora 가 정확 ID 매치와 별칭 기반으로 자동 병합합니다. 수동으로 병합하려면 Graph 탭에서 노드를 여러 개 선택한 뒤 Merge 를 누릅니다.

​
정리

  • 검색에서 제외 Facts 탭에서 행 우측 X 버튼, Graph 탭에서 노드/엣지 선택 후 Delete 키. 둘 다 소프트 삭제라 리트리벌에서 숨겨집니다.
  • Supersede on conflict Settings 의 토글 하나로 자동 갱신 정책을 켭니다.
  • 중요도 감쇠 오랫동안 리트리벌되지 않은 사실은 τ에 따라 감쇠해 자연스럽게 결과에서 밀려납니다.
자세한 것은 잊기 참고.

​
관계 그래프와 인과 그래프

Index (Graph) 는 Agent 가 쌓는 엔티티-관계 메모리입니다. 인과 그래프는 답변 검증과 원인-결과 분석에 쓰는, 여러분이 만든 별개 기능입니다. 이름은 비슷하지만 서로 독립이고, 둘 다 함께 쓸 수 있습니다.