Jak propojit Dify s Tabulkami Google a Diskem Google

Pokud chcete, aby vaši agenti s umělou inteligencí pracovali se skutečnými a aktuálními informacemi, propojení Dify s Tabulkami Google Je to jeden z nejjednodušších způsobů, jak toho dosáhnout. Tabulka může sloužit jako malé úložiště dat, ze kterého se můžete dotazovat na produkty, zákazníky, úkoly nebo jakékoli jiné záznamy používané vaší aplikací.

Tato integrace umožňuje pracovnímu postupu Dify číst různé rozsahy a zapisovat nové hodnoty bez nutnosti ručního kopírování dat. Můžete například vytvořit průvodce, který kontroluje stav objednávky, kategorizuje odpovědi na formuláře nebo aktualizuje tabulku po zpracování požadavku.

Existuje několik způsobů, jak to udělat. Nejpřímější trasa používá Plugin Google Sheets a účet služby Google CloudPokud potřebujete automaticky reagovat na změny, spouštět naplánované úlohy nebo kombinovat tabulku s jinými aplikacemi, můžete také použít zprostředkující platformu, jako je n8n.

Co potřebujete k propojení Dify s Tabulkami Google

Než začneme, je dobré si ujasnit, že doplněk omluc/google_sheets Tento plugin je k dispozici na Dify Marketplace a je určen pro komunitu. Není součástí oficiálních pluginů vyvinutých týmem Dify, i když jej lze nainstalovat z jejich trhu s rozšířeními.

Tento plugin v současné době obsahuje dva hlavní nástroje:

• Dávkové získání: načte data z jedné nebo více oblastí v tabulce.
• Dávková aktualizace: aktualizuje více rozsahů v rámci jedné operace.

Tyto funkce lze přidat jako nástroje v rámci pracovního postupu nebo je zpřístupnit agentovi k použití dle potřeby. K jejich konfiguraci budete potřebovat:

• A Účet Google s přístupem ke službě Google Cloud.
• Un projekt vytvořený v Google Cloudu.
• La API pro Tabulky Google povoleno.
• Servisní účet s klíč ve formátu JSON.
• A sdílený list s e-mailovou adresou daného účtu.

Servisní účet funguje jako samostatná identita. Dify proto přímo nepoužívá váš osobní účet Google ani nemůže automaticky přistupovat ke všem vašim tabulkám. Bude mít přístup pouze k dokumentům, které s ním explicitně sdílíte.

Jak vytvořit servisní účet ve službě Google Cloud

Prvním krokem je přejít do konzole Google Cloud a vytvořit nový projekt nebo vybrat existující. V rámci projektu otevřete sekci API a služby, přejděte do knihovny a vyhledejte... API pro Tabulky GooglePoté klepnutím na možnost ji povolte.

Dále zadejte IAM a administrace > Servisní účty a vytvořte si nový účet. Můžete mu dát název, který usnadní identifikaci jeho účelu, například „Dify Google Sheets“.

Během tohoto procesu vám Google může nabídnout možnost přiřadit role v rámci projektu. Pro tuto integraci nemusíte přiřazovat roli obecného vlastníka ani editora pro celý projekt. Přístup ke konkrétním listům je řízen později prostřednictvím možností sdílení v Tabulkách Google.

Jakmile je účet vytvořen:

1. Otevřete si své údaje v sekci servisních účtů.
2. Přejděte na kartu Klíče.
3. Klikněte na Přidat klíč > Vytvořit nový klíč.
4. Vyberte formát JSON.
5. Stáhněte a uložte soubor na bezpečném místě.

Soubor JSON obsahuje citlivé informace, včetně soukromého klíče. Nesmíte jej publikovat, posílat e-mailem ani nahrávat do repozitáře. Kdokoli, kdo tento klíč získá, by mohl jednat s oprávněními servisního účtu.

Jak nainstalovat a nakonfigurovat plugin v Dify

V Dify otevřete Plugin Marketplace a vyhledejte doplněk Google Sheets publikovaný společností omlucPřed instalací si zkontrolujte jméno autora, abyste si jej nezaměnili s jinými rozšířeními, která mohou nabízet jiné funkce.

