Agent NAS: AI 에이전트를 위한 네트워크 연결 스토리지. 에이전트가 일하고, 당신이 통제권을 유지하는 곳.

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

상태: 개념 및 명세 초안 v0.2 (2026년 11월). 참조 구현은 아직 없습니다.

Agent NAS 전면 패널 일러스트. 초록: 정상. 주황: 진행 중. 빨강: Human Gate에서 승인 대기 중.
Agent NAS

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

한눈에 보기

분류
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년 사이에 이미 네 가지 일이 일어났습니다.

스토리지 업체도 움직이고 있습니다. QNAP QuAgent, Synology DSM Agent, TrueNAS MCP는 모두 에이전트가 장비를 관리하게 해 줍니다. 그러나 우리가 아는 한, 그 안의 데이터 위에서 다른 에이전트가 안전하게 일하는 방식에 대해 직접 설치해 운영할 수 있고, 개방적이며, 검증할 수 있는 계약은 아직 없습니다. Agent NAS와 기존 접근 방식의 비교를 참고하세요.

네 가지 약속

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

9가지 개념, 세 가지 질문

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

작업

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

권한

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

지식

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

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

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

  1. Interface (인터페이스)

    에이전트, 사람, 도구가 이미 쓰는 인터페이스로 기능을 내보냅니다. 게이트웨이는 상태를 갖지 않으며, 누가 무엇을 할 수 있는지는 결코 결정하지 않습니다.

    • 마운트 (POSIX)
    • Git
    • S3
    • WebDAV/SMB
    • MCP
    • HTTP
    • CLI
    • A2A (선택)
  2. Trust (신뢰)

    유일한 인가 지점. 결정론적 정책이며, 판단에 모델이 관여하지 않습니다.

    • 주체와 실행
    • Capability Lease
    • 정책 엔진
    • Human Gate
    • Trust Labels
    • Credential Broker
    • Flight Recorder
  3. Memory (메모리)

    노트를 검색할 수 있는 지식으로 바꿉니다. 모두 아래 계층에서 다시 만들 수 있습니다.

    • Agent Memory
    • Budgeted Reads
    • Cascade Forget
    • 인덱스
    • 유지 관리 작업
    • 계보
  4. Store (스토어)

    이력이 있는 트리. 검증된 파일 시스템 스냅샷, Git, 또는 버전 관리되는 오브젝트 스토리지 위에 만듭니다.

    • Tree
    • Commit
    • Agent Branch
    • 파일 시스템 스냅샷
    • Git
    • 오브젝트 스토리지
Sync (동기화, 선택)

노드 사이의 복제와 공유. 일부러 마지막에 둡니다. 먼저 단일 노드를 제대로 만드는 것이 우선입니다.

  • Git 리모트
  • 스냅샷 전송
  • 리스 링크
  • 핸드오프 번들

아키텍처 읽기.

한 번의 실행이 거치는 길

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

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

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

예시 세션
$ 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

모든 인터페이스 보기.

우리가 걸고 있는 것

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

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

일곱 가지 베팅 전부는 설계 원칙에 있습니다.

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

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

터미널
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
{
  "mcpServers": {
    "agentnas-docs": { "url": "https://agentnas.com/mcp" }
  }
}

가장 먼저 나오는 질문

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

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

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

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

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

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

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

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

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

막지 못합니다. 인젝션 이후에 일어나는 일을 제한하고, 그 결과를 눈에 보이게 하며 되돌릴 수 있게 합니다. 솔직한 한계는 보안 페이지에 있습니다.

언제든 떠날 수 있나요?

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

모든 질문과 답변.

현재 상태

상태

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

이 페이지 인용하기

사람, 검색 엔진, 에이전트를 위한 고정 주소와 권장 인용 형식입니다.

권장 인용 형식
Agent NAS project. “Agent NAS: AI 에이전트를 위한 네트워크 연결 스토리지.” agentnas.com, 2026-11-11. https://agentnas.com/ko/