Agent NAS v0.2
한국어

자주 묻는 질문

Agent NAS에 대해 가장 먼저 나오는 질문에 답합니다. 그것이 무엇인지, 기존 스토리지와 메모리 도구와 어떻게 다른지, 보안과 프라이버시를 어떻게 다루는지, 프로젝트가 어디까지 왔는지.

v0.2 명세 초안 최종 수정

기본 질문

Agent NAS란 무엇인가요?

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

Agent NAS는 구매하거나 내려받을 수 있는 제품인가요?

아직은 아닙니다. 현재는 명세 초안(v0.2, 2026년 11월)을 갖춘 개념입니다. L0과 L1은 기존 부품으로 지금 만들 수 있고, 참조 구현 v0의 목표는 2027년 상반기이며, 그 뒤의 계획은 로드맵에 있습니다.

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

QNAP, Synology, TrueNAS 같은 제조사의 에이전트는 장비를 관리합니다. Agent NAS는 장비 안의 데이터 위에서 다른 에이전트가 어떻게 일하는지를 규정합니다. 브랜치, 리스, 메모리, 망각입니다. 둘은 서로 보완합니다. 비교를 참고하세요.

벡터 데이터베이스나 메모리 프레임워크와는 어떻게 다른가요?

그것들은 검색과 통합을 위한 도구이고, Agent NAS에서 진실은 출처를 가진 평범한 노트입니다. 벡터 스토어나 메모리 프레임워크는 인덱서로서 Agent Memory 아래에 놓을 수 있고, 인덱스는 언제든 버렸다가 다시 만들 수 있습니다.

오픈 소스인가요?

명세와 이 사이트는 CC BY 4.0 라이선스입니다. 참조 구현은 Apache-2.0으로 오픈 소스로 공개할 계획입니다.

설계와 보안

왜 데이터베이스가 아니라 파일과 Git인가요?

에이전트는 파일로 수렴하고 있습니다. 지침은 AGENTS.md, 스킬은 SKILL.md, 메모리는 Markdown, 이력은 Git입니다. 파일은 어떤 도구와 어떤 모델이든 읽을 수 있고, 비교하기 쉽고, 가지고 나가기 쉽습니다. 데이터베이스와 인덱스도 쓰지만 다시 만들 수 있는 파생 계층으로 씁니다.

실행이 잘못되면 최악의 경우 어떻게 되나요?

최악의 경우는 버려도 되는 브랜치 하나를 잃는 것입니다. 보호된 메인 라인은 검토를 거친 병합으로만 바뀌고, 삭제는 소프트 삭제이며, 스냅샷은 모든 리스의 바깥에 있습니다. 이것은 실수가 NAS 안에서 일어난 경우에 성립합니다. 이미 보낸 이메일이나 이미 호출한 외부 API는 NAS가 되돌릴 수 없습니다.

리스는 OAuth 토큰과 어떤 관계인가요?

리스는 OAuth 액세스 토큰입니다. 토큰 교환(RFC 8693)으로 요청하고, Rich Authorization Requests(RFC 9396)로 경로와 동작을 기술합니다. Agent NAS가 더하는 것은 브랜치, 예산, Rule of Two 속성을 포함하는 실행 단위의 규약입니다. Capability Lease를 참고하세요.

왜 메모리가 “노트와 캐시”인가요?

들여다보고, 고치고, 옮기고, 잊을 수 있게 하기 위해서입니다. 노트는 파일이고, 인덱스, 임베딩, 요약은 기록된 레시피로 노트에서 계산됩니다. 임베딩 모델을 바꾸면 시스템이 백그라운드에서 다시 계산합니다. 오염된 세션이 쓴 노트는 먼저 격리되고, 검토되기 전에는 자동으로 로드되지 않습니다.

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

막지 못합니다. 모델 바깥의 어떤 것도 완전히 막을 수는 없습니다. Agent NAS는 인젝션에 당한 에이전트가 할 수 있는 일을 제한합니다. Trust Labels는 외부 콘텐츠를 읽은 세션이 민감한 데이터와 외부로 나가는 경로를 함께 갖지 못하게 하고, 중대한 동작에는 Human Gate가 필요합니다. 솔직한 한계는 보안 페이지에 있습니다.

“잊힐 권리”는 어떻게 다루나요?

Cascade Forget을 통해서입니다. 원본에서 파생된 요약, 임베딩, 노트를 계보를 따라 삭제하고, 이력은 보존 등급에 따라 다루며, sensitive 등급에서는 키를 파기합니다(암호학적 파기). 보고서에는 다루지 못하는 범위가 명시됩니다. NAS 밖의 사본, 모델 제공자의 로그, 모델 가중치입니다. 모델이 무언가를 잊게 만들 수는 없습니다.

MCP를 꼭 써야 하나요?

아닙니다. MCP는 컨트롤 플레인 인터페이스 중 하나일 뿐이며, 파일, Git, S3에는 필요하지 않습니다. 프로토콜 계층은 교체할 수 있게 설계되어 있습니다.

도입과 미래

기존 NAS나 클라우드 스토리지를 대체하나요?

아닙니다. Overlay 배포 형태는 기존 NAS, 오브젝트 스토어, Git 호스트 앞에 게이트웨이를 놓고 그 안의 디렉터리나 버킷 하나만 관리합니다. 클라우드 스토리지를 Store로 쓸 수도 있습니다.

어떤 에이전트 프레임워크와 런타임에서 쓸 수 있나요?

디렉터리를 마운트하거나 Git, S3, MCP를 쓸 수 있는 런타임이면 무엇이든 됩니다. Agent Home의 레이아웃은 열린 규약(AGENTS.md, Agent Skills, YAML 프런트매터가 있는 Markdown)을 따르므로 Claude Code, Cursor, Codex, OpenHands, LangGraph, 자체 프레임워크 모두 후보입니다.

언제든 떠날 수 있나요?

그렇습니다. 모든 것을 평범한 파일과 Git 이력으로 내보낼 수 있습니다. 이것은 기능이 아니라 네 가지 약속 가운데 하나입니다.

Agent NAS를 쓰지 말아야 할 때는 언제인가요?

에이전트가 하나이고 기꺼이 다시 만들 수 있는 데이터뿐일 때입니다. AGENTS.md를 둔 Git 저장소로 충분합니다. 다른 경우는 사용 사례에 있습니다.

인용하거나 기여하려면 어떻게 하나요?

모든 페이지에 표준 URL과 권장 인용 형식이 있습니다. 기여하려면 GitHub에서 이슈를 열거나 토론을 시작하세요. 자세한 내용은 프로젝트 소개를 참고하세요.

이 페이지 인용하기

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

권장 인용 형식
Agent NAS project. “자주 묻는 질문.” agentnas.com, 2026-11-11. https://agentnas.com/ko/faq/