web_search Server Tool을 사용하면 모델이 추론 중에 웹을 검색할 수 있습니다. 모델이 검색이 필요한 시점을 결정하고, ARouter가 검색을 수행하며, 결과가 자동으로 모델의 컨텍스트에 주입됩니다.
이것은 더 이상 사용되지 않는 web 플러그인과 :online 모델 접미사의 권장 대체 방법입니다.
빠른 시작
{
"model": "openai/gpt-5.4",
"messages": [{"role": "user", "content": "What happened in AI research this week?"}],
"tools": [{"type": "arouter", "arouter": {"id": "web_search"}}]
}
| 매개변수 | 유형 | 기본값 | 설명 |
|---|
id | string | — | "web_search" 이어야 합니다 |
max_results | integer | 5 | 반환할 최대 검색 결과 수 |
engine | string | 자동 | 검색 엔진: "native", "exa", "parallel", 또는 "firecrawl" |
include_domains | string[] | — | 결과를 이 도메인으로 제한 (와일드카드 지원) |
exclude_domains | string[] | — | 이 도메인의 결과 제외 (와일드카드 지원) |
max_total_results | integer | — | 하나의 요청에서 여러 검색의 총 결과 수 제한 |
엔진 선택
| 엔진 | 설명 | 최적 용도 |
|---|
| (미설정) | 제공자가 지원하면 native 사용, 아니면 Exa | 일반 용도 |
"native" | 제공자의 내장 검색 (OpenAI, Anthropic, xAI) | 최고의 인용 품질 |
"exa" | Exa의 신경망+키워드 하이브리드 검색 | 연구, 틈새 주제 |
"parallel" | Parallel의 검색 API | 빠른 광범위한 쿼리 |
"firecrawl" | Firecrawl 심층 크롤 (BYOK) | 전체 페이지 콘텐츠 |
인용 파싱
{
"choices": [{
"message": {
"role": "assistant",
"content": "According to recent research...",
"annotations": [{
"type": "url_citation",
"url_citation": {
"url": "https://arxiv.org/abs/2501.12345",
"title": "Scaling Laws for LLMs",
"content": "We study the relationship between...",
"start_index": 32, "end_index": 96
}
}]
}
}]
}
| 엔진 | 비용 |
|---|
| Exa | 1,000 결과당 $4.00 |
| Parallel | 1,000 결과당 $4.00 |
| Native (OpenAI, Anthropic, xAI) | 제공자 요금으로 패스스루 |
| Firecrawl | BYOK——귀하의 Firecrawl API key |
Web 플러그인에서 마이그레이션
이전 (더 이상 사용되지 않음):
{"model": "openai/gpt-5.4:online", "messages": [...]}
{"model": "openai/gpt-5.4", "tools": [{"type": "arouter", "arouter": {"id": "web_search"}}], "messages": [...]}
