Skip to main content

Web Search

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

UI 구성

요소설명
Search검색어 입력 + Search 버튼
Fetch URLURL 입력 → 해당 페이지 본문 추출
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_searchBrave Search API 로 웹 검색 → 상위 N 개 결과 (제목·URL·스니펫, 본문 제외)query, top_n (기본 5)
fetch_url지정 URL 의 본문을 markdown 으로 추출 (robots.txt 준수)url, max_content_length (선택)

활용 패턴

1

대화 중 사실 확인

에이전트가 답변 중 최신 정보가 필요하다 판단하면 자동으로 search 호출 → 결과를 요약해 답변에 포함.
2

특정 URL 정독

사용자가 이 기사 요약해줘: https://... 와 같이 URL 을 제공하면 fetch_url 로 본문을 가져와 요약.
3

검색 + 내부 RAG 조합

레시피 — RAG + 웹 검색 통합 답변 참고 — 사내 문서(Storage) 기반 답변에 최신 공개 정보 를 더하는 패턴.

운영 주의

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

관련 문서