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

# 네트워크경로()

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

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

AI SDK 형식을 사용하여 스트리밍 네트워크 실행을 위한 네트워크 경로 핸들러를 생성합니다. 이 함수는 메시지를 수신하고 Agent 네트워크를 실행한 후 응답을 AI SDK 호환 형식으로 클라이언트에 다시 스트리밍하는 HTTP `POST` 엔드포인트를 등록합니다. Agent 네트워크를 사용하면 라우팅 Agent가 다른 Agent에 작업을 위임할 수 있습니다. [사용자 정의 API 경로](https://mastra.zisheng.pro/ko/docs/server/custom-api-routes) 내부에서 사용해야 합니다. 프레임워크에 종속되지 않는 핸들러가 필요하면 [`handleNetworkStream()`](https://mastra.zisheng.pro/ko/reference/ai-sdk/handle-network-stream)을 사용하세요. `networkRoute()`기존 AI SDK v5/기본 동작을 유지합니다. 앱이 AI SDK v6에 대해 입력된 경우 다음을 통과하세요.`version: 'v6'`.

## 사용예

이 예제에서는 ID가 `weatherAgent`인 Agent를 사용하는 `/network` 엔드포인트에 네트워크 경로를 설정하는 방법을 보여줍니다.

```typescript
import { Mastra } from '@mastra/core'
import { networkRoute } from '@mastra/ai-sdk'

export const mastra = new Mastra({
  server: {
    apiRoutes: [
      networkRoute({
        path: '/network',
        agent: 'weatherAgent',
      }),
    ],
  },
})
```

`agentId`를 기반으로 런타임 정의 Agent 라우팅을 사용할 수도 있습니다. URL `/network/weatherAgent`는 ID가 `weatherAgent`인 Agent로 확인됩니다.

```typescript
import { Mastra } from '@mastra/core'
import { networkRoute } from '@mastra/ai-sdk'

export const mastra = new Mastra({
  server: {
    apiRoutes: [
      networkRoute({
        path: '/network/:agentId',
      }),
    ],
  },
})
```

## 매개변수

**version** (`'v5' | 'v6'`): 출력할 AI SDK 스트림 계약을 선택합니다. 기존 기본 동작을 사용하려면 생략하거나 'v5'를 전달하세요. 앱이 AI SDK v6 응답 헬퍼를 기준으로 타입이 지정된 경우 'v6'을 전달하세요. (Default: `'v5'`)

**path** (`string`): 경로 경로입니다(예: /network 또는 /network/:agentId). 동적 Agent 라우팅에는 :agentId를 포함하세요. (Default: `'/network/:agentId'`)

**agent** (`string`): 이 네트워크 경로에 사용할 라우팅 Agent의 ID입니다. 경로에 :agentId가 포함되지 않은 경우 필수입니다.

**agentVersion** (`{ versionId: string } | { status?: 'draft' | 'published' }`): 특정 Agent 버전을 선택합니다. 정확한 버전을 대상으로 하려면 { versionId: '\<id>' }를 전달하고, 상태를 기준으로 확인하려면 { status: 'draft' } / { status: 'published' }를 전달하세요. 경로가 호출되면 쿼리 매개변수 ?versionId=\<id> 또는 ?status=draft|published가 이 정적 값보다 우선합니다. Editor가 구성되어 있어야 합니다.

**defaultOptions** (`AgentExecutionOptions`): Agent 실행에 전달되는 기본 옵션입니다. 여기에는 지침, Memory 구성, maxSteps 및 기타 실행 설정이 포함될 수 있습니다.

## 추가 구성

[`prepareSendMessagesRequest`](https://ai-sdk.dev/docs/reference/ai-sdk-ui/use-chat#transport.default-chat-transport.prepare-send-messages-request)를 사용하여 네트워크 경로로 전송되는 요청을 사용자 정의할 수 있습니다. 예를 들어 Agent에 추가 구성을 전달할 수 있습니다.

```typescript
const { error, status, sendMessage, messages, regenerate, stop } = useChat({
  transport: new DefaultChatTransport({
    api: 'http://localhost:4111/network',
    prepareSendMessagesRequest({ messages }) {
      return {
        body: {
          messages,
          // Pass memory config
          memory: {
            thread: 'user-1',
            resource: 'user-1',
          },
        },
      }
    },
  }),
})
```