Risoluzione dei problemi
Questa pagina raccoglie i problemi trasversali della console di Askme AI, che possono avere più di una causa in aree diverse del modulo (ad esempio un agente che non risponde per un limite raggiunto piuttosto che per un errore di configurazione). Per un problema specifico di una singola funzionalità, la tabella "Problemi comuni" in coda a ciascuna pagina del manuale resta il riferimento più preciso: questa pagina indica solo la sequenza di verifica e rimanda alla pagina di dettaglio pertinente.
Come usare questa pagina
Per ogni sintomo sono indicate le cause più frequenti in ordine di probabilità e la pagina in cui verificare ed eventualmente correggere la configurazione. Se il sintomo persiste dopo aver seguito tutti i rimandi, vedere Quando contattare il supporto.
Accesso e organizzazione
| Sintomo | Verifiche | Pagina di dettaglio |
|---|---|---|
| Dopo l'accesso compare la pagina Utenza non abilitata su Askme AI | L'utenza non è abilitata su Askme AI: occorre rivolgersi all'amministratore dell'organizzazione | Navigare la console, Utenti e ruoli |
| Dopo l'accesso compare la pagina Servizio momentaneamente non disponibile | Il profilo non è stato caricato: usare Riprova dopo qualche istante | Navigare la console |
| Un utente vede solo la chat, senza il menu della console | All'utente è assegnato il solo ruolo chat_user | Chat senza console, Utenti e ruoli |
| Un utente non vede alcune voci di menu o non riesce a compiere un'azione | Permessi del ruolo assegnato; gruppo Impostazioni nascosto agli operatori; capacità non attiva per l'organizzazione in Impostazioni > Organizzazione > Capacità | Navigare la console, Utenti e ruoli |
| Le email degli avvisi non arrivano | Destinatari indicati nella regola o, in loro assenza, amministratori con Ricevi notifiche via email attivo nel Profilo; l'email parte quando la regola scatta, non mentre l'avviso resta aperto, e rispetta l'intervallo minimo tra le email della regola | Avvisi |
Agenti e conversazioni
| Sintomo | Verifiche | Pagina di dettaglio |
|---|---|---|
| L'agente non passa allo stato Attivo | Sezione Istruzioni vuota: il cambio di stato viene rifiutato finché non è compilata | Creare e configurare un agente, Istruzioni |
| Il pannello Anteprima chat resta bloccato | Salvataggio ancora in corso ("Salva le modifiche per provare l'agente aggiornato") oppure non riuscito (Non salvato nell'intestazione) | Anteprima chat |
| L'agente non cita mai fonti nelle risposte | Nessuna base di conoscenza selezionata nella sezione Conoscenza, documenti non ancora Indicizzato, oppure contenuti giudicati non pertinenti dal controllo di pertinenza, ad esempio per domande in una lingua non dichiarata dalla base | Conoscenza dell'agente, Parametri avanzati del RAG |
| L'agente risponde "non ho informazioni sufficienti" a domande a cui la base di conoscenza risponde | Il messaggio Nessuna informazione utile compare solo quando il controllo di ambito giudica la domanda fuori ambito, cioè con Abilita handoff a operatore attivo, la condizione Domanda fuori ambito abilitata e il controllo attivo per l'organizzazione. Verificare che le istruzioni descrivano chiaramente l'ambito dell'agente oppure disattivare la condizione; negli altri casi la risposta è generata dall'agente, e vanno verificate le istruzioni e le fonti trovate nell'anteprima | Passaggio a operatore, Anteprima chat |
| Il passaggio a un operatore non scatta mai, oppure scatta troppo spesso | Interruttore generale e condizioni della sezione Passaggio a operatore, con le relative soglie e tempistiche | Passaggio a operatore |
| L'agente non risponde nel formato previsto | Output strutturato non attivo nella sezione Avanzate, schema JSON non valido, oppure connettori attivi collegati all'agente: in presenza di strumenti lo schema non viene applicato | Output strutturato |
Nella risposta compare un segnaposto {{variabile}} come testo letterale | La variabile del prompt non ha ricevuto un valore: il messaggio viene inviato comunque e il segnaposto resta invariato. Compilare la variabile nel riquadro Variabili e credenziali di prova o Informazioni per l'assistente prima di scrivere | Conversare con un agente, Variabili del prompt |
| Una risposta viene bloccata o sostituita da un messaggio di rifiuto | Regole attive nella sezione Guardrail dell'agente, comprese quelle Obbligatoria stabilite dall'organizzazione; controllo con Test rapido sulla pagina della regola | Guardrail, Creare e configurare un agente |
| Un controllo di guardrail non ha alcun effetto | Controllo non disponibile per l'organizzazione (la pagina della regola lo segnala accanto al controllo); Lingua ammessa senza alcuna lingua o Lunghezza della risposta senza alcuna lunghezza; azione Operatore su un agente con il passaggio a operatore disattivato | Guardrail, Passaggio a operatore |
| L'agente non usa mai uno strumento esterno | Connettore non selezionato nella sezione Strumenti e connettori, strumento disattivato nella scheda Strumenti del connettore, connettore in errore (verificare Test connessione o Verifica connettori e la scheda Log chiamate) | Connettori e server MCP |
Conoscenza e siti web
| Sintomo | Verifiche | Pagina di dettaglio |
|---|---|---|
| Alcune pagine attese non vengono mai acquisite da un sito web | Presenza in sitemap o raggiungibilità da un link interno del sito, percorsi esclusi | Siti web |
| Il testo acquisito da una pagina è incompleto o vuoto | Il sito carica i contenuti con JavaScript: attivare Lettura avanzata (browser) | Siti web |
| Il testo estratto da un documento scansionato è incompleto o impreciso | Qualità della scansione (risoluzione, inclinazione) e Modello per immagini e scansioni (OCR) della base di conoscenza | Caricare documenti |
| Un aggiornamento pianificato non è mai partito o mancano contenuti dopo un aggiornamento | Pianificazione del sito, raggiungibilità delle pagine, percorsi esclusi | Aggiornamento dei siti |
| Un contenuto riservato compare comunque tra le fonti citate | Il contenuto non è stato escluso con Nascondi dalle citazioni | Visibilità dei documenti nelle citazioni |
| L'eliminazione di una base di conoscenza chiede che cosa fare degli agenti | La base è usata da uno o più agenti: scegliere Scollega la conoscenza, gli agenti restano attivi oppure Metti in pausa gli agenti collegati | Le basi di conoscenza |
Strumenti e analisi
| Sintomo | Verifiche | Pagina di dettaglio |
|---|---|---|
| Un'analisi resta a lungo in elaborazione o termina in errore | Coda satura, modello temporaneamente non raggiungibile, formato del file non supportato, limite dell'organizzazione raggiunto | Analisi, Limiti del piano |
| Un classificatore resta a lungo In costruzione o risulta Fallito | Coda di costruzione satura, dati di partenza non validi | Classificazione |
| Il punteggio di un'analisi dei curriculum è sistematicamente basso | Descrizione del ruolo di riferimento troppo generica, competenze solo citate e non dimostrate nel curriculum, competenze usate l'ultima volta molti anni fa oppure per meno anni di quelli richiesti | Analisi dei curriculum |
| Un dato personale non viene sostituito, o viene sostituito per errore | Tipi di dato riconosciuti, Lista bianca e Lista nera in Impostazioni > Conformità > Protezione dati | Protezione dati |
Limiti e chiavi API
| Sintomo | Verifiche | Pagina di dettaglio |
|---|---|---|
| Un'operazione viene rifiutata per un limite raggiunto | Utilizzo del limite in Impostazioni > Consumi > Limiti; avviso Limiti del piano vicini alla soglia nella barra superiore | Limiti del piano |
| Una chiave API restituisce un errore di autorizzazione o viene rifiutata | Funzioni della chiave, scadenza o eliminazione della chiave in Impostazioni > API > Chiavi API; capacità Accesso API attiva per l'organizzazione | Chiavi API |
| Un modello non compare fra quelli selezionabili per l'agente | Modello non disponibile nel catalogo dell'organizzazione in Impostazioni > Organizzazione > Modelli e provider | Modelli e provider |
Quando contattare il supporto
Se dopo aver seguito le verifiche indicate il problema persiste, oppure riguarda un comportamento non descritto in questa pagina o nelle pagine di dettaglio, contattare il team Askme all'indirizzo [email protected], indicando l'organizzazione interessata, l'agente o la funzionalità coinvolta e i passaggi già effettuati. Per la gestione operativa quotidiana dell'organizzazione (agenti, basi di conoscenza, utenti, chiavi API) la console resta il canale più rapido rispetto all'apertura di una richiesta.