Obtenir l'assistance de l'IA pour interroger une feuille de calcul Google Sheets

Les instructions ci-dessous concernent uniquement les ordinateurs de bureau et portables.

Vous pouvez connecter Google Sheets à AI Assist, permettant à votre agent IA d'extraire des données de feuilles de calcul en temps réel lors des conversations. Cette fonctionnalité vous permet de consulter l'inventaire, de confirmer des réservations, de trouver des détails de commande ou de récupérer des dossiers clients, le tout sans quitter le chat.

 Avant de commencer 

Assurez-vous d'avoir :


  • Un plan AI Assist actif et payant : Growth, Business ou Enterprise.
  • Un compte Google avec accès à la feuille que vous souhaitez utiliser.
  • Des connaissances de base en codage dans Google Apps Script et OpenAPI/YAML. Si vous n'êtes pas familier avec le codage, nous vous recommandons de faire appel à un développeur. Pour plus d'informations, visitez notre portail développeur.

 Préparez votre Google Sheet 

 
Voici quelques conseils pour organiser votre feuille afin qu'elle soit facile à consulter et renvoie des résultats fiables :


  • Utilisez une ligne d'en-tête claire avec des noms de colonnes descriptifs.

  • Ajoutez une colonne d'identifiant unique pour les recherches directes (par exemple : SKU, ID de commande ou e-mail).

  • Maintenez un type de données unique dans chaque colonne. Par exemple, gardez les dates dans une colonne et les nombres dans une autre pour simplifier la gestion des données.

  • Évitez les cellules fusionnées ou les colonnes masquées. Au lieu de cela, gardez vos données dans un format tabulaire pour une meilleure accessibilité.


Exemple


Votre Google Sheet peut contenir des détails de commande, des descriptions de produits ou des informations générales.

Par exemple :
Importer une feuille de calcul depuis votre ordinateur


Si vos données se trouvent dans un fichier, vous pouvez facilement les importer dans Google Sheets :


  1. Ouvrez Google Sheets et cliquez sur Fichier > Importer.

  2. Sélectionnez l'onglet Télécharger et choisissez votre fichier, ou faites-le glisser dans la fenêtre.

  3. Choisissez comment vous souhaitez importer le fichier :
    • Créer une nouvelle feuille de calcul (recommandé)
    • Insérer de nouvelles feuilles dans la feuille de calcul actuelle
    • Remplacer la feuille de calcul ou Remplacer la feuille (à utiliser avec précaution)

  4. Cliquez sur Importer des données et vérifiez la ligne d'en-tête et les types de colonnes.

Types de fichiers pris en charge : .xlsx, .xls, .csv, .tsv, .ods.

 Créer et déployer une application web Google Apps Script 

 
 
 
1. Dans votre Google Sheet, allez dans Extensions > App Script.
2. La console Apps Script s'ouvrira dans un nouvel onglet. Saisissez un script dans Code.gs pour décrire les méthodes permettant d'interroger votre feuille.

Vous pouvez commencer à partir de cet exemple de script : Code.gs sur GitHub. L'échantillon recherche une colonne spécifique (SKU) et constitue un point de départ simple — modifiez-le pour qu'il corresponde à vos données et à vos règles de recherche. Pour plus d'informations sur la personnalisation du script, cliquez ici.
3. Cliquez sur Déployer > Nouveau déploiement.
4. Cliquez sur l'icône d'engrenage à côté de Sélectionner le type et choisissez Application Web.
 
 
 
 
 
5. Saisissez la Description. Réglez Exécuter en tant que sur Moi. Cela donne à votre script l'accès à votre feuille.

Réglez Qui a accès sur Tout le monde. Cela permet à AI Assist d'interroger votre feuille à l'aide de votre script.

Ensuite, cliquez sur Déployer.

6. Copiez et enregistrez l'URL de l'application Web. Vous en aurez besoin pour vos spécifications d'API.
Remarque : Une nouvelle URL est générée à chaque déploiement.

 Créer une spécification OpenAPI 

