Workflow SDK 现已支持在 Vercel 上通过 WebSocket 进行写入

Workflow SDK 现在默认通过 WebSocket 向 Vercel Workflows 发送事件写入和流写入，取代了之前每次写入（流写入则按写入组）各发一个 HTTP 请求的方式。只需升级到 workflow@5.2.0 或更高版本，无需修改任何代码。

部署升级后，新的运行会自动使用 WebSocket；已经在进行的运行则继续在启动它们的部署上完成。

terminal

1npm install workflow@latest

现有的流式代码无需改动。如果一个 step 需要连续写入一批数据块（比如 AI token），WebSocket 连接打开后会自动通过它发送：

stream-chunks.ts

1import { getWritable } from "workflow";2
3async function streamChunks(chunks: string[]) {4  "use step";5  const writer = getWritable<string>().getWriter();6  for (const chunk of chunks) {7    await writer.write(chunk);8  }9  writer.releaseLock();10}11
12export async function streamingWorkflow(chunks: string[]) {13  "use workflow";14  await streamChunks(chunks);15}

Copy link to heading流式传输跟上 AI 输出速度

在一个重放 AI agent token 流的 基准测试中，默认通过 WebSocket 写入流的 v5.2.0 比 v4.8.12 快 4.2 倍完成整个响应，且没有任何数据块延迟超过一秒。

Copy link to heading事件写入的 HTTP 请求更少

每个 step 的启动和完成都是一次事件写入，现在都通过 WebSocket 发送，因此包含大量 step 的 workflow 会产生更少的 HTTP 请求。效率的提升也带来了更好的性能和更低的成本。连接由每次投递时的队列处理器负责打开。

Copy link to heading开始使用

阅读 Vercel World 文档即可开始。如果你还在用 4.x，请先参考升级指南，因为 v5 是一个大版本更新。