Okuma kitaplığı
Sorgudaki değişikliği son kullanıcıya gösterin
Nicemleme aramasını izlenebilir kılın: başlangıç koşullarını kaydedin, tek filtreyi değiştirin, sınırlı yanıtları karşılaştırın ve farkın neyi kanıtlamadığını açıklayın.
Başlangıç durumunu kaydedin
Başlangıç durumu yalnızca ilk anahtar sözcük değildir; topluluk kapsamı, yazar kısıtları, tarih aralıkları ve puan eşikleri dâhil tüm filtrelerdir. Önerilen LocalLLaMA okuma alıştırmasında https://api.redditsearchapi.com üzerindeki /v1/search?q=quantization&subreddit=LocalLLaMA&limit=3&page=1 ile başlayın. Okurun sorusu, deneyde belleğin hangi koşullarda ölçüldüğü olabilir. Bu, belirli tartışmaların mevcut olduğuna ilişkin kanıt değil, önerilen istektir. Sonraki değişikliklerin amacı olması için soruyu parametrelerin üstüne yazın.
Gönderilen değerleri formun o andaki içeriğinden ayrı saklayın. Yanıt zamanını uygulama gözlemi olarak, dönen kayıt sayısını ve gerçek sayfalama alanlarını kaydedin. pagination.total ile pagination.relation birlikte tutulmalıdır; gte işaretli değer yaklaşık bir kesin sayı değil, alt sınırdır. Yanıtı yerel kaydetmek okurun incelediği malzemeyi koruyabilir. Yalnızca URL'yi kaydetmek ise sabit bir arşiv görüntüsünü değil, istek koşullarını korur. API bu karşılaştırma defterini sizin yerinize oluşturmaz.
Tek bir kontrolü değiştirin
Okurun bir puan eşiğinin etkisini incelemek istediğini varsayın. q=quantization, subreddit=LocalLLaMA, limit=3 ve page=1 aynı kalsın; min_score=10 ekleyin. Göndermeden önce eski ve yeni değerleri gösterin. Eşik, kayıtlı puanı filtreler; kaliteli kanıtı belirlemez ve puan sırası istemez. Başka bir alıştırmada yalnızca topluluk değişebilir. r/ öneki eklemenin aynı filtre için eşdeğer yazım olduğunu varsaymak yerine, amaçlanan subreddit değerini tam olarak kullanın.
Değişmiş isteği yalnızca açık bir eylemden sonra gönderin. Alan düzenlemek, her tuşta ücretli veri alımı başlatmak zorunda değildir. Soru quantization memory gerektiriyorsa çözümlenmiş iki terimin eşleşen bir title ya da text alanı içinde bulunması gerektiğini açıklayın; bu, tam ifade veya anlamsal arama değildir. Tarihleri YYYY-MM-DD UTC biçiminde tutun; to günü bütünüyle dâhildir. Yeni koşullara sayfa 1'den başlayın. Değişmiş sorgu, eskisinin ikinci sayfası değil, yeni dizidir.
Önce-sonra sorgu kartı gösterin
Gönderilmiş iki isteği kendi sonuçlarının yanına yerleştirin. Değişen parametreyi yalnızca renkle değil metinle vurgulayın ve istek zamanlarını gösterin. Küçük kart; okurun sorusunu, filtreleri, yanıt durumunu, gösterilen kayıt sayısını ve nitelenmiş toplamı içerebilir. Bir istek başarısızsa alanı başarısız olarak etiketleyin; eski başarılı yanıtı yeni filtre etiketi altında karşılaştırmayın. Gelen her yanıtı isteğine bağlayın ki geciken yanıt yanlış kartı sessizce değiştirmesin.
İlk kayıtları en iyi sonuçlar diye adlandırmadan mevcut kaynak metni kartların altında gösterin. Başlık, yazar, tarih ve kullanılabilir bağlantı eksik olabilir. Yerlerine bilgi üretmeyin; eksikleri belirtin. Okur, ayarlar hâlâ eksik gibi bir gözlemi kaynak metninden ayrı ekleyebilir. Uygulama iki yanıtı saklıyorsa bu, kendi saklama tercihleriniz olan uygulama depolamasıdır. Paylaşılan parametre özeti kimlik bilgilerini dışlamalı, sorgunun veya notun hassas bilgi içermesi durumunda uyarı vermelidir.
Yorumun sınırını belirtin
Tek girdiyi değiştirmek amaçlanan karşılaştırmayı incelemeyi kolaylaştırır; gözlenen her farkın yalnızca o değişiklikten kaynaklandığını kanıtlamaz. Ayrı isteklerde sabit veri görüntüsü vaat edilmez. İki yanıt da sınırlıdır; gte toplamı eşleşen toplulukların büyüklüklerini kesin olarak çıkarmaya elvermez. Veri, tarih, ilgi veya puan yerine arşivin _doc sırasındadır. Önce-sonra kartı iki isteği ve dönen malzemeyi belgeler; tartışma kalitesinin, popülerliğin veya teknik sorun yaygınlığının kontrollü ölçümünü değil.
Boş sonuç dâhil her başarılı veri alımı bir kredidir. Sonraki sayfa, en fazla 100 kayıt ve 100'e kadar sayfa numarasıyla başka bir istektir; pencereyi tüketmek tam kapsamı göstermez. Düz kayıtlar ve isteğe bağlı üst kayıt bağlantıları eksiksiz konuşmayı garanti etmez. Karşılaştırmayı okurun sonraki kararıyla bitirin: yararlı referansı saklamak, eksik ayarı araştırmak, bir koşulu yeniden değiştirmek veya durmak. Bağımsız tarihsel API bu karara malzeme sağlar; canlı Reddit görünümü ya da doğrulanmış yanıt sağlamaz.
