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 Google (Piano Pro)

Impossibile connettersi a Google

  1. Vai su Impostazioni > Connettori
  2. Fai clic su "Connetti account Google"
  3. Assicurati di approvare tutte le autorizzazioni richieste
  4. Verifica che il tuo account risulti connesso
  5. Se il problema persiste, disconnetti e riprova

Gli strumenti Google non funzionano

  1. Verifica che Google sia connesso (Impostazioni > Connettori)
  2. Prova ad aggiornare la connessione Google (pulsante "Riconnetti Google")
  3. Assicurati che lo strumento specifico sia abilitato (Impostazioni > Strumenti e integrazioni > 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 dal browser

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

  • Sul tuo dispositivo principale, assicurati che Private Relay sia attivo (Impostazioni > Connettività > Dispositivi e relay) e mostri "Connesso"
  • Accedi nel browser remoto con lo stesso account del tuo dispositivo principale: il relay raggiunge solo la tua istanza
  • L'estensione o l'app desktop del tuo dispositivo principale deve essere in esecuzione e online affinché il browser remoto possa controllarla
  • Al primo avvio la pagina potrebbe mostrare un indicatore di "connessione in corso" per alcuni secondi durante la creazione della sessione crittografata: attendi il completamento prima di ricaricare

Accesso effettuato ma la pagina remota rimane bloccata sulla schermata di login

  • Attendi qualche secondo: l'app viene avviata solo dopo che la sessione crittografata è stata stabilita
  • Se rimane bloccata, verifica che il dispositivo principale sia online e che Private Relay 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

Schermo vuoto nell'app desktop o mobile

  • Riavvia completamente l'app
  • Verifica di essere connesso a Internet
  • Prova a cancellare la cache dell'app (varia in base alla piattaforma)
  • Aggiorna all'ultima versione

Gli strumenti non funzionano

  1. Vai su Impostazioni > Strumenti e integrazioni > Configurazione strumenti e controlla che lo strumento sia abilitato
  2. Alcuni strumenti richiedono autorizzazioni o configurazioni (come un account Google connesso per gli strumenti Google)
  3. Se visualizzi un errore di "autorizzazione necessaria", riconnetti il provider in Impostazioni > Connettori e riapprova gli ambiti

L'estensione non riesce a connettersi all'app desktop

  • Per prima cosa, verifica che Abilita Caiioo Bridge sia attivo (Impostazioni > Connettività > Dispositivi e relay): è disattivato per impostazione predefinita e finché è disattivato l'estensione non si connetterà mai all'app desktop e i controlli Riconnetti/porta saranno disattivati
  • Se usi sia l'estensione del browser sia l'app desktop, l'estensione si connette all'app desktop tramite un WebSocket locale (bridge delle funzionalità, non sincronizzazione)
  • Riavvia l'app desktop e ricarica l'estensione
  • Assicurati che non siano in esecuzione altre copie dell'app desktop: più istanze entrano 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 temporaneamente inattivo quando non è l'app in primo piano; rimane connesso e Caiioo lo riattiva automaticamente quando un comando lo richiede
  • Se l'avviso persiste, porta il browser in primo piano una volta, quindi riprova

Gli allegati dei messaggi non vengono caricati

  • Verifica che il formato del file sia supportato (PDF, immagini, documenti Word, fogli di calcolo, presentazioni)
  • Prova con un file di dimensioni inferiori
  • Assicurati di disporre di una connessione 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.