AI Knowledge Base - Guida Demo Completa

AI Knowledge Base - Guida Demo Completa

Data: 22 Ottobre 2025 Obiettivo: Demo funzionante end-to-end del sistema AI

---

🎯 Cosa Dimostri

AI Assistant Generico per Comparto Industriale

  • 💡 Indipendente da macchine specifiche
  • 💡 Risponde su TUTTO il comparto (non singole macchine)
  • 💡 Query aggregate (es: "Produzione complessiva di ieri")
  • 💡 Flessibile e scalabile

    • Flusso completo: 1. ✅ Configurazione Provider → OpenAI attivato 2. ✅ Ambito DEMO → Preconfigurato con dati 3. ✅ AI Generator → Genera template automaticamente 4. ✅ Dashboard Costi → Mostra breakdown per ambito DEMO 5. ✅ Template Salvati → Funzionanti e riusabili

    ---

    📋 SETUP DEMO (10 minuti)

    Step 1: Esegui Script SQL Demo

    File: /Users/nscapati/Desktop/ai_demo_setup.sql

    Esegui in phpMyAdmin → Database capera_sartupDB

    Cosa crea:

  • ✅ Ambito "🎯 Demo Produzione"
  • ✅ 1 Template esempio (demo_prod_daily)
  • ✅ 1 Conversazione demo (4 messaggi)
  • ✅ Analytics demo (3 giorni di dati)

    • Verifica: Dashboard KB mostra:

  • Ambiti Configurati: 1 (o più se ne hai creati altri)
  • Totale Template: 1

    • ---

    Step 2: Configura OpenAI (già fatto ✅)

    Provider OpenAI dovrebbe essere già attivo con:

  • API Key configurata
  • Modello: gpt-4o-mini
  • Badge verde "Attivo"

    • ---

    Step 3: Verifica Dashboard Costi

    URL: /admin/ai/settings/cost-tracking

    Dovresti vedere:

    Stats Card:

  • Costo Totale: ~$0.0023 (mock)
  • Query Totali: 30 (mock 3 giorni)
  • Template Coverage: 70%

    • Tabella Breakdown Ambito: `` | Ambito | Query | Con LLM | Coverage | Tokens | Costo | |--------|-------|---------|----------|--------|-------| | 🎯 Demo Produzione | 30 | 9 | 70% | 5.850 | $0.0023 | `

    Grafico Trend: 3 punti (ultimi 3 giorni mock)

    ---

    🤖 DEMO AI GENERATOR

    Step 1: Vai al Generator

    URL: /admin/ai/kb/templates/generate

    Oppure: Menu → AI KB → Template → 🤖 Genera con AI

    ---

    Step 2: Genera Primo Template

    Form Input: ` Query Esempio: [Confronta questa settimana con la scorsa_]

    Ambito: [🎯 Demo Produzione ▼]

    [🤖 Genera con AI] `

    Click "Genera con AI" → Attendi 3-5 secondi...

    ---

    Step 3: Revisiona Template Generato

    Preview mostra (accordion collapsible):

    📝 Informazioni Base: ` Template ID: demo_comp_weeks Richiede LLM: No Cache TTL: 3600 secondi (60 min) Costo generazione: $0.002 `

    🔍 Pattern Matching: ` confronta? (?:questa settimana|settimana corrente) (?:con|vs) (?:la )?(?:scorsa|precedente) `

    🗃️ Query SQL: `sql SELECT WEEK(timestamp) as week_num, SUM(CAST(JSON_UNQUOTE(JSON_EXTRACT(raw_data, '$.TotalPieces')) AS DECIMAL)) as total FROM machine_operations_log WHERE machine_id = :machine_id AND timestamp >= DATE_SUB(NOW(), INTERVAL 2 WEEK) GROUP BY week_num ORDER BY week_num `

    💬 Template Risposta: ` ⚖️ Confronto Settimanale Comparto:

    📊 Settimana corrente: {current_total} pezzi 📊 Settimana scorsa: {previous_total} pezzi 🏭 Macchine attive: {machines_count}

    📈 Variazione: {delta_percent}% `

    💡 Suggerimenti:

  • Analizza le cause della variazione
  • Mostra trend mensile comparto
  • Quale macchina ha contribuito di più?

    • ---

    Step 4: Salva Template

    Click "💾 Salva Template"

    → Redirect a lista template → Vedi 2 template ora (demo_prod_daily + demo_comp_weeks)

    ---

    Step 5: Genera Altri 2-3 Template

    Query Suggerite (generiche per comparto):

    Template 2: ` Query: Quale macchina ha prodotto di più questa settimana? Ambito: 🎯 Demo Produzione ` → Genera → Salva

    Template 3: ` Query: Mostrami il trend complessivo degli ultimi 7 giorni Ambito: 🎯 Demo Produzione ` → Genera → Salva

    Template 4 (opzionale): ` Query: Quante operazioni totali abbiamo fatto oggi? Ambito: 🎯 Demo Produzione ` → Genera → Salva

    Costo totale: 3-4 template × $0.002 = $0.006-0.008

    ---

    💰 VERIFICA COSTI AGGIORNATI

    Dashboard Costi Dopo Generazione

    URL: /admin/ai/settings/cost-tracking

    Breakdown per Tipo Utilizzo: ` 🤖 Generazione KB: $0.006 3 generazioni Media: $0.002/template

    💬 Query Utenti: $0.0023 30 query (mock) Media: $0.000077/query `

    Totale: $0.0083

    Breakdown Ambito DEMO: ` 🎯 Demo Produzione Query: 30 Con LLM: 9 Template Coverage: 70% Tokens: 5.850 + 1.950 (generazione) = 7.800 Costo: $0.0031 `

    ---

    📊 VERIFICA TEMPLATE COVERAGE

    Dashboard KB

    URL: /admin/ai/kb/dashboard

    Dovresti vedere:

  • Totale Template: 4 (1 manuale + 3 generati)
  • Ambiti Configurati: 1 (Demo)
  • Sezione Ambiti: 🎯 Demo Produzione con "4 template"

    • ---

    Lista Template

    URL: /admin/ai/kb/templates

    Filtra per: Ambito = "🎯 Demo Produzione"

    Dovresti vedere 4 template: 1. demo_prod_daily (manuale) 2. demo_comp_weeks (generato AI) 3. demo_op_best (generato AI) 4. demo_trend_7d (generato AI)

    Tutti con:

  • Badge "🎯 Demo Produzione"
  • LLM: No (verde)
  • Utilizzi: 0 (normale, non ancora usati)

    • ---

    🎓 COSA MOSTRARE AL COMMITTENTE

    Parte 1: Configurazione Dinamica (5 min)

    Mostra: 1. Dashboard Provider → 3 provider, switch dinamico 2. Budget & Limiti → Real-time tracking 3. Dashboard Costi → Breakdown dettagliato

    Messaggio: "Sistema completamente configurabile via UI, no codice"

    ---

    Parte 2: AI Generator (5 min)

    Mostra: 1. Form "Genera con AI" 2. Inserisci query esempio 3. Click genera → Attendi 3s 4. Preview template completo 5. Salva

    Messaggio: "Da query a template completo in 10 secondi, costo $0.002"

    ---

    Parte 3: Knowledge Base (5 min)

    Mostra: 1. Lista ambiti con conteggi 2. Dettaglio ambito DEMO con 4 template 3. Dettaglio singolo template (pattern + SQL + response)

    Messaggio: "Knowledge Base organizzata, template riusabili, zero allucinazioni"

    ---

    Parte 4: Cost Monitoring (5 min)

    Mostra: 1. Dashboard costi con breakdown ambito DEMO 2. Proiezione mensile (~$0.02-0.05) 3. Insights automatici 4. Export report

    Messaggio: "Costi trasparenti e prevedibili, ROI positivo dal giorno 1"

    ---

    💡 PUNTI CHIAVE DEMO

    1. AI Assistant Generico (NON per Macchine Specifiche)

    Vantaggi Paradigma Generico:

  • ✅ Scalabilità: Aggiungi macchine senza modificare template
  • ✅ Flessibilità: "Produzione complessiva" → risposta aggregata automatica
  • ✅ Semplicità: Query umane naturali ("Quanto abbiamo prodotto?")
  • ✅ Vista d'insieme: Focus su reparto/comparto, non singola macchina
  • ✅ Zero coupling: Indipendente da configurazioni macchine

    • Quando Serve Machine-Specific:

  • ❌ "Come sta lavorando la Horizon 56?" → Serve filtro macchina
  • ✅ "Quale macchina ha prodotto di più?" → Query generica con GROUP BY

    • Soluzione: Template può opzionalmente filtrare per macchina SE menzionata nella query.

    ---

    2. Sistema AI-First

  • ✅ AI per configurare (Generator)
  • ✅ AI per interrogare (Assistant)
  • ✅ Template come ottimizzazione (non requisito)

    • 3. Interfacciamento Dinamico

  • ✅ Multi-provider (switch in 1 click)
  • ✅ Budget configurabile (3 livelli)
  • ✅ Alert automatici

    • 4. Costi Trasparenti

  • ✅ Tracking real-time per ambito
  • ✅ Breakdown dettagliato
  • ✅ ROI misurabile

    • 5. Zero Hardcode

  • ✅ Tutto configurabile via UI
  • ✅ Pattern dinamici
  • ✅ SQL generato AI
  • ✅ Response template AI

    • ---

    📊 METRICHE DEMO

    Setup Demo:

  • Ambiti: 1 (Demo)
  • Template: 4 (1 manuale + 3 AI)
  • Conversazioni: 1 (mock)
  • Messaggi: 4 (2 user + 2 assistant)

    • Costi Demo:

  • Generazione KB: $0.006 (3 template)
  • Query utenti: $0.0023 (mock)
  • Totale: $0.0083

    • Metriche:

  • Template coverage: 70%
  • Cache hit rate: 0% (normale, nessuna query ripetuta)
  • Query con LLM: 30% (9/30)

    • ---

    🔮 DOPO LA DEMO

    Se committente approva:

    Settimana 1:

  • Crea 3-4 ambiti prioritari reali
  • Genera 20-30 template con AI ($0.04-0.06)
  • Configura budget produzione

    • Settimana 2:

  • Implementa AI Assistant Chat Widget
  • Integra nelle macchine i40
  • User testing (3-5 operatori)

    • Settimana 3:

  • Raccolta feedback
  • Ottimizzazione template
  • Analisi costi reali
  • Production release

    • ---

    ✅ CHECKLIST PREPARAZIONE DEMO

    Prima della Demo

  • [ ] Script SQL demo eseguito
  • [ ] OpenAI configurato e attivo
  • [ ] Budget configurato ($10/mese test)
  • [ ] Ambito DEMO visibile
  • [ ] 1 Template manuale presente
  • [ ] Generati 3 template con AI
  • [ ] Dashboard costi mostra dati mock
  • [ ] Tutte le schermate accessibili

    • Durante la Demo

  • [ ] Mostra provider switch
  • [ ] Mostra budget real-time
  • [ ] Genera 1 template live
  • [ ] Mostra cost tracking
  • [ ] Spiega ROI

    • Domande Committente

  • [ ] Quali ambiti prioritari?
  • [ ] Quante query al giorno?
  • [ ] Budget approvato?
  • [ ] Timeline ok?

    • ---

    🚀 PRONTO PER LA DEMO!

    Hai tutto:

  • ✅ Sistema funzionante
  • ✅ Dati demo precaricati
  • ✅ AI Generator operativo
  • ✅ Cost tracking con dati
  • ✅ Provider configurato

Esegui: ai_demo_setup.sql` Testa: Genera 2-3 template con AI Verifica: Dashboard costi aggiornata

