# Agent NAS: AI 에이전트를 위한 네트워크 연결 스토리지

> Agent NAS는 “실행”을 중심으로 설계한 네트워크 연결 스토리지입니다. 에이전트의 모든 실행은 격리된 브랜치에서 작업하고, 수명이 짧고 범위가 좁은 리스를 통해 데이터에 접근합니다. 모든 변경은 추적하고 되돌릴 수 있으며, 메모리는 출처를 가진 평범한 파일입니다. 에이전트가 이미 쓰는 파일, Git, S3, MCP로 접근할 수 있습니다.

**에이전트가 일하고, 당신이 통제권을 유지하는 곳.** “실행”을 기본 단위로 삼는 NAS입니다. 실행마다 전용 브랜치와 리스가 주어지고, 모든 변경은 추적하고 되돌릴 수 있으며, 메모리는 읽고 고치고 가져갈 수 있는 노트입니다.

## 한눈에 보기

- **분류**: AI 에이전트를 위한 네트워크 연결 스토리지. 에이전트 네이티브 스토리지(agent-native storage)라고도 합니다.
- **핵심 아이디어**: 접근의 단위는 계정이 아니라 **실행**입니다. 실행은 브랜치에서 작업하고, 리스를 통해 데이터에 접근하며, 기록을 남깁니다.
- **네 가지 약속**: 범위가 제한되고, 복구할 수 있고, 책임을 물을 수 있고, 들여다볼 수 있습니다.
- **핵심 명사**: Tree, Commit, Principal, Run, Lease, Record.
- **개념**: 이름이 붙은 9가지 개념을 작업, 권한, 지식의 세 그룹으로 나눕니다.
- **인터페이스**: 데이터 플레인: 마운트, Git, S3, WebDAV. 컨트롤 플레인: MCP, HTTP, CLI.
- **명세**: 초안 v0.2. 적합성 수준은 L0 Files부터 L4 Sync까지이며, 각 수준마다 실행 가능한 인수 테스트가 있습니다.
- **상태**: 개념과 명세 단계이며 참조 구현은 아직 없습니다. L0과 L1은 기존 부품으로 지금 바로 만들 수 있습니다.
- **라이선스**: 콘텐츠는 CC BY 4.0입니다.

## 지금이어야 하는 이유

지난 1년 사이에 이미 네 가지 일이 일어났습니다.

