Sådan forbinder du Dify med Google Sheets og Google Drive

Hvis du ønsker, at dine AI-agenter skal arbejde med reel og opdateret information, Forbind Dify med Google Sheets Det er en af ​​de enkleste måder at opnå dette på. Regnearket kan fungere som et lille datalager, hvorfra man kan forespørge på produkter, kunder, opgaver eller enhver anden post, der bruges af din applikation.

Denne integration gør det muligt for en Dify-workflow at læse forskellige intervaller og skrive nye værdier uden manuel datakopiering. Du kan f.eks. oprette en guide, der kontrollerer ordrestatus, kategoriserer formularsvar eller opdaterer en tabel efter behandling af en anmodning.

Der er flere måder at gøre dette på. Den mest direkte rute bruger en Google Sheets-plugin og en Google Cloud-tjenestekontoHvis du har brug for at reagere automatisk på ændringer, køre planlagte opgaver eller kombinere regnearket med andre applikationer, kan du også bruge en mellemliggende platform som n8n.

Relateret artikel:

Sådan installeres og konfigureres Dify med Docker trin for trin

Hvad du skal bruge for at forbinde Dify med Google Sheets

Før vi begynder, er det værd at præcisere, at tilføjelsen omluc/google_sheets Dette er et community-plugin, der er tilgængeligt på Dify Marketplace. Det er ikke en del af de officielle plugins, der er udviklet af Dify-teamet, selvom det kan installeres fra deres udvidelsesmarkedsplads.

Dette plugin indeholder i øjeblikket to hovedværktøjer:

• Batch-hentning: henter data fra et eller flere områder i et regneark.
• Batchopdatering: opdaterer flere områder i samme operation.

Disse funktioner kan tilføjes som værktøjer i en arbejdsgang eller stilles til rådighed for en agent til brug efter behov. For at konfigurere dem skal du bruge:

• EN Google-konto med adgang til Google Cloud.
• Un projekt oprettet på Google Cloud.
• La Google Sheets API aktiveret.
• En servicekonto med en nøgle i JSON-format.
• EN delt ark med e-mailadressen for den konto.

Servicekontoen fungerer som en separat identitet. Derfor bruger Dify ikke direkte din personlige Google-konto, og den kan heller ikke automatisk få adgang til alle dine regneark. Den vil kun have adgang til de dokumenter, du eksplicit deler med den.

Sådan opretter du en servicekonto på Google Cloud

Det første trin er at gå til Google Cloud Console og oprette et nyt projekt eller vælge et eksisterende. I projektet skal du åbne afsnittet API'er og tjenester, gå til biblioteket og søge efter... Google Sheets APITryk derefter på indstillingen for at aktivere den.

Indtast derefter IAM og administration > Servicekonti og opret en ny konto. Du kan give den et navn, der gør det nemt at identificere, hvad den bruges til, f.eks. "Dify Google Sheets".

Under denne proces kan Google tilbyde dig muligheden for at tildele roller inden for projektet. For denne integration behøver du ikke at tildele en generel ejer- eller redaktørrolle for hele projektet. Adgang til specifikke regneark styres senere via delingsmulighederne i Google Sheets.

Når kontoen er oprettet:

1. Åbn dine oplysninger fra afsnittet med servicekonti.
2. Gå til fanen Nøgler.
3. Klik på Tilføj nøgle > Opret en ny nøgle.
4. Vælg formatet JSON.
5. Download og gem filen på et sikkert sted.

JSON-filen indeholder følsomme oplysninger, herunder en privat nøgle. Du må ikke offentliggøre den, sende den via e-mail eller uploade den til et arkiv. Enhver, der får fat i denne nøgle, kan handle med servicekontoens tilladelser.

Sådan installerer og konfigurerer du plugin'et på Dify

I Dify skal du åbne Plugin Marketplace og søge efter Google Sheets-tilføjelsen udgivet af omlucTjek forfatterens navn, før du installerer det, for at undgå at forveksle det med andre udvidelser, der muligvis tilbyder andre funktioner.

Efter installationen skal du åbne pluginets loginindstillinger. Formularen vil anmode om servicekontonøglen. Åbn den downloadede JSON-fil med en teksteditor. kopier alt indholdet og indsæt det i det tilsvarende felt.

