Ako prepojiť Dify s Tabuľkami Google a Diskom Google

Ak chcete, aby vaši agenti s umelou inteligenciou pracovali so skutočnými a aktuálnymi informáciami, prepojenie Dify s Tabuľkami Google Je to jeden z najjednoduchších spôsobov, ako to dosiahnuť. Tabuľkový procesor môže slúžiť ako malé úložisko údajov, z ktorého sa dajú vyhľadávať produkty, zákazníci, úlohy alebo akékoľvek iné záznamy používané vašou aplikáciou.

Táto integrácia umožňuje pracovnému postupu Dify čítať rôzne rozsahy a zapisovať nové hodnoty bez nutnosti manuálneho kopírovania údajov. Môžete napríklad vytvoriť sprievodcu, ktorý kontroluje stav objednávky, kategorizuje odpovede formulára alebo aktualizuje tabuľku po spracovaní požiadavky.

Existuje niekoľko spôsobov, ako to urobiť. Najpriamejšia trasa používa Doplnok Google Tabuľky a účet služby Google CloudAk potrebujete automaticky reagovať na zmeny, spúšťať naplánované úlohy alebo kombinovať tabuľkový procesor s inými aplikáciami, môžete použiť aj sprostredkovateľskú platformu, ako napríklad n8n.

Čo potrebujete na prepojenie Dify s Tabuľkami Google

Predtým, ako začneme, je dobré objasniť, že doplnok omluc/google_sheets Tento komunitný doplnok je dostupný na Dify Marketplace. Nie je súčasťou oficiálnych doplnkov vyvinutých tímom Dify, hoci sa dá nainštalovať z ich trhu s rozšíreniami.

Tento plugin v súčasnosti obsahuje dva hlavné nástroje:

• Dávkové získanie: načíta údaje z jedného alebo viacerých rozsahov v tabuľkovom hárku.
• Dávková aktualizácia: aktualizuje viacero rozsahov v rámci tej istej operácie.

Tieto funkcie je možné pridať ako nástroje v rámci pracovného postupu alebo ich sprístupniť agentovi na použitie podľa potreby. Na ich konfiguráciu budete potrebovať:

• A Účet Google s prístupom do služby Google Cloud.
• Un projekt vytvorený v službe Google Cloud.
• La API pre Tabuľky Google povolené.
• Servisný účet s kľúč vo formáte JSON.
• A zdieľaný hárok s e-mailovou adresou daného účtu.

Servisný účet funguje ako samostatná identita. Dify preto priamo nepoužíva váš osobný účet Google ani nemôže automaticky pristupovať ku všetkým vašim tabuľkám. Bude mať prístup iba k dokumentom, ktoré s ním explicitne zdieľate.

Ako vytvoriť servisný účet v službe Google Cloud

Prvým krokom je prejsť do konzoly Google Cloud a vytvoriť nový projekt alebo vybrať existujúci. V rámci projektu otvorte sekciu API a služby, prejdite do knižnice a vyhľadajte... API pre Tabuľky GooglePotom klepnutím na možnosť ju aktivujte.

Ďalej zadajte IAM a administrácia > Servisné účty a vytvorte si nový účet. Môžete mu dať názov, ktorý uľahčí identifikáciu jeho účelu, napríklad „Dify Google Sheets“.

Počas tohto procesu vám Google môže ponúknuť možnosť priradiť role v rámci projektu. Pre túto integráciu nemusíte priradiť rolu všeobecného vlastníka alebo editora pre celý projekt. Prístup ku konkrétnym tabuľkám sa neskôr riadi prostredníctvom možností zdieľania v Tabuľkách Google.

Po vytvorení účtu:

1. Otvorte si svoje údaje v sekcii servisných účtov.
2. Prejdite na kartu Kľúče.
3. Kliknite na Pridať kľúč > Vytvoriť nový kľúč.
4. Vyberte formát JSON.
5. Stiahnite a uložte súbor na bezpečnom mieste.

Súbor JSON obsahuje citlivé informácie vrátane súkromného kľúča. Nesmiete ho publikovať, posielať e-mailom ani nahrávať do úložiska. Každý, kto tento kľúč získa, môže konať s povoleniami servisného účtu.

Ako nainštalovať a nakonfigurovať doplnok v Dify

V aplikácii Dify otvorte Plugin Marketplace a vyhľadajte doplnok Google Sheets publikovaný spoločnosťou omlucPred inštaláciou si overte meno autora, aby ste si ho nezamenili s inými rozšíreniami, ktoré môžu ponúkať iné funkcie.

