Servizi AI disponibili

Askme AI espone un insieme di servizi specialistici accessibili dalla console o via API REST. Questa pagina ne offre la panoramica; le pagine successive trattano in dettaglio ciascun servizio.

Mappa dei servizi

Servizio	Cosa fa	Pagina dedicata
Analisi documenti	PDF, CV, contenuto testuale, dati tabellari (CSV/XLSX/JSON), OCR	Analisi
Classificazione & Similarity	Tassonomie su testi, catalogo similarity con wizard supervisionato/non supervisionato, top-N candidati	Classificazione
Valutazioni (Evaluations)	Dataset, test case, run RAGAS, AI credits tracking	Valutazioni

Per le funzionalità conversazionali (chat, agenti, RAG, KB, MCP) vedi la sezione Conversazioni & RAG.

Modello di esecuzione

Tutti i servizi di analisi seguono lo stesso pattern asincrono:

1. La richiesta crea un job (HTTP 202 Accepted + id del job)
2. Lo stato passa per pending → processing → completed | failed
3. Si interroga GET /api/v2/analysis/{id}/status per il polling
4. A completed si legge GET /api/v2/analysis/{id} per il risultato (result.response contiene la risposta dell'LLM o l'output dell'analisi)

Endpoint sincroni (/content/sync, /pdf/sync, /cv/sync) sono disponibili per casi d'uso interattivi: bloccano la richiesta fino al completamento.

Idempotenza e quote

Ogni job consuma quota dal piano del tenant (token LLM, AI credits). Le quote sono consultabili nella tab Monitoraggio → Quote (Monitoraggio).

Errori comuni

Stato job	Significato	Cosa fare
failed con No analyzer registered	Tipo di analisi non disponibile sull'istanza	Verifica con il team IT che il servizio sia abilitato
failed con quota_exceeded	Quota piano superata	Attendi il rinnovo del periodo o richiedi upgrade
Stuck in processing > 5 min	Job potrebbe essere rimasto agganciato	Lo watchdog lo marca failed automaticamente; rilancia

Provider e fallback

Le analisi usano modelli LLM globali del tenant. Se il modello primario fallisce per errori transitori (rate limit, provider non raggiungibile), la piattaforma può deviare automaticamente verso modelli alternativi configurati centralmente. Per gestire la lista contatta il team IT di Askme.