> ## 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",
  boxSizing: "border-box"
}} 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 탭**이 공간의 이벤트를 시간순으로 표시합니다. 왼쪽 목록에서 이벤트를 고르면 오른쪽에 원본 detail JSON 이 표시됩니다.
* **설정 탭** 아래 내용을 참고하세요.

## 설정 탭에서 정하는 것

Index 설정은 [메모리 설정](/ko/build/memory/settings#index)을 참고하세요.

## 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)는 답변 검증과 원인-결과 분석에 쓰는, 여러분이 만든 별개 기능입니다. 이름은 비슷하지만 서로 독립이고, 둘 다 함께 쓸 수 있습니다.