Hoe verbind je Dify met Google Sheets en Google Drive?

Als je wilt dat je AI-agenten met echte en actuele informatie werken, Verbind Dify met Google Sheets Dit is een van de eenvoudigste manieren om dit te bereiken. De spreadsheet kan fungeren als een kleine gegevensopslagplaats van waaruit u producten, klanten, taken of andere gegevens kunt opvragen die door uw applicatie worden gebruikt.

Deze integratie maakt het mogelijk dat een Dify-workflow verschillende bereiken leest en nieuwe waarden schrijft zonder dat handmatige gegevenskopie nodig is. U kunt bijvoorbeeld een wizard maken die de orderstatus controleert, formulierreacties categoriseert of een tabel bijwerkt na het verwerken van een aanvraag.

Er zijn verschillende manieren om dit te doen. De meest directe route maakt gebruik van een De Google Sheets-plug-in en een Google Cloud-serviceaccount.Als u automatisch op wijzigingen wilt reageren, geplande taken wilt uitvoeren of de spreadsheet met andere toepassingen wilt combineren, kunt u ook een tussenplatform zoals n8n gebruiken.

Gerelateerd artikel:

Stapsgewijze handleiding voor het installeren en configureren van Dify met Docker

Wat je nodig hebt om Dify met Google Sheets te verbinden

Voordat we beginnen, is het goed om te verduidelijken dat de add-on omluc/google_sheets Deze community-plugin is beschikbaar in de Dify Marketplace. Het is geen onderdeel van de officiële plugins die door het Dify-team zijn ontwikkeld, hoewel hij wel via hun extensiemarktplaats kan worden geïnstalleerd.

Deze plugin bevat momenteel twee belangrijke tools:

• Batch ophalen: Haalt gegevens op uit een of meer bereiken in een spreadsheet.
• Batch-update: Meerdere bereiken binnen dezelfde bewerking worden bijgewerkt.

Deze functies kunnen als hulpmiddelen aan een workflow worden toegevoegd of beschikbaar worden gesteld aan een agent voor gebruik naar behoefte. Om ze te configureren, hebt u het volgende nodig:

• A Google-account met toegang tot Google Cloud.
• Un project gemaakt op Google Cloud.
• La Google Sheets API ingeschakeld.
• Een serviceaccount met een sleutel in JSON-formaat.
• A gedeeld blad met het e-mailadres van dat account.

Het serviceaccount functioneert als een aparte identiteit. Dify gebruikt daarom niet rechtstreeks uw persoonlijke Google-account en heeft ook geen automatische toegang tot al uw spreadsheets. Het heeft alleen toegang tot de documenten die u expliciet met Dify deelt.

Hoe maak je een serviceaccount aan in Google Cloud?

De eerste stap is om naar de Google Cloud Console te gaan en een nieuw project aan te maken of een bestaand project te selecteren. Open binnen het project het gedeelte API's en services, ga naar de bibliotheek en zoek naar... Google Sheets APITik vervolgens op de optie om deze in te schakelen.

Vervolgens voert u in IAM en beheer > Serviceaccounts Maak een nieuw account aan. Je kunt het een naam geven die gemakkelijk te herkennen is waarvoor het gebruikt wordt, bijvoorbeeld "Dify Google Sheets".

Tijdens dit proces kan Google u de optie bieden om rollen binnen het project toe te wijzen. Voor deze integratie hoeft u geen algemene eigenaar- of bewerkerrol voor het hele project toe te wijzen. De toegang tot specifieke spreadsheets wordt later beheerd via de deelopties van Google Sheets.

Zodra het account is aangemaakt:

1. U kunt uw gegevens openen via het gedeelte 'Serviceaccounts'.
2. Ga naar het tabblad Sleutels.
3. Klik op Sleutel toevoegen > Een nieuwe sleutel aanmaken.
4. Selecteer het formaat JSON.
5. Download en sla het bestand op. op een veilige plek.

Het JSON-bestand bevat gevoelige informatie, waaronder een privésleutel. U mag het niet publiceren, via e-mail verzenden of uploaden naar een repository. Iedereen die deze sleutel verkrijgt, kan handelen met de machtigingen van het serviceaccount.

Hoe installeer en configureer je de plugin op Dify?

Open in Dify de Plugin Marketplace en zoek naar de Google Sheets-add-on die is gepubliceerd door omlucControleer de naam van de auteur voordat u de extensie installeert om verwarring met andere extensies met mogelijk andere functies te voorkomen.

Na de installatie opent u de instellingen voor de inloggegevens van de plugin. Het formulier vraagt ​​om de serviceaccountsleutel. Open het gedownloade JSON-bestand met een teksteditor. kopieer alle inhoud en plak het in het daarvoor bestemde veld..