Sistema pronto! 💪

---

Prossimo: Dopo la demo, implemento AI Assistant Chat Widget per interrogare! 🚀

Analisi Codice

Blocco 1 
| Ambito | Query | Con LLM | Coverage | Tokens | Costo |
|--------|-------|---------|----------|--------|-------|
| 🎯 Demo Produzione | 30 | 9 | 70% | 5.850 | $0.0023 |
Blocco 2 
Query Esempio: 
[Confronta questa settimana con la scorsa_]

Ambito:
[🎯 Demo Produzione ▼]

[🤖 Genera con AI]
Blocco 3 
Template ID: demo_comp_weeks
Richiede LLM: No
Cache TTL: 3600 secondi (60 min)
Costo generazione: $0.002
Blocco 4 
confronta? (?:questa settimana|settimana corrente) (?:con|vs) (?:la )?(?:scorsa|precedente)
Blocco 5 sql 
SELECT 
  WEEK(timestamp) as week_num,
  SUM(CAST(JSON_UNQUOTE(JSON_EXTRACT(raw_data, '$.TotalPieces')) AS DECIMAL)) as total
FROM machine_operations_log
WHERE machine_id = :machine_id
  AND timestamp >= DATE_SUB(NOW(), INTERVAL 2 WEEK)
GROUP BY week_num
ORDER BY week_num
Blocco 6 
⚖️ Confronto Settimanale Comparto:

📊 Settimana corrente: {current_total} pezzi
📊 Settimana scorsa: {previous_total} pezzi
🏭 Macchine attive: {machines_count}

📈 Variazione: {delta_percent}%
Blocco 7 
Query: Quale macchina ha prodotto di più questa settimana?
Ambito: 🎯 Demo Produzione
Blocco 8 
Query: Mostrami il trend complessivo degli ultimi 7 giorni
Ambito: 🎯 Demo Produzione
Blocco 9 
Query: Quante operazioni totali abbiamo fatto oggi?
Ambito: 🎯 Demo Produzione
Blocco 10 
🤖 Generazione KB:
$0.006
3 generazioni
Media: $0.002/template

💬 Query Utenti:
$0.0023
30 query (mock)
Media: $0.000077/query
Blocco 11 
🎯 Demo Produzione
Query: 30
Con LLM: 9
Template Coverage: 70%
Tokens: 5.850 + 1.950 (generazione) = 7.800
Costo: $0.0031

Documenti Correlati

AI Assistant Contestualizzato - Architettura v2.0
AI Assistant - Implementazione Completa
AI Cost Tracking System - Monitoraggio Costi Completo
AI Knowledge Base - Punto della Situazione
AI Knowledge Base - Routes Structure