Citations

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

Genel bakış

Citations, Claude’un yanıtlarındaki bilgilerin kaynak belgelerin tam olarak hangi noktasından geldiğini gösterir. Bu derste citations feature’ını nasıl etkinleştireceğini, response yapısını ve plain text + PDF üzerinde nasıl kullanılacağını öğreneceksin.

Claude, sağladığın belgelere dayalı sorular cevapladığında, kullanıcılar bunu yalnızca training data’sından çıkardığını sanabilir. Peki ya Claude belirli bilgiyi tam olarak nereden bulduğunu gösterebilseydi? İşte citations burada devreye girer — Claude’un kaynak belgelerinin spesifik kısımlarına atıfta bulunmasını ve her bilginin tam olarak nereden geldiğini kullanıcılara göstermesini sağlayan güçlü bir feature.

Citations neden önemli

Claude’a Earth’ün atmosferinin nasıl oluştuğunu sorduğunu ve detaylı bir yanıt aldığını hayal et. Citations olmadan kullanıcıların bilgiyi doğrulama veya Claude’un sağladığın belirli bir belgeye gerçekten atıf yaptığını anlama yolu yoktur. Citations bu transparency problemini, Claude’un yanıtından kaynak materyaline net bir iz oluşturarak çözer.

Citations’ı etkinleştirmek

Citations’ı etkinleştirmek için document message yapını değiştirmen gerekir. Document block’una iki yeni alan ekle:

{
    "type": "document",
    "source": {
        "type": "base64",
        "media_type": "application/pdf",
        "data": file_bytes,
    },
    "title": "earth.pdf",
    "citations": { "enabled": True }
}

title alanı belgeye okunaklı bir ad verir; citations: {"enabled": True} ise Claude’a bilgiyi nereden bulduğunu takip etmesini söyler.

Citation yapısını anlamak

Citations etkinleştirildiğinde, Claude’un response’u daha karmaşık hale gelir. Basit text yerine, her iddia için citation bilgisi içeren yapılandırılmış data alırsın.

Her citation birkaç temel bilgi parçası içerir:

• cited_text — Claude’un ifadesini destekleyen, belgendeki tam text
• document_index — Claude’un hangi belgeye atıfta bulunduğu (birden fazla belge sağladığında faydalı)
• document_title — Belgeye atadığın title
• start_page_number — Cited text’in başladığı yer
• end_page_number — Cited text’in bittiği yer

Citations ile user interface kurmak

Citations’ın gerçek gücü, bu bilgiyi erişilebilir kılan user interface’ler kurmaktan gelir. Kullanıcıların citation marker’larının üzerine hover yaparak bilginin tam olarak nereden geldiğini görebildikleri interaktif element’ler oluşturabilirsin.

Bu, kullanıcıların şunları yapabildiği transparent bir deneyim yaratır:

• Claude’un yanıtlarının gerçek kaynak materyaline dayandığını görmek
• Orijinal belgeyi kontrol ederek bilgiyi doğrulamak
• Her cited bilgi parçasının çevresindeki context’i anlamak

Plain text ile citations

Citations yalnızca PDF belgelerle sınırlı değildir. Plain text kaynaklarla da kullanabilirsin. Text ile çalışırken document yapını şöyle değiştir:

{
    "type": "document", 
    "source": {
        "type": "text",
        "media_type": "text/plain",
        "data": article_text,
    },
    "title": "earth_article",
    "citations": { "enabled": True }
}

Plain text kaynaklarda sayfa numarası yerine, Claude’un her bilgi parçasını text’te tam olarak nerede bulduğunu gösteren character pozisyonları alırsın.

Citations ne zaman kullanılır

Citations özellikle şu durumlarda değerlidir:

• Kullanıcıların doğruluk için bilgiyi doğrulaması gerektiğinde
• Kullanıcıların referans alabilmesi gereken otoriter belgelerle çalışırken
• Uygulaman için bilgi kaynakları konusunda transparency kritikse
• Kullanıcılar belirli gerçeklerin etrafındaki daha geniş context’i keşfetmek isteyebilirse

Citations’ı implemente ederek Claude’u, yanıt veren bir “black box”tan, çalışmasını gösteren transparent bir research assistant’a dönüştürürsün. Bu, kullanıcı güvenini artırır ve gerektiğinde kaynak materyallerine derinlemesine inmelerini sağlar.

Temel çıkarımlar

• Citations etkinleştirildiğinde Claude, her ifadesini kaynak belgenin spesifik bölümüne bağlar
• citations: { "enabled": True } document block’una eklenir; title alanı zorunlu olur
• PDF’lerde sayfa numarası, plain text’te karakter pozisyonu döner
• UI’da hover/inline citation marker’ları kullanıcıya doğrulama olanağı sunar
• Doğruluk, transparency ve user trust kritik uygulamalarda citations vazgeçilmezdir