Risoluzione dei problemi di ReplyRabbit
La maggior parte dei problemi di ReplyRabbit si riduce a una di tre cose: una chiave API mancante o errata, l'uso di un provider non consentito dal tuo livello di piano, o una cache FreeScout obsoleta. Segui la sezione corrispondente qui sotto, dove ogni problema elenca prima il sintomo e poi la soluzione.
Nessuna bozza viene generata
Sintomo: apri una conversazione, ma non appare alcuna bozza AI e sembra che non succeda nulla.
Correzione: apri le impostazioni ReplyRabbit della casella (Casella di posta > Impostazioni > ReplyRabbit) e conferma che sia selezionato un provider e che la sua chiave API sia impostata. Nel piano Free l'unico provider disponibile è OpenAI, quindi se ne hai scelto un altro, torna a OpenAI o esegui l'upgrade. Poi verifica che ReplyRabbit sia abilitato per la casella di posta in cui stai lavorando, poiché le bozze vengono generate solo per le caselle abilitate.
Errore chiave API non valida o provider
Sintomo: vedi un errore che menziona una chiave non valida, un errore di autenticazione o un provider non raggiungibile.
Correzione: ricontrolla la chiave per errori di battitura e spazi indesiderati, conferma che sia la chiave del provider che hai effettivamente selezionato (una chiave OpenAI non funziona con Anthropic) e assicurati che la chiave abbia ancora credito e accesso nella dashboard del provider. Una chiave senza saldo residuo o con accesso revocato produce lo stesso errore.
Errori dopo l'aggiornamento di PHP
Sintomo: dopo un aggiornamento del server (ad esempio, a Ubuntu 26.04 con PHP 8.5), Verifica connessione fallisce o i job in background si fermano, e il log di FreeScout mostra messaggi che terminano con is deprecated since 8.5.
Correzione: mantieni ReplyRabbit e gli altri tuoi moduli aggiornati da Gestisci > Moduli, poi esegui php artisan freescout:clear-cache e php artisan queue:restart. ReplyRabbit supporta PHP dalla 8.0 alla 8.5. Vedi Correggi gli errori "deprecated since 8.5" in FreeScout per scoprire da quale modulo proviene un messaggio.
Il menu ReplyRabbit è mancante
Sintomo: ReplyRabbit non appare nei menu o nelle impostazioni di FreeScout dopo l'installazione.
Correzione: prima assicurati che il modulo sia attivato in Gestisci > Moduli. Poi svuota la cache dalla radice di FreeScout:
php artisan freescout:clear-cacheSe manca ancora, controlla i permessi dell'utente: un utente senza accesso alla casella pertinente o alle impostazioni di amministrazione non vedrà le opzioni di ReplyRabbit.
Le bozze si sono fermate dopo un po'
Sintomo: le bozze funzionavano all'inizio, poi hanno smesso di generarsi più avanti nel mese.
Correzione: il piano Free consente 10 bozze al mese. Una volta raggiunto quel limite, le bozze si sospendono fino al mese successivo. Pro e Team non hanno limiti di bozze. Su qualsiasi piano, le bozze si sospendono anche se il Budget mensile di token è esaurito, quindi controlla anche quell'impostazione (0 significa nessun budget).
Il caching dei prompt non modifica il conteggio mensile dei token
Sintomo: le bozze ripetute sembrano idonee alla cache dei prompt del provider, ma l'utilizzo di token di ReplyRabbit mostra comunque il totale completo di input e output.
Correzione: questo è previsto. ReplyRabbit mantiene i budget mensili prudenti e conta i token totali, anche quando un provider fattura l'input in cache diversamente. I risparmi della cache del provider dipendono dal provider, dal modello, dai prefissi di prompt ripetuti e dalla reportistica del provider. Il controllo della cache Anthropic è usato solo per il lavoro di bozza ripetuto idoneo e ricade sulla generazione normale quando non supportato.
I ticket Linear non vengono creati
Sintomo: le azioni successive vengono rilevate, ma non viene creato alcun ticket Linear.
Correzione: nelle impostazioni di ReplyRabbit, controlla la chiave API Linear, il team selezionato e se i ticket sono in uno stato in sospeso in attesa di conferma. Conferma anche che il tuo livello includa Linear: la creazione manuale di ticket Linear è una funzionalità Pro, e la creazione automatica di ticket è una funzionalità Team.
Le issue Jira non vengono create
Sintomo: una conversazione richiede lavoro di ingegneria, ma non viene creata alcuna issue Jira.
Correzione: nelle impostazioni di ReplyRabbit, conferma che Jira sia selezionato come issue tracker della casella. Controlla l'URL del sito Jira Cloud, l'email dell'account, il token API, il progetto predefinito e il tipo di issue predefinito. Conferma anche che il tuo livello includa la creazione di issue: la creazione manuale di issue Jira è una funzionalità Pro, e la creazione automatica di issue è una funzionalità Team. Per il percorso di configurazione completo, vedi Integrazione Jira.
I Tag dei Workflows non vengono applicati
Sintomo: ti aspettavi tag come rr_priority_critical, rr_no_reply_needed, oppure rr_linear_issue_created, ma la conversazione non ha tag ReplyRabbit.
Correzione: apri le impostazioni ReplyRabbit della casella e conferma Abilita la sincronizzazione dei workflow e Applica tag FreeScout sono attivi nella Tag dei Workflows sezione. Se mancano i tag di segnale, conferma Segnali AI è attivo e la conversazione è stata analizzata. Se mancano i tag Linear, conferma che la conversazione abbia un'issue Linear creata da ReplyRabbit.
Se le ricette di FreeScout Workflows non si attivano, verifica prima che ReplyRabbit stia aggiungendo il tag FreeScout previsto. Poi verifica se il modulo Workflows installato reagisce alle modifiche programmatiche dei tag. ReplyRabbit può applicare i tag, ma il modulo Workflows controlla se una ricetta viene eseguita da quella modifica di tag.
Fonti di conoscenza: una bozza non ha usato le mie pagine di aiuto, la Knowledge Base, i prodotti o le risposte precedenti
Sintomo: una bozza ha ignorato informazioni che sai essere nelle tue pagine di aiuto, Knowledge Base, lista prodotti o risposte precedenti.
Correzione: inizia con la riga sotto la bozza nell'editor di risposta. Elenca cosa ha usato la bozza, ad esempio "Inclusi: 2 pagine di aiuto, 1 articolo della Knowledge Base, 3 risposte precedenti a questo cliente". Fai clic per vedere i link, più una nota per ogni fonte attivata che non ha aggiunto nulla:
- Attivato ma ancora nulla indicizzato: l'indicizzazione non è terminata. Controlla il queue worker (vedi sotto), poi attendi il completamento dell'indicizzazione.
- Nessuna corrispondenza valida per questo messaggio: la fonte va bene, ma nulla al suo interno corrispondeva abbastanza strettamente al messaggio di questo cliente. Aggiungi o migliora contenuti che rispondano a questo tipo di domanda.
- Indice sopra il limite di ricerca: una volta che l'indice supera 6.000 sezioni indicizzate, viene eseguita solo la corrispondenza per parole chiave, non quella basata sul significato. Rimuovi le fonti di cui non hai bisogno per riportarlo sotto il limite.
- Il tuo piano non lo include: quella fonte non è disponibile sul tuo piano attuale.
- Il modulo Knowledge Base non è installato o attivo: installalo o attivalo in Gestisci > Moduli.
Avvisi sullo stato della configurazione
Il banner dello stato di configurazione nelle impostazioni della casella ora avvisa quando:
- Il worker della coda non sembra essere in esecuzione. L'indicizzazione e le bozze automatiche non si completano mai senza di esso. FreeScout esegue la coda tramite il cron job
php artisan schedule:runoppure unaqueue:workprocesso, quindi assicurati che uno di essi sia configurato. - Nessuna fonte di conoscenza è attivata. Attiva almeno una in Mailbox settings, Knowledge sources.
- Una fonte è attivata ma non ancora indicizzata. Lascia completare l'indicizzazione.
Fonti del sito web
- La scansione si ferma a 200 pagine per impostazione predefinita, e la fonte ora lo indica, con un pulsante per aumentare il limite. Salva le impostazioni dopo, poi esegui di nuovo la scansione.
- Le pagine che non possono essere lette vengono conteggiate con un motivo, ad esempio bloccate dal sito (403), non trovate (404), troppe richieste (429), un errore del server, troppo grandi o nessun testo leggibile (spesso una pagina costruita con JavaScript). Chiedi al tuo host di lasciar passare il crawler o punta la sorgente a pagine che non richiedono JavaScript.
- Le pagine molto lunghe vengono accorciate a circa 24.000 caratteri. Quando la corrispondenza semantica è attiva, la fonte mostra quante pagine sono state accorciate. Suddividi le pagine lunghe se la parte che ti serve è vicina alla fine.
Outline e corrispondenza basata sul significato
- La sincronizzazione Outline si ferma a 1.000 documenti. I documenti oltre tale limite non vengono sincronizzati.
- La corrispondenza basata sul significato (semantica) richiede un provider di embeddings. Alcuni modelli di embedding non sono ancora calibrati per corrispondenze solo di significato e mostrano un avviso, quindi passa a un modello di embedding diverso se lo vedi.
Ancora bloccato?