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

# handleNetworkStream()

> **已弃用:** Agent network 已弃用，并将在未来版本中移除。请改用搭配 `agent.stream()` 或 `agent.generate()` 的 [supervisor Agent](https://mastra.zisheng.pro/docs/capabilities/subagents)。升级方法请参阅[迁移指南](https://mastra.zisheng.pro/guides/migrations/network-to-supervisor)。

与框架无关的处理程序，用于以 AI SDK 兼容格式流式传输 network 执行。当需要在 Hono 或 Mastra 自有的 [apiRoutes](https://mastra.zisheng.pro/docs/server/custom-api-routes) 功能之外处理 network stream 时，请直接使用此函数。

`handleNetworkStream()` 返回一个 `ReadableStream`，可使用 [`createUIMessageStreamResponse()`](https://ai-sdk.dev/docs/reference/ai-sdk-ui/create-ui-message-stream-response) 对其进行封装。

`handleNetworkStream()` 保留现有的 AI SDK v5 默认行为。如果应用使用 AI SDK v6 类型，请传入 `version: 'v6'`。

如果要在 Mastra server 中创建 network 路由，请使用 [`networkRoute()`](https://mastra.zisheng.pro/reference/ai-sdk/network-route)。

## 使用示例

Next.js App Router 示例：

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

export async function POST(req: Request) {
  const params = await req.json()
  const stream = await handleNetworkStream({
    mastra,
    agentId: 'routingAgent',
    params,
  })
  return createUIMessageStreamResponse({ stream })
}
```

## 参数

**version** (`'v5' | 'v6'`): 选择要输出的 AI SDK stream 协议。省略此项或传入 'v5' 可使用现有默认行为；当应用使用 AI SDK v6 response helper 的类型时，传入 'v6'。 (Default: `'v5'`)

**mastra** (`Mastra`): 用于查找和执行 Agent 的 Mastra 实例。

**agentId** (`string`): 作为 network 执行的路由 Agent ID。

**agentVersion** (`{ versionId: string } | { status?: 'draft' | 'published' }`): 选择特定的 Agent 版本。传入 { versionId: '\<id>' } 可指定确切版本，或传入 { status: 'draft' } / { status: 'published' } 按状态解析。需要配置 Editor。

**params** (`NetworkStreamHandlerParams`): 包含消息和执行选项的请求参数。包括 messages（必填），以及 memory、maxSteps、runId 等任意 AgentExecutionOptions。

**defaultOptions** (`AgentExecutionOptions`): 传递给 Agent 执行的默认选项。这些选项会与 params 合并，且 params 优先。