Questa è una traduzione automatica del documento originale in inglese. In caso di discrepanze tra la presente traduzione e la versione originale in inglese, prevarrà la versione inglese. Leggi la versione originale in inglese

Risoluzione dei problemi

Qualcosa non funziona? Inizia da qui.

Problemi con l'estensione del browser

L'estensione non si carica

  1. Assicurati di averla installata dal Chrome Web Store (non una versione di sviluppo)
  2. Vai su chrome://extensions e cerca messaggi di errore
  3. Prova a disabilitare e riabilitare l'estensione
  4. Riavvia completamente Chrome se il problema persiste

Il pannello laterale non si apre

  1. Clicca sull'icona di Caiioo nella barra degli strumenti (in alto a destra)
  2. Assicurati di essere su una pagina web normale (alcune pagine come le impostazioni di Chrome non consentono estensioni)
  3. Vai su chrome://extensions, trova Caiioo e clicca su "Ricarica"
  4. Prova a cliccare di nuovo sull'icona

Barra laterale vuota o corrotta dopo un aggiornamento

  • Svuota la cache del browser e ricarica l'estensione
  • Chiudi e riapri il pannello laterale
  • Se nulla aiuta, disabilita e riabilita l'estensione

Problemi di accesso

Impossibile accedere con Google / Apple / Microsoft

  1. Assicurati che il browser non blocchi i popup — OAuth richiede una finestra popup
  2. Su iOS, se l'accesso con Google si blocca, prova invece l'opzione "Accedi con Apple"
  3. Cancella i cookie per caiioo.ai e riprova
  4. Se hai cambiato password di recente, esci prima dal fornitore nel browser, poi riprova

Bloccato nella schermata di login dopo l'accesso

  • Attendi qualche secondo — l'app sta recuperando il tuo profilo
  • Se rimane bloccata, chiudi e riapri l'app (o ricarica l'estensione)
  • Assicurati che l'orologio del dispositivo sia corretto — la validazione del token OAuth fallisce se l'orario è errato

Problemi con la chiave API

La chiave API non funziona

  1. Copia nuovamente la chiave dal sito web del provider e incollala con attenzione (senza spazi iniziali o finali)
  2. Verifica che il tuo account disponga ancora di crediti
  3. Prova a generare una nuova chiave e a usare quella
  4. Controlla che il formato della chiave sia corretto: le chiavi di OpenRouter iniziano con sk-or-

Non riesco a trovare la mia chiave API

  • OpenRouter: openrouter.ai/keys
  • Ollama: nessuna chiave richiesta — verifica che il tuo server locale sia in esecuzione su http://localhost:11434

Consulta Provider IA e chiavi API per maggiori dettagli.

"Limite di frequenza superato" o "sovraccarico" sul modello scelto

Dipende dal provider, non dalla tua chiave. Quando un modello da te scelto supera il limite di frequenza, è sovraccarico o non disponibile, Caiioo indica il nome del modello e spiega l'accaduto invece di passare silenziosamente a uno diverso. Attendi un minuto e invia di nuovo, oppure scegli tu stesso un altro modello. (Quando è stato Caiioo a scegliere il modello per te, il passaggio avviene comunque in automatico: questa è la differenza.)

Un modello gratuito continua a rifiutare le mie richieste

Alcuni modelli gratuiti di OpenRouter rifiutano le richieste provenienti da app che non figurano nel loro elenco di autorizzazioni. Caiioo memorizza il modello che ha opposto un rifiuto, lo contrassegna nel selettore e lo salta durante il passaggio a un altro modello, ricontrollando in seguito nel caso in cui il blocco venga rimosso. Nel frattempo, seleziona un modello diverso.

Integrazione con Google (Livello Pro)

Impossibile connettersi a Google

  1. Vai su Impostazioni > Account > Autorizzazioni e permessi dell'account
  2. Fai clic su "Collega account Google"
  3. Assicurati di approvare tutte le autorizzazioni richieste
  4. Verifica che il tuo account risulti connesso
  5. Se ancora non funziona, disconnettiti e riprova