- **에이전트는 파일 안에서 일합니다.** [AGENTS.md](https://agents.md), [Agent Skills](https://agentskills.io/specification), Git 기반 메모리([Letta Context Repositories](https://www.letta.com/blog/context-repositories/)), 긴 출력을 파일로 기록하는 [동적 컨텍스트 탐색](https://cursor.com/blog/dynamic-context-discovery)을 거치며 파일은 에이전트의 작업 매체가 되었습니다.
- **실수는 빠르고 값비쌉니다.** 2026년 4월, 한 코딩 에이전트가 관련 없는 파일에서 찾아낸 권한이 지나치게 넓은 토큰을 써서 [한 회사의 프로덕션 데이터베이스와 같은 볼륨의 백업을 9초 만에 삭제했습니다](https://www.theregister.com/software/2026/04/27/cursor-opus-agent-snuffs-out-startups-production-database/5224442).
- **사람은 모든 단계를 검토할 수 없습니다.** Anthropic에 따르면 사용자는 [권한 요청의 93~97%](https://claude.com/resources/articles/auto-mode-default-in-claude-code)를 승인합니다. 통제된 실험에서 사람이 잡아낸 것은 심어 둔 위험한 명령의 13.6%뿐이었습니다.
- **메모리가 공격 표면이 되었습니다.** [2026년의 여러 연구](https://arxiv.org/abs/2606.04329)는 영속 메모리에 기록된 악의적인 지시가 세션을 넘어 살아남으며, 입력이나 검색 단계에서만 방어해서는 효과가 작다는 것을 보여 줍니다.

스토리지 업체도 움직이고 있습니다. [QNAP QuAgent](https://www.qnap.com/en/software/quagent), [Synology DSM Agent](https://www.synology.com/en-us/beta/2026_DSM_Agent_1_0_Beta/release_note), [TrueNAS MCP](https://truenas.github.io/truenas-research-labs/)는 모두 에이전트가 장비를 관리하게 해 줍니다. 그러나 우리가 아는 한, 그 안의 데이터 위에서 다른 에이전트가 안전하게 일하는 방식에 대해 직접 설치해 운영할 수 있고, 개방적이며, 검증할 수 있는 계약은 아직 없습니다. [Agent NAS와 기존 접근 방식의 비교](https://agentnas.com/ko/compare/)를 참고하세요.

## 네 가지 약속

| 약속 | 의미 | 구현하는 개념 |
| --- | --- | --- |
| 범위가 제한됨 | 실행은 리스에 명시된 것만 건드릴 수 있고, 리스는 제때 효력을 잃습니다. 신뢰할 수 없는 콘텐츠를 읽은 세션은 민감한 데이터와 외부로 나가는 경로를 동시에 가질 수 없습니다. | [Capability Lease](https://agentnas.com/ko/concepts/capability-lease/), [Trust Labels](https://agentnas.com/ko/concepts/trust-labels/) |
| 복구할 수 있음 | 쓰기는 먼저 브랜치에 반영되고, 보호된 데이터는 검토를 거친 병합으로만 바뀝니다. 삭제는 소프트 삭제이며, 스냅샷은 어떤 리스의 권한도 미치지 않는 곳에 있습니다. | [Agent Branch](https://agentnas.com/ko/concepts/agent-branch/), [Human Gate](https://agentnas.com/ko/concepts/human-gate/) |
| 책임을 물을 수 있음 | 모든 변경이 누가, 누구를 대신해, 어떤 리스로 했는지와 무엇을 읽었는지에 답할 수 있습니다. | [Flight Recorder](https://agentnas.com/ko/concepts/flight-recorder/) |
| 들여다볼 수 있음 | 메모리는 출처가 있는 평범한 노트이고, 인덱스는 버렸다가 다시 만들 수 있으며, 모든 데이터를 내보낼 수 있습니다. | [Agent Home](https://agentnas.com/ko/concepts/agent-home/), [Agent Memory](https://agentnas.com/ko/concepts/agent-memory/), [Budgeted Reads](https://agentnas.com/ko/concepts/budgeted-reads/), [Cascade Forget](https://agentnas.com/ko/concepts/cascade-forget/) |

## 9가지 개념, 세 가지 질문

Agent NAS는 이름이 붙은 9가지 개념을 제안합니다. 개념마다 전용 페이지가 있으며, 그대로 인용할 수 있는 정의, 동작 방식, 작게 시작하는 방법, 인터페이스 스케치, 명세가 요구하는 사항, 그리고 솔직한 한계를 담고 있습니다.

### 작업

작업은 어디에서 이루어지고, 무슨 일이 있었는가?

- AN-01 [Agent Home (에이전트 홈)](https://agentnas.com/ko/concepts/agent-home/): 역할마다 하나씩, 이력이 있는 디렉터리. 가지고 떠날 수 있는 평범한 파일.
- AN-02 [Agent Branch (에이전트 브랜치)](https://agentnas.com/ko/concepts/agent-branch/): 실행마다 쓰기 시 복사(copy-on-write) 브랜치에서 일합니다. 메인 라인에 닿는 것은 검토를 거친 병합뿐입니다.
- AN-03 [Flight Recorder (플라이트 레코더)](https://agentnas.com/ko/concepts/flight-recorder/): 실행마다 하나, 해시로 연결되며 읽은 것까지 담는 기록.

### 권한

누가, 누구의 승인으로 무엇을 할 수 있는가?

- AN-04 [Capability Lease (권한 리스)](https://agentnas.com/ko/concepts/capability-lease/): 한 번의 실행을 위한 좁은 인가. 만료 시점과 예산이 있고, 하위 리스는 더 좁아지기만 합니다.
- AN-05 [Human Gate (사람 승인 게이트)](https://agentnas.com/ko/concepts/human-gate/): 되돌릴 수 없거나, 외부로 나가거나, 권한을 높이는 동작 앞에만 나타나며, 실제 diff를 보여 줍니다.
- AN-06 [Trust Labels (신뢰 라벨)](https://agentnas.com/ko/concepts/trust-labels/): 작은 라벨 두 개와 세션 오염으로 Rule of Two를 강제합니다.

### 지식

에이전트는 무엇을 알고, 어떻게 읽고, 어떻게 잊는가?

- AN-07 [Agent Memory (에이전트 메모리)](https://agentnas.com/ko/concepts/agent-memory/): 읽고 고칠 수 있는 노트가 진실입니다. 인덱스는 버려도 되는 캐시입니다.
- AN-08 [Budgeted Reads (예산 읽기)](https://agentnas.com/ko/concepts/budgeted-reads/): 파일을 개요, 섹션, 줄 범위, 전체로 읽되, 예산에 맞춰 단계적으로 낮춥니다.
- AN-09 [Cascade Forget (연쇄 망각)](https://agentnas.com/ko/concepts/cascade-forget/): 계보를 따라 파생물을 삭제하고, 이력은 보존 등급으로 다루며, 하지 못한 일을 보고합니다.

## 네 개의 계층, 여섯 개의 명사

Store 계층은 검증된 스토리지를 그대로 씁니다. 그 위의 모든 계층은 Store에서 다시 만들 수 있고, 핵심은 Tree, Commit, Principal, Run, Lease, Record라는 여섯 개의 명사뿐입니다. 스토리지 엔진은 새로 만들지 않습니다. 혁신은 계약에 있습니다.

- **Interface (인터페이스)**: 에이전트, 사람, 도구가 이미 쓰는 인터페이스로 기능을 내보냅니다. 게이트웨이는 상태를 갖지 않으며, 누가 무엇을 할 수 있는지는 결코 결정하지 않습니다. (마운트 (POSIX), Git, S3, WebDAV/SMB, MCP, HTTP, CLI, A2A (선택))
- **Trust (신뢰)**: 유일한 인가 지점. 결정론적 정책이며, 판단에 모델이 관여하지 않습니다. (주체와 실행, Capability Lease, 정책 엔진, Human Gate, Trust Labels, Credential Broker, Flight Recorder)
- **Memory (메모리)**: 노트를 검색할 수 있는 지식으로 바꿉니다. 모두 아래 계층에서 다시 만들 수 있습니다. (Agent Memory, Budgeted Reads, Cascade Forget, 인덱스, 유지 관리 작업, 계보)
- **Store (스토어)**: 이력이 있는 트리. 검증된 파일 시스템 스냅샷, Git, 또는 버전 관리되는 오브젝트 스토리지 위에 만듭니다. (Tree, Commit, Agent Branch, 파일 시스템 스냅샷, Git, 오브젝트 스토리지)
- **Sync (동기화, 선택)**: 노드 사이의 복제와 공유. 일부러 마지막에 둡니다. 먼저 단일 노드를 제대로 만드는 것이 우선입니다. (Git 리모트, 스냅샷 전송, 리스 링크, 핸드오프 번들)

[아키텍처 읽기](https://agentnas.com/ko/architecture/).

## 한 번의 실행이 거치는 길

1. **리스를 요청합니다.** 연구 에이전트 Cleo의 오케스트레이터가 이번 실행을 위해 [Capability Lease](https://agentnas.com/ko/concepts/capability-lease/)를 요청합니다. `/shared/launch`를 읽고 변경을 제안할 수 있으며, 유효 기간은 네 시간입니다. 소유자가 미리 정해 둔 정책 범위 안에 있으므로 자동으로 승인됩니다.
2. **작업을 시작합니다.** NAS가 실행과 그 브랜치 `cleo/run_91ab`를 만들고, 샌드박스는 이 브랜치를 평범한 디렉터리로 마운트합니다. Cleo는 [Agent Home](https://agentnas.com/ko/concepts/agent-home/)에서 `AGENTS.md`와 검토를 마친 메모리를 읽습니다.
3. **예산 안에서 읽습니다.** 긴 보고서를 [Budgeted Reads](https://agentnas.com/ko/concepts/budgeted-reads/)로 읽습니다. 먼저 400토큰짜리 개요를 받고, 필요하면 특정 줄 범위를 읽습니다. 모든 읽기는 실행의 읽기 매니페스트에 더해집니다.
4. **브랜치에서 작업합니다.** 변경은 [Agent Branch](https://agentnas.com/ko/concepts/agent-branch/)에 반영됩니다. 공유 `main`은 지금은 전혀 바뀌지 않습니다.
5. **게이트를 만납니다.** Cleo가 웹 페이지를 읽었으므로 [Trust Labels](https://agentnas.com/ko/concepts/trust-labels/)가 세션에 `external` 오염을 표시합니다. `main`에 병합을 제안하면 정책이 [Human Gate](https://agentnas.com/ko/concepts/human-gate/)를 요구합니다. 소유자는 휴대폰에서 NAS가 계산한 실제 diff와 신뢰할 수 없는 출처를 확인하고 승인합니다.
6. **기록을 남깁니다.** 병합은 출처가 담긴 커밋을 만듭니다. 무엇을 읽고 무엇을 썼는지, 누가 무엇을 승인했는지가 해시로 연결되어 [Flight Recorder](https://agentnas.com/ko/concepts/flight-recorder/)에 들어갑니다.
7. **메모리를 정리합니다.** Cleo가 새로 알게 된 사실 몇 가지를 노트로 남깁니다. 이 세션은 외부 콘텐츠를 읽었으므로 이 [Agent Memory](https://agentnas.com/ko/concepts/agent-memory/) 노트는 먼저 격리됩니다. 불러올 수는 있지만 사람이 검토하기 전에는 자동으로 로드되지 않습니다.
8. **잊습니다.** 몇 주 뒤 고객이 잊어 달라고 요청합니다. [Cascade Forget](https://agentnas.com/ko/concepts/cascade-forget/)이 계보를 따라 관련된 요약과 인덱스를 삭제하고, 다루지 못한 범위를 명시한 보고서를 발급합니다.

## 에이전트가 이미 쓰는 언어로 말합니다

시작하는 데 새로운 SDK는 필요 없습니다. 파일을 읽고 쓰거나, Git이나 S3를 쓰거나, MCP 도구를 호출할 수 있는 에이전트라면 Agent NAS를 쓸 수 있습니다. 아래 세션은 계획 중인 명령줄을 보여 주는 예시일 뿐입니다.

*예시 세션*

```bash
$ nas lease create --role cleo --paths "/shared/launch/**" --actions read,write,propose --ttl 4h
lease lse_7Qk3 · run run_91ab · branch cleo/run_91ab · expires 16:00
$ nas mount --lease lse_7Qk3 ~/work       # plain files, on a branch
$ ./draft-release-notes.sh                # the agent works with ordinary tools
$ nas propose --into main
gate gt_2Mx4 waiting for approval: merge cleo/run_91ab into main (4 files)
$ nas gate approve gt_2Mx4                # the owner, from another terminal or a phone
merged · commit 91ce3a7 · record 18211
```

[모든 인터페이스 보기](https://agentnas.com/ko/interfaces/).

## 우리가 걸고 있는 것

몇 년 동안 유효하기를 바라는 설계라면, 무엇에 걸고 있는지와 그 예상이 빗나갔을 때 어떻게 되는지를 밝혀야 합니다.

- **에이전트는 앞으로도 파일 시스템과 Git을 주된 작업 매체로 쓸 것이다.** 그렇지 않다면 Agent Home은 내보내기 형식으로 격하되지만, 나머지 개념은 그대로 성립합니다.
- **“한 번의 실행”은 앞으로도 인가와 책임의 자연스러운 단위일 것이다.** 오래 이어지는 자율 프로세스가 나타나면 리스는 예산이 붙은 갱신의 연속이 됩니다.
- **프롬프트 인젝션은 예측 가능한 미래에 모델 계층에서 근절되지 않을 것이다.** 근절된다면 Trust Labels는 심층 방어의 저렴한 한 겹이 됩니다.
- **사람의 주의력은 앞으로도 희소할 것이다.** 완전 자동화를 충분히 믿을 수 있게 되면 Human Gate는 사전 승인 정책에 자리를 내주고, 감사 기록은 남습니다.

일곱 가지 베팅 전부는 [설계 원칙](https://agentnas.com/ko/principles/)에 있습니다.

## 이 사이트는 에이전트도 읽을 수 있습니다

모든 페이지에는 Markdown 쌍둥이 페이지가 있고, 사이트는 `llms.txt`를 공개하며, 읽기 전용의 작은 MCP 서버도 운영합니다. 터미널에서 직접 시험해 보세요.

*터미널*

```bash
curl -H "Accept: text/markdown" https://agentnas.com/what-is-agent-nas/
curl https://agentnas.com/llms.txt
curl -X POST https://agentnas.com/api/search \
  -H "content-type: application/json" \
  -d '{"query": "capability lease", "limit": 5}'
```

문서 서버를 MCP 클라이언트에 추가하려면 다음과 같이 설정합니다.

*mcp.json*

```json
{
  "mcpServers": {
    "agentnas-docs": { "url": "https://agentnas.com/mcp" }
  }
}
```

## 가장 먼저 나오는 질문

### Agent NAS를 한 문장으로 설명하면?

“실행”을 중심으로 설계한 네트워크 연결 스토리지입니다. 에이전트의 모든 실행은 격리된 브랜치에서 작업하고, 수명이 짧고 범위가 좁은 리스를 통해 데이터에 접근합니다. 모든 변경은 추적하고 되돌릴 수 있으며, 메모리는 출처를 가진 평범한 파일입니다.

### 내려받을 수 있는 소프트웨어가 있나요?

아직 없습니다. Agent NAS는 현재 개념과 명세 초안(v0.2) 단계입니다. L0과 L1은 Git, 파일 시스템 스냅샷, 작은 게이트웨이로 지금 만들 수 있습니다. 참조 구현 v0의 목표는 2027년 상반기입니다. [로드맵](https://agentnas.com/ko/roadmap/)을 참고하세요.

### NAS 제조사가 내놓는 AI 에이전트와는 어떻게 다른가요?

그런 에이전트는 장비를 관리합니다. Agent NAS는 장비 안의 데이터 위에서 다른 에이전트가 어떻게 일하는지를 규정합니다. 브랜치, 리스, 메모리, 망각입니다. 둘은 서로 보완하며, 제조사의 장비는 Overlay 배포의 기반이 될 수 있습니다.

### 기존 스토리지를 대체하나요?

아닙니다. Overlay 배포 형태는 기존 NAS, 오브젝트 스토어, Git 호스트 앞에 놓이며, 그 안의 디렉터리나 버킷 하나만 관리합니다.

### 프롬프트 인젝션을 막을 수 있나요?

막지 못합니다. 인젝션 이후에 일어나는 일을 제한하고, 그 결과를 눈에 보이게 하며 되돌릴 수 있게 합니다. 솔직한 한계는 [보안](https://agentnas.com/ko/security/) 페이지에 있습니다.

### 언제든 떠날 수 있나요?

그렇습니다. 모든 것을 평범한 파일과 Git 이력으로 내보낼 수 있습니다. 선택 기능이 아니라 설계상의 보장입니다.

[모든 질문과 답변](https://agentnas.com/ko/faq/).

## 현재 상태

> **상태.** Agent NAS는 개념과 명세 초안 단계(v0.2, 2026년 11월)입니다. v0.2는 설계를 현실에 맞게 다잡은 개정으로, 13가지 개념을 9가지로 줄이고 각 개념마다 작게 시작하는 방법과 솔직한 한계를 적었습니다. 아직 참조 구현은 없습니다.

- [명세 초안](https://agentnas.com/ko/spec/): 적합성 수준과 실행 가능한 인수 테스트.
- [로드맵](https://agentnas.com/ko/roadmap/): 지금, 다음, 이후, 그리고 하지 않을 것.
- [프로젝트 소개](https://agentnas.com/ko/about/): 라이선스, 인용 방법, 참여 방법.

---

표준 URL: https://agentnas.com/ko/
최종 수정: 2026-11-11 · 명세 초안 v0.2 · CC BY 4.0