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

# Index 메모리

> 엔티티 사실을 벡터·그래프로 색인해 Agent 가 검색·순회로 찾습니다

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

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

## 언제 쓰나

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

## 만들기

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

<DocImage src="/images/docs/memory-index-tuning.png" alt="Index 스페이스 Settings: 인덱스 형태(vector/graph), 임베딩 모델, 고급 검색 튜닝" />

## 두 가지 형태

**Vector (기본)** 사실을 임베딩해 벡터로 색인하고, 의미 유사도로 검색합니다.

**Graph** 사실을 `(subject, relationship, object)` 형태의 엔티티-관계 트리플로 색인합니다.

```
(customer:alice) --[works_at]--> (org:acme)
(order:42)       --[refunded_on]--> (date:2026-07-15)
(order:42)       --[belongs_to]--> (customer:alice)
```

엔티티는 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 마다 개별로 붙입니다.

**스코프** 어떤 요청 파라미터로 사실을 나눌지. [스코핑](/ko/build/memory/scoping) 참고.

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

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

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

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

* **가중치** 관련성·최근성·중요도를 어떻게 섞을지 (기본 3/1/1)
* **τ (반감기, 일)** 최근성 감쇠 반감기. 기본 14일. 옛 사실이 새 사실만큼 유효한 도메인(용어집, 자리 잡은 절차)은 τ 를 키워 최근성 영향을 줄입니다
* **Supersede on conflict** 새 사실이 기존과 부딪히면 새 것이 이기고 옛것은 이력으로 남김. 꺼 두면 두 사실이 공존하며 리트리벌이 둘 다 반환
* **KG 그라운딩** 벡터 검색 후 그래프 관계로 연결된 이웃 사실도 함께 가져옵니다. 켜면 세 값이 뜹니다.
  * **Depth** 시드로부터 몇 홉까지 걸어갈지 (기본 1, 최대 3)
  * **Decay** 홉당 점수 감쇠 (0\~1)
  * **Cap** 가져올 이웃 최대 수

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

## Agent 에 붙이기

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

## 사실이 쌓이는 방식

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

## 엔티티 병합 (Graph 전용)

같은 엔티티를 여러 번 다르게 말한 것(예: "Alice", "[alice@company.com](mailto:alice@company.com)") 은 같은 노드로 묶어야 합니다. Nora 가 정확 ID 매치와 별칭 기반으로 자동 병합합니다.

수동으로 병합하려면 Graph 탭에서 노드를 여러 개 선택한 뒤 **Merge** 를 누릅니다.

## 정리

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

자세한 것은 [잊기](/ko/build/memory/forgetting) 참고.

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

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