Phase 18: Advanced analytics and enhanced documentation

README.md

@@ -18,6 +18,7 @@ Un agente configurabile basato su DeepAgents che supporta più provider LLM.
 - **Web UI responsive**: Interfaccia web per gestione configurazioni ottimizzata per mobile e desktop
 - **Dashboard monitoraggio**: Monitoraggio in tempo reale del sistema con supporto multilingue
 - **Marketplace plugin**: Scopri e installa plugin dal marketplace
+- **Analytics avanzate**: Analisi dettagliate dell'uso e raccomandazioni
 - **Comandi integrati**: Comandi speciali con prefisso "/" per gestione rapida
 - **Monitoraggio**: Sistema di logging e monitoraggio delle performance
 - **Dashboard performance**: Monitoraggio dettagliato delle performance
@@ -225,6 +226,7 @@ Quando interagisci con l'agente, puoi usare comandi speciali preceduti da "/" pe
 /clear              - Pulisce lo schermo
 /plugins            - Elenca i plugin disponibili
 /marketplace        - Apre il marketplace dei plugin
+/analytics          - Mostra il report analytics
 /language           - Cambia la lingua dell'interfaccia
 /performance        - Mostra il report delle performance
 /monitoring         - Apre la dashboard di monitoraggio
@@ -250,15 +252,25 @@ Ollama URL: http://192.168.0.50:11434
 👤 You: Elenca i file nella directory corrente
 🤖 MaxClaw: [Esegue ls e mostra i file]
 
-👤 You: /performance
-📊 Performance Report (Last 24 hours)
-==================================================
+👤 You: /analytics
+📊 Advanced Analytics Report (Last 30 days)
+============================================================
 
-📈 Request Statistics:
-  Total Requests: 150
-  Total Errors: 2
-  Error Rate: 1.33%
-  Avg Response Time: 0.245s
+💬 Conversation Statistics:
+  Total Conversations: 45
+  Total Message Characters: 12,500
+  Total Response Characters: 25,800
+  Average Message Length: 278 chars
+  Average Response Length: 573 chars
+
+🤖 Provider Usage:
+  ollama: 30 (66.7%)
+  openai: 15 (33.3%)
+  Most Used: ollama
+
+💡 Insights and Recommendations:
+  💡 You're heavily using ollama (67% of conversations). Consider diversifying with other providers for different use cases.
+  ✅ Great response times! Average is 0.8s.
 
 👤 You: /exit
 👋 Goodbye!
@@ -324,6 +336,76 @@ curl -X POST http://localhost:8000/configurations \
   }'
 ```
 
+## Analytics Avanzate
+
+MaxClaw Agent include un sistema avanzato di analytics per monitorare l'uso e ottenere raccomandazioni.
+
+### Report Analytics
+
+Il report analytics include:
+
+1. **Statistiche Conversazioni**:
+   - Numero totale di conversazioni
+   - Caratteri totali dei messaggi e risposte
+   - Lunghezza media di messaggi e risposte
+
+2. **Utilizzo Provider**:
+   - Quale provider viene usato di più
+   - Distribuzione percentuale dell'uso
+   - Modello più utilizzato
+
+3. **Metriche di Performance**:
+   - Tempo di risposta medio
+   - Tempo di risposta minimo e massimo
+   - Tempo totale di risposta
+
+4. **Utilizzo Strumenti**:
+   - Quali strumenti vengono usati di più
+   - Numero di utilizzi per strumento
+
+5. **Utilizzo Comandi**:
+   - Quali comandi vengono usati di più
+   - Numero di utilizzi per comando
+
+6. **Pattern di Errori**:
+   - Errori ricorrenti
+   - Pattern di errore più comuni
+
+7. **Statistiche Sessioni**:
+   - Numero totale di sessioni
+   - Durata media delle sessioni
+   - Messaggi medi per sessione
+
+### Raccomandazioni
+
+Il sistema genera automaticamente raccomandazioni basate sui pattern di utilizzo:
+
+- **Diversificazione provider**: Se usi troppo un singolo provider
+- **Ottimizzazione performance**: Se i tempi di risposta sono lenti
+- **Utilizzo strumenti**: Se usi frequentemente certi strumenti
+- **Gestione errori**: Se ci sono errori ricorrenti
+- **Pattern di utilizzo**: Se l'uso è troppo basso o troppo alto
+
+### Visualizzare le Analytics
+
+```bash
+# Usa il comando /analytics
+/analytics
+
+# Oppure esegui lo script direttamente
+python analytics.py
+```
+
+### Configurazione
+
+I dati di analytics vengono salvati in `~/.maxclaw/analytics/` e includono:
+- Conversazioni (truncati per privacy)
+- Utilizzo strumenti
+- Utilizzo provider
+- Utilizzo comandi
+- Pattern di errori
+- Sessioni utente
+
 ## Marketplace dei Plugin
 
 MaxClaw Agent include un marketplace per scoprire e installare plugin.
@@ -944,6 +1026,7 @@ MaxClaw Agent include un sistema di monitoraggio e logging:
 - **Dashboard web**: Monitoraggio in tempo reale via interfaccia web con supporto multilingue
 - **Interfacce responsive**: Ottimizzate per dispositivi mobili e desktop
 - **Marketplace plugin**: Scopri e installa plugin dal marketplace
+- **Analytics avanzate**: Analisi dettagliate dell'uso e raccomandazioni
 
 ## Sicurezza