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

# 실행.이력서()

그만큼`.resume()`메서드는 새 데이터로 일시 중단된 Workflow 실행을 재개하므로 특정 단계부터 계속 실행할 수 있습니다.

## 사용예

```typescript
const run = await workflow.createRun()

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

if (result.status === 'suspended') {
  const resumedResults = await run.resume({
    resumeData: { value: 'resume data' },
  })
}
```

## 매개변수

**resumeData** (`z.infer<TResumeSchema>`): 일시 중지된 단계를 재개하기 위한 데이터입니다

**step** (`Step<string, any, any, TResumeSchema, any, TEngineType> | [...Step<string, any, any, any, any, TEngineType>[], Step<string, any, any, TResumeSchema, any, TEngineType>] | string | string[]`): 실행을 재개할 단계입니다. Step 인스턴스, Step 배열, 단계 ID 문자열 또는 단계 ID 문자열 배열을 사용할 수 있습니다

**requestContext** (`RequestContext`): 재개할 때 사용할 Request Context 데이터입니다

**retryCount** (`number`): 중첩 Workflow 실행을 위한 선택적 재시도 횟수입니다

**forEachIndex** (`number`): 일시 중지된 .foreach() 단계의 특정 반복을 대상으로 지정합니다. 재개할 반복의 0부터 시작하는 인덱스를 전달하세요. 다른 반복은 일시 중지된 상태로 유지됩니다. 동일한 resumeData를 사용하여 해당 단계의 일시 중지된 모든 반복을 재개하려면 이 필드를 생략하세요.

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

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

**tracingOptions** (`TracingOptions`): Tracing 구성을 위한 옵션입니다.

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

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

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

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

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

**outputOptions** (`OutputOptions`): 출력 구성을 위한 옵션입니다.

**outputOptions.includeState** (`boolean`): 결과에 Workflow 실행 상태를 포함할지 여부입니다.

## 보고

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

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

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

## 확장된 사용 예

```typescript
if (result.status === 'suspended') {
  const resumedResults = await run.resume({
    step: result.suspended[0],
    resumeData: { value: 'resume data' },
  })
}
```

> **노트:** 정확히 한 단계만 일시 중지된 경우 `step` 매개변수를 생략할 수 있으며, Workflow가 해당 단계를 자동으로 재개합니다. 일시 중지된 단계가 여러 개인 Workflow에서는 재개할 단계를 명시적으로 지정해야 합니다.

### 싱글 재개[`.foreach()`](https://mastra.zisheng.pro/ko/reference/workflows/workflow-methods/foreach) iteration

[`.foreach()`](https://mastra.zisheng.pro/ko/reference/workflows/workflow-methods/foreach) 단계가 여러 반복에서 일시 중지되면 `forEachIndex`(0부터 시작)를 사용하여 서로 다른 `resumeData`로 한 번에 하나의 반복을 재개하세요. `forEachIndex`로 지정하지 않은 반복은 재개될 때까지 일시 중지된 상태로 유지됩니다.

```typescript
// Resume only the second iteration (index 1) with its own data
await run.resume({
  step: 'approve',
  resumeData: { ok: true },
  forEachIndex: 1,
})

// Later, resume the first iteration with different data
await run.resume({
  step: 'approve',
  resumeData: { ok: false },
  forEachIndex: 0,
})
```

`forEachIndex`를 생략하면 해당 단계에서 일시 중지된 모든 반복이 동일한 `resumeData`로 재개됩니다.

## 관련된

- [Workflow 개요](https://mastra.zisheng.pro/ko/docs/workflows/overview)
- [Workflow.createRun()](https://mastra.zisheng.pro/ko/reference/workflows/workflow-methods/create-run)
- [일시중단 및 재개](https://mastra.zisheng.pro/ko/docs/workflows/suspend-and-resume)
- [루프 속 인간](https://mastra.zisheng.pro/ko/docs/workflows/human-in-the-loop)