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

# Mastra.addDynamicWorkflow()

:::실험적

동적 Workflow는 베타 버전입니다. API가 안정될 때까지 주요 버전 변경 없이 주요 변경 사항이 발생할 수 있습니다.

:::

`.addDynamicWorkflow()` 메서드는 동적 Workflow 정의를 검증하고 인스턴스에 실제 Workflow로 등록하며, `workflowDefinitions` 스토리지 도메인을 통해 유지합니다. 등록된 Workflow는 [`getWorkflow()`](https://mastra.zisheng.pro/ko/reference/core/getWorkflow)를 통해 다른 Workflow와 동일하게 실행됩니다. 전체 설정 예시는 [동적 Workflow](https://mastra.zisheng.pro/ko/docs/workflows/dynamic-workflows)를, 허용되는 필드와 그래프 엔트리는 [동적 Workflow 정의 레퍼런스](https://mastra.zisheng.pro/ko/reference/workflows/dynamic-workflow-definition)를 참조하세요.

## 사용예

```typescript
await mastra.addDynamicWorkflow({
  id: 'greeting-workflow',
  description: 'Returns a greeting for the supplied name',
  inputSchema: {
    type: 'object',
    properties: { name: { type: 'string' } },
    required: ['name'],
  },
  outputSchema: {
    type: 'object',
    properties: { message: { type: 'string' } },
    required: ['message'],
  },
  graph: [
    {
      type: 'mapping',
      id: 'create-greeting',
      mapConfig: JSON.stringify({
        message: { template: 'Hello, ${initData.name}!' },
      }),
    },
  ],
})

const run = await mastra.getWorkflow('greeting-workflow').createRun()
const result = await run.start({ inputData: { name: 'Ada' } })
```

## 매개변수

**def** (`DynamicWorkflowGraph`): Workflow 정의입니다. id, 선택적 설명 및 메타데이터, JSON Schema 입력/출력 스키마, 선택적 상태 및 요청 컨텍스트 스키마, 단계 그래프를 포함합니다.

## 보고

정의가 검증되고, 등록되고, 지속되면 해결되는 약속입니다.

## 행동

- 정의는 변경되기 전에 완전히 검증됩니다(구조, 참조, 스키마 흐름). 그래프에서 참조하는 Agent, Tool 및 Workflow는 이미 인스턴스에 등록되어 있어야 합니다.
- 기존 ID로 정의를 추가하면 저장된 정의와 실시간 등록이 모두 대체됩니다. 실행 중인 작업은 시작할 때 사용한 그래프를 유지합니다.
- `workflowDefinitions` 도메인을 지원하는 스토리지 어댑터가 없는 경우에도 Workflow는 검증되어 Memory에 등록되지만, 재시작하면 정의가 손실됩니다.
- 중첩된 도우미 Workflow와 함께 루트 Workflow를 추가하려면 [`addDynamicWorkflows()`](https://mastra.zisheng.pro/ko/reference/core/addDynamicWorkflows)를 사용합니다.

## 관련된

- [Mastra.addDynamicWorkflows()](https://mastra.zisheng.pro/ko/reference/core/addDynamicWorkflows): 종속성 순서가 지정된 정의 번들을 추가합니다.
- [Mastra.getWorkflow()](https://mastra.zisheng.pro/ko/reference/core/getWorkflow): 등록된 Workflow를 검색합니다.
- [동적 Workflow](https://mastra.zisheng.pro/ko/docs/workflows/dynamic-workflows): 동적 Workflow 설정 및 사용
- [동적 Workflow 정의](https://mastra.zisheng.pro/ko/reference/workflows/dynamic-workflow-definition): 정의 필드 및 그래프 항목