Vai al contenuto
Kaiross

Storage

Box

Cerca e legge documenti di Box (PDF, Office, testo); caricamento con conferma.

  • Accesso con Connetti (OAuth)
  • Azioni con conferma
  • Sorgente sincronizzabile
  • Rispetta i permessi dei file

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
search_files Cerca file e cartelle per nome o contenuto. Lettura
list_folder Contenuto di una cartella ("0" = radice). Lettura
read_file Testo di un file trovato con la ricerca o nell’elenco di una cartella (fino a 15 MB). Lettura
upload_text Carica un file di testo in una cartella. Richiede conferma. Con conferma

Le azioni che modificano dati sono spente di default. Si attivano nella connessione con l’opzione Consenti il caricamento di 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 Box e premi Nuova connessione. Il modulo mostra la stessa guida sotto Guida e permessi consigliati.

  1. app.box.com/developers/console → Create Platform App → User Authentication (OAuth 2.0).
  2. Configuration: Redirect URI = quello mostrato qui sotto; Application scopes: Read all files and folders (e Write per il caricamento).
  3. Copia Client ID e secret, salva e premi Connetti; l’agente vede ciò che vede l’utente collegato.

Campi del modulo: App key / Client ID.

Da incollare (cifrato nel Vault, poi non più visibile): Client secret.

Permessi dei file (sorgenti sincronizzate): con Rispetta i permessi della fonte ogni documento è visibile in chat solo al proprietario e ai collaboratori del file e delle cartelle che lo contengono; i gruppi Box si espandono se l’account collegato può vederne i membri. Link condiviso Chiunque → visibile a tutti; Persone dell’azienda → dominio del proprietario.

Accesso con «Connetti» (OAuth)

  1. Nel modulo della connessione copia il valore Indirizzo di ritorno (Redirect URI) da registrare nell’app OAuth (icona Copia indirizzo di ritorno).
  2. Registra l’app OAuth presso il fornitore (passi qui sopra) incollando quel Redirect URI.
  3. Inserisci in Kaiross Client ID e Client secret e premi Salva e connetti: si apre la finestra del fornitore, accedi con l’account da usare e autorizza.
  4. Se in seguito il test segnala «Accesso scaduto», premi Ricollega nella connessione.

Permessi (scope) richiesti

Kaiross chiede solo questi permessi al fornitore; le azioni di scrittura restano comunque spente finché non le attivi.

  • root_readwrite

Da sapere

  • Si può usare anche come sorgente sincronizzata della knowledge: agente → scheda Sincronizzazione → Aggiungi sorgente. Vedi Sorgenti sincronizzate.
  • Con Rispetta i permessi della fonte (attivo di default) ogni documento sincronizzato è visibile in chat solo a chi può aprirlo nel servizio.

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

Account non collegato o accesso scaduto
Il collegamento OAuth non è mai stato completato o non è più valido: premi Connetti o Ricollega nella connessione.
Permessi insufficienti
All’account mancano gli scope necessari: confrontali con l’elenco qui sopra.
Troppe richieste
Il servizio limita la frequenza delle chiamate: riprova tra qualche minuto.

Altre integrazioni della categoria Storage

Tutte le integrazioni