Claude'ın araç kataloğu BM25 aramasıyla büyürken bellek API'si yalnızca dizin listeleme sunuyor

Tek taşma problemi, iki farklı cevap

dev.to'da yayımlanan bir geliştirici analizi, Claude Developer Platform içindeki bir tasarım ayrımına dikkat çekiyor: bağlama sığmayacak kadar çok aday olduğunda araç kataloğu ve bellek deposu sorunu tamamen farklı şekillerde çözüyor. Araçlar sıralı arama alıyor. Bellekler ise ls'ye daha yakın bir şey elde ediyor.

Bu gözlem, iki yüzeyin de aynı duvara çarpması nedeniyle önemli. Bir araç kataloğu, tanımları görevin haklı gösterdiğinden daha fazla bağlama mal olduğunda taşar. Bir bellek deposu da aynı nedenle taşar ve ölçek belgelenmiştir: yazıda atıf yapılan Anthropic bellek deposu rehberine göre bir depo 10.000'e kadar bellek tutabiliyorken, tek bir List memories çağrısı sayfa başına en fazla 100 öğe döndürüyor; öğeler tam içerik taşıdığında bu sınır 20'ye düşüyor. Hangi adayların modele ulaştığını bir şeyin seçmesi gerekiyor.

Araç tarafı sıralı erişim sunuyor

Araç tarafında platform, kutudan çıktığı gibi regex tabanlı ve BM25 tabanlı arama araçları sağlıyor ve Anthropic'in gelişmiş araç kullanımı dokümantasyonu, geliştiricilerin embeddings veya diğer stratejilerle özel arama araçları da kurabileceğini belirtiyor. API referansı tool_search_tool_regex_20251119 ve tool_search_tool_bm25_20251119 olmak üzere iki varyant isimlendiriyor; BM25 varyantı, Claude'ın araçları bulmak için doğal dil sorguları göndermesine izin veriyor.

Mekanizma tanımları erteliyor. Başlangıçta bağlamda yalnızca arama aracının kendisi ve ertelenmemiş araçlar bulunur; geri kalan her şey, API'nin tool reference blokları olarak döndürdüğü kısa bir liste olarak gelir — varsayılan olarak en fazla beş tanesi — ve Claude, arama girdisinde bu sınırı yükseltebilir. Model hiçbir zaman kataloğun tamamını elinde tutmaz.

Bellek tarafı dizin gezintisi sunuyor

List memories endpoint'i tam olarak beş sorgu parametresi alıyor: depth, limit, page, path_prefix ve view. Bunların hiçbiri bir arama değil. Anthropic'in kendi dokümantasyonu dosya sistemi metaforunu sağlıyor: depth değerinin 1 olması ls gibi, depth'in verilmesi ise find gibi davranıyor. Sıralamanın stabil ve sunucu tarafından tanımlı olduğu belirtiliyor; dev.to yazısı bunun alakalı ile aynı şey olmadığına dikkat çekiyor.

Dosyaları yönetilen bir depo yerine geliştiricinin kontrol ettiği altyapıda tutan istemci taraflı bellek aracı da aynı noktaya düşüyor: görüntüleme, oluşturma, düzenleme ve yeniden adlandırma işlemlerini kapsayan altı belgelenmiş komut var ve aralarında arama yok.

İsimlendirme, erişim tasarımının kendisidir

Analize göre bunun sonucu, path segmentlerinin organizasyonel bir süs olmaktan çıkıp asıl seçim anahtarları haline gelmesi. Endpoint'in sunduğu tek filtre path_prefix ve depth olduğundan, path şemasını tasarlayan kişi aslında erişim tasarımını yapıyor.

Anthropic'in kendi araç rehberi bunu araçlar için açıkça ortaya koyuyor: arama isimler ve açıklamalar üzerinden eşleşiyor, yani açıklayıcı tanımlar keşfedilebilirliği artırıyor ve servise veya kaynağa göre tutarlı namespacing, tek bir aramanın bütün bir grubu yüzeye çıkarmasını sağlıyor. Bellek en iyi uygulama rehberinde path'ler hakkında eşdeğer bir cümle yok. Onun yerine bir seviye daha yüksekte bölümülendirme yapıyor: kullanıcı başına bir, paylaşılan alan bilgisi için bir ve projeye özgü bağlam için bir depo gibi daha küçük, amaca göre tasarlanmış depolar öneriyor; her deponun içindeki ağacı ise path'leri yazan kişiye bırakıyor. Tam projeksiyon ayrıca dışa aktarma ve senkronizasyon için toplu okuma yolu olarak belgelendiğinden, toplu okumalar gelecekteki API büyümesinden bağımsız olarak aynı listeleme üzerinden yürüyor.

Neden önemli

Bu ayrım, agent'ların bağlamı nasıl ölçeklendirdiğini şekillendiriyor. Araç yolunda platform sıralı seçim yapıyor ve model kısa bir liste tüketiyor. Bellek yolunda model bir listeleme okuyor ve alakayı kendisi kararlaştırıyor; bu da erişim kalitesini path isimlendirme disiplinine ve agent'ın kendi muhakemesine yıkıyor. Büyük bellek depoları kuran geliştiriciler, path tasarımını sonradan akla gelen bir ayrıntı değil, birinci sınıf bir mühendislik kararı olarak ele almak isteyebilir.

Gözlemin kanıtlamadığı şeyler

Yazı kapsam konusunda dikkatli. Endpoint, tarihli bir header arkasında Beta olarak işaretlenmiş ve tüm parametreler 2026-09-07 tarihinde doğrulanmış. Bir oturuma bağlı depo ayrıca sandbox içinde /mnt/memory altına mount ediliyor ve agent orayı standart araç takımıyla okuyup yazdığı için boşluk tek bir belgelenmiş endpoint'te, ürünün kendisinde değil. Yazı ayrıca sıralı aramanın bellek için daha iyi olacağını iddia etmiyor; bu, test etmediği ampirik bir soru. Yazar ayrıca, AI agent'ları için bir bellek motoru olan Mnemoverse üzerinde çalıştığını açıklıyor — bu, okurların argümanı değerlendirirken göz önünde bulundurması gereken çıkar çatışması.