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

# Mastra.getWorkflow()

`.getWorkflow()` 方法用於依註冊鍵取得 Workflow。此方法為 Workflow 輸入和輸出 schema 提供完整的 TypeScript 類型推斷。

## 使用範例

```typescript
// Retrieve workflow by its registration key (recommended for type inference)
const workflow = mastra.getWorkflow('testWorkflow')
const run = await workflow.createRun()

// TypeScript will properly infer the input schema type
await run.startAsync({
  inputData: {/* properly typed */},
})
```

## 類型推斷

為了獲得最佳 TypeScript 支援，請將 Workflow 的**註冊鍵**（將 Workflow 新增到 Mastra 時使用的鍵）傳給 `getWorkflow()`。這樣可對以下內容進行完整的類型推斷：

- 輸入資料 schema
- 輸出資料 schema
- 步驟結果

如果需要依 Workflow 的 `id` 屬性而非註冊鍵取得，可以使用 `getWorkflowById()`，但請注意類型推斷不會同樣精確。

## 參數

**id** (`TWorkflowId extends keyof TWorkflows`): 要取得的 Workflow ID。必須是 Mastra 設定中存在的有效 Workflow ID。

**options** (`{ serialized?: boolean }`): 選用設定物件。當 serialized 為 true 時，僅傳回 Workflow 名稱，而非完整的 Workflow 執行個體。

## 傳回值

**workflow** (`TWorkflows[TWorkflowId]`): 具有指定 ID 的 Workflow 執行個體。如果找不到該 Workflow，則擲回錯誤。

## 相關內容

- [Workflow 概覽](https://mastra.zisheng.pro/zh-TW/docs/workflows/overview)