Gli strumenti Google non funzionano

  1. Verifica che Google sia connesso (Impostazioni > Account > Autorizzazioni e permessi dell'account)
  2. Prova ad aggiornare la tua connessione Google (pulsante "Riconnetti Google")
  3. Assicurati che lo strumento specifico sia abilitato (Impostazioni > Strumenti, modalità e app > Configurazione strumenti)

Problemi con Private Sync

La sincronizzazione non funziona

  1. Verifica che la sincronizzazione privata sia effettivamente abilitata (Impostazioni > Connettività > Private Sync)
  2. Verifica che il tuo account Google sia connesso
  3. Assicurati di avere spazio di archiviazione residuo su Google Drive
  4. Fai clic su "Riconnetti Google" se il token è scaduto
  5. Prova a disattivare e riattivare la sincronizzazione

I dati non si sincronizzano tra i dispositivi

  • La sincronizzazione privata lavora in background: attendi qualche secondo
  • Controlla di utilizzare lo stesso account Google su tutti i dispositivi
  • Assicurati che la sincronizzazione privata sia abilitata anche sull'altro dispositivo
  • Aggiorna manualmente disattivando e riattivando la sincronizzazione

Problemi di accesso remoto al browser

La pagina relay.caiioo.ai/app non si connette

  • Sul tuo dispositivo principale, assicurati che Relè privato sia attivato (Impostazioni > Connettività > Connessioni) e mostri "Connesso"
  • Accedi al browser remoto con lo stesso account del tuo dispositivo principale: il relè raggiunge solo la tua istanza
  • L'estensione o l'app desktop del tuo dispositivo principale devono essere in esecuzione e online affinché il browser remoto possa controllarla
  • All'apertura iniziale, la pagina potrebbe mostrare un'icona di caricamento della connessione per alcuni secondi durante la creazione della sessione crittografata: lasciala finire prima di ricaricare

Accesso effettuato ma la pagina remota rimane sulla schermata di login

  • Attendi qualche secondo: l'app si avvia solo una volta stabilita la sessione crittografata
  • Se rimane bloccata, conferma che il tuo dispositivo principale sia online e che il Relè privato sia connesso, quindi ricarica la pagina

Problemi di prestazioni

Le risposte sono lente

  1. Controlla se il provider di IA ha problemi (controlla la loro pagina di stato)
  2. Prova a usare un modello più veloce ed economico (come Gemini Flash o Mistral)
  3. Archivia le vecchie conversazioni se ne hai centinaia
  4. Controlla la tua connessione internet

Le conversazioni richiedono un'eternità

  • L'IA sta lavorando—cerca l'indicatore di caricamento
  • Alcuni modelli sono più lenti di altri. Passa a uno più veloce se hai fretta
  • Se richiede più di qualche minuto, l'IA potrebbe essersi bloccata. Clicca su Stop e riprova

Abbonamento e fatturazione

Impossibile visualizzare "Gestisci piano"

  • Assicurati di aver effettuato l'accesso con l'account che detiene l'abbonamento
  • Se ti sei abbonato su iOS, il pulsante Gestisci piano reindirizza alle impostazioni di abbonamento Apple
  • Se ti sei abbonato sul Web, reindirizza al portale di fatturazione Stripe
  • Esci e accedi nuovamente per aggiornare lo stato del tuo abbonamento

"Gestisci piano" si apre nel posto sbagliato

  • Gli acquisti in-app di iOS sono gestiti in Impostazioni > ID Apple > Abbonamenti — non su caiioo.ai/account
  • Gli abbonamenti Stripe sono gestiti tramite il link del portale in Impostazioni > Account > Profilo utente o su caiioo.ai/account
  • Caiioo reindirizza automaticamente in base a dove ti sei abbonato — questo è il comportamento previsto

Effettuato l'upgrade ma ancora sul vecchio livello

  • Gli upgrade di Stripe impiegano un minuto per propagarsi: ricarica l'app
  • Gli acquisti in-app di Apple possono richiedere fino a 24 ore per la verifica. Tocca "Ripristina acquisti" in Impostazioni > Account > Profilo utente per accelerare il processo
  • Se hai già un abbonamento su un'altra piattaforma, il pulsante Abbonati ti dirà di gestirlo lì

Altri problemi

Schermata vuota nell'app desktop o mobile

  • Riavvia completamente l'app
  • Controlla di essere connesso a Internet
  • Prova a svuotare la cache dell'app (varia a seconda della piattaforma)
  • Aggiorna alla versione più recente

Gli strumenti non funzionano

  1. Vai su Impostazioni > Strumenti, modalità e app > Configurazione strumenti e verifica che lo strumento sia abilitato
  2. Alcuni strumenti richiedono autorizzazioni o configurazione (come un account Google collegato per gli strumenti Google)
  3. Se visualizzi un errore "richiede autorizzazione", ricollega il provider in Impostazioni > Account > Autorizzazioni e permessi dell'account e riapprova gli ambiti

L'estensione non riesce a connettersi all'app desktop

  • Per prima cosa, controlla che Abilita bridge Caiioo sia attivato (Impostazioni > Connettività > Connessioni) — è disattivato per impostazione predefinita e finché è disattivato l'estensione non si connette mai all'app desktop e i controlli di riconnessione/porta sono disattivati
  • Se usi sia l'estensione per browser che l'app desktop, l'estensione si connette all'app desktop tramite un WebSocket locale (bridge di funzionalità, non sincronizzazione dello stato)
  • Riavvia l'app desktop e poi ricarica l'estensione
  • Assicurati che non siano in esecuzione altre copie dell'app desktop: istanze multiple vanno in conflitto

Avviso "Browser non connesso" su macOS anche se un browser è aperto

  • Caiioo ora riconosce Chrome, Safari, Edge e Firefox — l'avviso scompare non appena uno di essi si connette
  • Safari si connette tramite un canale diverso e può diventare brevemente inattivo quando non è l'app in primo piano; rimane connesso e Caiioo lo riattiva automaticamente quando un comando lo richiede
  • Se il avviso persiste, porta il browser in primo piano una volta, quindi riprova

Gli allegati dei messaggi non vengono caricati

  • Controlla che il formato del file sia supportato (PDF, immagini, documenti Word, fogli di calcolo, presentazioni)
  • Prova un file più piccolo
  • Assicurati di avere una connessione a Internet

Ottenere aiuto

  • Risposte rapide: Fai clic sull'icona ? nell'intestazione
  • Impostazioni e risoluzione dei problemi: Fai clic sull'icona a forma di ingranaggio
  • Questa guida: Impostazioni > Aiuto > Documentazione e note legali
  • Lascia che Caiioo invii una segnalazione di errore per te: Chiedi di segnalare un problema e si aprirà il modulo di supporto integrato precompilato con una descrizione dettagliata da revisionare e inviare. Dici "inviala e basta" e — con la tua approvazione — invierà il ticket direttamente, allegando i dettagli tecnici della conversazione in modo che il team possa riprodurre ciò che hai visto.

Vedi anche

This guide is maintained by the Caiioo team using Slate, our built-in editor.