I Servizi AI
Oltre alla piattaforma conversazionale (agenti, Knowledge Base, Chat), Askme AI mette a disposizione un insieme di servizi specialistici per compiti puntuali su documenti e testi: analisi, valutazione di candidature, modifica di PDF, classificazione, misurazione della qualità degli agenti, libreria di prompt riutilizzabili e protezione dei dati personali. Tutti i servizi sono raggiungibili dalla voce di menu Servizi o tramite API.
La voce Servizi è presente nel menu laterale per tutti i ruoli: quali servizi siano effettivamente utilizzabili dipende poi dai permessi del ruolo e dalle funzionalità incluse nel piano del tenant (vedi Utenti e ruoli e Funzionalità attivabili).
I servizi disponibili
| Servizio | Cosa fa | Pagina |
|---|---|---|
| Analisi documentale | Riassunti, punti chiave, sentiment e statistiche su PDF, testo e dati tabellari | Analisi documentale |
| Analisi CV e candidature | Punteggio di un CV rispetto alle posizioni lavorative configurate | Analisi CV e candidature |
| Editor PDF | Rimozione pagine, aggiunta testo e campi firma, modifica guidata in linguaggio naturale | Editor PDF |
| Classificazione e similarità | Catalogo di esempi per assegnare automaticamente un'etichetta a un testo nuovo | Classificazione e similarità |
| Valutazioni e A/B Testing | Misura la qualità delle risposte di un agente e confronta varianti di configurazione | Valutazioni e A/B Testing |
| Template Prompt | Libreria di prompt riutilizzabili da richiamare nel system prompt degli agenti | Template Prompt |
| PII Shield | Protezione dei dati personali nelle conversazioni e nelle analisi | PII Shield |
Come funzionano le elaborazioni
Le analisi (documentale, CV, editor PDF, classificazione, valutazioni) seguono lo stesso modello di esecuzione asincrono:
- La richiesta crea un job e restituisce subito un identificativo.
- Lo stato passa da
pendingaprocessing, fino acompletedoppurefailed. - Si interroga lo stato del job fino al completamento.
- A
completedè disponibile il risultato dell'elaborazione.
Per i casi d'uso interattivi che richiedono una risposta immediata, alcuni servizi offrono anche una variante sincrona, che attende il completamento prima di rispondere: è indicata per volumi ridotti, perché la richiesta resta in attesa per l'intera durata dell'elaborazione.
Un job avviato e mai interrogato consuma comunque la quota associata: se si integra un servizio via API, è opportuno seguire sempre il ciclo di vita del job fino allo stato finale.
Quote e consumi
Ogni elaborazione consuma quota dal piano del tenant (crediti AI, token dei modelli utilizzati). I consumi per servizio sono consultabili in Monitoraggio → Costi e consumi; i limiti applicati al tenant sono descritti in Amministrazione → Quote e crediti.
Errori comuni
| Sintomo | Causa probabile | Cosa fare |
|---|---|---|
Il job resta a lungo in processing | Coda satura o elaborazione anomala | Un controllo automatico marca il job come failed dopo un tempo massimo; è possibile rilanciarlo |
Il job termina in failed | Errore del provider AI, file non valido o quota esaurita | Consultare il messaggio di errore del job; verificare la quota in Monitoraggio |
| Il servizio non compare tra le opzioni | Funzionalità non abilitata per il tenant | Verificare con il team Askme quali servizi sono attivi sul piano sottoscritto |