handleNetworkStream()

Obsolète

Les réseaux d’Agents sont obsolètes et seront supprimés dans une prochaine version. Utilisez plutôt des Agents superviseurs avec agent.stream() ou agent.generate(). Consultez le guide de migration pour effectuer la mise à niveau.

Gestionnaire indépendant du framework permettant de diffuser l’exécution d’un réseau dans un format compatible avec AI SDK. Utilisez directement cette fonction lorsque vous devez gérer la diffusion d’un réseau en dehors de Hono ou de la fonctionnalité apiRoutes de Mastra.

handleNetworkStream() renvoie un ReadableStream que vous pouvez encapsuler avec createUIMessageStreamResponse().

handleNetworkStream() conserve le comportement par défaut existant d’AI SDK v5. Si votre application est typée pour AI SDK v6, transmettez version: 'v6'.

Utilisez networkRoute() si vous souhaitez créer une route de réseau dans un serveur Mastra.

Exemple d’utilisation

Exemple avec l’App Router de Next.js :

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 })
}

Paramètres

version?:

'v5' | 'v6'

= 'v5'

Sélectionne le contrat de flux AI SDK à émettre. Omettez ce paramètre ou transmettez 'v5' pour conserver le comportement par défaut existant. Transmettez 'v6' lorsque votre application est typée pour les assistants de réponse d’AI SDK v6.

mastra:

Mastra

Instance Mastra à utiliser pour rechercher et exécuter l’Agent.

agentId:

string

ID de l’Agent de routage à exécuter en tant que réseau.

agentVersion?:

{ versionId: string } | { status?: 'draft' | 'published' }

Sélectionne une version précise de l’Agent. Transmettez { versionId: '<id>' } pour cibler une version exacte, ou { status: 'draft' } / { status: 'published' } pour la déterminer selon son statut. Nécessite la configuration de l’Editor.

params:

NetworkStreamHandlerParams

Paramètres de la requête contenant les messages et les options d’exécution. Ils comprennent messages (obligatoire) et toutes les options AgentExecutionOptions telles que memory, maxSteps, runId, etc.

defaultOptions?:

AgentExecutionOptions

Options par défaut transmises à l’exécution de l’Agent. Elles sont fusionnées avec params, qui est prioritaire.