Comment connecter Dify à Google Sheets et Google Drive

Si vous souhaitez que vos agents IA fonctionnent avec des informations réelles et à jour, connecter Dify à Google Sheets C'est l'une des méthodes les plus simples pour y parvenir. La feuille de calcul peut servir de petit référentiel de données permettant d'interroger les produits, les clients, les tâches ou tout autre enregistrement utilisé par votre application.

Cette intégration permet à un flux de travail Dify de lire différentes plages de données et d'écrire de nouvelles valeurs sans nécessiter de copie manuelle. Par exemple, vous pouvez créer un assistant qui vérifie le statut d'une commande, catégorise les réponses d'un formulaire ou met à jour un tableau après le traitement d'une requête.

Il existe plusieurs façons de procéder. La méthode la plus directe utilise un Le plugin Google Sheets et un compte de service Google CloudSi vous devez réagir automatiquement aux changements, exécuter des tâches planifiées ou combiner la feuille de calcul avec d'autres applications, vous pouvez également utiliser une plateforme intermédiaire comme n8n.

Ce dont vous avez besoin pour connecter Dify à Google Sheets

Avant de commencer, il convient de préciser que le module complémentaire omluc/google_sheets Disponible sur la plateforme Dify Marketplace, ce plugin est développé par la communauté. Il ne fait pas partie des plugins officiels développés par l'équipe Dify, bien qu'il puisse être installé depuis leur catalogue d'extensions.

Ce plugin intègre actuellement deux outils principaux :

• Récupération par lots : Récupère des données à partir d'une ou plusieurs plages dans une feuille de calcul.
• Mise à jour par lots : met à jour plusieurs plages au cours d'une même opération.

Ces fonctions peuvent être ajoutées comme outils au sein d'un flux de travail ou mises à la disposition d'un agent pour une utilisation ponctuelle. Pour les configurer, vous aurez besoin de :

• UN Compte Google avec accès à Google Cloud.
• Un projet créé sur Google Cloud.
• La API Google Sheets activée.
• Un compte de service avec un clé au format JSON.
• UN feuille partagée avec l'adresse e-mail de ce compte.

Le compte de service fonctionne comme une entité distincte. Par conséquent, Dify n'utilise pas directement votre compte Google personnel et ne peut pas accéder automatiquement à toutes vos feuilles de calcul. Il aura uniquement accès aux documents que vous partagez explicitement avec lui.

Comment créer un compte de service sur Google Cloud

La première étape consiste à accéder à la console Google Cloud et à créer un projet ou à en sélectionner un existant. Dans le projet, ouvrez la section API et services, accédez à la bibliothèque et recherchez… API Google SheetsEnsuite, appuyez sur l'option pour l'activer.

Ensuite, entrez Gestion des identités et des accès (IAM) et administration > Comptes de service Créez ensuite un nouveau compte. Vous pouvez lui donner un nom qui permette d'identifier facilement sa fonction, par exemple « Dify Google Sheets ».

Au cours de ce processus, Google peut vous proposer d'attribuer des rôles au sein du projet. Pour cette intégration, il n'est pas nécessaire d'attribuer un rôle de propriétaire ou d'éditeur général pour l'ensemble du projet. L'accès aux feuilles de calcul spécifiques est géré ultérieurement via les options de partage de Google Sheets.

Une fois le compte créé :

1. Ouvrez vos informations dans la section des comptes de service.
2. Allez dans l'onglet Clés.
3. Cliquez sur Ajouter une clé > Créer une nouvelle clé.
4. Sélectionnez le format JSON.
5. Téléchargez et enregistrez le fichier dans un endroit sûr.

Le fichier JSON contient des informations sensibles, notamment une clé privée. Vous ne devez ni le publier, ni l'envoyer par courriel, ni le télécharger sur un dépôt. Toute personne qui obtiendrait cette clé pourrait utiliser les autorisations du compte de service.

Comment installer et configurer le plugin sur Dify

Dans Dify, ouvrez le Plugin Marketplace et recherchez l'extension Google Sheets publiée par omlucVérifiez le nom de l'auteur avant de l'installer afin d'éviter toute confusion avec d'autres extensions pouvant offrir des fonctions différentes.

