跳至主要內容

Mastra.getWorkflow()

.getWorkflow() 方法用於依註冊鍵取得 Workflow。此方法為 Workflow 輸入和輸出 schema 提供完整的 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,則擲回錯誤。