Po instalaci otevřete nastavení přihlašovacích údajů pluginu. Formulář bude vyžadovat klíč servisního účtu. Otevřete stažený soubor JSON v textovém editoru. zkopírovat veškerý jeho obsah a vložte jej do příslušného pole.

Nekopírujte samostatně pouze e-mail, ID projektu nebo soukromý klíč. Doplněk vyžaduje kompletní strukturu JSON k ověření požadavků odeslaných do Tabulek Google.

Dále uložte přihlašovací údaje a otevřete tabulku, kterou chcete použít. Uvnitř souboru JSON najdete pole s názvem client_email, jehož hodnota bude vypadat podobně jako tato:

[email protected]

Klikněte na Podíl v Tabulkách Google a přidejte tuto adresu, jako by se jednalo o jiného uživatele:

• Uděluje povolení čtenář pokud Dify bude pouze konzultovat data.
• Uděluje povolení editor pokud potřebujete také aktualizovat buňky.

Veřejné sdílení tabulky prostřednictvím odkazu se nedoporučuje. Servisní účet umožňuje uchovávat dokument v soukromí a omezit přístup na konkrétního uživatele.

Jak číst data z Tabulek Google z pracovního postupu

Chcete-li načíst informace z listu, přidejte do pracovního postupu Dify uzel nástroje a vyberte akci Dávkové získáníDoplněk umožňuje dotazovat více rozsahů v rámci jedné operace, což eliminuje nutnost vytvářet samostatný uzel pro každou sekci tabulky.

Budete muset zadat identifikátor tabulky. Ten se zobrazí v její webové adrese mezi /d/ y /editV URL s touto strukturou:

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

Musíte použít pouze hodnotu označenou jako IDENTIFICADOR.

Budete také muset zadat název a rozsah tabulace pomocí notace Tabulek Google. Některé příklady by mohly být:

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

Název před vykřičníkem odpovídá tabulátoru. Následující písmena a číslice vymezují sloupce a řádky, které mají být načteny.

Výsledek pak můžete předat uzlu LLM, aby jej shrnul, vyhledal záznam nebo připravil odpověď. Je vhodné dát modelu pokyn, aby používal pouze načtená data a jasně označil, kdy nenajde shodu, zejména pokud list obsahuje informace o zákaznících, zásobách nebo objednávkách.

Jak aktualizovat buňky z Dify

Nástroj Dávková aktualizace Umožňuje zapisovat hodnoty v různých rozsazích. To lze použít například ke změně stavu úkolu, uložení klasifikace generované umělou inteligencí nebo přidání výsledku požadavku.

Před použitím ověřte, zda má servisní účet oprávnění editora k dokumentu. Pokud má pouze oprávnění ke čtení, dotazy budou fungovat, ale Google bude odmítat pokusy o zápis.

Je také vhodné zabránit modelu ve volném výběru libovolného rozsahu nebo hodnoty. Bezpečnější konfigurace spočívá v Nejprve ověřte data, omezte upravitelné sloupce a sestavte rozsah pomocí řízených proměnných. prostřednictvím pracovního postupu.

Například můžete proces uspořádat takto:

1. El uživatel zadá číslo objednávky.
2. Dávkové získání se vrací do fronty odpovídající.
3. Podmíněný uzel zkontrolujte, zda objednávka existuje.
4. Model analyzuje nebo klasifikuje informace.
5. Dávková aktualizace zapíše výsledek v konkrétním sloupci.
6. Výstupní uzel potvrzuje, který záznam byl upraven.

Kdykoli je to možné, použijte během nastavení testovací tabulku. Špatně vytvořená aktualizace může přepsat existující informace, zejména pokud rozsah pokrývá více řádků nebo sloupců, než bylo zamýšleno.

Časté chyby při propojování Dify s Google Sheets

Pokud narazíte na chybu ověřování, ověřte, zda jste vložili celý soubor JSON a zda jeho formát nebyl změněn. Soukromé klíče obsahují zalomení řádků, která musí být v rámci struktury dokumentu zachována.

