Phase 8: Additional provider integrations (Anthropic, Google) and enhanced documentation

This commit is contained in:
truetype committed 2026-03-20 18:47:02 +01:00
1 parent c44a4ae92a
commit c54f2a33c8
2 files changed
+413 -5

No files matched your search

+51 -4
View File
@@ -4,7 +4,7 @@ Un agente configurabile basato su DeepAgents che supporta più provider LLM.
## Caratteristiche
- **Indipendente dal provider**: Funziona con OpenAI, Ollama, OpenRouter e qualsiasi altro provider supportato da `init_chat_model` di LangChain
- **Indipendente dal provider**: Funziona con OpenAI, Ollama, OpenRouter, Anthropic, Google e qualsiasi altro provider supportato da `init_chat_model` di LangChain
- **Basato su DeepAgents**: Include pianificazione, accesso al filesystem, sub-agenti e gestione del contesto out of the box
- **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
@@ -17,6 +17,7 @@ Un agente configurabile basato su DeepAgents che supporta più provider LLM.
- **API REST**: Server API per accesso remoto
- **Web UI**: Interfaccia web per gestione configurazioni
- **Comandi integrati**: Comandi speciali con prefisso "/" per gestione rapida
- **Monitoraggio**: Sistema di logging e monitoraggio delle performance
## Installazione
@@ -68,12 +69,14 @@ Puoi configurare MaxClaw Agent in diversi modi:
Imposta le seguenti variabili d'ambiente per configurare il tuo provider LLM:
- `MODEL_PROVIDER`: Il provider da utilizzare (es. "openai", "ollama", "openrouter")
- `MODEL_NAME`: Il nome specifico del modello (es. "gpt-4o", "gemma2:9b")
- `MODEL_PROVIDER`: Il provider da utilizzare (es. "openai", "ollama", "openrouter", "anthropic", "google")
- `MODEL_NAME`: Il nome specifico del modello (es. "gpt-4o", "gemma2:9b", "claude-3-5-sonnet")
- Variabili specifiche per il provider:
- Per OpenAI: `OPENAI_API_KEY`
- Per Ollama: `OLLAMA_BASE_URL` (predefinito a http://localhost:11434)
- Per OpenRouter: `OPENROUTER_API_KEY` e opzionalmente `OPENROUTER_BASE_URL` (predefinito a https://openrouter.ai/api/v1)
- Per Anthropic: `ANTHROPIC_API_KEY`
- Per Google: `GOOGLE_API_KEY`
### Esempi di Configurazione
@@ -98,6 +101,20 @@ export MODEL_NAME="anthropic/claude-3.5-sonnet"
export OPENROUTER_API_KEY="la-tua-chiave-api-openrouter"
```
#### Anthropic
```bash
export MODEL_PROVIDER="anthropic"
export MODEL_NAME="claude-3-5-sonnet-20241022"
export ANTHROPIC_API_KEY="la-tua-chiave-api-anthropic"
```
#### Google
```bash
export MODEL_PROVIDER="google"
export MODEL_NAME="gemini-1.5-pro"
export GOOGLE_API_KEY="la-tua-chiave-api-google"
```
### 2. Configurazione Persistente (Consigliato)
Utilizza la CLI, la TUI o l'interfaccia web per gestire le configurazioni che persistono tra le sessioni.
@@ -277,9 +294,19 @@ curl -X POST http://localhost:8000/configurations \
MaxClaw Agent ora fornisce un'interfaccia unificata per gestire qualsiasi provider LLM. Una volta configurato un provider, puoi usare gli stessi comandi per tutti.
### Provider Supportati
MaxClaw Agent supporta i seguenti provider:
1. **Ollama** - Modelli locali
2. **OpenAI** - GPT-4o, GPT-4o-mini, GPT-4-turbo, ecc.
3. **OpenRouter** - Accesso a centinaia di modelli
4. **Anthropic** - Claude 3.5 Sonnet, Claude 3 Opus, Claude 3 Haiku, ecc.
5. **Google** - Gemini 1.5 Pro, Gemini 1.5 Flash, ecc.
### Strumenti Disponibili per Ogni Provider
Per ogni provider configurato (Ollama, OpenAI, OpenRouter), hai accesso a:
Per ogni provider configurato, hai accesso a:
- `{provider}_list_models`: Elenca tutti i modelli disponibili
- `{provider}_model_info`: Ottieni informazioni dettagliate su un modello
@@ -305,6 +332,16 @@ Per ogni provider configurato (Ollama, OpenAI, OpenRouter), hai accesso a:
"List available OpenRouter models"
"Test connection to OpenRouter"
"Show me OpenRouter configuration"
# Con Anthropic configurato:
"List available Anthropic models"
"Test connection to Anthropic"
"Show me Anthropic configuration"
# Con Google configurato:
"List available Google models"
"Test connection to Google"
"Show me Google configuration"
```
### Configurazione Automatica
@@ -323,6 +360,14 @@ export OPENAI_API_KEY="sk-..."
# Se hai configurato OpenRouter:
export OPENROUTER_API_KEY="sk-or-..."
# → Verranno caricati automaticamente gli strumenti OpenRouter
# Se hai configurato Anthropic:
export ANTHROPIC_API_KEY="sk-ant-..."
# → Verranno caricati automaticamente gli strumenti Anthropic
# Se hai configurato Google:
export GOOGLE_API_KEY="AIza..."
# → Verranno caricati automaticamente gli strumenti Google
```
## Strumenti Personalizzati
@@ -402,6 +447,8 @@ docker run -it --rm \
-e OLLAMA_BASE_URL=http://host.docker.internal:11434 \
-e OPENAI_API_KEY=sk-... \
-e OPENROUTER_API_KEY=sk-or-... \
-e ANTHROPIC_API_KEY=sk-ant-... \
-e GOOGLE_API_KEY=AIza... \
-e PROXMOX_HOST=192.168.0.100 \
-e PROXMOX_USER=root \
-e PROXMOX_PASSWORD=password \