Kopieer niet alleen het e-mailadres, de project-ID of de privésleutel afzonderlijk. De add-on heeft de volledige JSON-structuur nodig om verzoeken aan Google Sheets te authenticeren.

Sla vervolgens de inloggegevens op en open het spreadsheet dat u wilt gebruiken. In het JSON-bestand vindt u een veld met de naam client_email, waarvan de waarde er ongeveer zo uit zal zien:

[email protected]

Klik op Deel Voeg dat adres toe in Google Sheets alsof het een andere gebruiker betreft:

• Verleent toestemming aan lezer als Dify alleen gegevens raadpleegt.
• Verleent toestemming aan editor als u ook cellen moet bijwerken.

Het is niet aan te raden om de spreadsheet openbaar te delen via een link. Met het serviceaccount kunt u het document privé houden en de toegang beperken tot een specifieke gebruiker.

Hoe lees je gegevens uit Google Sheets vanuit een workflow?

Om informatie uit het spreadsheet op te halen, voegt u een toolknooppunt toe aan de Dify-workflow en selecteert u de actie. Batch GetMet de add-in kunt u meerdere bereiken in één bewerking opvragen, waardoor het niet nodig is om voor elk deel van de tabel een apart knooppunt aan te maken.

U moet de spreadsheet-identificatiecode opgeven. Deze vindt u in het webadres, tussen de volgende regels: /d/ y /editIn een URL met deze structuur:

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

U mag alleen de waarde gebruiken die is gemarkeerd als IDENTIFICADOR.

Je moet ook de tabnaam en het bereik specificeren met behulp van de Google Sheets-notatie. Enkele voorbeelden zijn:

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

De naam vóór het uitroepteken komt overeen met het tabblad. De letters en cijfers die volgen, geven de kolommen en rijen aan die moeten worden opgehaald.

Je kunt het resultaat vervolgens doorgeven aan een LLM-node om het samen te vatten, een record te vinden of een reactie voor te bereiden. Het is raadzaam om het model te instrueren alleen de opgehaalde gegevens te gebruiken en duidelijk aan te geven wanneer er geen overeenkomst wordt gevonden, vooral als het spreadsheet klant-, voorraad- of orderinformatie bevat.

Hoe cellen van Dify bij te werken

Het gereedschap Batch-update Hiermee kunt u waarden in verschillende bereiken invoeren. Dit kan bijvoorbeeld worden gebruikt om de status van een taak te wijzigen, een door AI gegenereerde classificatie op te slaan of het resultaat van een verzoek toe te voegen.

Controleer voordat u het gebruikt of het serviceaccount bewerkingsrechten heeft voor het document. Als het alleen leesrechten heeft, werken zoekopdrachten wel, maar zal Google pogingen om te schrijven weigeren.

Het is ook raadzaam te voorkomen dat het model vrijelijk een bereik of waarde kiest. Een veiligere configuratie bestaat uit: Valideer eerst de gegevens, beperk de aanpasbare kolommen en construeer het bereik met behulp van gecontroleerde variabelen. via de workflow.

Je kunt het proces bijvoorbeeld als volgt organiseren:

1. El De gebruiker voert een ordernummer in..
2. Batch Get sluit weer aan in de rij. overeenkomend.
3. Een voorwaardelijk knooppunt controleren of de bestelling bestaat.
4. Het model analyseert of classificeert de informatie.
5. Batch Update schrijft het resultaat weg. in een specifieke kolom.
6. Het uitvoerknooppunt bevestigt welke record is gewijzigd.

Gebruik indien mogelijk een testspreadsheet tijdens de configuratie. Een slecht opgestelde update kan bestaande informatie overschrijven, vooral wanneer het bereik meer rijen of kolommen omvat dan de bedoeling is.

Veelgemaakte fouten bij het koppelen van Dify aan Google Sheets

Als u een authenticatiefout tegenkomt, controleer dan of u het volledige JSON-bestand hebt geplakt en of de opmaak ervan niet is gewijzigd. Privésleutels bevatten regeleinden die binnen de documentstructuur behouden moeten blijven.

Als Dify aangeeft dat het het werkblad niet kan vinden of openen, controleer dan de volgende punten:

• De Google Sheets API is ingeschakeld in het juiste project.
• Het blad is gedeeld met de exacte waarde van client_email.
• De bladidentificatiecode bevat geen extra onderdelen van de URL.
• De tabnaam komt overeen, inclusief hoofdletters, spaties en accenten.
• Het bereik maakt gebruik van een geldige notatie, zoals Datos!A2:C20.
• Het account heeft bewerkingsrechten als de workflow probeert te schrijven.

Als je de sleutel in Google Cloud hebt verwijderd of gedeactiveerd, moet je een nieuwe aanmaken en de in Dify opgeslagen inloggegevens vervangen. Je moet ook een nieuwe sleutel genereren als je vermoedt dat het JSON-bestand is blootgesteld.

