Web search tool

Bu modül için tahmini süre: 7 dakika

Genel bakış

Claude, kullanıcı sorularını yanıtlamak için internette güncel veya özelleşmiş bilgiyi aratmasına olanak veren built-in bir web search tool içerir. Implementation sağlamanız gereken diğer tool’lardan farklı olarak Claude tüm arama sürecini otomatik yönetir — siz sadece etkinleştirmek için basit bir schema sağlarsınız.

Önemli not: Organizasyonunuzun bu tool’u kullanmadan önce settings console üzerinden Web Search tool’unu etkinleştirmesi gerekir. Ayarı burada bulabilirsiniz: https://console.anthropic.com/settings/privacy

Web search tool’u kurmak

Web search tool’u kullanmak için şu zorunlu field’lara sahip bir schema object oluşturursunuz:

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

max_uses field’ı Claude’un kaç arama gerçekleştirebileceğini sınırlar. Claude initial sonuçlara göre follow-up aramalar yapabilir, bu yüzden bu aşırı API çağrılarını önler. Tek bir arama birden çok sonuç döner, ancak Claude ek aramaların gerekli olduğuna karar verebilir.

Yanıt nasıl çalışır

Claude web search tool’u kullandığında yanıt birkaç tür block içerir:

• Text blocks — Claude’un ne yaptığını açıklaması
• ServerToolUseBlock — Claude’un kullandığı tam arama sorgusunu gösterir
• WebSearchToolResultBlock — Arama sonuçlarını içerir
• WebSearchResultBlock — Title ve URL’leri ile birlikte tek tek arama sonuçları
• Citation blocks — Claude’un ifadelerini destekleyen text

Yanıt yapısı, Claude’un tam olarak ne arattığını ve hangi kaynakları bulduğunu görmenize izin verir. Citation’lar Claude’un yanıtlarını desteklemek için kullandığı spesifik metni, kaynak URL’leri ile birlikte içerir.

Search domain’lerini kısıtlamak

allowed_domains field’ını kullanarak aramaları belirli domain’lerle sınırlayabilirsiniz. Güvenilir, otoriter kaynaklar istediğinizde özellikle faydalıdır:

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

Örneğin tıp veya egzersiz tavsiyesi sorduğunuzda PubMed (nih.gov) gibi domain’lere kısıtlamak, rastgele blog içeriği yerine kanıta dayalı bilgi almanızı sağlar.

Search sonuçlarını render etmek

Yanıttaki farklı block tipleri belirli UI rendering için tasarlanmıştır:

• Text block’ları normal content olarak render edin
• Web search sonuçlarını üstte bir kaynak listesi olarak gösterin
• Citation’ları kaynak domain, sayfa title, URL ve quoted text dahil olmak üzere text ile satır içi gösterin

Bu yapı, kullanıcıların Claude’un yanıtlarına nasıl ulaştığını anlamasına yardımcı olur ve kullanılan kaynaklar hakkında şeffaflık sağlar. Citation format’ı hangi spesifik bilginin hangi kaynaklardan geldiğini netleştirir ve AI’ın yanıtlarına güven inşa eder.

Pratik kullanım

Web search tool en çok şu durumlarda işe yarar:

• Güncel olaylar ve son gelişmeler
• Claude’un training data’sında olmayan özelleşmiş bilgi
• Fact-checking ve otoriter kaynak bulma
• Güncel bilgi gerektiren araştırma görevleri

API çağrılarınızda schema’yı tools array’inize dahil etmek yeterlidir; Claude bir web search’in kullanıcının sorusunu yanıtlamaya yardımcı olup olmayacağına otomatik karar verecektir.

Temel çıkarımlar

• Web search, implementasyonunu Anthropic tarafının yaptığı, yalnızca schema kayıt etmenizi gerektiren bir server tool’dur
• Önce console’dan organizasyon için etkinleştirilmelidir (privacy settings)
• max_uses parametresi follow-up search sayısını sınırlar ve maliyeti kontrol eder
• Yanıt; text blocks, ServerToolUseBlock, WebSearchToolResultBlock, WebSearchResultBlock ve citation block’lardan oluşur
• allowed_domains parametresi sonuçları nih.gov gibi otoriter kaynaklara kısıtlar
• Citation’lar (quoted text + URL) kullanıcıya kaynak şeffaflığı sağlar; RAG benzeri bir deneyim sunar