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

# Evolution 메모리

> 성공한 개선에서 나온 패턴이 자동으로 쌓이는 자가진화 공간

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

**Evolution 메모리**는 개선 플로우가 확인·배포한 패턴이 자동으로 쌓이는 공간입니다. 여러분이나 Agent 가 직접 쓰는 곳이 아니라 **읽기 중심**이고, 붙여 둔 Agent 가 자연스럽게 덕을 봅니다.

이런 것을 다룹니다.

* 실패 → 원인 → 이긴 fix 로 이어진 **진단 패턴**
* 재사용될수록 신뢰가 오르는 **효능(efficacy)** 지표
* **안 쓰이면 감쇠하는 freshness** 오래된 외부 사실을 다시 검증해야 한다는 신호입니다.

## 언제 쓰나

* 품질을 복리로 쌓고 싶은 오래가는 Agent
* 실행이 많아 개선 플로우가 패턴을 빠르게 쌓는 대량 Agent
* 진단 메모리가 어떻게 자라는지 팀이 살펴봐야 하는 경우

## 만들기

**메모리 → 새 공간 → Evolution (self-evolving)** 로 즉시 생성됩니다. 사용자가 항목을 직접 채우지는 않고, 개선 플로우가 승인·배포된 개선마다 이 공간을 자동으로 채웁니다.

## 상세 페이지

Evolution 은 primary lens 안에 두 개의 sub-tab 이 있습니다.

* **Metrics** 총 항목 수, 재사용·재발 횟수, 효능·freshness 분포, 시간대별 성장 곡선을 보여 주는 지표 대시보드입니다.
* **Graph** 이 공간이 축적한 진단 패턴을 3D 그래프로 표시합니다. 노드를 클릭하거나 드래그해 탐색할 수 있습니다.
* **Log** 이벤트를 시간순으로 표시합니다.
* **Settings** 아래 내용을 참고하세요.

<DocImage src="/images/docs/memory-diagnostic.png" alt="Evolution 상세: Metrics 대시보드와 Graph 3D 뷰의 sub-tab" />

## Settings 탭에서 정하는 것

Evolution 은 자동 관리 공간이라 조정할 것이 적습니다.

**Basics** 이름을 바꿉니다.

**Flow 바인딩** 특정 Flow 에 바인딩해 그 Flow 의 Agent 들만 이 공간을 씁니다. 비워 두면 Agent 마다 개별로 붙입니다.

**스코프** 워크스페이스·테넌트 단위로 나눌지 결정 ([스코핑](/ko/build/memory/scoping) 참고).

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

Wiki/Index 처럼 정책 프롬프트나 검색 튜닝 필드는 없습니다. 채우기·감쇠·검증이 개선 플로우와 카나리 시스템에서 자동으로 이루어지기 때문입니다.

## Agent 에 붙이기

Flow 빌더 → Agent → **메모리** 탭 → **메모리 추가**. 붙어 있으면 Agent 가 진단할 때 관련 패턴을 자동으로 회상합니다.

## 노드 정리 (PRUNE)

Graph 탭에서 노드를 클릭하고 `Delete` 키를 누르면 그 진단 항목이 **소프트 제거** 됩니다. 잘못된 패턴을 손으로 걷어낼 때 씁니다.

제거 직후 우측 하단에 **Undo** 토스트가 뜹니다. 클릭하면 되돌립니다. 소프트 제거이므로 나중에도 관리자 도구로 복구할 수 있습니다.

<Note>
  Evolution 의 항목은 개선 플로우가 만든 것이라, 손으로 지운다는 것은 "이 패턴이 사실 유효하지 않다" 는 판단입니다. 지우기 전에 그 패턴이 왜 잘못됐는지 트레이스로 확인하는 걸 권합니다.
</Note>

## 개선 플로우와의 관계

Evolution 은 개선 플로우의 결과가 쌓이는 곳입니다. 신호 → 클러스터 → 개선 제안 → 시뮬레이션 → 승인 → 배포로 이어지는 루프가 매번 새 진단 패턴을 이 공간에 남깁니다. 자세한 것은 [개선 개요](/ko/reliable/improvements/overview) 를 참고하세요.