Après l'installation, ouvrez les paramètres d'identification du plugin. Le formulaire vous demandera la clé du compte de service. Ouvrez le fichier JSON téléchargé avec un éditeur de texte. copier tout son contenu et collez-le dans le champ correspondant.

Ne copiez pas séparément l'adresse e-mail, l'identifiant du projet ou la clé privée. L'extension nécessite la structure JSON complète pour authentifier les requêtes adressées à Google Sheets.

Ensuite, enregistrez les identifiants et ouvrez la feuille de calcul que vous souhaitez utiliser. Dans le fichier JSON, vous trouverez un champ appelé client_email, dont la valeur aura une apparence similaire à celle-ci :

[email protected]

Cliquez sur Partager dans Google Sheets, ajoutez cette adresse comme s'il s'agissait d'un autre utilisateur :

• Accorde la permission à lecteur si Dify ne consulte que les données.
• Accorde la permission à éditeur si vous devez également mettre à jour des cellules.

Il est déconseillé de partager publiquement la feuille de calcul via un lien. Le compte de service vous permet de conserver le document privé et d'en restreindre l'accès à un utilisateur spécifique.

Comment lire des données depuis Google Sheets dans un flux de travail

Pour récupérer les informations de la feuille, ajoutez un nœud d'outil au flux de travail Dify et sélectionnez l'action. Récupération par lotsCe module complémentaire vous permet d'interroger plusieurs plages en une seule opération, ce qui évite d'avoir à créer un nœud différent pour chaque section du tableau.

Vous devrez fournir l'identifiant de la feuille de calcul. Celui-ci figure dans son adresse web, entre les colonnes suivantes : /d/ y /editDans une URL avec cette structure :

https://docs.google.com/spreadsheets/d/IDENTIFICADOR/edit

Vous devez uniquement utiliser la valeur marquée comme IDENTIFICADOR.

Vous devrez également spécifier le nom de l'onglet et la plage en utilisant la notation Google Sheets. Voici quelques exemples :

Clientes!A2:D50
Productos!A:C
Pedidos!B2:B20

Le nom précédant le point d'exclamation correspond à la tabulation. Les lettres et les chiffres qui suivent délimitent les colonnes et les lignes à extraire.

Vous pouvez ensuite transmettre le résultat à un nœud LLM pour le synthétiser, localiser un enregistrement ou préparer une réponse. Il est conseillé de configurer le modèle pour qu'il utilise uniquement les données extraites et qu'il indique clairement les cas où aucune correspondance n'est trouvée, notamment si la feuille contient des informations sur les clients, les stocks ou les commandes.

Comment mettre à jour les cellules à partir de Dify

L'outil Mise à jour par lots Il permet de saisir des valeurs dans différentes plages. Cela peut servir, par exemple, à modifier le statut d'une tâche, à enregistrer une classification générée par une IA ou à ajouter le résultat d'une requête.

Avant de l'utiliser, vérifiez que le compte de service dispose des droits d'édition sur le document. S'il ne dispose que des droits de lecture, les requêtes fonctionneront, mais Google refusera toute tentative d'écriture.

Il est également conseillé d'empêcher le modèle de choisir librement n'importe quelle plage ou valeur. Une configuration plus sécurisée consiste en : Commencez par valider les données, limitez les colonnes modifiables et définissez la plage à l'aide de variables contrôlées. tout au long du flux de travail.

Par exemple, vous pouvez organiser le processus comme ceci :

1. El l'utilisateur saisit un numéro de commande.
2. Batch Get reprend sa place correspondant.
3. Un nœud conditionnel vérifier si la commande existe.
4. Le modèle analyse ou classe les informations.
5. La mise à jour par lots écrit le résultat dans une colonne spécifique.
6. Le nœud de sortie confirme quel enregistrement a été modifié.

Dans la mesure du possible, utilisez une feuille de calcul de test lors de la configuration. Une mise à jour mal conçue peut écraser des informations existantes, surtout si la plage couvre plus de lignes ou de colonnes que prévu.

Erreurs courantes lors de la connexion de Dify à Google Sheets

En cas d'erreur d'authentification, vérifiez que vous avez bien collé le fichier JSON complet et que son format n'a pas été modifié. Les clés privées contiennent des sauts de ligne qui doivent être conservés dans la structure du document.

