Biblioteca di lettura
Progettare la scelta di fermarsi o leggere un’altra pagina
Rendi deliberata la richiesta di un’altra pagina LocalLLaMA. Collega domanda aperta, costo e limite di paginazione senza predire la qualità delle risposte non viste.
Individuare l’attività irrisolta
È più facile valutare il pulsante per la pagina successiva quando il lettore sa indicare ciò che resta da chiarire. In una ricerca proposta sulla quantizzazione, potrebbe cercare una discussione che specifichi le condizioni di una misurazione della memoria. Dopo la prima risposta, chiedi se il materiale le descrive. La risposta può essere sì, no o incerta per mancanza di contesto. È una decisione di lettura, non la conclusione che la prima pagina contenga i record più pertinenti. L’API non garantisce una simile classifica.
Tieni domanda e breve nota accanto ai record caricati. Se la prima pagina fornisce già un riferimento utile, permetti di conservarlo e uscire senza altri recuperi. Altrimenti mantieni l’incertezza precisa, per esempio “hardware non specificato”, invece di “servono altri risultati”. Sono scelte d’interfaccia illustrative, non risultati osservati su LocalLLaMA. Lo scorrimento automatico non dovrebbe trasformare una domanda aperta in una ricerca illimitata né spostare un riferimento ancora in esame.
Stimare un’altra richiesta
Stima costo concreto e lavoro di lettura, non il valore di risposte mai viste. Passare da pagina 1 a pagina 2 con limit=3 chiede fino ad altri tre record alle stesse condizioni. Ogni recupero riuscito costa un credito, anche se vuoto. La conversione standard è $1 per 1000 crediti a pagamento; la ricarica minima di $50 ne fornisce 50000. Questi dati aiutano il gestore a pianificare le richieste. Non giustificano la promessa che una specifica pagina successiva contenga un esperimento utile o opinioni più varie.
La tua applicazione può scegliere un budget di lettura inferiore al massimo del servizio. Spiegalo prima della prossima richiesta: un’altra pagina, fino a tre record, stessi filtri. Non stimare la rilevanza dalla varietà di una prima pagina minuscola o da una distribuzione di punteggi inventata. L’ordine _doc non dà motivo di pensare che i record utili arrivino prima o che le pagine seguenti valgano meno. Il lettore può invece cambiare un filtro o fermarsi. Sono scelte più oneste di un consiglio basato su materiale non ricevuto.
Leggere i segnali di confine
Leggi pagination.has_more prima di proporre un’altra pagina e mantieni invariati filtri inviati e limit mentre incrementi page. Il servizio accetta pagine da 1 a 100 e al massimo 100 record per richiesta. A page=100 con limit=100, una pagina finale piena non lascia spazio a un record di anticipazione oltre la finestra esposta. pagination.window_exhausted può quindi accompagnare has_more=false e un totale come limite inferiore. Ferma quella sequenza al confine senza annunciare di aver letto ogni record corrispondente.
Mostra pagination.total con pagination.relation. gte significa che sono indicati almeno tanti riscontri, non circa tanti; unknown può accompagnare null. Una pagina vuota dopo la prima può avere un totale sconosciuto. Questi campi descrivono la risposta limitata, non la completezza del tema. Neppure record ripetuti o simili provano che le pagine seguenti siano ridondanti. Se l’elenco elimina duplicati tramite ID reali, spiega la scelta locale e conserva abbastanza provenienza da distinguerla dai dati restituiti da ogni risposta.
Permettere al lettore di fermarsi
Usa un’azione esplicita per la pagina successiva e rendi semplice lasciare quella corrente. Il lettore dovrebbe poter conservare un riferimento, chiudere il quaderno o tornare alle condizioni inviate senza nuove chiamate. Durante una richiesta, impedisci attivazioni ripetute della stessa azione e mantieni accessibile il testo esistente. Se offri un comando Stop, specifica cosa interrompe: future richieste automatiche o l’attesa nell’interfaccia. Non garantisce di cancellare il lavoro già inviato al server né di renderlo gratuito.
Se la richiesta successiva fallisce, distingui i record già caricati dal numero di pagina ancora in sospeso. Proponi un tentativo deliberato solo quando opportuno. Un guasto a monte ha una gestione del rimborso, eventualmente in attesa di riconciliazione; una risposta persa lascia incerto l’addebito finale. Non passare silenziosamente a un’altra pagina nascondendo il tentativo fallito. Concludi in uno stato utile: il lettore sa cosa ha esaminato, perché ha continuato o smesso e cosa resta ignoto. È un esito difendibile per una ricerca storica, anche senza risposta completa.
