Askme AI
Il motore di intelligenza artificiale dei moduli Askme
Askme AI è la piattaforma multi-tenant che orchestra le funzionalità di intelligenza artificiale dei moduli Askme. Espone una console di amministrazione per i tenant administrator e una API REST consumabile dagli altri moduli Askme (Chat, Desk, Sign) e da integrazioni dei clienti.
Il modulo è progettato per coprire l'intero ciclo di vita di un'esperienza conversazionale o di un servizio AI: dall'ingestione dei contenuti (knowledge base) alla configurazione degli agenti, fino al monitoraggio dei consumi e dei costi.
Cosa puoi fare con Askme AI
Costruire agenti conversazionali con RAG
- Agenti con system prompt versionato, ereditarietà via parent prompt, fallback automatico fra modelli LLM
- Knowledge base multilingua con sorgenti file (PDF, DOCX, TXT), URL, sitemap, RSS/Atom, query a database e FAQ editoriali
- Pipeline RAG con riscrittura della query (semplice o multi-query), reranking, scope-check configurabile
- Visibilità per-sorgente delle citazioni e KB temporanee per scenari one-shot
Estendere le capacità con strumenti esterni
- Server MCP (Model Context Protocol) collegabili agli agenti via trasporti
stdio,SSEoStreamable HTTP(JSON-RPC 2.0) - Approvazione esplicita dei tool prima dell'esecuzione, health check periodici, dettaglio per-tool
Conversare in vocale
- Canale voce bidirezionale (microfono + TTS) integrato negli agenti
- Rilevamento automatico della lingua dell'utente e risposta nella sua lingua
- Barge-in: l'utente può interrompere la voce dell'agente in qualsiasi momento
Eseguire analisi documentali
- Estrazione e sintesi di PDF, scoring di CV, analisi di contenuto testuale, statistica e insight su dati tabellari (CSV/XLSX/JSON), OCR di documenti scansionati
- Form unificato in console e API REST async + sync per ogni tipologia
Classificare testi
- Catalogo Similarity (supervisionato o non supervisionato) per assegnare etichette a nuovi testi rispetto agli esempi del cliente
- Classificazione top-N con verdict (
strong/medium/weak/none) per scenari di triage e routing automatico
Misurare la qualità
- Valutazioni RAGAS con dataset, test case e judge dedicato; AI credits tracciati per run
- Esperimenti A/B su configurazioni di agente in produzione
- Monitoraggio consumi per modello, source app, categoria operazione, con quote e alert via email
Architettura ad alto livello
Askme AI è un servizio multi-tenant: ogni cliente vive in un proprio tenant, isolato a livello dati, con quote e feature flag dedicati. La console amministrativa è gestita dal tenant administrator (ruolo admin); gli operatori (operator) possono usare la chat e gestire alcune risorse senza accesso alle configurazioni globali.
L'integrazione dei sistemi esterni avviene esclusivamente via API REST autenticate con API key (header X-Api-Key); l'header obbligatorio X-Source-App consente l'attribuzione delle chiamate al modulo chiamante.
Integrazione con i moduli Askme
Askme AI alimenta gli altri moduli Askme. La tabella sottostante riassume le funzionalità AI esposte da ciascun modulo e indica quali aspetti sono configurabili dal tenant administrator e quali richiedono il supporto del team IT di Askme.
Askme Chat
Askme Chat è la piattaforma di messaggistica multi-canale (widget web, WhatsApp, Telegram). 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 dal tenant admin | Supporto team IT |
|---|---|---|
| Agenti conversazionali RAG associati ai canali Chat | ✓ — gestione agenti, KB, prompt | — |
| Classificazione automatica di intent in arrivo dai canali | ✓ — classification_intents su agente / catalogo Similarity | — |
| Rilevamento di handoff a operatore (6 criteri) | ✓ — handoff config dell'agente | — |
| Canale vocale sul widget web | ✓ — feature flag voice_channel + permesso chat.voice.use | — |
| Webhook in uscita verso il bot Chat | ✓ — pannello Webhook | — |
| Wiring tecnico fra istanze Chat e tenant Askme AI | — | ✓ — provisioning 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 dal tenant admin | Supporto team IT |
|---|---|---|
Suggerimenti di prossima azione su un ticket (POST /api/v2/desk/suggestions) | Parziale — l'API si consuma direttamente; i prompt sono centralizzati | ✓ — modifica system prompt suggerimenti, modello dedicato |
Generazione one-shot di workflow Desk a partire da un catalogo (POST /api/v2/desk/workflow/generate) | Parziale — il flusso si invoca dal Desk | ✓ — system prompt workflow, modelli small/large, soglie pre-filtro, cost tier |
| Classificazione automatica dei ticket in arrivo | ✓ — catalogo Similarity dedicato | — |
| Estrazione di dati strutturati dal corpo dei ticket | ✓ — analisi PDF / contenuto via API | — |
| Wiring fra tenant Desk e Askme AI | — | ✓ — provisioning, mapping campi |
Le chiamate provenienti da Askme Desk sono identificate da X-Source-App: askmedesk.
La modifica dei prompt e dei modelli usati dal flusso desk_workflow_* o desk_suggestions_* richiede l'intervento del team IT di Askme: i parametri sono persistiti in system_settings e propagati ai vari ambienti. Apri un ticket interno di richiesta indicando lo specifico 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 dal tenant admin | Supporto team IT |
|---|---|---|
| Estrazione attributi da documenti firmati (extract-attributes) | Parziale — l'API si consuma; i template di estrazione sono centralizzati | ✓ — definizione template, prompt, schema di output |
| OCR di documenti scansionati e PDF immagine | ✓ — POST /api/v2/analysis/ocr | — |
| Classificazione tipo documento (contratto, fattura, ...) | ✓ — catalogo Similarity dedicato | — |
| Analisi di policy o clausole su PDF firmato | ✓ — POST /api/v2/analysis/pdf | — |
| Wiring fra tenant Sign e Askme AI | — | ✓ — provisioning, mapping campi |
Le chiamate provenienti da Askme Sign sono identificate da X-Source-App: askmesign.
I template di estrazione attributi e gli schemi JSON usati per ratificare l'output del modello sono gestiti centralmente dal team IT di Askme. Per aggiungere o modificare un template, apri un ticket interno indicando il tipo di documento, gli attributi richiesti e una manciata di esempi rappresentativi.
Vedi anche la sezione Askme Sign nella pagina di integrazione.
Prossimi Passi
Quickstart
Il primo agente in 10 minuti: knowledge base, agente, prova in chat.
Manuale tenant administrator
Guida operativa al modulo: agenti, KB, chat, MCP, servizi AI, monitoraggio.
API Reference
Endpoint REST con attributi, esempi di richiesta e risposta. Autenticazione via API key.
Supporto
- 📧 Email: [email protected]
- 📚 Knowledge Base: support.askme.it
Per bug e richieste di configurazione applicativa (prompt centralizzati, template di estrazione, provisioning canali) è necessario aprire un ticket interno al team IT di Askme.
Per la gestione operativa del proprio tenant (agenti, KB, utenti, API key) è disponibile la console amministrativa: tutte le funzioni sono accessibili al ruolo admin.