Lorsque Dify indique qu'il ne trouve pas ou ne peut pas accéder à la feuille, vérifiez les points suivants :

• L'API Google Sheets est activée dans le projet approprié.
• La feuille a été partagée avec la valeur exacte de client_email.
• L'identifiant de la feuille ne contient aucune partie supplémentaire de l'URL.
• Le nom de l'onglet correspond, y compris les majuscules, les espaces et les accents.
• La plage utilise une notation valide, telle que Datos!A2:C20.
• Le compte dispose des droits d'éditeur si le flux de travail tente d'écrire.

Si vous avez supprimé ou désactivé la clé dans Google Cloud, vous devrez en créer une nouvelle et remplacer les identifiants enregistrés dans Dify. Il est également conseillé de générer une nouvelle clé si vous soupçonnez que le fichier JSON a été exposé.

Différences entre les plugins Google Sheets et Google Drive

Google Sheets et Google Drive ne doivent pas être considérés comme une seule et même intégration. Le plugin communautaire Sheets est destiné à afficher et modifier les plages de cellules par le biais d'un compte de service.

En revanche, le plugin officiel Google Drive disponible comme source de données utilise OAuth 2.0Il vous permet de parcourir les dossiers, de lister les fichiers et de télécharger leur contenu pour traitement ou intégration dans un flux de connaissances Dify.

Le connecteur Drive est en lecture seule : il ne crée pas de fichiers, n'organise pas les dossiers et ne modifie ni ne supprime les documents. Lorsque vous téléchargez des fichiers natifs depuis Google Workspace, il les exporte automatiquement vers des formats compatibles. Les feuilles de calcul Google Sheets sont converties au format XLSX, tandis que les documents Google Docs et Google Slides sont exportés au format PDF.

Vous devez donc choisir l'intégration en fonction de la tâche :

• Utilisez le plugin pour Google Sheets lire ou écrire des valeurs dans des cellules.
• Utilisez la source de données de Google Drive localiser et télécharger des fichiers.
• Combinez les deux uniquement si le flux de travail doit fonctionner avec des cellules et des documents entiers.

Comment étendre l'intégration à l'aide de n8n

Le module complémentaire Google Sheets est utile pour exécuter des actions depuis DifyCependant, il ne couvre pas à lui seul tous les scénarios d'automatisation. Si vous avez besoin de déclencheurs, d'exécutions planifiées ou de connexions à plusieurs applications, vous pouvez utiliser des composants supplémentaires. n8n comme intermédiaire.

Dans cette architecture, Dify peut envoyer les données à un webhook n8n via une requête HTTP. n8n reçoit la requête, Il exécute ses nœuds Google Sheets et renvoie le résultat au flux de travail..

Il est également possible d'inverser le processus. Par exemple, n8n peut détecter une nouvelle ligne, traiter ses valeurs et appeler l'API d'une application publiée sur Dify. Le résultat généré par l'IA peut ensuite être inscrit dans une autre colonne de la même feuille.

Ce système vous permet de créer des automatisations telles que :

• Classer automatiquement les réponses ajoutées à une feuille.
• Générer des résumés à un moment précis.
• Mettre à jour les enregistrements et envoyer une notification simultanément.
• Combinez les données de Google Sheets avec votre messagerie, votre CRM ou d'autres applications.
• Effectuez des validations avant d'autoriser l'IA à modifier une cellule.

En contrepartie, la configuration est plus complexe et nécessite la protection des webhooks, des identifiants et des clés API utilisés par les deux services.

Connecter Dify à Google Sheets vous permet de transformer une feuille de calcul standard en une source d'information facilement accessible pour les agents ou les flux de travail. La méthode la plus simple consiste à activer l'API Sheets, à créer un compte de service, à installer l'extension et à partager uniquement les feuilles nécessaires avec votre adresse e-mail.

À partir de là, Batch Get vous permet d'interroger des plages, et Batch Update écrit les résultats.Si le projet nécessite de travailler avec des documents complets, de réagir à des événements ou de coordonner plusieurs applications, vous pouvez compléter cette configuration avec Google Drive ou n8n sans confondre les fonctions de chaque outil.