- Direkte Integration durch spezialisierte Plugins zum Lesen und Schreiben von Daten in Tabellenkalkulationen.
- Automatisierte, cloudbasierte Dateiverwaltung, die das Suchen, Erstellen und Herunterladen von Dokumenten ermöglicht.
- Flexible Konfiguration über JSON-Dienstkonten oder OAuth 2.0-Authentifizierungsprotokolle.
- Bidirektionale Synchronisierung, die es Ihnen ermöglicht, Google Workspace-Dokumente in kompatible Formate wie XLSX und PDF zu konvertieren.
Wenn Sie möchten, dass Ihre KI-Agenten mit realen und aktuellen Informationen arbeiten, Dify mit Google Sheets verbinden Dies ist eine der einfachsten Möglichkeiten, dies zu erreichen. Die Tabellenkalkulation kann als kleines Datenrepository dienen, aus dem Produkte, Kunden, Aufgaben oder beliebige andere Datensätze, die von Ihrer Anwendung verwendet werden, abgefragt werden können.
Diese Integration ermöglicht es einem Dify-Workflow, verschiedene Bereiche zu lesen und neue Werte zu schreiben, ohne dass Daten manuell kopiert werden müssen. Beispielsweise können Sie einen Assistenten erstellen, der den Bestellstatus prüft, Formularantworten kategorisiert oder eine Tabelle nach der Bearbeitung einer Anfrage aktualisiert.
Dafür gibt es mehrere Möglichkeiten. Der direkteste Weg führt über ein/e Google Sheets-Plugin und ein Google Cloud-DienstkontoWenn Sie automatisch auf Änderungen reagieren, geplante Aufgaben ausführen oder die Tabellenkalkulation mit anderen Anwendungen kombinieren müssen, können Sie auch eine Zwischenplattform wie n8n verwenden.
Was Sie benötigen, um Dify mit Google Sheets zu verbinden
Bevor wir beginnen, ist es sinnvoll, klarzustellen, dass das Komplement omluc/google_sheets Dieses Community-Plugin ist im Dify Marketplace erhältlich. Es gehört nicht zu den offiziellen Plugins des Dify-Teams, kann aber über den Dify-Erweiterungs-Marketplace installiert werden.
Dieses Plugin beinhaltet derzeit zwei Hauptwerkzeuge:
- Stapelverarbeitung: Ruft Daten aus einem oder mehreren Bereichen in einer Tabellenkalkulation ab.
- Stapelaktualisierung: Aktualisiert mehrere Bereiche innerhalb desselben Vorgangs.
Diese Funktionen können als Werkzeuge in einen Workflow integriert oder einem Agenten bei Bedarf zur Verfügung gestellt werden. Zur Konfiguration benötigen Sie Folgendes:
- A Google-Konto mit Zugriff auf Google Cloud.
- Un Projekt erstellt auf Google Cloud.
- La Google Sheets API aktiviert.
- Ein Servicekonto mit einem Schlüssel im JSON-Format.
- A gemeinsames Blatt mit der E-Mail-Adresse dieses Kontos.
Das Dienstkonto fungiert als separate Identität. Daher nutzt Dify weder direkt Ihr persönliches Google-Konto noch kann es automatisch auf alle Ihre Tabellen zugreifen. Es hat nur Zugriff auf die Dokumente, die Sie explizit freigeben.
So erstellen Sie ein Dienstkonto in Google Cloud
Im ersten Schritt rufen Sie die Google Cloud Console auf und erstellen ein neues Projekt oder wählen ein bestehendes aus. Öffnen Sie im Projekt den Bereich „APIs und Dienste“, gehen Sie zur Bibliothek und suchen Sie nach … Google Sheets APITippen Sie anschließend auf die Option, um sie zu aktivieren.
Als Nächstes geben Sie Folgendes ein: IAM und Administration > Dienstkonten und erstellen Sie ein neues Konto. Sie können ihm einen Namen geben, der die Verwendung leicht erkennbar macht, zum Beispiel „Dify Google Sheets“.
Während dieses Prozesses bietet Google Ihnen möglicherweise die Option an, Rollen innerhalb des Projekts zuzuweisen. Für diese Integration ist es nicht erforderlich, eine allgemeine Inhaber- oder Bearbeiterrolle für das gesamte Projekt zuzuweisen. Der Zugriff auf einzelne Tabellenblätter wird später über die Freigabeoptionen von Google Tabellen gesteuert.
Sobald das Konto erstellt wurde:
- Öffnen Sie Ihre Daten im Bereich „Servicekonten“.
- Wechseln Sie zum Tab Schlüssel.
- Klicken Sie auf Schlüssel hinzufügen > Neuen Schlüssel erstellen.
- Wählen Sie das Format aus JSON.
- Laden Sie die Datei herunter und speichern Sie sie. an einem sicheren Ort.
Die JSON-Datei enthält sensible Informationen, darunter einen privaten Schlüssel. Sie dürfen diese Datei weder veröffentlichen, per E-Mail versenden noch in ein Repository hochladen. Jeder, der diesen Schlüssel erhält, könnte mit den Berechtigungen des Dienstkontos agieren.
So installieren und konfigurieren Sie das Plugin auf Dify
Öffnen Sie in Dify den Plugin Marketplace und suchen Sie nach dem von [Name des Entwicklers] veröffentlichten Google Sheets-Add-on. omlucPrüfen Sie vor der Installation den Namen des Autors, um Verwechslungen mit anderen Erweiterungen zu vermeiden, die möglicherweise andere Funktionen bieten.
Öffnen Sie nach der Installation die Anmeldeinformationen des Plugins. Das Formular fordert den Dienstkontoschlüssel an. Öffnen Sie die heruntergeladene JSON-Datei mit einem Texteditor. Kopieren Sie den gesamten Inhalt. und fügen Sie es in das entsprechende Feld ein..
Kopieren Sie nicht nur die E-Mail-Adresse, die Projekt-ID oder den privaten Schlüssel separat. Das Add-on benötigt die vollständige JSON-Struktur, um Anfragen an Google Sheets zu authentifizieren.
Speichern Sie anschließend die Zugangsdaten und öffnen Sie die gewünschte Tabellenkalkulation. In der JSON-Datei finden Sie ein Feld namens client_emailDeren Wert etwa so aussehen wird:
[email protected]Klicken Sie auf Aktie Fügen Sie in Google Sheets diese Adresse hinzu, als wäre es ein anderer Benutzer:
- Erteilt die Erlaubnis an Leser Dify wird nur Daten konsultieren.
- Erteilt die Erlaubnis an Editor falls Sie auch Zellen aktualisieren müssen.
Es wird nicht empfohlen, die Tabelle öffentlich über einen Link zu teilen. Mit dem Dienstkonto können Sie das Dokument privat halten und den Zugriff auf bestimmte Benutzer beschränken.
Wie man Daten aus Google Sheets aus einem Workflow liest
Um Informationen aus dem Tabellenblatt abzurufen, fügen Sie dem Dify-Workflow einen Werkzeugknoten hinzu und wählen Sie die Aktion aus. StapelverarbeitungDas Add-in ermöglicht es Ihnen, mehrere Bereiche in einem einzigen Vorgang abzufragen, wodurch vermieden wird, für jeden Abschnitt der Tabelle einen separaten Knoten erstellen zu müssen.
Sie müssen die Tabellenkennung angeben. Diese befindet sich in der Webadresse zwischen /d/ y /editIn einer URL mit dieser Struktur:
https://docs.google.com/spreadsheets/d/IDENTIFICADOR/editSie dürfen nur den als gekennzeichneten Wert verwenden. IDENTIFICADOR.
Sie müssen außerdem den Tab-Namen und den Bereich mithilfe der Google Sheets-Notation angeben. Einige Beispiele wären:
Clientes!A2:D50
Productos!A:C
Pedidos!B2:B20Der Name vor dem Ausrufezeichen entspricht dem Tabulator. Die nachfolgenden Buchstaben und Zahlen begrenzen die abzurufenden Spalten und Zeilen.
Anschließend können Sie das Ergebnis an einen LLM-Knoten übergeben, um es zusammenzufassen, einen Datensatz zu finden oder eine Antwort vorzubereiten. Es empfiehlt sich, das Modell anzuweisen, nur die abgerufenen Daten zu verwenden und deutlich zu kennzeichnen, wenn keine Übereinstimmung gefunden wird, insbesondere wenn das Tabellenblatt Kunden-, Bestands- oder Bestellinformationen enthält.
Wie aktualisiert man Zellen aus Dify?
Das Werkzeug Stapelaktualisierung Es ermöglicht das Schreiben von Werten in verschiedenen Bereichen. Dies kann beispielsweise verwendet werden, um den Status einer Aufgabe zu ändern, eine KI-generierte Klassifizierung zu speichern oder das Ergebnis einer Anfrage hinzuzufügen.
Bevor Sie es verwenden, vergewissern Sie sich, dass das Dienstkonto über Bearbeitungsberechtigungen für das Dokument verfügt. Wenn es nur Leseberechtigungen hat, funktionieren Abfragen zwar, aber Google lehnt Schreibversuche ab.
Es ist außerdem ratsam, zu verhindern, dass das Modell frei einen beliebigen Bereich oder Wert wählt. Eine sicherere Konfiguration besteht aus: Zuerst sollten die Daten validiert, die veränderbaren Spalten eingeschränkt und der Bereich mithilfe von Kontrollvariablen erstellt werden. durch den Arbeitsablauf.
Sie können den Prozess beispielsweise folgendermaßen organisieren:
- El Der Benutzer gibt eine Bestellnummer ein..
- Batch Get wird wieder in die Warteschlange gestellt. entsprechend.
- Ein bedingter Knoten Prüfen, ob die Bestellung existiert.
- Das Modell analysiert oder klassifiziert die Informationen.
- Batch-Update schreibt das Ergebnis in einer bestimmten Spalte.
- Der Ausgabeknoten bestätigt, welcher Datensatz geändert wurde.
Verwenden Sie nach Möglichkeit während der Einrichtung eine Testtabelle. Ein fehlerhaftes Update kann vorhandene Daten überschreiben, insbesondere wenn der Bereich mehr Zeilen oder Spalten umfasst als beabsichtigt.
Häufige Fehler bei der Verbindung von Dify mit Google Sheets
Falls ein Authentifizierungsfehler auftritt, überprüfen Sie, ob Sie die vollständige JSON-Datei eingefügt haben und ob deren Formatierung nicht verändert wurde. Private Schlüssel enthalten Zeilenumbrüche, die innerhalb der Dokumentstruktur erhalten bleiben müssen.
Wenn Dify meldet, dass das Tabellenblatt nicht gefunden oder darauf nicht zugegriffen werden kann, überprüfen Sie folgende Punkte:
- Die Google Sheets API ist im richtigen Projekt aktiviert.
- Das Tabellenblatt wurde mit dem genauen Wert von geteilt.
client_email. - Die Blattkennung enthält keine zusätzlichen Teile der URL.
- Der Tabulatorname stimmt überein, einschließlich Groß- und Kleinschreibung, Leerzeichen und Akzenten.
- Der Bereich verwendet eine gültige Notation, wie zum Beispiel
Datos!A2:C20. - Das Konto verfügt über Bearbeitungsberechtigungen, wenn der Workflow versucht, Daten zu schreiben.
Wenn Sie den Schlüssel in Google Cloud gelöscht oder deaktiviert haben, müssen Sie einen neuen erstellen und die in Dify gespeicherten Anmeldeinformationen ersetzen. Sie sollten auch einen neuen Schlüssel generieren, wenn Sie vermuten, dass die JSON-Datei offengelegt wurde.
Unterschiede zwischen den Google Sheets- und Google Drive-Plugins
Google Sheets und Google Drive sollten nicht als eine einzige Integration betrachtet werden. Das Sheets-Community-Plugin ist für Folgendes gedacht: Zellbereiche anzeigen und bearbeiten über ein Servicekonto.
Im Gegensatz dazu verwendet das offizielle Google Drive-Plugin, das als Datenquelle verfügbar ist, OAuth 2.0Es ermöglicht Ihnen, Ordner zu durchsuchen, Dateien aufzulisten und deren Inhalte herunterzuladen, um sie weiterzuverarbeiten oder in einen Dify-Wissensstrom zu integrieren.
Der Drive-Connector ist schreibgeschützt: Er erstellt keine Dateien, organisiert keine Ordner und ändert oder löscht keine Dokumente. Beim Herunterladen nativer Dateien aus Google Workspace werden diese automatisch in kompatible Formate exportiert. Google Tabellen werden in XLSX-Dateien konvertiert, während Google Docs und Google Präsentationen als PDFs exportiert werden.
Daher müssen Sie die Integration entsprechend der Aufgabenstellung auswählen:
- Verwenden Sie das Plugin für Google Tabellen Werte in Zellen lesen oder schreiben.
- Verwenden Sie die Datenquelle von Google Drive Dateien suchen und herunterladen.
- Kombinieren Sie beides nur dann, wenn der Workflow sowohl mit Zellen als auch mit ganzen Dokumenten arbeiten muss.
Wie man die Integration mit n8n erweitert
Das Google Sheets-Add-on ist nützlich für Aktionen von Dify ausführenEs deckt jedoch nicht alle Automatisierungsszenarien allein ab. Wenn Sie Trigger, geplante Ausführungen oder Verbindungen zu mehreren Anwendungen benötigen, können Sie diese hinzufügen. n8n als Vermittler.
In dieser Architektur, Dify kann die Daten an einen n8n-Webhook senden. über eine HTTP-Anfrage. n8n empfängt die Anfrage. Es führt seine Google Sheets-Knoten aus und gibt das Ergebnis an den Workflow zurück..
Der Vorgang lässt sich auch umkehren. Beispielsweise kann n8n eine neue Zeile erkennen, deren Werte verarbeiten und die API einer auf Dify veröffentlichten Anwendung aufrufen. Das KI-generierte Ergebnis kann dann in eine andere Spalte desselben Tabellenblatts geschrieben werden.
Dieses System ermöglicht die Erstellung von Automatisierungen wie beispielsweise:
- Automatische Kategorisierung der in ein Blatt eingetragenen Antworten.
- Generiere Zusammenfassungen zu einem bestimmten Zeitpunkt.
- Datensätze aktualisieren und gleichzeitig eine Benachrichtigung versenden.
- Kombinieren Sie Daten aus Google Sheets mit E-Mails, CRM-Systemen oder anderen Anwendungen.
- Validierungen müssen durchgeführt werden, bevor die KI eine Zelle verändern darf.
Im Gegenzug ist die Konfiguration komplexer und erfordert den Schutz der Webhooks, Anmeldeinformationen und API-Schlüssel, die von beiden Diensten verwendet werden.
Durch die Verbindung von Dify mit Google Sheets verwandeln Sie herkömmliche Tabellenkalkulationen in eine leicht zugängliche Informationsquelle für Ihre Mitarbeiter oder Arbeitsabläufe. Am einfachsten aktivieren Sie die Sheets API, erstellen ein Dienstkonto, installieren das Plugin und teilen anschließend nur die benötigten Tabellenblätter mit Ihrer E-Mail-Adresse.
Von dort aus, Mit Batch Get können Sie Bereiche abfragen, und Batch Update schreibt die Ergebnisse.Wenn das Projekt mit vollständigen Dokumenten arbeiten, auf Ereignisse reagieren oder mehrere Anwendungen koordinieren muss, können Sie dieses Setup mit Google Drive oder n8n ergänzen, ohne die Funktionen der einzelnen Tools zu verwechseln.
Ich bin ein Technik-Enthusiast, der seine „Geek“-Interessen zum Beruf gemacht hat. Ich habe mehr als 10 Jahre meines Lebens damit verbracht, modernste Technologie zu nutzen und aus purer Neugier an allen möglichen Programmen herumzubasteln. Mittlerweile habe ich mich auf Computertechnik und Videospiele spezialisiert. Das liegt daran, dass ich seit mehr als fünf Jahren für verschiedene Websites zum Thema Technologie und Videospiele schreibe und Artikel erstelle, die Ihnen die Informationen, die Sie benötigen, in einer für jeden verständlichen Sprache vermitteln möchten.
Bei Fragen reicht mein Wissen von allem rund um das Windows-Betriebssystem bis hin zu Android für Mobiltelefone. Und mein Engagement gilt Ihnen, ich bin immer bereit, ein paar Minuten zu investieren und Ihnen bei der Lösung aller Fragen in dieser Internetwelt zu helfen.