Passa al contenuto principale

Risoluzione dei problemi

Questa pagina raccoglie i problemi trasversali lato console di Askme AI, che possono avere più di una causa possibile in aree diverse del modulo (ad esempio un agente che non risponde per un problema di quota piuttosto che 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.

Agenti e conversazioni

SintomoVerifichePagina di dettaglio
L'agente non passa allo stato AttivoSystem prompt vuoto: la transizione viene rifiutata finché il campo non è compilatoCreare un agente, System prompt e istruzioni
L'agente non cita mai fonti nelle risposteRAG disattivato sull'agente, nessuna Knowledge Base collegata, oppure soglia di score troppo altaCollegare le Knowledge Base (RAG), Parametri avanzati del RAG
L'handoff verso un operatore non scatta mai, oppure scatta troppo spessoToggle generale e condizioni singole di escalation, soglie di confidenza e ripetizioniEscalation verso un operatore (handoff)
L'agente ignora lo schema di output o risponde in linguaggio naturaleServer MCP collegati all'agente (mutuamente esclusivi con l'output strutturato)Output strutturato
Un messaggio non può essere inviato in chatVariabile template obbligatoria non compilata prima dell'avvio della conversazioneLa console Chat, Variabili template nelle conversazioni
L'agente non propone mai l'approvazione di uno strumentoNessun server MCP collegato, oppure approvazione umana disattivata sullo strumentoServer MCP

Knowledge Base e scraping

SintomoVerifichePagina di dettaglio
Alcune pagine attese non vengono mai acquisite dallo scrapingPresenza in sitemap o raggiungibilità da un link interno del sito, regole di esclusioneSorgenti web: scraping e discovery
Il testo acquisito da una pagina è incompleto o vuotoIl sito richiede JavaScript per mostrare il contenuto: attivare il Rendering avanzatoSorgenti web: scraping e discovery
Il testo estratto da un documento scansionato è incompleto o imprecisoQualità della scansione (risoluzione, inclinazione)Caricare documenti (con OCR)
Un'acquisizione pianificata non è mai partita o mancano contenuti dopo un aggiornamentoConfigurazione della pianificazione, raggiungibilità delle pagine, regole di esclusioneRe-scraping e pianificazione
Un contenuto riservato compare comunque tra le fonti citateToggle di visibilità non disattivato su quella sorgenteVisibilità dei documenti nelle citazioni

Servizi e analisi

SintomoVerifichePagina di dettaglio
Un job di analisi resta a lungo in elaborazione o termina in erroreCoda satura, provider AI temporaneamente non raggiungibile, formato file non supportato, quota esauritaAnalisi documentale, Quote e crediti AI
Un catalogo di similarità resta a lungo in building o risulta failedCoda di costruzione satura, sorgente non validaClassificazione e similarità
Il punteggio di un'analisi CV è sistematicamente bassoDescrizione della posizione lavorativa troppo generica, oppure competenze solo citate e non dimostrate (criterio "dimostrato vs. citato")Analisi CV
Un dato personale non viene oscurato, o viene oscurato per erroreListe di eccezione della policy PII ("Oscura sempre"/"Ignora sempre")PII Shield

Quote e accessi

SintomoVerifichePagina di dettaglio
Un'operazione viene rifiutata per quota esauritaStato della quota corrispondente e sue soglieQuote e crediti AI
Una chiave API restituisce errore di autorizzazione o viene rifiutata a sorpresaScope/ruolo della chiave, scadenza o revocaChiavi API
Un modello desiderato non compare nel catalogo dell'agenteFascia di costo non inclusa nel piano del tenantModelli LLM e provider
Un utente non vede alcune voci di menu o non riesce a compiere un'azionePermessi del ruolo assegnatoUtenti e ruoli

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 il tenant interessato, l'agente o la funzionalità coinvolta e i passaggi già effettuati. Per la gestione operativa quotidiana del tenant (agenti, Knowledge Base, utenti, chiavi API), la console amministrativa resta il canale più rapido rispetto all'apertura di un ticket.

Pagine correlate