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

# StorageBrowserRef

`StorageBrowserRef` は、保存された Agent に付加するインラインのブラウザー設定です。`provider` ID はハイドレーション時に、[`BrowserProvider`](https://mastra.zisheng.pro/ja/reference/editor/browser-provider) に対して解決されます。この Provider は [`MastraEditor.browsers`](https://mastra.zisheng.pro/ja/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 }`): ブラウザーの viewport の寸法。ウィンドウサイズとページのレンダリング方法を制御します。

**timeout** (`number`): ブラウザー操作のデフォルトタイムアウト（ミリ秒）。 (Default: `10000`)

**screencast** (`ScreencastOptions`): ブラウザーフレームを UI にストリーミングするための Screencast オプション。

**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()` の呼び出し時に遅延解決されます。Editor は `MastraEditor.browsers` で `config.provider` を検索し、`provider.createBrowser(config)` を呼び出します。Provider が登録されていない場合、Editor は警告をログに記録して `undefined` を返します。Agent は引き続き読み込まれますが、ブラウザーは使用できません。

## 関連情報

- [Browser](https://agent-builder.mastra.ai/browser): 概念と実践的な例。
- [BrowserProvider](https://mastra.zisheng.pro/ja/reference/editor/browser-provider): 実装者向けの Provider インターフェース。
- [BuilderAgentDefaults](https://agent-builder.mastra.ai/reference/builder-agent-defaults): この型を Builder のデフォルトとして固定する場所。
- [StorageWorkspaceRef](https://mastra.zisheng.pro/ja/reference/editor/storage-workspace-ref): Workspace 設定に対応する関連参照型。