Phase 8: Additional provider integrations (Anthropic, Google) and enhanced documentation
This commit is contained in:
1 parent
c44a4ae92a
commit
c54f2a33c8
2 files changed
+413
-5
No files matched your search
@@ -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 \
|
||||
|
||||
Reference in new issue
Block a user