로드 중

중요 참고 사항: 조직에서 웹 검색 도구를 사용하려면 먼저 설정 콘솔에서 이 도구를 활성화해야 합니다. 이 설정은 여기에서 찾을 수 있습니다: https://platform.claude.com/settings/capabilities

로드 중

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

당사 서버가 최신 양자 컴퓨팅 발전에 대해 묻자, Claude가 웹을 검색하여 세 가지 결과를 바탕으로 답변합니다.

웹 검색 도구 설정하기

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

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

max_uses 필드는 Claude가 수행할 수 있는 검색 횟수를 제한합니다. Claude는 초기 결과를 바탕으로 후속 검색을 수행할 수 있으므로, 이 필드는 과도한 API 호출을 방지합니다. 한 번의 검색은 여러 결과를 반환하지만, Claude는 추가 검색이 필요하다고 판단할 수 있습니다.

응답이 작동하는 방식

Claude가 웹 검색 도구를 사용하면, 응답에는 여러 유형의 블록이 포함됩니다:

  • 텍스트 블록 - Claude가 무엇을 하고 있는지에 대한 설명
  • ServerToolUseBlock - Claude가 사용한 정확한 검색 쿼리를 보여줍니다
  • WebSearchToolResultBlock - 검색 결과를 포함합니다
  • WebSearchResultBlock - 제목과 URL이 있는 개별 검색 결과
  • 인용 블록 - Claude의 진술을 뒷받침하는 텍스트

Claude의 쿼리 "best exercises building leg muscle strength scientific research"와 nih.gov 결과가 포함된 응답 블록.

응답 구조를 통해 Claude가 정확히 무엇을 검색했는지, 그리고 어떤 출처를 찾았는지 확인할 수 있습니다. 인용에는 Claude가 답변을 뒷받침하는 데 사용한 구체적인 텍스트와 출처 URL이 포함됩니다.

검색 도메인 제한하기

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

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

예를 들어, 의료 또는 운동 관련 조언을 물어볼 때 PubMed(nih.gov)와 같은 도메인으로 제한하면 무작위 블로그 콘텐츠가 아닌 근거 기반 정보를 얻을 수 있습니다.

검색창이 있는 PubMed 홈 페이지와 생물 의학 문헌에 대한 3,800만 개 이상의 인용을 포함하고 있다는 안내.

검색 결과 렌더링하기

응답의 다양한 블록 유형은 특정 UI 렌더링을 위해 설계되었습니다:

  • 텍스트 블록은 일반 콘텐츠로 렌더링하세요
  • 웹 검색 결과는 상단에 출처 목록으로 표시하세요
  • 인용은 출처 도메인, 페이지 제목, URL, 인용된 텍스트를 포함하여 텍스트와 함께 인라인으로 표시하세요

상단에 여섯 개의 nih.gov 출처 카드가 있고, 이어서 ncbi.nlm.nih.gov에 대한 인라인 인용으로 끝나는 Introduction 단락.

이 구조는 사용자가 Claude가 어떻게 답변에 도달했는지 이해하는 데 도움이 되며, 사용된 출처에 대한 투명성을 제공합니다. 인용 형식은 어떤 특정 정보가 어떤 출처에서 나왔는지 명확하게 해주어, AI 응답에 대한 신뢰를 구축합니다.

실제 사용 사례

웹 검색 도구는 다음과 같은 경우에 가장 효과적입니다:

  • 최신 소식 및 최근 동향
  • Claude의 학습 데이터에 없는 전문 정보
  • 사실 확인 및 신뢰할 수 있는 출처 찾기
  • 최신 정보가 필요한 리서치 작업

API 호출 시 도구 배열에 스키마를 포함하기만 하면, Claude가 사용자의 질문에 답하는 데 웹 검색이 도움이 될지 자동으로 판단합니다.