Connetti AWS Bedrock

Pensa ad Amazon Bedrock come a un gigantesco distributore automatico di modelli AI—invece di snack, eroga potenti modelli linguistici da Anthropic, Meta e altri, tutto con un semplice metodo di pagamento: il tuo account AWS.

Cosa Ti Serve

Prima di iniziare, assicurati di avere:

• Un account AWS (il piano gratuito va benissimo)
• Credenziali AWS—sono come la tua carta d’identità. Puoi usare:
  • Un ruolo IAM se sei su EC2/ECS/Lambda (zero configurazione!)
  • Variabili d’ambiente AWS_ACCESS_KEY_ID + AWS_SECRET_ACCESS_KEY
  • Un AWS_PROFILE per SSO o profili nominati
  • Oppure esegui semplicemente aws configure per lo sviluppo locale

Passo 1: Installa Hermes con Supporto Bedrock

Apri il terminale ed esegui:

cd ~/.hermes/hermes-agent
uv pip install -e ".[bedrock]"

Questo aggiunge il “plug-in” Bedrock alla tua installazione di Hermes. Pensalo come installare un pacchetto lingua sul tuo telefono.

Passo 2: Di’ a Hermes di Usare Bedrock

Esegui questo comando per scegliere il tuo provider:

hermes model

Quando richiesto:

1. Scegli “More providers…”
2. Seleziona “AWS Bedrock”
3. Scegli la tua regione (es. us-east-2)
4. Scegli un modello (es. Claude Sonnet 4)

Hermes salverà automaticamente le tue impostazioni. Il tuo ~/.hermes/config.yaml sarà simile a:

model:
  default: us.anthropic.claude-sonnet-4-6
  provider: bedrock
  base_url: https://bedrock-runtime.us-east-2.amazonaws.com
bedrock:
  region: us-east-2

Passo 3: Inizia a Chattare

hermes chat

Tutto qui! Ora stai parlando con un modello tramite AWS Bedrock.

Impostare la Tua Regione

Puoi impostare la tua regione AWS in tre modi (priorità dalla più alta alla più bassa):

1. Aggiungi region sotto bedrock: nel tuo file di configurazione
2. Imposta la variabile d’ambiente AWS_REGION
3. Imposta la variabile d’ambiente AWS_DEFAULT_REGION

Se non la imposti, Hermes usa us-east-1 come predefinita.

Extra: Guardrail (Filtri di Sicurezza)

Vuoi aggiungere filtri sui contenuti? Aggiungi questo alla tua configurazione:

bedrock:
  region: us-east-2
  guardrail:
    guardrail_identifier: "abc123def456"  # Dalla console Bedrock
    guardrail_version: "1"                # Oppure "DRAFT"
    stream_processing_mode: "async"       # "sync" o "async"
    trace: "disabled"                     # "enabled", "disabled", "enabled_full"

Scoperta dei Modelli

Hermes trova automaticamente i modelli disponibili nella tua regione. Puoi personalizzare quali mostrare:

bedrock:
  discovery:
    enabled: true
    provider_filter: ["anthropic", "meta"]

Riepilogo

Collegare AWS Bedrock a Hermes è come collegare una nuova console al tuo TV—installa il driver, scegli il gioco e gioca. Ottieni accesso a modelli di prim’ordine con la sicurezza e l’affidabilità di AWS.

Consiglio pratico: Se stai girando su EC2 o Lambda, salta del tutto le chiavi API. Basta associare un ruolo IAM con AmazonBedrockFullAccess e Hermes lo rileverà automaticamente. Nessuna configurazione, nessun problema—solo pura potenza AI.