> ## 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](/zh-Hant/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 — 網頁搜尋](/zh-Hant/guides/features/server-tools/overview) 取得遷移指南。