跳至主要內容

Run.restart()

.restart() 方法會重新啟動與伺服器失去連線的有效 Workflow run,讓你從失去連線的一刻(最後一個有效 step)繼續執行。

使用範例
使用範例 的直接連結

const run = await workflow.createRun()

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

const restartedResult = await run.restart()

參數
參數 的直接連結

requestContext?:

RequestContext
恢復執行時使用的 Request Context 資料

tracingContext?:

TracingContext
用於建立 child span 及加入 metadata 的 Tracing context。使用 Mastra 的 tracing 系統時會自動注入。

currentSpan?:

Span
用於建立 child span 及加入 metadata 的目前 span。可用它建立自訂 child span,或在執行期間更新 span 屬性。

tracingOptions?:

TracingOptions
Tracing 設定選項。

metadata?:

Record<string, any>
要加入 root trace span 的 metadata。適合加入使用者 ID、session ID 或 feature flag 等自訂屬性。

requestContextKeys?:

string[]
要擷取並用作這個 trace 的 metadata 的其他 RequestContext key。巢狀值支援點號標記法(例如 'user.id')。

traceId?:

string
這次執行使用的 Trace ID(1 至 32 個十六進位字元)。如有提供,這個 trace 將成為指定 trace 的一部分。

parentSpanId?:

string
這次執行使用的 parent span ID(1 至 16 個十六進位字元)。如有提供,root span 將建立為此 span 的 child。

tags?:

string[]
要套用至這個 trace 的標籤。這些字串標籤用於分類及篩選 trace。

傳回值
傳回值 的直接連結

result:

Promise<WorkflowResult<TState, TOutput, TSteps>>
一個 Promise,其解析結果為包含 step 輸出及狀態的 Workflow 執行結果

traceId?:

string
啟用 Tracing 時,與這次執行關聯的 Trace ID。可用於關聯 log 及偵錯執行流程。

spanId?:

string
啟用 Tracing 時,與這次執行關聯的 root span ID。可用於 span 層級的查找及關聯。