Hur man ansluter Dify till Google Sheets och Google Drive

Om du vill att dina AI-agenter ska arbeta med verklig och aktuell information, anslut Dify med Google Sheets Det är ett av de enklaste sätten att uppnå detta. Kalkylbladet kan fungera som ett litet datalager från vilket du kan söka efter produkter, kunder, uppgifter eller andra poster som används av din applikation.

Denna integration gör det möjligt för ett Dify-arbetsflöde att läsa olika intervall och skriva nya värden utan att manuell datakopiering krävs. Du kan till exempel skapa en guide som kontrollerar orderstatus, kategoriserar formulärsvar eller uppdaterar en tabell efter att en begäran har bearbetats.

Det finns flera sätt att göra detta. Den mest direkta vägen använder en Google Sheets-plugin och ett Google Cloud-tjänstkontoOm du behöver reagera automatiskt på ändringar, köra schemalagda uppgifter eller kombinera kalkylbladet med andra program kan du också använda en mellanliggande plattform som n8n.

Vad du behöver för att ansluta Dify till Google Sheets

Innan vi börjar är det värt att förtydliga att tillägget omluc/google_sheets Detta är ett community-plugin, som finns tillgängligt på Dify Marketplace. Det är inte en del av de officiella plugins som utvecklats av Dify-teamet, även om det kan installeras från deras marknadsplats för tillägg.

Detta plugin innehåller för närvarande två huvudverktyg:

• Batch Hämta: hämtar data från ett eller flera områden i ett kalkylblad.
• Batchuppdatering: uppdaterar flera områden inom samma operation.

Dessa funktioner kan läggas till som verktyg i ett arbetsflöde eller göras tillgängliga för en agent för användning vid behov. För att konfigurera dem behöver du:

• En Google-konto med åtkomst till Google Cloud.
• Un projekt skapat på Google Cloud.
• La Google Sheets API aktiverad.
• Ett servicekonto med en nyckel i JSON-format.
• En delat ark med e-postadressen för det kontot.

Tjänstkontot fungerar som en separat identitet. Därför använder Dify inte direkt ditt personliga Google-konto, och kan inte heller automatiskt komma åt alla dina kalkylblad. Det kommer bara att ha åtkomst till de dokument som du uttryckligen delar med det.

Hur man skapar ett tjänstkonto på Google Cloud

Det första steget är att gå till Google Cloud Console och skapa ett nytt projekt eller välja ett befintligt. I projektet öppnar du avsnittet API:er och tjänster, går till biblioteket och söker efter... Google Sheets APITryck sedan på alternativet för att aktivera det.

Ange sedan IAM och administration > Tjänstkonton och skapa ett nytt konto. Du kan ge det ett namn som gör det enkelt att identifiera vad det används till, till exempel "Dify Google Sheets".

Under den här processen kan Google erbjuda dig möjligheten att tilldela roller inom projektet. För den här integrationen behöver du inte tilldela en generell ägare eller redigeringsroll för hela projektet. Åtkomst till specifika ark styrs senare via delningsalternativen i Google Sheets.

När kontot har skapats:

1. Öppna dina uppgifter från avsnittet för servicekonton.
2. Gå till fliken Nycklar.
3. Klicka på Lägg till nyckel > Skapa en ny nyckel.
4. Välj format JSON.
5. Ladda ner och spara filen på en säker plats.

JSON-filen innehåller känslig information, inklusive en privat nyckel. Du får inte publicera den, skicka den via e-post eller ladda upp den till ett datalager. Alla som får tag på nyckeln kan agera med tjänstkontots behörigheter.

Hur man installerar och konfigurerar plugin-programmet på Dify

I Dify, öppna Plugin Marketplace och sök efter Google Sheets-tillägget som publicerats av omlucKontrollera författarens namn innan du installerar det för att undvika att förväxla det med andra tillägg som kan erbjuda andra funktioner.

Efter installationen öppnar du plugin-programmets inloggningsinställningar. Formuläret kommer att begära servicekontonyckeln. Öppna den nedladdade JSON-filen med en textredigerare. kopiera allt dess innehåll och klistra in den i motsvarande fält.

Kopiera inte bara e-postadressen, projekt-ID:t eller den privata nyckeln separat. Tillägget kräver hela JSON-strukturen för att autentisera förfrågningar till Google Sheets.

Spara sedan inloggningsuppgifterna och öppna kalkylbladet du vill använda. Inuti JSON-filen hittar du ett fält som heter client_email, vars värde kommer att se ut ungefär så här:

[email protected]

Klicka på Dela i Google Sheets och lägg till den adressen som om det vore en annan användare:

• Ger tillstånd att läsare om Dify endast kommer att konsultera data.
• Ger tillstånd att redaktör om du också behöver uppdatera celler.

Det rekommenderas inte att dela kalkylarket offentligt via en länk. Tjänstkontot låter dig hålla dokumentet privat och begränsa åtkomsten till en specifik användare.

Hur man läser data från Google Sheets från ett arbetsflöde

För att hämta information från arket, lägg till en verktygsnod i Dify-arbetsflödet och välj åtgärden Batch HämtaTillägget låter dig fråga flera områden i en enda operation, vilket undviker att behöva skapa en annan nod för varje avsnitt i tabellen.

Du måste ange kalkylbladets identifierare. Denna visas i webbadressen, mellan /d/ y /editI en URL med denna struktur:

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

Du får endast använda värdet som är markerat som IDENTIFICADOR.

Du måste också ange fliknamnet och intervallet med hjälp av Google Sheets-notation. Några exempel skulle vara:

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

Namnet före utropstecknet motsvarar tabbtangenten. Bokstäverna och siffrorna som följer avgränsar de kolumner och rader som ska hämtas.

