Phase 3: Unified provider tools system for all LLM providers

README.md

@@ -9,6 +9,7 @@ Un agente configurabile basato su DeepAgents che supporta più provider LLM.
 - **Configurazione semplice**: Imposta le variabili d'ambiente per scegliere il tuo provider e modello
 - **Configurazione persistente**: Gestisci e conserva le configurazioni tramite CLI o TUI
 - **Estensibile**: Aggiungi strumenti personalizzati, modifica i prompt e configura i sub-agenti secondo le tue esigenze
+- **Strumenti unificati**: Gestisci qualsiasi provider con la stessa interfaccia
 - **Strumenti personalizzati**: Include strumenti per gestire Proxmox e Ollama
 
 ## Installazione
@@ -117,9 +118,61 @@ python main.py
 
 Puoi quindi interagire con l'agente nel terminale. Digita 'exit' per uscire.
 
+## Strumenti Unificati per Provider
+
+MaxClaw Agent ora fornisce un'interfaccia unificata per gestire qualsiasi provider LLM. Una volta configurato un provider, puoi usare gli stessi comandi per tutti.
+
+### Strumenti Disponibili per Ogni Provider
+
+Per ogni provider configurato (Ollama, OpenAI, OpenRouter), hai accesso a:
+
+- `{provider}_list_models`: Elenca tutti i modelli disponibili
+- `{provider}_model_info`: Ottieni informazioni dettagliate su un modello
+- `{provider}_test_connection`: Testa la connessione al provider
+- `{provider}_get_default_model`: Mostra il modello predefinito
+- `{provider}_set_default_model`: Imposta un modello predefinito
+- `{provider}_info`: Mostra informazioni sulla configurazione del provider
+
+### Esempi di Utilizzo
+
+```bash
+# Con Ollama configurato:
+"List available Ollama models"
+"Test connection to Ollama"
+"What's the default model for Ollama?"
+
+# Con OpenAI configurato:
+"List available OpenAI models"
+"Test connection to OpenAI"
+"Show me OpenAI configuration"
+
+# Con OpenRouter configurato:
+"List available OpenRouter models"
+"Test connection to OpenRouter"
+"Show me OpenRouter configuration"
+```
+
+### Configurazione Automatica
+
+Gli strumenti vengono caricati automaticamente in base alle variabili d'ambiente configurate:
+
+```bash
+# Se hai configurato Ollama:
+export OLLAMA_BASE_URL="http://192.168.0.50:11434"
+# → Verranno caricati automaticamente gli strumenti Ollama
+
+# Se hai configurato OpenAI:
+export OPENAI_API_KEY="sk-..."
+# → Verranno caricati automaticamente gli strumenti OpenAI
+
+# Se hai configurato OpenRouter:
+export OPENROUTER_API_KEY="sk-or-..."
+# → Verranno caricati automaticamente gli strumenti OpenRouter
+```
+
 ## Strumenti Personalizzati
 
-MaxClaw Agent include strumenti personalizzati per gestire il tuo ambiente:
+MaxClaw Agent include anche strumenti personalizzati per gestire il tuo ambiente:
 
 ### Strumenti Proxmox
 Configura le variabili d'ambiente per abilitare gli strumenti Proxmox:
@@ -139,10 +192,8 @@ Strumenti disponibili:
 - `proxmox_create_snapshot`: Crea uno snapshot
 - `proxmox_list_snapshots`: Elenca gli snapshot di una VM
 
-### Strumenti Ollama
-Gli strumenti Ollama sono sempre disponibili e utilizzano l'URL configurato in `OLLAMA_BASE_URL`.
-
-Strumenti disponibili:
+### Strumenti Ollama (Legacy)
+Gli strumenti Ollama specifici sono ancora disponibili per retrocompatibilità:
 - `ollama_list_models`: Elenca tutti i modelli disponibili
 - `ollama_model_info`: Ottieni informazioni dettagliate su un modello
 - `ollama_pull_model`: Scarica un nuovo modello