웹 검색 도구

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

웹 검색 도구 설정하기

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

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

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

이를 통해 Claude는 신뢰할 수 없는 정보를 담고 있을 수 있는 무작위 피트니스 블로그 대신 정부 건강 사이트와 같은 신뢰할 수 있는 도메인만 검색하게 됩니다.

검색 결과 렌더링하기

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

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

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