로드 중
로드 중

Claude에는 사용자의 질문에 답하기 위해 최신 정보나 전문 정보를 인터넷에서 검색할 수 있는 내장 웹 검색 도구가 포함되어 있습니다. 직접 구현을 제공해야 하는 다른 도구와 달리, Claude는 전체 검색 프로세스를 자동으로 처리합니다. 이를 활성화하려면 간단한 스키마만 제공하면 됩니다.

우리 서버가 최신 양자 컴퓨팅 발전에 대해 질문하면, Claude가 웹을 검색하고 세 가지 결과를 바탕으로 답변합니다.

웹 검색 도구 설정하기

웹 검색 도구를 사용하려면 다음과 같은 필수 필드를 포함하는 스키마 객체를 생성합니다:

python
web_search_schema = {
    "type": "web_search_20250305",
    "name": "web_search", 
    "max_uses": 5
}

max_uses 필드는 Claude가 수행할 수 있는 검색 횟수를 제한합니다. Claude는 초기 결과를 바탕으로 후속 검색을 수행할 수도 있으므로, 이 필드는 과도한 API 호출을 방지합니다.

작동 방식

도구 목록에 웹 검색 스키마를 포함하면, Claude는 질문에 따라 언제 검색할지 자동으로 결정합니다. 예를 들어 "다리 근육을 키우는 데 가장 좋은 운동은 무엇인가요?"라고 물으면 최신 피트니스 연구에 대한 검색이 트리거될 수 있습니다.

응답에는 여러 유형의 블록이 포함됩니다:

  • TextBlock - Claude가 수행하고 있는 작업에 대한 설명
  • ServerToolUseBlock - Claude가 사용한 정확한 검색 쿼리를 표시
  • WebSearchToolResultBlock - 검색 결과를 포함
  • WebSearchResultBlock - 제목과 URL이 포함된 개별 검색 결과
  • CitationsWebSearchResultLocation - Claude의 진술을 뒷받침하는 구체적인 텍스트 인용

검색 도메인 제한하기

allowed_domains 필드를 사용하여 특정 도메인으로 검색을 제한할 수 있습니다. 이는 권위 있는 출처를 원할 때 특히 유용합니다:

python
web_search_schema = {
    "type": "web_search_20250305",
    "name": "web_search",
    "max_uses": 5,
    "allowed_domains": ["nih.gov"]
}

이렇게 하면 Claude가 신뢰할 수 없는 정보가 있을 수 있는 무작위 피트니스 블로그 대신 정부 보건 사이트와 같은 신뢰할 수 있는 도메인만 검색하도록 보장합니다.

검색 결과 렌더링하기

응답 구조는 풍부한 UI 렌더링을 위해 설계되었습니다. 일반적으로 다음과 같이 처리합니다:

  • 텍스트 블록을 일반 콘텐츠로 표시
  • 웹 검색 결과를 상단에 참조 목록으로 표시
  • 출처 자료로 돌아가는 링크와 함께 인용을 인라인으로 렌더링
  • 인용된 텍스트를 강조하여 Claude가 자신의 진술을 어떻게 뒷받침하는지 보여줌

이를 통해 사용자가 Claude의 출처를 확인하고 어떻게 결론에 도달했는지 이해할 수 있는 투명한 경험을 만들어냅니다. 이 인용 시스템은 Claude의 응답 뒤에 있는 근거를 보여줌으로써 신뢰를 구축하는 데 도움이 됩니다.