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

# handleNetworkStream()

> **非推奨:** Agent ネットワークは非推奨であり、今後のリリースで削除されます。代わりに、`agent.stream()` または `agent.generate()` とともに [Supervisor Agent](https://mastra.zisheng.pro/ja/docs/capabilities/subagents) を使用してください。移行するには[移行ガイド](https://mastra.zisheng.pro/ja/guides/migrations/network-to-supervisor)を参照してください。

AI SDK 互換形式でネットワーク実行をストリーミングする、フレームワークに依存しないハンドラーです。Hono または Mastra 独自の [apiRoutes](https://mastra.zisheng.pro/ja/docs/server/custom-api-routes) 機能の外部でネットワークストリーミングを処理する必要がある場合は、この関数を直接使用します。

`handleNetworkStream()` は、[`createUIMessageStreamResponse()`](https://ai-sdk.dev/docs/reference/ai-sdk-ui/create-ui-message-stream-response) でラップできる `ReadableStream` を返します。

`handleNetworkStream()` は、既存の AI SDK v5／デフォルトの動作を維持します。アプリが AI SDK v6 の型を使用している場合は、`version: 'v6'` を渡します。

Mastra サーバー内にネットワークルートを作成する場合は、[`networkRoute()`](https://mastra.zisheng.pro/ja/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 ストリームコントラクトを選択します。既存のデフォルト動作を使用するには、省略するか 'v5' を渡します。アプリが AI SDK v6 のレスポンスヘルパーの型を使用している場合は、'v6' を渡します。 (Default: `'v5'`)

**mastra** (`Mastra`): Agent の検索と実行に使用する Mastra インスタンス。

**agentId** (`string`): ネットワークとして実行するルーティング 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 が優先されます。