Po inštalácii otvorte nastavenia poverení pluginu. Formulár bude vyžadovať kľúč servisného účtu. Otvorte stiahnutý súbor JSON pomocou textového editora. skopírovať celý jeho obsah a vložte ho do príslušného poľa.

Nekopírujte samostatne iba e-mail, ID projektu alebo súkromný kľúč. Doplnok vyžaduje na overenie požiadaviek odoslaných do Tabuliek Google kompletnú štruktúru JSON.

Potom uložte prihlasovacie údaje a otvorte tabuľku, ktorú chcete použiť. V súbore JSON nájdete pole s názvom client_email, ktorého hodnota bude mať podobný vzhľad:

[email protected]

Kliknite na Zdieľať v Tabuľkách Google a pridajte túto adresu, ako keby išlo o iného používateľa:

• Udeľuje povolenie čitateľ ak Dify bude iba konzultovať údaje.
• Udeľuje povolenie redaktor ak potrebujete aktualizovať aj bunky.

Verejné zdieľanie tabuľky prostredníctvom odkazu sa neodporúča. Servisný účet vám umožňuje udržať dokument súkromný a obmedziť prístup na konkrétneho používateľa.

Ako čítať údaje z Tabuliek Google z pracovného postupu

Ak chcete načítať informácie z hárka, pridajte do pracovného postupu Dify uzol nástroja a vyberte akciu Dávkové získanieDoplnok umožňuje dotazovať viacero rozsahov v rámci jednej operácie, čím sa vyhnete nutnosti vytvárať iný uzol pre každú sekciu tabuľky.

Budete musieť zadať identifikátor tabuľky. Ten sa zobrazuje v jej webovej adrese medzi /d/ y /editV URL adrese s touto štruktúrou:

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

Musíte použiť iba hodnotu označenú ako IDENTIFICADOR.

Budete tiež musieť zadať názov a rozsah tabulátora pomocou notácie v Tabuľkách Google. Niektoré príklady by mohli byť:

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

Názov pred výkričníkom zodpovedá tabulátoru. Nasledujúce písmená a čísla vymedzujú stĺpce a riadky, ktoré sa majú načítať.

Výsledok potom môžete odovzdať uzlu LLM, aby ho zhrnul, vyhľadal záznam alebo pripravil odpoveď. Je vhodné dať modelu pokyn, aby používal iba načítané údaje a jasne označil, kedy nenájde zhodu, najmä ak hárok obsahuje informácie o zákazníkoch, zásobách alebo objednávkach.

Ako aktualizovať bunky z Dify

Nástroj Dávková aktualizácia Umožňuje zapisovať hodnoty v rôznych rozsahoch. Toto sa dá použiť napríklad na zmenu stavu úlohy, uloženie klasifikácie vygenerovanej umelou inteligenciou alebo pridanie výsledku požiadavky.

Pred použitím overte, či má servisný účet povolenia na úpravu dokumentu. Ak má iba povolenia na čítanie, dotazy budú fungovať, ale Google bude odmietať pokusy o zápis.

Taktiež je vhodné zabrániť modelu vo voľnom výbere ľubovoľného rozsahu alebo hodnoty. Bezpečnejšia konfigurácia pozostáva z Najprv overte údaje, obmedzte modifikovateľné stĺpce a vytvorte rozsah pomocou riadených premenných. prostredníctvom pracovného postupu.

Napríklad môžete proces zorganizovať takto:

1. El používateľ zadá číslo objednávky.
2. Dávkové získanie sa vracia do fronty zodpovedajúce.
3. Podmienený uzol skontrolujte, či objednávka existuje.
4. Model analyzuje alebo klasifikuje informácie.
5. Dávková aktualizácia zapíše výsledok v konkrétnom stĺpci.
6. Výstupný uzol potvrdí, ktorý záznam bol upravený.

Vždy, keď je to možné, použite počas nastavovania testovaciu tabuľku. Zle vytvorená aktualizácia môže prepísať existujúce informácie, najmä ak rozsah pokrýva viac riadkov alebo stĺpcov, ako bolo zamýšľané.

Bežné chyby pri prepojení Dify s Tabuľkami Google

Ak sa vyskytne chyba overenia, overte, či ste vložili celý súbor JSON a či jeho formát nebol zmenený. Súkromné ​​kľúče obsahujú zalomenia riadkov, ktoré musia byť v štruktúre dokumentu zachované.

Keď Dify signalizuje, že nemôže nájsť alebo získať prístup k hárku, skontrolujte tieto body:

