> ## Documentation Index
> Fetch the complete documentation index at: https://docs.platform.nora.my/llms.txt
> Use this file to discover all available pages before exploring further.

# 관계 그래프

> 구조화 사실을 Agent 가 순회할 수 있는 엔티티-관계 트리플로 저장.

일부 메모리는 자연스럽게 그래프 모양: *Alice → works at → Acme*, *Order 42 → refunded on → 2026-07-15*. 이를 **관계 트리플** 로 저장하면 Agent 가 순회할 수 있음 — 구조 질문에 답하기 위해 관계 따라가기.

## 관계 그래프가 맞는 곳

이 정보를 자유 텍스트 노트로 저장하고 리트리벌이 찾게 할 수도 있음. 동작함. 하지만 관계 그래프가 더 나은 때:

* Agent 가 **멀티홉 질문에 답해야 함** ("Alice 와 같은 회사에서 일하는 다른 사람은?").
* 안정된 ID 를 가진 **정본 엔티티** 가 있음 (고객·제품·티켓·프로젝트).
* 관계에 대한 **필터·집계** 필요 ("이번 분기에 환불을 몇 건 발행했나?").

## 구조

트리플은 `(subject, relationship, object)`. subject 와 object 둘 다 ID 를 가진 엔티티. relationship 은 이름 있는 엣지 타입.

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

엔티티는 ID 외에 속성 (name, created\_at, 커스텀 필드) 가질 수 있음.

## 그래프 메모리 스페이스 만들기

메모리 스페이스 만들 때 **Index** 타입 선택하고 **Graph mode** 켬. 표준 벡터 인덱스 위에 엔티티/관계 모델 활성화.

## 트리플 쓰기

Agent 로부터:

* `remember_fact` 도구를 `subject`, `relationship`, `object` 와 함께 사용.
* 또는 스페이스에 **Auto-extract triples** 켜기 — Nora 가 자유형 Agent 노트에서 엔티티·관계를 자동 추출.

CLI 로부터:

```bash theme={null}
nora memory triple <space> \
  --subject "customer:alice" \
  --relationship "works_at" \
  --object "org:acme"
```

## 순회

그래프 스페이스에 붙이면 Agent 가 두 도구 획득:

* **`recall_facts`** — ID 나 이름으로 엔티티에 대한 사실 리트리벌.
* **`traverse`** — 엣지 따라가기. "Alice 가 어디서 일해?" 물으면 `(entity, path)` 쌍 세트로 답변.

그래프 스페이스가 붙으면 두 도구 자동 추가.

## 양방향 엣지

관계는 **대칭** 표시 가능 (`same_as`, `sibling_of`) 이면 양방향 순회. 또는 명시적으로 방향 있음 (`works_at`, `parent_of`) 와 정의된 역 (`employs`, `child_of`) 함께.

스페이스 스키마에서 관계 타입별 설정.

## 엔티티 해소

같은 엔티티에 대한 여러 언급은 같은 노드로 해소되어야 함. Nora 자동 해소:

* 정확한 ID 매치.
* 별칭 매치 (엔티티별 별칭 목록).
* 유사도 임계값 이상의 퍼지 이름 매치 (조정 가능).

수동 병합 가능: **Space → Entities → 중복 선택 → Merge**.

## 모순

새 트리플이 기존과 모순되면 (`works_at` 이 Acme 라 했는데 새 트리플이 Beta), Nora 는 조용히 덮어쓰지 않음. 리뷰용으로 모순을 플래그, 또는 **auto-supersede on conflict** 를 켜면 새 트리플이 이기고 옛 것은 이력이 됨.

## 그래프 vs. 인과 그래프

관계 그래프 메모리는 Agent 가 축적하는 엔티티-관계 데이터. **인과 그래프** ([인과 그래프 개요](/ko/build/causal-graph/overview) 참고) 는 검증과 분석에 쓰이는 도메인-저작 원인-결과 변수 그래프. 다른 도구, 다른 작업 — 둘 다 쓸 수 있음.