handleNetworkStream()

非推奨

Agent ネットワークは非推奨であり、今後のリリースで削除されます。代わりに、agent.stream() または agent.generate() とともに Supervisor Agent を使用してください。移行するには移行ガイドを参照してください。

AI SDK 互換形式でネットワーク実行をストリーミングする、フレームワークに依存しないハンドラーです。Hono または Mastra 独自の apiRoutes 機能の外部でネットワークストリーミングを処理する必要がある場合は、この関数を直接使用します。

handleNetworkStream() は、createUIMessageStreamResponse() でラップできる ReadableStream を返します。

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

Mastra サーバー内にネットワークルートを作成する場合は、networkRoute() を使用してください。

使用例

Next.js App Router の例:

app/api/network/route.ts

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'

= 'v5'

出力する AI SDK ストリームコントラクトを選択します。既存のデフォルト動作を使用するには、省略するか 'v5' を渡します。アプリが AI SDK v6 のレスポンスヘルパーの型を使用している場合は、'v6' を渡します。

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 が優先されます。