Du kan sedan skicka resultatet till en LLM-nod för att sammanfatta det, hitta en post eller förbereda ett svar. Det är lämpligt att instruera modellen att endast använda den hämtade informationen och att tydligt ange när den inte hittar en matchning, särskilt om arket innehåller kund-, lager- eller orderinformation.

Hur man uppdaterar celler från Dify

Verktyget Batchuppdatering Det låter dig skriva värden i olika intervall. Detta kan till exempel användas för att ändra statusen för en uppgift, spara en AI-genererad klassificering eller lägga till resultatet av en begäran.

Innan du använder det, kontrollera att tjänstkontot har redigeringsbehörighet för dokumentet. Om det bara har läsbehörighet kommer frågor att fungera, men Google kommer att avvisa skrivförsök.

Det är också lämpligt att förhindra att modellen fritt väljer något intervall eller värde. En säkrare konfiguration består av Validera först data, begränsa de modifierbara kolumnerna och bygg intervallet med hjälp av kontrollerade variabler. genom arbetsflödet.

Du kan till exempel organisera processen så här:

1. El användaren anger ett ordernummer.
2. Batch Get kommer tillbaka i kön motsvarande.
3. En villkorlig nod kontrollera om ordern finns.
4. Modellen analyserar eller klassificerar informationen.
5. Batchuppdatering skriver resultatet i en specifik kolumn.
6. Utgångsnoden bekräftar vilken post som har ändrats.

Använd när det är möjligt ett testkalkylblad under installationen. En dåligt konstruerad uppdatering kan skriva över befintlig information, särskilt när intervallet täcker fler rader eller kolumner än vad som är avsett.

Vanliga misstag när man kopplar Dify till Google Sheets

Om du stöter på ett autentiseringsfel, kontrollera att du har klistrat in hela JSON-filen och att dess format inte har ändrats. Privata nycklar innehåller radbrytningar som måste bibehållas inom dokumentstrukturen.

När Dify indikerar att den inte kan hitta eller komma åt arket, kontrollera dessa punkter:

• Google Sheets API är aktiverat i rätt projekt.
• Arket har delats med det exakta värdet av client_email.
• Ark-ID:n innehåller inga ytterligare delar av URL:en.
• Fliknamnet matchar, inklusive versaler, mellanslag och accenter.
• Intervallet använder en giltig notation, till exempel Datos!A2:C20.
• Kontot har redigeringsbehörighet om arbetsflödet försöker skriva.

Om du har raderat eller inaktiverat nyckeln i Google Cloud måste du skapa en ny och ersätta de inloggningsuppgifter som sparats i Dify. Du bör också generera en ny nyckel om du misstänker att JSON-filen har exponerats.

Skillnader mellan Google Sheets- och Google Drive-pluginen

Google Sheets och Google Drive bör inte behandlas som en enda integration. Sheets community-plugin är avsett för visa och ändra cellintervall via ett servicekonto.

Däremot använder det officiella Google Drive-pluginet som är tillgängligt som datakälla en OAuth 2.0Det låter dig bläddra bland mappar, lista filer och ladda ner deras innehåll för bearbetning eller införlivande i en Dify-kunskapsström.

Drive-anslutningen är skrivskyddad: den skapar inte filer, organiserar inte mappar eller ändrar eller tar inte bort dokument. När du laddar ner inbyggda filer från Google Workspace exporteras de automatiskt till kompatibla format. Google Sheets konverteras till XLSX-filer, medan Google Docs och Google Slides exporteras som PDF-filer.

Därför måste du välja integrationen enligt uppgiften:

• Använd pluginet för Google Kalkylark att läsa eller skriva värden i celler.
• Använd datakällan för Google Drive för att hitta och ladda ner filer.
• Kombinera båda endast om arbetsflödet behöver arbeta med celler och hela dokument.

Hur man utökar integrationen med n8n

Google Sheets-tillägget är användbart för utföra åtgärder från DifyDen täcker dock inte alla automatiseringsscenarier på egen hand. Om du behöver utlösare, schemalagda körningar eller kopplingar till flera applikationer kan du placera n8n som mellanhand.

I denna arkitektur, Dify kan skicka data till en n8n webhook via en HTTP-förfrågan. n8n tar emot förfrågan, Den kör sina Google Sheets-noder och returnerar resultatet till arbetsflödet..

Du kan också vända processen. Till exempel kan n8n upptäcka en ny rad, bearbeta dess värden och anropa API:et för en applikation publicerad på Dify. Det AI-genererade resultatet kan sedan skrivas till en annan kolumn i samma ark.

Det här systemet låter dig skapa automatiseringar som:

• Klassificera automatiskt svaren som läggs till i ett ark.
• Generera sammanfattningar vid en specifik tidpunkt.
• Uppdatera register och skicka ett meddelande samtidigt.
• Kombinera data från Google Sheets med e-post, CRM eller andra appar.
• Tillämpa valideringar innan AI tillåts ändra en cell.

I gengäld är konfigurationen mer komplex och kräver att webhooks, autentiseringsuppgifter och API-nycklar som används av båda tjänsterna skyddas.

Genom att ansluta Dify till Google Sheets kan du omvandla ett vanligt kalkylblad till en lättillgänglig informationskälla för agenter eller arbetsflöden. Det mest direkta tillvägagångssättet är att aktivera Sheets API, skapa ett servicekonto, installera plugin-programmet och endast dela de nödvändiga ark med din e-postadress.

Därifrån, Batch Get låter dig fråga intervall och Batch Update skriver resultat.Om projektet behöver arbeta med kompletta dokument, reagera på händelser eller koordinera flera applikationer kan du komplettera den här konfigurationen med Google Drive eller n8n utan att blanda ihop funktionerna hos varje verktyg.