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

> Web Search — 웹 검색과 URL 콘텐츠 가져오기. Search / Fetch URL 2 모드 + 2 개 도구 선택

# Web search

# Web Search

**경로**: 하단 툴바 **Web Search**

에이전트가 **최신 정보를 외부 웹에서 가져와** 답변에 반영하도록 활성화하는 패널입니다. 검색 결과 상위 N 개 요약 + 개별 URL 본문 추출 두 가지를 지원.

<Frame>
  <img src="https://mintcdn.com/dnotitia-328335e7/3mgjFAVO5t1rKplH/images/image-35.png?fit=max&auto=format&n=3mgjFAVO5t1rKplH&q=85&s=b95271bdc09cbdce6fb74b0e74a7070e" alt="Image" width="1351" height="986" data-path="images/image-35.png" />
</Frame>

## UI 구성

| 요소                    | 설명                                               |
| --------------------- | ------------------------------------------------ |
| **Search** 탭          | 검색어 입력 + Search 버튼                               |
| **Fetch URL** 탭       | URL 입력 → 해당 페이지 본문 추출                            |
| **Tools** 체크리스트       | 활성화할 도구 선택 (`N/2 enabled`)                       |
| 검색 입력                 | `Enter search query...`                          |
| **Search the web** 버튼 | 직접 검색 실행                                         |
| 빈 상태                  | `Enter a query and click Search to find results` |

## Tools — 2 개 도구

`Select All` 또는 개별 체크로 활성화 (`N/2 enabled`).

| 도구              | 용도                                                      | 인자                               |
| --------------- | ------------------------------------------------------- | -------------------------------- |
| **web\_search** | Brave Search API 로 웹 검색 → 상위 N 개 결과 (제목·URL·스니펫, 본문 제외) | `query`, `top_n` (기본 5)          |
| **fetch\_url**  | 지정 URL 의 본문을 markdown 으로 추출 (`robots.txt` 준수)           | `url`, `max_content_length` (선택) |

## 활용 패턴

<Steps>
  <Step title="대화 중 사실 확인">
    에이전트가 답변 중 최신 정보가 필요하다 판단하면 자동으로 **search** 호출 → 결과를 요약해 답변에 포함.
  </Step>

  <Step title="특정 URL 정독">
    사용자가 `이 기사 요약해줘: https://...` 와 같이 URL 을 제공하면 **fetch\_url** 로 본문을 가져와 요약.
  </Step>

  <Step title="검색 + 내부 RAG 조합">
    [레시피 — RAG + 웹 검색 통합 답변](/agent-chat/recipes/rag-web-search) 참고 — 사내 문서(Storage) 기반 답변에 **최신 공개 정보** 를 더하는 패턴.
  </Step>
</Steps>

## 운영 주의

<Warning>
  * **정보 신뢰도** — 웹 검색 결과는 출처가 불균일합니다. 에이전트 System Prompt 에 "출처 URL 명시·근거 부족 시 단정 금지" 규칙 추가.
  * **robots.txt·저작권** — fetch\_url 은 공개 페이지 대상. 로그인·유료 콘텐츠 우회 금지.
  * **PII·민감 질의** — 사용자 개인정보가 섞인 질의를 그대로 검색 엔진에 보내지 않도록 주의. 필요 시 마스킹.
  * **비용** — 검색·URL fetch 호출은 별도 과금될 수 있습니다. 한도·요금: [Billing](/billing)
  * **캐시** — 짧은 간격의 동일 질의는 캐시될 수 있어 "실시간 정보" 를 기대할 때 주의.
</Warning>

## 관련 문서

* [RAG + 웹 검색 통합 답변 레시피](/agent-chat/recipes/rag-web-search)
* [MCP Tools](/agent-chat/toolbar/mcp-tools) — 필요 시 커스텀 검색 MCP 추가