Kopier ikke kun e-mailadressen, projekt-ID'et eller den private nøgle separat. Tilføjelsen kræver den komplette JSON-struktur for at godkende anmodninger til Google Sheets.

Gem derefter loginoplysningerne og åbn det regneark, du vil bruge. Inde i JSON-filen finder du et felt kaldet client_email, hvis værdi vil se sådan ud:

[email protected]

Klik på Dele i Google Sheets og tilføj den adresse, som om det var en anden bruger:

• Giver tilladelse til læser hvis Dify kun vil konsultere data.
• Giver tilladelse til redaktør hvis du også skal opdatere celler.

Det anbefales ikke at dele regnearket offentligt via et link. Servicekontoen giver dig mulighed for at holde dokumentet privat og begrænse adgangen til en bestemt bruger.

Sådan læser du data fra Google Sheets fra en arbejdsgang

For at hente oplysninger fra arket skal du tilføje en værktøjsnode til Dify-arbejdsgangen og vælge handlingen Batch HentTilføjelsesprogrammet giver dig mulighed for at forespørge på flere områder i én handling, hvilket undgår at skulle oprette en forskellig node for hver sektion af tabellen.

Du skal angive regnearkets id. Dette vises i dets webadresse mellem /d/ y /editI en URL med denne struktur:

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

Du må kun bruge den værdi, der er markeret som IDENTIFICADOR.

Du skal også angive fanebladnavnet og -området ved hjælp af Google Sheets-notation. Nogle eksempler ville være:

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

Navnet før udråbstegnet svarer til tabulatoren. Bogstaverne og tallene, der følger, afgrænser de kolonner og rækker, der skal hentes.

Du kan derefter sende resultatet til en LLM-node for at opsummere det, finde en post eller forberede et svar. Det er tilrådeligt at instruere modellen til kun at bruge de hentede data og tydeligt angive, når den ikke finder et match, især hvis arket indeholder kunde-, lager- eller ordreoplysninger.

Sådan opdaterer du celler fra Dify

Værktøjet Batchopdatering Det giver dig mulighed for at skrive værdier i forskellige intervaller. Dette kan for eksempel bruges til at ændre status for en opgave, gemme en AI-genereret klassificering eller tilføje resultatet af en anmodning.

Før du bruger den, skal du kontrollere, at servicekontoen har redigeringstilladelser til dokumentet. Hvis den kun har læsetilladelser, vil forespørgsler fungere, men Google vil afvise skriveforsøg.

Det er også tilrådeligt at forhindre modellen i frit at vælge et hvilket som helst interval eller værdi. En mere sikker konfiguration består af Valider først dataene, begræns antallet af modificerbare kolonner, og opbyg intervallet ved hjælp af kontrollerede variabler. gennem arbejdsgangen.

For eksempel kan du organisere processen således:

1. El brugeren indtaster et ordrenummer.
2. Batch Get kommer tilbage i køen tilsvarende.
3. En betinget node tjek om ordren findes.
4. Modellen analyserer eller klassificerer informationen.
5. Batchopdatering skriver resultatet i en bestemt kolonne.
6. Outputnoden bekræfter, hvilken post der er blevet ændret.

Brug, når det er muligt, et testregneark under opsætningen. En dårligt konstrueret opdatering kan overskrive eksisterende oplysninger, især når området dækker flere rækker eller kolonner end beregnet.

Almindelige fejl ved forbindelse af Dify med Google Sheets

Hvis du støder på en godkendelsesfejl, skal du kontrollere, at du har indsat hele JSON-filen, og at dens format ikke er blevet ændret. Private nøgler indeholder linjeskift, der skal opretholdes i dokumentstrukturen.

Når Dify angiver, at den ikke kan finde eller få adgang til arket, skal du kontrollere disse punkter:

• Google Sheets API er aktiveret i det korrekte projekt.
• Arket er blevet delt med den nøjagtige værdi af client_email.
• Ark-id'et indeholder ingen yderligere dele af URL'en.
• Fanebladnavnet matcher, inklusive store bogstaver, mellemrum og accenter.
• Intervallet bruger en gyldig notation, f.eks. Datos!A2:C20.
• Kontoen har redigeringstilladelse, hvis arbejdsgangen forsøger at skrive.

