> Discover all available pages from the documentation index: https://mastra.zisheng.pro/ko/llms.txt

# 스토리지작업공간참조

`StorageWorkspaceRef`저장된 Agent에 작업공간을 연결하는 데 사용되는 식별된 공용체입니다. ID로 Mastra 런타임에 등록된 작업공간을 가리키거나 작업공간 스냅샷을 인라인에 포함합니다.

[`BuilderAgentDefaults.workspace`](https://agent-builder.mastra.ai/reference/builder-agent-defaults)와 저장된 Agent 레코드에서 사용하는 유형입니다.

## 사용예

```typescript
import { MastraEditor } from '@mastra/editor'

// Variant 1 — reference a runtime workspace by id
new MastraEditor({
  builder: {
    enabled: true,
    configuration: {
      agent: {
        workspace: { type: 'id', workspaceId: 'builder-workspace' },
      },
    },
  },
})

// Variant 2 — inline a workspace snapshot
new MastraEditor({
  builder: {
    enabled: true,
    configuration: {
      agent: {
        workspace: {
          type: 'inline',
          config: {
            name: 'inline-builder-workspace',
            filesystem: {
              provider: 'local',
              config: { basePath: './agent-files' },
            },
          },
        },
      },
    },
  },
})
```

## 변형

**{ type: 'id'; workspaceId: string }** (`IdRef`): new Mastra({ workspace }) 또는 mastra.addWorkspace()를 통해 Mastra 런타임에 등록된 Workspace를 참조합니다. id는 관리자 구성, 저장된 Agent 레코드 및 하이드레이션을 연결하는 조인 키입니다.

**{ type: 'id'; workspaceId: string }.type** (`'id'`): 판별자입니다. 리터럴 "id"여야 합니다.

**{ type: 'id'; workspaceId: string }.workspaceId** (`string`): Mastra 런타임에 등록된 Workspace의 ID입니다. Builder가 Workspace의 스냅샷을 만들고 영구 저장한 후 나중에 하이드레이션하는 데 사용합니다.

**{ type: 'inline'; config: StorageWorkspaceSnapshotType }** (`InlineRef`): Workspace 스냅샷을 직접 포함합니다. Builder는 inline-\<sha256(config)\[:12]> 형식의 결정적 ID를 도출하고 스냅샷을 영구 저장하므로, 동일한 인라인 구성은 여러 Agent에서 중복 제거됩니다.

**{ type: 'inline'; config: StorageWorkspaceSnapshotType }.type** (`'inline'`): 판별자입니다. 리터럴 "inline"이어야 합니다.

**{ type: 'inline'; config: StorageWorkspaceSnapshotType }.config** (`StorageWorkspaceSnapshotType`): 직렬화된 Workspace 구성입니다(파일 시스템, Sandbox, 마운트, 검색, Skill, Tool). 필드 목록은 아래의 StorageWorkspaceSnapshotType 섹션을 참조하세요.

## `StorageWorkspaceSnapshotType`

아래에 삽입된 `{ type: 'inline', config }` 형태입니다. `@mastra/core/storage`에 정의되어 있습니다.

**name** (`string`): Workspace의 표시 이름입니다.

**description** (`string`): Workspace 목록에 표시되는 용도 설명입니다.

**filesystem** (`StorageFilesystemConfig`): 기본 파일 시스템 구성입니다. provider는 MastraEditor.filesystems에 등록된 ID와 일치해야 합니다(기본 제공: local).

**sandbox** (`StorageSandboxConfig`): Sandbox 구성입니다. provider는 MastraEditor.sandboxes에 등록된 ID와 일치해야 합니다(기본 제공: local).

**mounts** (`Record<string, StorageFilesystemConfig>`): Workspace에 마운트되는 추가 파일 시스템입니다. 마운트 경로를 키로 사용합니다.

**search** (`StorageSearchConfig`): 검색 구성입니다(벡터 Provider, 임베더, BM25 설정).

**skills** (`string[]`): 이 Workspace에 할당된 Skill 엔터티 ID입니다.

**tools** (`StorageWorkspaceToolsConfig`): Workspace Tool 구성입니다(허용 목록, 기본값).

**autoSync** (`boolean`): 파일 시스템과 Sandbox 간의 자동 동기화입니다. (Default: `false`)

**operationTimeout** (`number`): 개별 작업의 제한 시간(밀리초)입니다.

## 수분 공급

`StorageWorkspaceRef`는 `list()`가 아닌 `mastra.editor.agent.getById()`에서 지연 해석됩니다. Editor는 `MastraEditor.filesystems` / `MastraEditor.sandboxes`에서 파일 시스템 및 Sandbox Provider를 조회하여 런타임 `Workspace`를 구체화합니다. 누락된 Provider는 경고로 표시되며 Workspace는 생략됩니다.

## 관련된

- [작업공간](https://agent-builder.mastra.ai/workspace): 개념 및 작업 사례.
- [BuilderAgentDefaults](https://agent-builder.mastra.ai/reference/builder-agent-defaults): 이 유형이 Builder 기본값으로 고정되어 있는 곳입니다.
- [MastraEditor 클래스](https://mastra.zisheng.pro/ko/reference/editor/mastra-editor): 파일 시스템 및 샌드박스 공급자를 등록합니다.
- [스토리지브라우저참조](https://mastra.zisheng.pro/ko/reference/editor/storage-browser-ref): 브라우저 구성을 위한 형제 참조 유형입니다.