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

# workflowSnapshotToStream()

将 `WorkflowState` 对象（由 `workflow.getWorkflowRunById()` 返回）转换为由 AI SDK UIMessage data part 组成的 `ReadableStream`。该 stream 包含与实时 [`workflowRoute()`](https://mastra.zisheng.pro/reference/ai-sdk/workflow-route) 相同的 `WorkflowDataPart` 和 `WorkflowStepDataPart` chunk。

如果要使用渲染实时 Workflow stream 的同一组 UI 组件来显示已完成或已暂停的 Workflow run，请使用此函数。

## 使用示例

将过去的 Workflow run 作为 stream 重放的 Next.js App Router endpoint：

```typescript
import { workflowSnapshotToStream } from '@mastra/ai-sdk'
import { createUIMessageStreamResponse } from 'ai'
import { mastra } from '@/src/mastra'

export async function GET(req: Request) {
  const { searchParams } = new URL(req.url)
  const runId = searchParams.get('runId')!

  const workflowRun = await mastra.getWorkflow('myWorkflow').getWorkflowRunById(runId)

  if (!workflowRun) {
    return new Response('Not found', { status: 404 })
  }

  const stream = workflowSnapshotToStream(workflowRun)
  return createUIMessageStreamResponse({ stream })
}
```

## 参数

**workflowRun** (`WorkflowState`): Workflow run 状态对象，由 getWorkflowRunById() 或 Workflow runs API 返回。包含 runId、workflowName、status 和 steps。

## 返回值

`ReadableStream`：由 AI SDK UIMessage data part 组成的 stream，包含：

- 一个 `start` 标记
- 一个包含 Workflow 状态和所有 step 摘要的 `WorkflowDataPart`
- 每个 step 对应一个包含完整输出的 `WorkflowStepDataPart`
- 一个 `finish` 标记

将此 stream 传递给 AI SDK 的 [`createUIMessageStreamResponse()`](https://ai-sdk.dev/docs/reference/ai-sdk-ui/create-ui-message-stream-response) 或 `createUIMessageStream()`。

## 相关内容

- [`workflowRoute()`](https://mastra.zisheng.pro/reference/ai-sdk/workflow-route): 流式传输实时 Workflow run
- [`handleWorkflowStream()`](https://mastra.zisheng.pro/reference/ai-sdk/handle-workflow-stream): 用于实时 Workflow 流式传输、与框架无关的处理程序
- [`toAISdkStream()`](https://mastra.zisheng.pro/reference/ai-sdk/to-ai-sdk-stream): 将实时 Mastra stream 转换为 AI SDK 格式
- [`toAISdkMessages()`](https://mastra.zisheng.pro/reference/ai-sdk/to-ai-sdk-messages): 将已存储的 Agent 消息转换为 AI SDK 格式