Hvis du har slettet eller deaktiveret nøglen i Google Cloud, skal du oprette en ny og erstatte de loginoplysninger, der er gemt i Dify. Du bør også generere en ny nøgle, hvis du har mistanke om, at JSON-filen er blevet eksponeret.

Forskelle mellem Google Sheets- og Google Drive-plugins

Google Sheets og Google Drive bør ikke behandles som én enkelt integration. Sheets-fællesskabspluginnet er beregnet til se og rediger celleområder via en servicekonto.

I modsætning hertil bruger det officielle Google Drive-plugin, der er tilgængeligt som datakilde, en OAuth 2.0Det giver dig mulighed for at gennemse mapper, liste filer og downloade deres indhold til behandling eller inkorporering i en Dify-vidensstrøm.

Drive-connectoren er skrivebeskyttet: den opretter ikke filer, organiserer ikke mapper eller ændrer eller sletter dokumenter. Når du downloader native filer fra Google Workspace, eksporteres de automatisk til kompatible formater. Google Sheets konverteres til XLSX-filer, mens Google Docs og Google Slides eksporteres som PDF-filer.

Derfor skal du vælge integrationen i henhold til opgaven:

• Brug plugin'et til Google Regneark at læse eller skrive værdier i celler.
• Brug datakilden fra Google Drev at finde og downloade filer.
• Kombiner kun begge, hvis arbejdsgangen skal arbejde med celler og hele dokumenter.

Sådan udvider du integrationen ved hjælp af n8n

Google Sheets-tilføjelsen er nyttig til udfør handlinger fra DifyDen dækker dog ikke alle automatiseringsscenarier alene. Hvis du har brug for udløsere, planlagte udførelser eller forbindelser til flere applikationer, kan du placere n8n som mellemmand.

I denne arkitektur, Dify kan sende dataene til en n8n webhook via en HTTP-anmodning. n8n modtager anmodningen, Den udfører sine Google Sheets-noder og returnerer resultatet til arbejdsgangen.

Du kan også vende processen om. For eksempel kan n8n registrere en ny række, behandle dens værdier og kalde API'en for en applikation, der er udgivet på Dify. Det AI-genererede resultat kan derefter skrives til en anden kolonne i det samme ark.

Dette system giver dig mulighed for at oprette automatiseringer såsom:

• Klassificer automatisk de svar, der er tilføjet til et ark.
• Generer opsummeringer på et bestemt tidspunkt.
• Opdater poster og send en besked på samme tid.
• Kombinér data fra Google Sheets med e-mail, CRM eller andre applikationer.
• Anvend valideringer, før du tillader AI at ændre en celle.

Til gengæld er konfigurationen mere kompleks og kræver beskyttelse af webhooks, legitimationsoplysninger og API-nøgler, der bruges af begge tjenester.

Ved at forbinde Dify med Google Sheets kan du omdanne et standardregneark til en lettilgængelig informationskilde for agenter eller arbejdsgange. Den mest direkte fremgangsmåde er at aktivere Sheets API'en, oprette en servicekonto, installere pluginnet og kun dele de nødvendige ark med din e-mailadresse.

Derfra, Batch Get giver dig mulighed for at forespørge på intervaller, og Batch Update skriver resultater.Hvis projektet skal arbejde med komplette dokumenter, reagere på begivenheder eller koordinere flere applikationer, kan du supplere denne opsætning med Google Drive eller n8n uden at forveksle funktionerne i hvert værktøj.

Relateret artikel:

Sådan opretter du en AI-assistent uden at skrive en eneste linje kode ved hjælp af Dify

Alberto Navarro

Jeg er en teknologientusiast, der har vendt sine "nørde" interesser til et erhverv. Jeg har brugt mere end 10 år af mit liv på at bruge avanceret teknologi og pille ved alle slags programmer af ren nysgerrighed. Nu har jeg specialiseret mig i computerteknologi og videospil. Dette skyldes, at jeg i mere end 5 år har skrevet til forskellige hjemmesider om teknologi og videospil, og lavet artikler, der søger at give dig den information, du har brug for, på et sprog, der er forståeligt for alle.

Har du spørgsmål, så spænder min viden fra alt relateret til Windows styresystemet samt Android til mobiltelefoner. Og mit engagement er over for dig, jeg er altid villig til at bruge et par minutter og hjælpe dig med at løse eventuelle spørgsmål, du måtte have i denne internetverden.