Come fare in modo che AI Assist interroghi un foglio Google

Le istruzioni qui sotto sono solo per computer desktop e laptop.

Puoi collegare Google Sheets ad AI Assist, permettendo al tuo agente AI di recuperare dati in tempo reale da un foglio di calcolo durante le conversazioni. Questa funzione ti consente, ad esempio, di consultare l'inventario, confermare prenotazioni, trovare dettagli sugli ordini o recuperare dati dei clienti — tutto senza uscire dalla chat.

Assicurati di avere:

• Un piano AI Assist attivo e a pagamento: Growth, Business o Enterprise.

• Un account Google con accesso al foglio che desideri utilizzare.

• Conoscenze base di programmazione in Google Apps Script e OpenAPI/YAML.
  Se non hai familiarità con il codice, ti consigliamo di farti aiutare da uno sviluppatore. Per maggiori informazioni, visita il nostro portale per sviluppatori.

Ecco alcuni suggerimenti per organizzare il tuo foglio in modo che sia facilmente ricercabile e restituisca risultati affidabili:

• Utilizza una riga di intestazione chiara con nomi di colonna descrittivi.

• Aggiungi una colonna con identificatori univoci per ricerche dirette (ad esempio: SKU, ID ordine o Email).

• Mantieni un solo tipo di dato per colonna. Ad esempio, usa una colonna solo per le date e un'altra solo per i numeri per semplificare la gestione dei dati.

• Evita celle unite o colonne nascoste. Mantieni invece i dati in un formato tabellare, per una migliore accessibilità.

Il tuo Google Sheet può contenere dettagli sugli ordini, descrizioni dei prodotti o informazioni generali.

Ad esempio:

Importare un foglio di calcolo dal computerSe i tuoi dati sono contenuti in un file, puoi importarli facilmente in Google Fogli:

1. Apri Google Fogli e fai clic su File > Importa.
2. Seleziona la scheda Carica e scegli il file, oppure trascinalo direttamente nella finestra.
3. Scegli come desideri importare il file:
   
   • Crea nuovo foglio di lavoro (consigliato)
   • Inserisci nuovi fogli nel foglio di lavoro corrente
   • Sostituisci foglio di lavoro o Sostituisci foglio (utilizza queste opzioni con cautela)
4. Fai clic su Importa dati e verifica la riga di intestazione e i tipi di dati delle colonne.

Tipi di file supportati: .xlsx, .xls, .csv, .tsv, .ods.
Creare e distribuire un'app web con Google Apps Script

1. Nel tuo Foglio Google, vai su Estensioni > Apps Script.

1. La console Apps Script si aprirà in una nuova scheda. Inserisci uno script nel file Code.gs per definire i metodi da utilizzare per interrogare i dati presenti nel tuo foglio.

Puoi iniziare utilizzando questo script di esempio:
Code.gs su GitHub
Lo script di esempio esegue una ricerca in una colonna specifica (SKU) e rappresenta un semplice punto di partenza. Modificalo in base ai tuoi dati e ai criteri di ricerca che desideri utilizzare.
Per maggiori informazioni su come personalizzare lo script, consulta la guida su GitHub.

3.Clicca su Distribuisci > Nuova distribuzione.

4.Clicca sull’icona a forma di ingranaggio accanto a Seleziona tipo e scegli Web app.

5.Inserisci una Descrizione. Imposta Esegui come su Me. Questo darà allo script accesso al tuo foglio di calcolo.

Imposta Chi ha accesso su Chiunque. Questo permetterà ad AI Assist di interrogare il tuo foglio usando lo script.

Infine, clicca su Distribuisci.

Copia e salva l’URL della Web App. Ti servirà per le specifiche API.

Nota: a ogni nuova distribuzione viene generato un nuovo URL.

AI Assist ha bisogno di un file OpenAPI (in formato YAML o JSON) che descriva come chiamare questo esempio. la tua Web App.

Puoi copiare le specifiche da Assicurati di:

• Sostituire il valore di servers.urls con l’URL della Web App copiato da Apps Script.

• Rimuovere /exec alla fine dell’URL.

• Modificare i parametri rilevanti in base alle tue esigenze.

Per maggiori informazioni su come personalizzare le specifiche,clicca qui.

Usa un validatore/editor come Swagger Editor per controllare il tuo file YAML o JSON.

Copia e salva l’URL del file raw, ti servirà per la sezione successiva.

Nota: il campo “title” nelle tue specifiche verrà visualizzato come nome dell’integrazione sulla dashboard di tawk.to.

Ad esempio:

Se disponi di più integrazioni API, assegna a ciascuna un nome descrittivo, in modo da poterla individuare facilmente.
Aggiungere l’integrazione in tawk.toNota: per utilizzare questa integrazione è necessario disporre di un piano AI Assist a pagamento.

1. Accedi al tuo account tawk.to e seleziona la proprietà corretta.

3.Clicca su Automazioni nel menu in alto.

3.Fai clic su Integrazioni nel sottomenu a sinistra.

4.Fai clic su OpenAPI Server nella sezione Strumento personalizzato.

Puoi anche cercare “OpenAPI” utilizzando la barra Cerca nella parte superiore.

5.Si aprirà la pagina Panoramica di OpenAPI Server. Fai clic su Installa nell’angolo in alto a destra.

1. Nella finestra pop-up, inserisci i dettagli dello schema:

• Seleziona URL del file dello schema e inserisci l’URL dello schema, oppure
• Seleziona Incolla schema e incolla lo schema in formato JSON.

Lascia vuoto il campo URL di base dell’API e seleziona Nessuna autenticazione come metodo di autenticazione.
Quindi, fai clic su Salva.

7.Dopo aver salvato, fai clic su Agenti nel sottomenu a sinistra.

8.Seleziona il tuo agente AI. Quindi, fai clic su Strumenti nel menu a sinistra. Assicurati che l’integrazione sia abilitata nella sezione Stato.

• Esegui le richieste più comuni e alcuni casi limite utilizzando l’anteprima nella dashboard.
• Utilizza Logger.log() in Apps Script e controlla la pagina Esecuzioni per individuare eventuali errori.
• Verifica che lo schema OpenAPI corrisponda all’output JSON effettivamente restituito.
• Se i tempi di risposta sono lenti, utilizza la cache per i risultati richiesti più frequentemente.
• Mantieni le risposte coerenti, utilizzando sempre gli stessi campi e tipi di dati, in modo che AI Assist possa interpretarli in modo affidabile.

• Limiti di utilizzo
  Tieni in considerazione le quote e i limiti di Google Apps Script e configura il sistema in modo da gestire correttamente nuovi tentativi e tempi di attesa progressivi in caso di errore.
• Protezione dei dati
  Assicurati di rispettare il GDPR e le altre normative sulla privacy applicabili quando vengono restituiti dati personali.
• Controllo delle versioni
  Quando modifichi le specifiche OpenAPI, incrementa il numero di versione oppure aggiorna il titolo, in modo che le diverse versioni delle integrazioni siano facilmente identificabili.

• Fai clic sull’icona verde della live chat
• Programma una chiamata con noi
• Visita la nostra community