AI Assist a besoin d'un fichier OpenAPI (YAML ou JSON) qui décrit comment appeler votre application web.

Vous pouvez copier les spécifications dans cet exemple. Assurez-vous de :


  • Remplacez la valeur servers.urls par l'URL de l'application Web copiée de l'Apps Script ci-dessus.
  • Supprimez /exec à la fin de l'URL.
  • Modifiez les paramètres pertinents pour répondre à vos besoins. Pour plus d'informations sur la personnalisation des spécifications, cliquez ici.

Utilisez un validateur/éditeur tel que Swagger Editor pour vérifier votre fichier YAML/JSON. Copiez et enregistrez l'URL de votre fichier brut. Vous en aurez besoin pour la section suivante.

Remarque : Le « titre » dans vos spécifications apparaîtra comme le nom de l'intégration sur votre tableau de bord tawk.to.


Par exemple :

Si vous avez plusieurs intégrations d'API, donnez à chacune d'elles un nom descriptif afin qu'elle soit facile à trouver.

Ajouter l'intégration dans tawk.to
Remarque : Vous aurez besoin d'un plan AI Assist payant pour effectuer cette intégration.


1. Connectez-vous à votre compte tawk.to, et sélectionnez la propriété correcte.
2. Cliquez sur Automation dans la barre de navigation de gauche.
3. Cliquez sur Integrations dans le sous-menu de gauche.
4. Cliquez sur OpenAPI Server sous Custom Tool.
Vous pouvez également rechercher « OpenAPI » à l'aide de la barre de Recherche en haut.
5. Cela ouvre la page Présentation du serveur OpenAPI. Cliquez sur Installer dans le coin supérieur droit.
6. Dans la fenêtre contextuelle, saisissez les détails de votre schéma :
- Sélectionnez URL du fichier de schéma et saisissez l'URL de votre schéma, ou
- Sélectionnez Coller le schéma et collez votre schéma en JSON


Laissez URL de base de l'API vide, et choisissez Pas d'authentification sous Méthode d'authentification.


Ensuite, cliquez sur Enregistrer.
7. Après avoir enregistré, cliquez sur Agents dans le sous-menu de gauche.
8. Sélectionnez votre agent IA. Cliquez ensuite sur Outils dans le menu de gauche. Assurez-vous que l'intégration est activée sous Statut.
Testez votre intégration à l'aide de l'aperçu du widget sur la droite.

 Tester et affiner 

  • Exécutez des requêtes courantes et des cas particuliers dans l'aperçu du tableau de bord.

  • Utilisez Logger.log() dans Apps Script et consultez la page Exécutions pour les erreurs.

  • Confirmez que le schéma OpenAPI correspond à la sortie JSON réelle.

  • Mettez en cache les résultats fréquents si les réponses sont lentes.

  • Gardez des réponses cohérentes (mêmes champs et types) afin qu'AI Assist puisse les analyser de manière fiable.

 Notes de sécurité 

Soyez prudent lorsque vous manipulez des informations sensibles. Ne renvoyez que les champs dont AI Assist a besoin et surveillez l'utilisation pour détecter toute activité inhabituelle.

 Considérations supplémentaires 


  • Limites de débit
    Tenez compte des quotas de Google Apps Script et prévoyez des tentatives et des délais d'attente.

  • Protection des données
    Conformez-vous au RGPD et aux autres lois applicables sur la protection de la vie privée lorsque vous renvoyez des données personnelles.

  • Versionnage
    Lorsque vous modifiez votre spécification OpenAPI, incrémentez une version ou mettez à jour le titre afin que les intégrations restent claires.

Si vous avez des commentaires sur cet article, ou si vous avez besoin d'aide supplémentaire :




 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Cet article a-t-il été utile ?

5 sur 15 ont aimé cet article