Configurazione del tenant

Questa pagina raccoglie le impostazioni che l'amministratore tenant puo' gestire. Per modifiche centralizzate (modello operazionale, retention default, impostazioni di sistema) contatta il team IT di Askme.

Lingue dell'interfaccia

Askme AI e' multilingua: l'interfaccia e' disponibile in italiano (default), inglese e spagnolo.

Cambiare la lingua

• A livello utente: icona profilo in alto a destra → Lingua (modifica immediata, persistente)
• A livello dei contenuti: la lingua di una knowledge base si imposta nel form di creazione (vedi Lingue della KB)

Risposte multilingua dell'agente

Per far rispondere un agente nella stessa lingua del messaggio dell'utente:

1. Inserisci {{detected_language}} nel system prompt dell'agente
2. La lingua viene rilevata automaticamente in chat e propagata
3. La pipeline RAG traduce internamente le query verso la lingua canonica della KB se necessario

Feature flag del tenant

I feature flag controllano la disponibilita' delle funzionalita' del tenant. Vengono ereditati dal piano sottoscritto e possono essere ulteriormente abilitati/disabilitati a livello tenant da chi ha il permesso admin.feature_flags.manage.

Flag piu' rilevanti

Flag	Funzionalita' attivata
chat	Sezione Chat con gli agenti
knowledge	Knowledge base
mcp_servers	Gestione e utilizzo MCP server
rag_advanced	RAG avanzato (multi-query rewrite, reranking)
voice_channel	Canale vocale (microfono e TTS)
handoff_detection	Rilevamento automatico criteri handoff
scraping_advanced	Rendering Playwright per scraping JS-heavy
webhooks	Webhook in uscita su eventi della piattaforma
evaluations	Valutazioni e dataset di test
ab_testing	Esperimenti A/B su configurazioni agente
workflow_editor	Editor visuale di workflow
similarity	Catalogo similarity / classificatori top-N
api_access	Accesso API esterno tramite chiavi

Disabilitare un flag

Disabilitare un flag nasconde le voci sidebar corrispondenti per tutti gli utenti del tenant e blocca le relative API. Le configurazioni precedentemente create non vengono cancellate, ma diventano inaccessibili finche' il flag non viene riabilitato.

Integrazioni

Source app attribution

Tutte le chiamate verso Askme AI devono essere etichettate con un'app sorgente tramite header X-Source-App. Lista chiusa di valori ammessi:

Valore	Quando si usa
askmechat	Chiamate provenienti da Askme Chat
askmedesk	Workflow generati da Askme Desk
api_direct	Integrazioni custom che chiamano direttamente le API REST (es. CRM, ERP, applicazioni cliente)
askmeai	Riservato alla console Askme AI
internal	Riservato alle chiamate inter-servizio della piattaforma

Valori al di fuori della lista vengono rifiutati. L'attribuzione e' visibile nelle dashboard di Monitoraggio: tab Attivita' (per riga) e tab Costi (aggregato).

Askme Desk

Quando il tenant e' integrato con Askme Desk, i workflow di Desk possono invocare gli agenti Askme AI tramite chiave API dedicata. Configura una chiave con X-Source-App: askmedesk per separare il traffico nelle metriche.

Webhook in uscita

Configura webhook per ricevere notifiche su eventi della piattaforma (upload documento, scraping completato/fallito, ecc.):

1. Sezione Amministrazione → Webhook
2. Nuovo webhook: nome, URL endpoint, secret HMAC-SHA256 (Genera secret), eventi sottoscritti
3. Invia test per verificare la raggiungibilita'
4. Ogni richiesta include header X-Askme-Signature con la firma HMAC-SHA256 per autenticazione

Il destinatario deve ricalcolare l'HMAC-SHA256 del body con il secret condiviso e confrontarlo con la firma in header.

Voice provider

Il canale vocale utilizza un provider STT (speech-to-text) e un provider TTS (text-to-speech). La scelta dei provider avviene a livello di sistema, ma il tenant puo' configurare:

• Voci TTS per lingua — mapping lingua → voce per dare un'identita' sonora coerente all'agente in italiano, inglese, spagnolo
• Lingua di default quando il rilevamento automatico non riesce

Le impostazioni si trovano sotto Amministrazione → Impostazioni voce (visibili se il flag voice_channel e' attivo).

Data retention del tenant

Configura la durata di conservazione dei dati del tuo tenant nella sezione Amministrazione → Data retention:

• Conservazione conversazioni (giorni) — default 365
• Conservazione messaggi (giorni) — default 365
• Conservazione analisi (giorni) — default 180
• Toggle per abilitare/disabilitare la retention automatica

Un job schedulato giornaliero elimina i dati piu' vecchi delle policy configurate.

Operazione irreversibile

La cancellazione dei dati per retention e' definitiva. Se hai bisogno di conservare dati storici per compliance, esporta periodicamente le conversazioni e le metriche in CSV (sezione Monitoraggio).

Audit log

Tutte le operazioni amministrative del tenant sono tracciate nel log di audit:

• Sezione Amministrazione → Audit log
• Filtra per azione (creazione, modifica, eliminazione, login, logout), risorsa, periodo
• Per ciascuna riga: data, utente, azione, risorsa, dettagli, IP
• Esporta CSV per archiviazione esterna

Impostazioni tenant (sola lettura)

La pagina Amministrazione → Impostazioni tenant mostra in sola lettura:

• Nome tenant
• Codice tenant
• Piano attualmente sottoscritto
• Quote / limiti del piano
• Feature flag attivi

Per modifiche a questi attributi (cambio piano, ridefinizione quote, abilitazione feature non disponibili sul piano corrente) contatta il team IT di Askme.

Suggerimenti operativi

• Verifica i feature flag prima di aprire un nuovo caso d'uso: la sezione potrebbe semplicemente non essere abilitata sul piano
• Etichetta sempre X-Source-App sulle integrazioni: ti permette di leggere le metriche per app
• Calendarizza la rotazione di webhook secret ogni 90 giorni, come per le chiavi API
• Esporta periodicamente l'audit log se devi conservarlo oltre la retention configurata