핸들네트워크스트림()

:::warning[사용되지 않음]

Agent 네트워크는 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다. 대신 agent.stream() 또는 agent.generate()와 함께 supervisor Agent를 사용하세요. 업그레이드하려면 마이그레이션 가이드를 참고하세요. :::

AI SDK 호환 형식의 스트리밍 네트워크 실행을 위한 프레임워크에 구애받지 않는 핸들러입니다. Hono 또는 Mastra 자체 외부의 네트워크 스트리밍을 처리해야 하는 경우 이 기능을 직접 사용하십시오.apiRoutes feature.

handleNetworkStream()은 createUIMessageStreamResponse()로 감쌀 수 있는 ReadableStream을 반환합니다. handleNetworkStream()기존 AI SDK v5/기본 동작을 유지합니다. 앱이 AI SDK v6에 대해 입력된 경우 다음을 통과하세요.version: 'v6'.

Mastra 서버 내에 네트워크 경로를 만들려면 networkRoute()를 사용하세요.

사용예

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

매개변수

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가 우선합니다.