Verschillen tussen de Google Sheets- en Google Drive-plug-ins

Google Sheets en Google Drive moeten niet als één geïntegreerde oplossing worden beschouwd. De Sheets community-plugin is bedoeld voor Celbereiken bekijken en wijzigen via een serviceaccount.

Daarentegen maakt de officiële Google Drive-plug-in, die beschikbaar is als gegevensbron, gebruik van OAuth 2.0Het programma stelt je in staat om door mappen te bladeren, bestanden weer te geven en de inhoud ervan te downloaden voor verwerking of integratie in een Dify-kennisstroom.

De Drive-connector is alleen-lezen: hij maakt geen bestanden aan, organiseert geen mappen en wijzigt of verwijdert geen documenten. Wanneer u bestanden downloadt vanuit Google Workspace, worden deze automatisch geëxporteerd naar compatibele formaten. Google Sheets worden geconverteerd naar XLSX-bestanden, terwijl Google Docs en Google Slides worden geëxporteerd als PDF's.

U moet daarom de integratie kiezen die het beste bij de taak past:

• Gebruik de plugin voor Google Sheets Om waarden in cellen te lezen of te schrijven.
• Gebruik de gegevensbron van Google Drive om bestanden te lokaliseren en te downloaden.
• Combineer beide methoden alleen als de workflow zowel met cellen als met complete documenten moet werken.

Hoe breid je integratie uit met n8n?

De Google Sheets-add-on is handig voor Voer acties uit vanuit DifyHet dekt echter niet alle automatiseringsscenario's op zichzelf. Als u triggers, geplande uitvoeringen of verbindingen met meerdere applicaties nodig hebt, kunt u die daar plaatsen. n8n als tussenpersoon.

In deze architectuur, Dify kan de gegevens naar een n8n-webhook sturen. via een HTTP-verzoek. n8n ontvangt het verzoek. Het voert de bijbehorende Google Sheets-knooppunten uit en stuurt het resultaat terug naar de workflow..

Je kunt het proces ook omkeren. N8n kan bijvoorbeeld een nieuwe rij detecteren, de waarden ervan verwerken en de API aanroepen van een applicatie die op Dify is gepubliceerd. Het door AI gegenereerde resultaat kan vervolgens naar een andere kolom in hetzelfde spreadsheet worden geschreven.

Met dit systeem kunt u automatiseringen creëren zoals:

• De antwoorden die aan een spreadsheet zijn toegevoegd, worden automatisch geclassificeerd.
• Genereer samenvattingen op een specifiek tijdstip.
• Records bijwerken en tegelijkertijd een melding versturen.
• Combineer gegevens uit Google Sheets met e-mail, CRM of andere applicaties.
• Voer validaties uit voordat je AI toestaat een cel te wijzigen.

Daar tegenover staat dat de configuratie complexer is en dat de webhooks, inloggegevens en API-sleutels die door beide services worden gebruikt, beschermd moeten worden.

Door Dify te koppelen aan Google Sheets kunt u een standaard spreadsheet omzetten in een gemakkelijk toegankelijke informatiebron voor agenten of workflows. De meest directe manier is om de Sheets API in te schakelen, een serviceaccount aan te maken, de plug-in te installeren en alleen de benodigde spreadsheets te delen met uw e-mailadres.

Van daaruit, Met Batch Get kunt u bereiken opvragen en met Batch Update worden de resultaten weggeschreven.Als het project met complete documenten moet werken, op gebeurtenissen moet reageren of meerdere applicaties moet coördineren, kunt u deze configuratie aanvullen met Google Drive of n8n zonder de functies van de verschillende tools door elkaar te halen.

Gerelateerd artikel:

Hoe maak je een AI-assistent zonder ook maar één regel code te schrijven met Dify?

Alberto Navarro

Ik ben een technologieliefhebber die van zijn 'nerd'-interesses zijn beroep heeft gemaakt. Ik heb meer dan 10 jaar van mijn leven doorgebracht met het gebruik van de allernieuwste technologie en het sleutelen aan allerlei programma's uit pure nieuwsgierigheid. Nu heb ik mij gespecialiseerd in computertechnologie en videogames. Dit komt omdat ik al meer dan vijf jaar voor verschillende websites over technologie en videogames schrijf en artikelen heb gemaakt die proberen u de informatie te geven die u nodig heeft in een taal die voor iedereen begrijpelijk is.

Als je vragen hebt, mijn kennis strekt zich uit van alles wat te maken heeft met het Windows-besturingssysteem tot Android voor mobiele telefoons. En mijn toewijding is aan jou, ik ben altijd bereid om een ​​paar minuten te besteden en je te helpen bij het oplossen van eventuele vragen die je hebt in deze internetwereld.