Risoluzione problemi¶

Anche con una configurazione corretta, possono verificarsi problemi. Questo capitolo raccoglie le situazioni più comuni e le relative soluzioni.

Problemi di autenticazione¶

L'autenticazione non si avvia automaticamente

Se una richiesta a NotebookLM fallisce senza aprire la finestra di login, verificare lo stato del server:

Controlla lo stato di NotebookLM

Claude utilizza il tool get_health per diagnosticare il problema. Sulla base del risultato potrebbe essere sufficiente avviare manualmente l'autenticazione con setup_auth.

Problemi persistenti di autenticazione

In caso di errori ripetuti, la soluzione più efficace è una pulizia completa seguita da una nuova autenticazione:

1. Chiedere a Claude: Esegui la pulizia di NotebookLM preservando la libreria
2. Verificare l'anteprima di ciò che verrà eliminato
3. Confermare l'operazione
4. Ri-autenticarsi: Configura l'autenticazione per NotebookLM

La pulizia rimuove i dati del browser, la cache e i profili corrotti, preservando la libreria dei notebook registrati.

Problemi con le risposte¶

Le risposte contengono conoscenze esterne

Se le risposte sembrano integrare informazioni non presenti nei documenti: 1. Verificare che il sistema stia effettivamente utilizzando il tool ask_question (la strutturazione automatica è attiva solo con questo tool) 2. Provare a riformulare la domanda in modo più specifico 3. Verificare su NotebookLM che il prompt strutturato sia stato effettivamente inviato, controllando la cronologia della chat nel notebook 4. Verificare che il tool ask_question abbia effettivamente restituito una risposta. Nella chat di Claude Desktop, espandere il dettaglio della chiamata al tool e controllare che il campo Response contenga il testo di NotebookLM. Se la risposta è assente o contiene un errore, Claude potrebbe aver generato la risposta autonomamente con le proprie conoscenze.

Timeout o assenza di risposta

NotebookLM può andare in timeout se il prompt contiene formattazione problematica. Il sistema gestisce automaticamente questo aspetto evitando linee decorative nei prompt, ma se il codice sorgente del server è stato personalizzato, verificare che all'inizio della richiesta strutturata inviata non siano presenti sequenze di === o ---.

Citazioni assenti nella risposta

Domande molto generiche possono produrre risposte meno strutturate. Riformulare con maggiore specificità migliora la qualità delle citazioni. Per esempio, invece di "Parlami del progetto", chiedere "Quali sono le milestone del progetto e le relative scadenze, con riferimento ai documenti?".

[NON PRESENTE NEI DOCUMENTI] inatteso

Questa dichiarazione è un comportamento corretto, significa che l'informazione cercata non è nei documenti caricati. Verificare che il notebook selezionato sia quello giusto e che i documenti pertinenti siano effettivamente presenti in NotebookLM.

Problemi di connessione¶

Errore "browserContext.newPage: Target page/context/browser has been closed"

Il server si riprende automaticamente da questo errore ricreando il contesto del browser. È sufficiente riprovare la richiesta.

Errore "ProcessSingleton" o conflitti di profilo

Il server è configurato per gestire automaticamente questa situazione utilizzando profili browser isolati. Se il problema persiste, verificare che non ci siano processi residui del server e riprovare.

Limiti degli account¶

Limite giornaliero raggiunto

Gli account gratuiti hanno un limite di 50 query al giorno verso NotebookLM. Il contatore si resetta a mezzanotte (ora UTC). Le opzioni disponibili:

• attendere il reset del contatore
• utilizzare il tool re_auth per passare a un account Google diverso (se si dispone di più account)
• valutare un abbonamento NotebookLM Plus per limiti superiori (500 query al giorno)

Pulizia completa¶

Se i problemi persistono nonostante i tentativi di risoluzione, è possibile eseguire una pulizia profonda che rimuove tutti i dati del server mantenendo la libreria dei notebook:

Esegui la pulizia completa di NotebookLM preservando la libreria

La pulizia scansiona otto categorie di file: dati dell'installazione corrente, cache NPM, log del server, file temporanei e altri dati residui. Prima di eliminare qualsiasi cosa il sistema mostra un'anteprima dettagliata di ciò che verrà rimosso e attende conferma esplicita. Dopo la pulizia è necessario ri-autenticarsi.