Askme AI
Il motore di intelligenza artificiale della suite Askme
Askme AI è la piattaforma multi-tenant che orchestra le funzionalità di intelligenza artificiale della suite Askme. Espone una console di amministrazione per i tenant administrator e una API REST consumabile dai prodotti suite (Chat, Desk, Sign) e da integrazioni dei clienti.
Il prodotto è 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 prodotto chiamante.
Integrazione con la suite Askme
Askme AI alimenta gli altri prodotti della suite. La tabella sottostante riassume le funzionalità AI esposte da ciascun prodotto 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 (web widget, WhatsApp, Messenger, Telegram, ...). L'integrazione con Askme AI alimenta i bot conversazionali.
| 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.
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.
Prossimi Passi
Manuale tenant administrator
Guida operativa al prodotto: 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) apri un ticket interno al team IT di Askme.
Per la gestione operativa del tuo tenant (agenti, KB, utenti, API key) usa la console amministrativa: tutto è a disposizione del ruolo admin.