Askme AI
Il motore di intelligenza artificiale dei moduli Askme
Askme AI è la piattaforma che fornisce le funzionalità di intelligenza artificiale ai moduli Askme. Mette a disposizione una console web, usata dagli amministratori e dagli operatori di ciascuna organizzazione, e una API REST utilizzata dagli altri moduli Askme (Chat, Desk, Sign) e dalle integrazioni dei clienti.
Il modulo copre l'intero ciclo di vita di un'esperienza conversazionale o di un servizio AI: dal caricamento dei contenuti nelle basi di conoscenza alla configurazione degli agenti, fino al controllo della qualità delle risposte, dei consumi e della protezione dei dati.
Cosa si può fare con Askme AI
Costruire agenti conversazionali con RAG
Un agente risponde secondo le proprie Istruzioni, con il modello scelto e consultando le basi di conoscenza collegate. La pagina di un agente riunisce la configurazione, divisa in sezioni, e il pannello Anteprima chat, che permette di provare l'agente senza lasciare la pagina. Le modifiche vengono salvate automaticamente e le versioni precedenti restano consultabili, confrontabili e ripristinabili.
La voce Conoscenza raccoglie le basi di conoscenza, alimentate da quattro tipi di fonte: Documenti (PDF, Word, testo o CSV, anche scansionati), Siti web acquisiti e aggiornati secondo una pianificazione, FAQ e Sorgenti dati collegate a un database. Una base di conoscenza può dichiarare più lingue dei contenuti e la ricerca semantica trova i contenuti anche con domande poste in altre lingue, senza traduzione; può essere condivisa con tutta l'organizzazione o con singoli utenti e consente di escludere singoli contenuti dalle fonti citate.
La ricerca nei contenuti riformula la domanda prima di cercare, combina la ricerca per significato con quella per parole, riordina i risultati per pertinenza quando i frammenti lo consentono e verifica che i contenuti trovati siano pertinenti prima di fornirli all'agente. Le domande a cui i contenuti non rispondono sono gestite dall'agente secondo le proprie istruzioni oppure, con il passaggio a operatore attivo, con messaggi configurabili.
Collegare strumenti esterni
La voce Connettori raccoglie i server MCP che mettono strumenti esterni a disposizione degli agenti, collegati via HTTP, SSE o comando locale. Il dettaglio di un connettore mostra gli strumenti esposti, la configurazione, gli agenti collegati e il Log chiamate con l'esito di ogni chiamata; ciascuno strumento ha un proprio stato, che permette di disattivarlo, e il pulsante Verifica connettori controlla in una sola volta tutti i server. Nella sezione Strumenti e connettori di un agente si scelgono i connettori da usare; quando uno strumento richiede una conferma, la conversazione chiede l'autorizzazione prima di eseguirlo.
Conversare in vocale
Quando la capacità Canale Vocale è attiva per l'organizzazione, le conversazioni con un agente offrono anche la modalità voce: l'utente parla con l'agente, che risponde a voce nella lingua dell'utente e può essere interrotto in qualsiasi momento.
Analizzare, tradurre e anonimizzare documenti
Il gruppo Strumenti comprende Analisi, con la pagina Nuova analisi e i tipi Contenuto, PDF, Curriculum, Dati e OCR, le cui impostazioni si possono salvare come modello riutilizzabile; Classificazione, per la classificazione dei testi; Traduzione; Editor PDF, per modificare, analizzare e compilare moduli PDF; Anonimizzazione, che restituisce un documento pdf, xlsx o docx, anche raccolto in un file zip, con i dati personali sostituiti. Le analisi sono disponibili anche tramite API REST.
Classificare testi
Un classificatore impara da esempi di testo ad assegnare un'etichetta a un testo nuovo, il che lo rende adatto allo smistamento automatico di richieste, ticket e documenti. Nella forma più semplice, il catalogo, il testo riceve l'etichetta degli esempi a cui somiglia di più, anche partendo da esempi senza categorie: in questo caso è la piattaforma a individuare i gruppi ricorrenti e a proporre le etichette. Con più esempi etichettati il classificatore può invece essere addestrato, per distinguere con maggiore precisione etichette simili tra loro.
Misurare la qualità e i consumi
Il gruppo Monitoraggio comprende Panoramica; Conversazioni, con le viste Da rivedere e Con operatore; Valutazioni su dataset di prova; A/B Testing, per confrontare varianti di configurazione di un agente; Avvisi. Quando una regola di avviso scatta, i destinatari indicati nella regola, o in loro assenza gli amministratori dell'organizzazione, ricevono un'email. L'utilizzo rispetto ai limiti dell'organizzazione è riportato in Impostazioni > Consumi > Limiti.
Governare e proteggere i dati
Nel gruppo Impostazioni, l'area Conformità comprende Protezione dati, che sostituisce i dati personali prima che raggiungano il modello e li ripristina nella risposta, con i tipi di dato riconosciuti e le liste di eccezione; Guardrail, cioè le regole dell'organizzazione che controllano i messaggi in ingresso e le risposte in uscita degli agenti; Registro attività, che riporta chi ha fatto cosa nella console.
Architettura ad alto livello
Askme AI serve più clienti, ciascuno nella propria organizzazione: un ambiente isolato a livello di dati, con utenti, limiti e capacità propri. L'amministratore dell'organizzazione gestisce, oltre ad agenti e contenuti, utenti e ruoli, chiavi API, modelli e impostazioni di conformità; l'operatore lavora su agenti, basi di conoscenza, conversazioni e strumenti, ma non vede il gruppo Impostazioni né le pagine Panoramica e Avvisi del monitoraggio. Il ruolo chat_user dà accesso alla sola chat con gli agenti, senza la console. Il dettaglio delle voci visibili a ciascun ruolo è in Navigare la console.
L'integrazione dei sistemi esterni avviene esclusivamente tramite API REST autenticate con chiave API (header X-Api-Key); l'header X-Source-App, consigliato, attribuisce ogni chiamata al modulo che la effettua; in sua assenza la piattaforma lo ricava dal tipo di autenticazione.
Integrazione con i moduli Askme
Askme AI alimenta gli altri moduli Askme. Le tabelle seguenti riassumono le funzionalità AI usate da ciascun modulo e indicano quali aspetti sono configurabili dall'amministratore dell'organizzazione e quali richiedono il supporto del team IT di Askme.
Askme Chat
Askme Chat è la piattaforma di messaggistica multi-canale, dal widget web ai canali di messaggistica. L'integrazione con Askme AI alimenta i bot conversazionali. Il funzionamento congiunto dei due moduli, con l'ordine di priorità tra workflow del chatbot, agente AI e operatore, è descritto in Askme AI e i moduli Askme.
| Funzionalità AI | Configurabile dall'amministratore | Supporto team IT |
|---|---|---|
| Agenti conversazionali RAG associati ai canali Chat | ✓ — agenti, basi di conoscenza, istruzioni | — |
| Riconoscimento delle richieste in arrivo dai canali | ✓ — condizioni della sezione Passaggio a operatore dell'agente; Classificazione | — |
| Passaggio automatico a un operatore | ✓ — sezione Passaggio a operatore dell'agente | — |
| Canale vocale sul widget web | Parziale — permesso del ruolo; la capacità Canale Vocale deve essere attiva per l'organizzazione | — |
| Webhook in uscita verso il bot Chat | ✓ — Impostazioni > API > Webhook | — |
| Collegamento tecnico fra le istanze Chat e l'organizzazione Askme AI | — | ✓ — configurazione iniziale dei canali |
Le chiamate provenienti da Askme Chat sono identificate dall'header X-Source-App: askmechat ed entrano nelle metriche di monitoraggio dedicate.
Askme Desk
Askme Desk è la piattaforma di helpdesk e ticketing. Askme AI fornisce suggerimenti per gli operatori, generazione di workflow e classificazione delle richieste.
| Funzionalità AI | Configurabile dall'amministratore | Supporto team IT |
|---|---|---|
Suggerimenti di prossima azione su un ticket (POST /api/v2/desk/suggestions) | Parziale — l'API si usa direttamente; i prompt sono centralizzati | ✓ — prompt dei suggerimenti, modello dedicato |
Generazione di workflow Desk a partire da un catalogo (POST /api/v2/desk/workflow/generate) | Parziale — il flusso si avvia da Askme Desk | ✓ — prompt del workflow, modelli dedicati, soglie di pre-filtro |
| Classificazione automatica dei ticket in arrivo | ✓ — classificatore dedicato in Classificazione | — |
| Estrazione di dati strutturati dal corpo dei ticket | ✓ — Analisi di PDF o contenuto tramite API | — |
| Collegamento fra Askme Desk e Askme AI | — | ✓ — configurazione iniziale, corrispondenza dei campi |
Le chiamate provenienti da Askme Desk sono identificate da X-Source-App: askmedesk.
La modifica dei prompt e dei modelli usati dai suggerimenti e dalla generazione di workflow richiede l'intervento del team IT di Askme, che la applica ai diversi ambienti. Per richiederla è sufficiente aprire una richiesta indicando il parametro da rivedere.
Vedi anche la sezione Askme Desk nella pagina di integrazione.
Askme Sign
Askme Sign è la piattaforma di firma digitale e gestione documentale. Askme AI offre estrazione strutturata e classificazione dei documenti.
| Funzionalità AI | Configurabile dall'amministratore | Supporto team IT |
|---|---|---|
| Estrazione di attributi da documenti firmati | Parziale — l'API si usa direttamente; i template di estrazione sono centralizzati | ✓ — definizione dei template, prompt, schema di output |
| OCR di documenti scansionati e PDF immagine | ✓ — POST /api/v2/analysis/ocr | — |
| Classificazione del tipo di documento (contratto, fattura, ...) | ✓ — classificatore dedicato in Classificazione | — |
| Analisi di policy o clausole su PDF firmato | ✓ — POST /api/v2/analysis/pdf | — |
| Collegamento fra Askme Sign e Askme AI | — | ✓ — configurazione iniziale, corrispondenza dei campi |
Le chiamate provenienti da Askme Sign sono identificate da X-Source-App: askmesign.
I template di estrazione degli attributi e gli schemi JSON con cui viene validato l'output del modello sono gestiti centralmente dal team IT di Askme. Per aggiungere o modificare un template è sufficiente aprire una richiesta indicando il tipo di documento, gli attributi richiesti e alcuni esempi rappresentativi.
Vedi anche la sezione Askme Sign nella pagina di integrazione.
Prossimi Passi
Quickstart
Il primo agente in 10 minuti: base di conoscenza, agente, anteprima chat, chiave API.
Manuale della console
Guida operativa: Chat, Agenti, Conoscenza, Connettori, Strumenti, Monitoraggio, Impostazioni.
API Reference
Endpoint REST con attributi, esempi di richiesta e risposta. Autenticazione con chiave API.
Supporto
Per assistenza è possibile scrivere a [email protected] oppure consultare il portale support.askme.it.
Per bug e richieste di configurazione applicativa (prompt centralizzati, template di estrazione, configurazione dei canali) è necessario aprire una richiesta al team IT di Askme. Per la gestione operativa della propria organizzazione (agenti, basi di conoscenza, utenti, chiavi API) è disponibile la console: le pagine del gruppo Impostazioni sono visibili agli amministratori e non agli operatori.