> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arouter.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 웹 검색

> 모든 모델의 응답에 실시간 웹 데이터를 활용합니다. web 플러그인 또는 :online 접미사를 사용하거나 모델 중심 검색을 위해 Server Tools로 마이그레이션하세요.

<Warning>
  `web` 플러그인과 `:online` 모델 접미사는 **더 이상 사용되지 않습니다**. 계속 작동하지만 새 통합은 [Server Tools](/ko/guides/features/server-tools/overview)를 사용해야 합니다.
</Warning>

ARouter는 모든 모델에 대해 웹 검색 그라운딩을 지원합니다. 모델 슬러그에 `:online`을 추가하거나 `web` 플러그인을 사용하여 활성화합니다.

## 빠른 시작

```json theme={null}
{"model": "openai/gpt-5.4:online"}
```

또는:

```json theme={null}
{"model": "openai/gpt-5.4", "plugins": [{"id": "web"}]}
```

## web 플러그인 사용자 지정

```json theme={null}
{
  "model": "openai/gpt-5.4",
  "messages": [...],
  "plugins": [{"id": "web", "max_results": 3}]
}
```

| 매개변수              | 유형         | 기본값  | 설명                                          |
| ----------------- | ---------- | ---- | ------------------------------------------- |
| `id`              | `string`   | —    | `"web"`이어야 함                                |
| `max_results`     | `number`   | `5`  | 최대 검색 결과 수                                  |
| `engine`          | `string`   | auto | 검색 엔진: `"native"`, `"exa"`, 또는 `"parallel"` |
| `include_domains` | `string[]` | —    | 이 도메인의 결과만 반환                               |
| `exclude_domains` | `string[]` | —    | 이 도메인의 결과 제외                                |

## Server Tools로 마이그레이션

마이그레이션 가이드는 [Server Tools — 웹 검색](/ko/guides/features/server-tools/overview)를 참조하세요.