• Rozhranie API pre Tabuľky Google je povolené v správnom projekte.
• Hárok bol zdieľaný s presnou hodnotou client_email.
• Identifikátor hárka neobsahuje žiadne ďalšie časti URL adresy.
• Názov tabulátora sa zhoduje vrátane veľkých písmen, medzier a diakritiky.
• Rozsah používa platný zápis, napríklad Datos!A2:C20.
• Účet má povolenie editora, ak sa pracovný postup pokúsi o zápis.

Ak ste kľúč v službe Google Cloud odstránili alebo deaktivovali, budete musieť vytvoriť nový a nahradiť ním prihlasovacie údaje uložené v službe Dify. Nový kľúč by ste mali vygenerovať aj v prípade podozrenia, že súbor JSON bol odhalený.

Rozdiely medzi doplnkami Tabuľky Google a Disk Google

Tabuľky Google a Disk Google by sa nemali považovať za jednu integráciu. Doplnok komunity Tabuliek je určený pre zobraziť a upraviť rozsahy buniek prostredníctvom servisného účtu.

Naproti tomu oficiálny doplnok služby Disk Google, ktorý je k dispozícii ako zdroj údajov, používa OAuth 2.0Umožňuje vám prehliadať priečinky, zobrazovať súbory a sťahovať ich obsah na spracovanie alebo začlenenie do streamu znalostí Dify.

Konektor Disku je iba na čítanie: nevytvára súbory, neusporiada priečinky ani neupravuje ani neodstraňuje dokumenty. Keď si stiahnete natívne súbory z Google Workspace, automaticky ich exportuje do kompatibilných formátov. Tabuľky Google sa konvertujú na súbory XLSX, zatiaľ čo Dokumenty Google a Prezentácie Google sa exportujú ako súbory PDF.

Preto si musíte vybrať integráciu podľa úlohy:

• Použite plugin pre Tabuľky Google čítať alebo zapisovať hodnoty do buniek.
• Použite zdroj údajov Disk Google na vyhľadanie a stiahnutie súborov.
• Kombinujte obe možnosti iba v prípade, že pracovný postup potrebuje pracovať s bunkami a celými dokumentmi.

Ako rozšíriť integráciu pomocou n8n

Doplnok Tabuľky Google je užitočný pre vykonávať akcie z DifySamotná ponuka však nepokrýva všetky scenáre automatizácie. Ak potrebujete spúšťače, plánované spustenia alebo pripojenia k viacerým aplikáciám, môžete umiestniť n8n ako sprostredkovateľ.

V tejto architektúre, Dify môže odoslať dáta do webhooku n8n prostredníctvom HTTP požiadavky. n8n prijme požiadavku, Vykoná svoje uzly v Tabuľkách Google a vráti výsledok do pracovného postupu..

Proces môžete vykonať aj obrátene. Napríklad n8n dokáže zistiť nový riadok, spracovať jeho hodnoty a zavolať API aplikácie publikovanej na Dify. Výsledok vygenerovaný umelou inteligenciou sa potom môže zapísať do iného stĺpca v tom istom hárku.

Tento systém vám umožňuje vytvárať automatizácie, ako napríklad:

• Automaticky klasifikovať odpovede pridané do hárka.
• Generujte súhrny v konkrétnom čase.
• Aktualizovať záznamy a zároveň odoslať oznámenie.
• Kombinujte údaje z Tabuliek Google s e-mailom, CRM alebo inými aplikáciami.
• Pred povolením umelej inteligencii upraviť bunku použite validácie.

Na oplátku je konfigurácia zložitejšia a vyžaduje ochranu webhookov, prihlasovacích údajov a kľúčov API používaných oboma službami.

Prepojenie Dify s Tabuľkami Google vám umožňuje transformovať štandardnú tabuľku na ľahko dostupný zdroj informácií pre agentov alebo pracovné postupy. Najpriamejším prístupom je povoliť rozhranie Sheets API, vytvoriť si servisný účet, nainštalovať doplnok a zdieľať iba potrebné tabuľky s vašou e-mailovou adresou.

Odtiaľ, Funkcia Batch Get umožňuje dotazovať rozsahy a funkcia Batch Update zapisuje výsledky.Ak je potrebné v rámci projektu pracovať s kompletnými dokumentmi, reagovať na udalosti alebo koordinovať viacero aplikácií, môžete toto nastavenie doplniť o Disk Google alebo n8n bez toho, aby ste si museli mýliť funkcie jednotlivých nástrojov.