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

# 스토리지브라우저참조

`StorageBrowserRef`저장된 Agent에 연결된 인라인 브라우저 구성입니다. 그만큼`provider`ID는 수화 시간에 해결됩니다.[`BrowserProvider`](https://mastra.zisheng.pro/ko/reference/editor/browser-provider)등록된[`MastraEditor.browsers`](https://mastra.zisheng.pro/ko/reference/editor/mastra-editor).

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

## 사용예

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

new MastraEditor({
  browsers: { [stagehandBrowserProvider.id]: stagehandBrowserProvider },
  builder: {
    enabled: true,
    configuration: {
      agent: {
        browser: {
          type: 'inline',
          config: {
            provider: 'stagehand',
            headless: true,
            viewport: { width: 1280, height: 720 },
          },
        },
      },
    },
  },
})
```

## 유형

```typescript
type StorageBrowserRef = { type: 'inline'; config: StorageBrowserConfig }
```

브라우저에는 `{ type: 'id' }` 변형을 사용할 수 없습니다. 브라우저는 항상 인라인됩니다.

## 속성

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

**config** (`StorageBrowserConfig`): Provider id 및 인스턴스별 브라우저 구성입니다. 아래 섹션을 참조하세요.

## `StorageBrowserConfig`

아래 구조는 `config`에 인라인됩니다. `@mastra/core/storage`에 정의되어 있습니다.

**provider** (`string`): Provider 식별자입니다(예: "stagehand"). MastraEditor.browsers에 등록된 BrowserProvider.id와 일치해야 합니다. 내장 Provider는 없습니다.

**headless** (`boolean`): 브라우저를 헤드리스 모드로 실행합니다(표시되는 UI 없음). (Default: `true`)

**viewport** (`{ width: number; height: number }`): 브라우저 뷰포트 크기입니다. 창 크기와 페이지 렌더링 방식을 제어합니다.

**timeout** (`number`): 브라우저 작업의 기본 제한 시간(밀리초)입니다. (Default: `10000`)

**screencast** (`ScreencastOptions`): 브라우저 프레임을 UI로 스트리밍하기 위한 스크린캐스트 옵션입니다.

**screencast.format** (`'jpeg' | 'png'`): 이미지 형식입니다.

**screencast.quality** (`number`): JPEG 품질(0\~100)입니다.

**screencast.maxWidth** (`number`): 최대 너비(픽셀)입니다.

**screencast.maxHeight** (`number`): 최대 높이(픽셀)입니다.

**screencast.everyNthFrame** (`number`): N번째 프레임마다 캡처합니다.

## 수분 공급

`StorageBrowserRef`는 `mastra.editor.agent.getById()`에서 지연 해석됩니다. 편집기는 `MastraEditor.browsers`에서 `config.provider`를 조회하고 `provider.createBrowser(config)`를 호출합니다. Provider가 등록되지 않은 경우 편집기는 경고를 기록하고 `undefined`를 반환합니다. Agent는 계속 로드되지만 브라우저는 포함되지 않습니다.

## 관련된

- [브라우저](https://agent-builder.mastra.ai/browser): 개념 및 작업 사례.
- [브라우저 제공자](https://mastra.zisheng.pro/ko/reference/editor/browser-provider): 구현자 측 공급자 인터페이스입니다.
- [BuilderAgentDefaults](https://agent-builder.mastra.ai/reference/builder-agent-defaults): 이 유형이 Builder 기본값으로 고정되어 있는 곳입니다.
- [스토리지작업공간참조](https://mastra.zisheng.pro/ko/reference/editor/storage-workspace-ref): 작업공간 구성을 위한 형제 참조 유형입니다.