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

# 핸들네트워크스트림()

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

Agent 네트워크는 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다. 대신 `agent.stream()` 또는 `agent.generate()`와 함께 [supervisor Agent](https://mastra.zisheng.pro/ko/docs/capabilities/subagents)를 사용하세요. 업그레이드하려면 [마이그레이션 가이드](https://mastra.zisheng.pro/ko/guides/migrations/network-to-supervisor)를 참고하세요. :::

AI SDK 호환 형식의 스트리밍 네트워크 실행을 위한 프레임워크에 구애받지 않는 핸들러입니다. Hono 또는 Mastra 자체 외부의 네트워크 스트리밍을 처리해야 하는 경우 이 기능을 직접 사용하십시오.[apiRoutes](https://mastra.zisheng.pro/ko/docs/server/custom-api-routes) feature.

`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/ko/reference/ai-sdk/network-route)를 사용하세요.

## 사용예

Next.js 앱 라우터 예:

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