본문으로 건너뛰기

실행.시작()

그만큼.start()메서드는 입력 데이터로 Workflow 실행을 시작하므로 처음부터 Workflow를 실행할 수 있습니다.

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

const run = await workflow.createRun()

const result = await run.start({
  inputData: {
    value: 'initial data',
  },
})

매개변수
매개변수에 대한 직접 링크

inputData?:

z.infer<TInput>
Workflow의 입력 스키마와 일치하는 입력 데이터입니다

requestContext?:

RequestContext
Workflow 실행 중 사용할 Request Context 데이터입니다

outputWriter?:

(chunk: TOutput) => Promise<void>
출력 청크가 생성될 때 처리하는 선택적 비동기 함수입니다

tracingContext?:

TracingContext
자식 span을 생성하고 메타데이터를 추가하기 위한 Tracing 컨텍스트입니다. Mastra의 Tracing 시스템을 사용할 때 자동으로 주입됩니다.

currentSpan?:

Span
자식 span을 생성하고 메타데이터를 추가하기 위한 현재 span입니다. 실행 중 사용자 정의 자식 span을 생성하거나 span 속성을 업데이트하는 데 사용합니다.

tracingOptions?:

TracingOptions
Tracing 구성을 위한 옵션입니다.

metadata?:

Record<string, any>
루트 Trace span에 추가할 메타데이터입니다. 사용자 ID, 세션 ID 또는 기능 플래그와 같은 사용자 정의 속성을 추가할 때 유용합니다.

requestContextKeys?:

string[]
이 Trace의 메타데이터로 추출할 추가 RequestContext 키입니다. 중첩 값에는 점 표기법을 지원합니다(예: 'user.id').

traceId?:

string
이 실행에 사용할 Trace ID입니다(1~32자의 16진수). 제공하면 이 Trace가 지정된 Trace의 일부가 됩니다.

parentSpanId?:

string
이 실행에 사용할 부모 span ID입니다(1~16자의 16진수). 제공하면 루트 span이 이 span의 자식으로 생성됩니다.

tags?:

string[]
이 Trace에 적용할 태그입니다. Trace를 분류하고 필터링하는 문자열 레이블입니다.

outputOptions?:

OutputOptions
출력 구성을 위한 옵션입니다.

includeState?:

boolean
결과에 Workflow 실행 상태를 포함할지 여부입니다.

보고
보고에 대한 직접 링크

result:

Promise<WorkflowResult<TState, TOutput, TSteps>>
단계 출력과 상태가 포함된 Workflow 실행 결과로 이행되는 Promise입니다

traceId?:

string
Tracing이 활성화된 경우 이 실행과 연결된 Trace ID입니다. 로그를 연결하고 실행 흐름을 디버깅하는 데 사용합니다.

spanId?:

string
Tracing이 활성화된 경우 이 실행과 연결된 루트 span ID입니다. span 수준 조회와 연결에 사용합니다.

확장된 사용 예
확장된 사용 예에 대한 직접 링크

import { RequestContext } from '@mastra/core/request-context'

const run = await workflow.createRun()

const requestContext = new RequestContext()
requestContext.set('variable', false)

const result = await run.start({
  inputData: {
    value: 'initial data',
  },
  requestContext,
})
On this page