본문으로 건너뛰기

스토리지브라우저참조

StorageBrowserRef저장된 Agent에 연결된 인라인 브라우저 구성입니다. 그만큼providerID는 수화 시간에 해결됩니다.BrowserProvider등록된MastraEditor.browsers.

BuilderAgentDefaults.browser와 저장된 Agent 레코드에서 사용하는 유형입니다.

사용예
사용예에 대한 직접 링크

src/mastra/index.ts
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 },
          },
        },
      },
    },
  },
})

유형
유형에 대한 직접 링크

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

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

속성
속성에 대한 직접 링크

type:

'inline'
판별자입니다. 리터럴 "inline"이어야 합니다.

config:

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

StorageBrowserConfig
storagebrowserconfig에 대한 직접 링크

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

provider:

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

headless?:

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

viewport?:

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

timeout?:

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

screencast?:

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

format?:

'jpeg' | 'png'
이미지 형식입니다.

quality?:

number
JPEG 품질(0~100)입니다.

maxWidth?:

number
최대 너비(픽셀)입니다.

maxHeight?:

number
최대 높이(픽셀)입니다.

everyNthFrame?:

number
N번째 프레임마다 캡처합니다.

수분 공급
수분 공급에 대한 직접 링크

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

On this page