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

# Wiki 메모리

> 사람과 Agent 가 함께 쓰는 노트. 오래 남는 팀 지식과 상시 절차를 담습니다

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

**Wiki 메모리**는 사람과 Agent 가 마크다운으로 함께 쓰는 노트 공간입니다. 팀 위키처럼 오래 남고, 리트리벌은 의미 검색으로 이루어집니다.

## 언제 쓰나

* **상시 운영 절차·플레이북** "환불 처리 시 항상 주문 상태를 먼저 확인" 같은 규칙을 저장할 때 씁니다.
* **외부 문서에 없는 팀 지식** 커뮤니케이션 톤이나 예외 처리 방식을 저장할 때 씁니다.
* Agent 가 이후에도 계속 참조해야 할 결정과 결론

<DocImage src="/images/docs/memory-wiki-note.png" alt="Wiki 스페이스에 쌓인 노트: 왼쪽에 노트 목록, 오른쪽에 마크다운 본문" />

## 만들기

**메모리 → 새 공간 → Wiki (notes)** 로 즉시 생성됩니다. 자세한 흐름은 [메모리 개요 → 공간 만들기](/ko/build/memory/overview#공간-만들기)를 참고하세요.

## 상세 페이지

Wiki 를 열면 이렇게 구성됩니다.

* **Notes 탭** 왼쪽에는 노트 목록, 오른쪽에는 마크다운 에디터가 있습니다. 상단 필터로 스코프별로 좁혀 봅니다.
* **Log 탭** 이 공간의 이벤트를 시간순으로 표시합니다.
* **Settings 탭** 아래 내용을 참고하세요.

에디터에는 세 가지 필드가 있습니다.

* **경로 (path)** 선택 사항입니다. Agent가 노트를 참조하는 주소입니다. 모노스페이스로 표시되며, `docs/refund-policy` 같은 폴더 형식으로 작성하면 노트를 묶어 정리하기 편합니다.
* **제목 (title)** 선택 사항입니다. 사람에게 표시되는 이름입니다.
* **본문** 마크다운으로 작성합니다. 상단의 편집/미리보기 토글로 렌더링 결과를 바로 확인할 수 있습니다.

저장하면 리트리벌용 임베딩이 자동으로 갱신됩니다.

## Settings 탭에서 정하는 것

**Basics** 공간 이름을 바꿉니다. 패러다임(Wiki)은 생성 후 고정입니다.

**Flow 바인딩** 이 공간을 특정 Flow 하나에 바인딩하면 그 Flow 의 모든 Agent 가 자동으로 이 공간을 읽고 씁니다. 바인딩하지 않으면 Flow 빌더에서 Agent 마다 개별로 붙입니다.

**스코프** 어떤 요청 파라미터로 노트를 나눌지 정합니다. `flow_id` / `thread_id` / `user_id` / 커스텀 키를 조합할 수 있습니다. [스코핑](/ko/build/memory/scoping)을 참고하세요.

**Access** (선택) 파티션 키(호출자 신원으로 자동 필터)와 필요 권한 게이트를 걸어 접근 자체를 통제합니다. [스코핑 → 접근 제어](/ko/build/memory/scoping#접근-제어선택)를 참고하세요.

**Memory agent (큐레이터)** Wiki 공간을 관리하는 에이전트입니다. 무엇을 남기고, 늘리고, 지울지 이 에이전트가 정합니다.

* **모델** 추출·통합을 수행합니다. 워크스페이스에 키를 등록한 공급자 중에서 고릅니다. 비우면 저비용 기본값을 씁니다.
* **정책 프롬프트** 무엇을 남기고 지울지 지시하는 자유 문장. 예: "고객의 안정적 선호·결정은 남기고, 잡담은 버리고, 선호가 바뀌면 기존 것을 대체."
* **멀티모달** 이미지·음성·비디오를 메모리에 어떻게 담을지 (`재사용` / `참조` / `재분석`). `재분석`은 추가 비용이 듭니다.
* **백그라운드 저장** 켜 두면 저장·삭제가 응답 경로 밖에서 처리되어 응답 지연이 없습니다. 검색은 항상 동기입니다. 켜 두기를 권합니다.

## Agent 에 붙이기

Flow 빌더에서 Agent 를 열고 **메모리** 탭 → **메모리 추가** 로 붙입니다. 예산이 걱정이면 같은 탭의 **메모리 최대 비용**을 켜세요. Flow 전체가 같은 Wiki 를 쓴다면 Settings 의 **Flow 바인딩**을 쓰는 것이 편합니다.

## 노트가 쌓이는 방식

세 가지 경로가 있습니다.

**메모리 에이전트가 자동으로** 실행이 끝날 때 위 **정책 프롬프트** 에 따라 남길 것을 추려 씁니다. 사용자 개입 없이 이 경로가 대부분을 채웁니다.

**Agent 가 명시적으로** Agent 프롬프트에서 저장을 지시하도록 만들 수 있습니다. 트레이스에 도구 호출로 남아 가시성이 좋고, 어떤 것을 남길지 프롬프트로 좁게 제어할 수 있습니다.

**직접(사람) 또는 CLI** Wiki 상세 페이지에서 새 노트를 직접 작성하거나, [`nora memory`](/ko/cli/memory) 로 스크립트 실행. 알려진 사실을 미리 채워 두거나 기존 스토어에서 이전할 때 유용합니다.

## 노트가 검색되는 방식

Wiki 가 붙은 Agent 가 모델을 부를 때마다 자동으로 리트리벌이 걸립니다. 지식 검색과 비슷하지만 스코프가 걸리고, 메모리에 맞춘 랭킹을 씁니다.

* **관련성** 지금 쿼리와 노트 내용의 의미적 거리
* **최근성** 최근에 쓴 노트를 위로. 시간이 지나면 점수가 감쇠
* **중요도** 중요도가 높은 노트를 위로

리트리벌 프리셋은 Agent마다 다르게 설정할 수 있습니다. Agent 인스펙터의 **메모리** 탭에서 연결한 공간별로 **Retrieval preset** 을 고릅니다.

## 룰 스타일 노트

절차·룰을 담을 때는 노트에 트리거·액션을 명확히 적으면 메모리 에이전트가 관련 상황에서 잘 회상해 옵니다.

```markdown theme={null}
# 환불 처리 룰

Trigger: 사용자가 `refund` 를 말할 때
Action: 주문이 환불 가능한지 보려고 `lookup_order` 를 항상 먼저 호출한다.
```

정책 프롬프트에 "룰 형식 노트는 관련 상황에서 항상 컨텍스트에 포함" 이라고 지시해 두면 룰이 매 턴 반영됩니다. Wiki 자체에 "rule" 타입이라는 개념은 없고, 그냥 마크다운 노트의 관례일 뿐입니다.

## 노트 정리

* **편집** 노트 클릭 → 에디터에서 수정. 저장 시 임베딩 자동 갱신
* **검색에서 제외** 에디터 우측 상단 `⋯` 메뉴 → **검색에서 제외**. 소프트 삭제라 리트리벌에서 사라지고 하단에 되돌리기 토스트가 잠깐 뜹니다
* **중복** 같은 스코프 안에서 사실상 같은 내용이 자동으로 병합됩니다. Agent 가 "Alice 는 이메일을 선호" 를 다섯 번 쓰는 일이 없습니다.

더 자세한 정리 방법은 [잊기](/ko/build/memory/forgetting)를 참고하세요.

## 트레이스에서 살펴보기

Draft 실행 시 트레이스 뷰에서 실행당 모든 메모리 읽기·쓰기가 보입니다.

* **읽기** 쿼리, 반환된 top-N 항목, 스코프
* **쓰기** 내용, 스코프, 새 항목인지 중복 업데이트인지

배포 전 Draft 에서 메모리 동작을 확인하기 좋습니다.