Vai al contenuto
Kaiross

Storage

Amazon S3

Sfoglia e legge file da un bucket S3 o compatibile (MinIO, R2, Exoscale).

  • Token o credenziali
  • Azioni con conferma
  • Anche via tunnel VPN
  • Sorgente sincronizzabile

Strumenti per l’agente

L’agente sceglie da solo lo strumento adatto alla domanda. Nella scheda MCP e database dell’agente puoi disattivare quelli che non servono.

StrumentoCosa faTipo
list_objects Elenca cartelle e file del bucket sotto un prefisso (una cartella alla volta). Lettura
read_object Legge un file del bucket e ne restituisce il testo (PDF, Word, Excel, CSV, testo). Lettura
upload_text Carica un file di testo (es. CSV, Markdown, JSON) nel bucket. Richiede conferma. Con conferma

Le azioni che modificano dati sono spente di default. Si attivano nella connessione con l’opzione Consenti caricamento file (con conferma); poi ogni azione mostra in chat un riepilogo e parte solo con Conferma ed esegui.

Configurazione passo per passo

In Kaiross apri Integrazioni, scegli Amazon S3 e premi Nuova connessione. Il modulo mostra la stessa guida sotto Guida e permessi consigliati.

  1. Crea un utente IAM dedicato con policy minima: s3:ListBucket sul bucket e s3:GetObject su arn:aws:s3:::<bucket>/* (più s3:PutObject solo se abiliti il caricamento).
  2. Genera una access key per l’utente e incollala qui: la secret resta nel Vault.
  3. Per MinIO/R2 indica l’endpoint e, se serve, attiva path-style.

Campi del modulo: Bucket, Regione, Endpoint (servizi compatibili), Access key ID, URL path-style, Limita alla cartella (prefisso).

Da incollare (cifrato nel Vault, poi non più visibile): Secret access key.

Da sapere

  • Se il servizio è nella rete della tua azienda, crea prima un tunnel in Impostazioni → Rete / VPN e nella connessione scegli Raggiungibile tramite → il tunnel. Vedi Database e gestionali.
  • Si può usare anche come sorgente sincronizzata della knowledge: agente → scheda Sincronizzazione → Aggiungi sorgente. Vedi Sorgenti sincronizzate.

Collegarla a un agente

  1. Apri Agenti, scegli l’agente e vai alla scheda MCP e database.
  2. In Aggiungi scegli Collega un’integrazione esistente e seleziona la connessione, oppure Dal catalogo per crearne una nuova (il pulsante diventa Salva e collega).
  3. Controlla gli Strumenti abilitati e, in Conferma delle azioni, quali azioni devono chiedere conferma.
  4. Premi Prova in chat e fai una domanda che richiede i dati del servizio.

Errori frequenti

Credenziali non valide
Controlla token, password o chiave API: spesso manca un carattere o il token è scaduto. Creane uno nuovo e aggiorna la connessione.
Permessi insufficienti
All’account o al token mancano i permessi necessari: confrontali con la configurazione qui sopra (Guida e permessi consigliati nell’app) e, se serve, crea un token nuovo.
Servizio non raggiungibile
Controlla indirizzo, porta e firewall. Un server nella rete aziendale richiede un tunnel VPN; senza tunnel sono ammessi solo indirizzi pubblici.
Troppe richieste
Il servizio limita la frequenza delle chiamate: riprova tra qualche minuto.

Altre integrazioni della categoria Storage

Tutte le integrazioni