Pokud Dify signalizuje, že list nemůže najít nebo k němu přistupovat, zkontrolujte tyto body:

• Rozhraní Google Sheets API je povoleno ve správném projektu.
• List byl sdílen s přesnou hodnotou client_email.
• Identifikátor listu neobsahuje žádné další části adresy URL.
• Název tabulace se shoduje, včetně velkých písmen, mezer a diakritiky.
• Rozsah používá platný zápis, například Datos!A2:C20.
• Účet má oprávnění editora, pokud se pracovní postup pokusí o zápis.

Pokud jste klíč v Google Cloudu smazali nebo deaktivovali, budete muset vytvořit nový a nahradit jím přihlašovací údaje uložené v Dify. Nový klíč byste měli vygenerovat také v případě podezření, že byl soubor JSON odhalen.

Rozdíly mezi pluginy Google Sheets a Google Drive

Tabulky Google a Disk Google by neměly být považovány za jednu integraci. Plugin komunity Tabulek je určen pro zobrazení a úprava oblastí buněk prostřednictvím servisního účtu.

Naproti tomu oficiální plugin Google Drive, který je k dispozici jako zdroj dat, používá OAuth 2.0Umožňuje procházet složky, seznam souborů a stahovat jejich obsah pro zpracování nebo začlenění do datového toku Dify.

Konektor Disku je pouze pro čtení: nevytváří soubory, neuspořádává složky ani neupravuje ani nemaže dokumenty. Když si stáhnete nativní soubory z Google Workspace, automaticky je exportuje do kompatibilních formátů. Tabulky Google se převedou do souborů XLSX, zatímco Dokumenty Google a Prezentace Google se exportují jako PDF.

Proto musíte zvolit integraci podle úkolu:

• Použijte plugin pro Tabulky Google číst nebo zapisovat hodnoty do buněk.
• Použijte zdroj dat Disk Google vyhledávat a stahovat soubory.
• Obojí kombinujte pouze v případě, že pracovní postup potřebuje pracovat s buňkami i celými dokumenty.

Jak rozšířit integraci pomocí n8n

Doplněk Google Sheets je užitečný pro spouštět akce z DifyNicméně, samo o sobě nepokrývá všechny scénáře automatizace. Pokud potřebujete spouštěče, plánované spuštění nebo připojení k více aplikacím, můžete umístit n8n jako zprostředkovatel.

V této architektuře, Dify může odesílat data do webhooku n8n. prostřednictvím HTTP požadavku. n8n požadavek obdrží, Spustí své uzly z Google Tabulek a vrátí výsledek do pracovního postupu..

Proces můžete také obrátit. Například n8n dokáže detekovat nový řádek, zpracovat jeho hodnoty a zavolat API aplikace publikované na Dify. Výsledek vygenerovaný umělou inteligencí pak lze zapsat do jiného sloupce ve stejném listu.

Tento systém umožňuje vytvářet automatizace, jako například:

• Automaticky klasifikovat odpovědi přidané do listu.
• Generovat souhrny v určitém čase.
• Aktualizovat záznamy a zároveň odeslat oznámení.
• Kombinujte data z Tabulek Google s e-mailem, CRM nebo jinými aplikacemi.
• Před povolením umělé inteligenci upravit buňku použijte validace.

Konfigurace je na oplátku složitější a vyžaduje ochranu webhooků, přihlašovacích údajů a klíčů API používaných oběma službami.

Propojení Dify s Google Sheets vám umožní transformovat standardní tabulku na snadno dostupný zdroj informací pro agenty nebo pracovní postupy. Nejpřímějším přístupem je povolit Sheets API, vytvořit servisní účet, nainstalovat plugin a sdílet pouze potřebné tabulky s vaší e-mailovou adresou.

Odtamtud, Funkce Batch Get umožňuje dotazovat rozsahy a funkce Batch Update zapisuje výsledky.Pokud projekt potřebuje pracovat s kompletními dokumenty, reagovat na události nebo koordinovat více aplikací, můžete toto nastavení doplnit o Google Drive nebo n8n, aniž byste si museli plést funkce jednotlivých nástrojů.