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.
| Strumento | Cosa fa | Tipo |
|---|---|---|
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.
- Crea un utente IAM dedicato con policy minima:
s3:ListBucketsul bucket es3:GetObjectsuarn:aws:s3:::<bucket>/*(piùs3:PutObjectsolo se abiliti il caricamento). - Genera una access key per l’utente e incollala qui: la secret resta nel Vault.
- 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
- Apri Agenti, scegli l’agente e vai alla scheda MCP e database.
- In Aggiungi scegli Collega un’integrazione esistente e seleziona la connessione, oppure Dal catalogo per crearne una nuova (il pulsante diventa Salva e collega).
- Controlla gli Strumenti abilitati e, in Conferma delle azioni, quali azioni devono chiedere conferma.
- 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.