Vai al contenuto
Kaiross

Documenti

Google Sheets

Legge fogli Google come tabelle (grafici ed export) e aggiunge righe con conferma.

  • Accesso con Connetti (OAuth)
  • Azioni con conferma

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
find_spreadsheets Cerca fogli Google per nome. Lettura
get_spreadsheet Schede di un foglio (nome, righe e colonne), per scegliere l’intervallo da leggere. Lettura
read_range Legge un intervallo come tabella (prima riga = intestazioni, max 5000 righe): utilizzabile per grafici ed export. Lettura
append_rows Aggiunge righe in fondo a una tabella/scheda. Richiede conferma. Con conferma
update_range Sovrascrive i valori di un intervallo. Richiede conferma. Con conferma

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

  1. console.cloud.google.com → nuovo progetto → API e servizi → Libreria → abilita Google Sheets API e Google Drive API.
  2. Schermata di consenso OAuth: tipo Interno (Google Workspace) così solo gli utenti del dominio possono autorizzare.
  3. Credenziali → Crea credenziali → ID client OAuth → Applicazione web; in URI di reindirizzamento autorizzati incolla il Redirect URI mostrato qui sotto.
  4. Copia Client ID e Client secret, salva e premi Connetti con l’account da usare. Permessi richiesti: lettura/scrittura dei fogli e ricerca dei file.

Campi del modulo: Client ID OAuth.

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

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.

  • https://www.googleapis.com/auth/spreadsheets
  • https://www.googleapis.com/auth/drive.metadata.readonly

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 Documenti

Tutte le integrazioni