> For the complete documentation index, see [llms.txt](https://help.genesis.autify.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.genesis.autify.com/features-ko/resources-context/workspace-memory.md).

# 워크스페이스 메모리

이 문서에서는 **리소스 및 컨텍스트** 탭 안의 **메모리** 기능을 설명합니다. 워크스페이스 메모리는 Genesis 에이전트가 채팅·워크플로·MCP를 통해 기록하는 워크스페이스 단위의 영구적인 지식입니다. 개별 작업을 넘어 남겨야 할 지식이 사실·결정·규칙·주의 사항으로 축적되며, 이후 채팅과 워크플로 실행의 컨텍스트에 자동으로 포함되어 참조됩니다.

## 사전 조건

| 작업        | 필요한 권한    |
| --------- | --------- |
| 메모리 목록 보기 | 전체 구성원    |
| 메모리 보관    | 관리자 / 소유자 |

## 기록되는 지식의 종류

워크스페이스 메모리는 다음 4가지 종류로 분류됩니다.

| 종류    | 설명                |
| ----- | ----------------- |
| 사실    | 프로젝트에 관한 사실       |
| 결정    | 팀이 내린 의사결정        |
| 규칙    | 따라야 할 규칙이나 규약     |
| 주의 사항 | 놓치기 쉬운 함정이나 주의할 점 |

각 메모리에는 유효 시작 일시(및 선택적으로 유효 종료 일시)가 설정되며, 다음 중 하나의 상태로 표시됩니다.

| 상태    | 설명                            |
| ----- | ----------------------------- |
| 현재 유효 | 현재 시점에 유효한 메모리                |
| 적용 예정 | 유효 시작 일시가 아직 도래하지 않은 메모리      |
| 기록    | 유효 종료 일시가 지나 더 이상 유효하지 않은 메모리 |

새 메모리가 기존 메모리를 **업데이트**(이전 메모리를 대체)하거나 **확장**(둘 다 유효한 상태로 유지)하는 관계도 함께 표시됩니다.

{% hint style="info" %}
워크스페이스 메모리에는 인증 정보나 개인 키를 저장할 수 없습니다. 해당 패턴과 일치하는 내용은 저장 시 거부됩니다.
{% endhint %}

## Genesis에서의 활용

Genesis 에이전트는 채팅·워크플로·MCP 세 가지 경로로 워크스페이스 메모리를 읽고 씁니다.

* **채팅과 워크플로**: 에이전트는 `recallMemory` 도구로 필요한 지식을 검색하고, 작업을 넘어 남겨야 할 지식은 `writeMemory` 도구로 기록합니다. 현재 유효한 메모리는 대화나 워크플로 실행의 컨텍스트에도 자동으로 추가되어 에이전트가 판단 근거(증거)로 참조합니다.
* **MCP**: 외부 클라이언트는 MCP의 `recall_memory` / `write_memory` 도구로 동일한 메모리를 읽고 쓸 수 있으며, `consult` 도구를 사용하면 메모리를 포함한 워크스페이스 전체(사양·코드·파일·워크플로·실행 기록)를 아우르는 답변을 받을 수 있습니다.

## 메모리 확인하기

1. 워크스페이스 페이지에서 **리소스 및 컨텍스트** 탭을 선택합니다.
2. **메모리** 탭을 선택합니다.

목록에는 각 메모리의 종류, 상태, 내용, 유효 기간, 기록 출처(채팅 / 워크플로 / MCP)와 작성자, 기록 일시가 표시됩니다.

## 메모리 보관하기

1. **메모리** 탭에서 보관할 메모리의 행에 있는 **메모리 보관**(휴지통 아이콘)을 클릭하고, 확인 대화상자에서 **메모리 보관**을 클릭합니다.

{% hint style="warning" %}
보관하면 에이전트가 더 이상 이 메모리를 회상하거나 받지 않습니다. 이 작업은 되돌릴 수 없습니다.
{% endhint %}

## 참고 자료

* [리소스 및 컨텍스트 개요](/features-ko/resources-context/resources-and-context-overview.md)