Jak połączyć Dify z Arkuszami Google i Dyskiem Google

Jeśli chcesz, aby Twoi agenci AI pracowali na prawdziwych i aktualnych informacjach, połącz Dify z Arkuszami Google To jeden z najprostszych sposobów osiągnięcia tego celu. Arkusz kalkulacyjny może pełnić funkcję małego repozytorium danych, z którego można wyszukiwać produkty, klientów, zadania lub dowolne inne rekordy używane przez aplikację.

Ta integracja umożliwia przepływowi pracy Dify odczytywanie różnych zakresów i zapisywanie nowych wartości bez konieczności ręcznego kopiowania danych. Na przykład, można utworzyć kreator, który sprawdza status zamówienia, kategoryzuje odpowiedzi z formularza lub aktualizuje tabelę po przetworzeniu żądania.

Istnieje kilka sposobów, aby to zrobić. Najbardziej bezpośrednia trasa wykorzystuje Wtyczka Arkuszy Google i konto usługi Google CloudJeśli chcesz automatycznie reagować na zmiany, uruchamiać zaplanowane zadania lub połączyć arkusz kalkulacyjny z innymi aplikacjami, możesz także skorzystać z platformy pośredniczącej, takiej jak n8n.

Czego potrzebujesz, aby połączyć Dify z Arkuszami Google

Zanim zaczniemy, warto wyjaśnić, że dodatek omluc/arkusz_google Dostępna w Dify Marketplace, jest to wtyczka społecznościowa. Nie jest częścią oficjalnych wtyczek opracowanych przez zespół Dify, chociaż można ją zainstalować z ich sklepu z rozszerzeniami.

Ta wtyczka obecnie zawiera dwa główne narzędzia:

• Pobieranie wsadowe: pobiera dane z jednego lub więcej zakresów arkusza kalkulacyjnego.
• Aktualizacja zbiorcza: aktualizuje wiele zakresów w ramach tej samej operacji.

Funkcje te można dodać jako narzędzia w ramach przepływu pracy lub udostępnić agentowi do użycia w razie potrzeby. Aby je skonfigurować, potrzebne będą:

• A Konto Google z dostępem do Google Cloud.
• Un projekt utworzony w Google Cloud.
• La Interfejs API Arkuszy Google włączone.
• Konto usługi z klucz w formacie JSON.
• A współdzielony arkusz z adresem e-mail tego konta.

Konto usługi działa jako odrębna tożsamość. Dlatego Dify nie korzysta bezpośrednio z Twojego osobistego konta Google ani nie może automatycznie uzyskiwać dostępu do wszystkich Twoich arkuszy kalkulacyjnych. Będzie miało dostęp tylko do dokumentów, które wyraźnie mu udostępnisz.

Jak utworzyć konto usługi w Google Cloud

Pierwszym krokiem jest przejście do Konsoli Google Cloud i utworzenie nowego projektu lub wybranie istniejącego. W projekcie otwórz sekcję API i usługi, przejdź do biblioteki i wyszukaj… Interfejs API Arkuszy GoogleNastępnie dotknij opcji, aby ją włączyć.

Następnie wprowadź IAM i administracja > Konta usługowe i utwórz nowe konto. Możesz nadać mu nazwę, która ułatwi identyfikację jego przeznaczenia, na przykład „Dify Google Sheets”.

W trakcie tego procesu Google może zaoferować Ci możliwość przypisania ról w projekcie. W przypadku tej integracji nie musisz przypisywać roli ogólnego właściciela ani redaktora dla całego projektu. Dostęp do konkretnych arkuszy jest później kontrolowany za pomocą opcji udostępniania w Arkuszach Google.

Po utworzeniu konta:

1. Otwórz swoje dane w sekcji kont usługowych.
2. Przejdź do zakładki Klawiatura.
3. Kliknij na Dodaj klucz > Utwórz nowy klucz.
4. Wybierz format JSON.
5. Pobierz i zapisz plik w bezpiecznym miejscu.

Plik JSON zawiera poufne informacje, w tym klucz prywatny. Nie wolno go publikować, wysyłać e-mailem ani przesyłać do repozytorium. Każdy, kto uzyska ten klucz, może działać z uprawnieniami konta usługi.

Jak zainstalować i skonfigurować wtyczkę w Dify

W Dify otwórz Plugin Marketplace i wyszukaj dodatek Google Sheets opublikowany przez omlucPrzed instalacją sprawdź nazwisko autora, aby nie pomylić go z innymi rozszerzeniami, które mogą oferować odmienne funkcje.

Po instalacji otwórz ustawienia poświadczeń wtyczki. Formularz poprosi o klucz konta usługi. Otwórz pobrany plik JSON w edytorze tekstu. skopiuj całą jego zawartość i wklej go w odpowiednim polu.

Nie kopiuj osobno tylko adresu e-mail, identyfikatora projektu ani klucza prywatnego. Dodatek wymaga pełnej struktury JSON do uwierzytelniania żądań wysyłanych do Arkuszy Google.

Następnie zapisz dane uwierzytelniające i otwórz arkusz kalkulacyjny, którego chcesz użyć. W pliku JSON znajdziesz pole o nazwie client_email, którego wartość będzie wyglądać podobnie do tej:

[email protected]

Kliknij na Udział w Arkuszach Google i dodaj ten adres tak, jakby był to adres innego użytkownika:

• Udziela pozwolenia na czytelnik jeśli Dify będzie jedynie konsultować dane.
• Udziela pozwolenia na redaktor jeśli chcesz również zaktualizować komórki.

Publiczne udostępnianie arkusza kalkulacyjnego za pośrednictwem linku nie jest zalecane. Konto usługi pozwala zachować prywatność dokumentu i ograniczyć dostęp do niego do konkretnego użytkownika.

Jak odczytać dane z Arkuszy Google z poziomu przepływu pracy

Aby pobrać informacje z arkusza, dodaj węzeł narzędzia do przepływu pracy Dify i wybierz akcję Pobieranie wsadoweDodatek umożliwia wykonywanie zapytań obejmujących wiele zakresów w ramach jednej operacji, co eliminuje konieczność tworzenia osobnego węzła dla każdej sekcji tabeli.

Będziesz musiał podać identyfikator arkusza kalkulacyjnego. Znajduje się on w jego adresie internetowym, pomiędzy /d/ y /editW adresie URL o takiej strukturze:

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

Należy używać wyłącznie wartości oznaczonej jako IDENTIFICADOR.

Będziesz musiał również określić nazwę i zakres karty, korzystając z notacji Arkuszy Google. Oto kilka przykładów:

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

Nazwa przed wykrzyknikiem odpowiada karcie. Litery i cyfry, które następują po niej, ograniczają kolumny i wiersze do pobrania.

Następnie możesz przekazać wynik do węzła LLM w celu jego podsumowania, zlokalizowania rekordu lub przygotowania odpowiedzi. Zaleca się poinstruowanie modelu, aby korzystał wyłącznie z pobranych danych i wyraźnie sygnalizował, gdy nie znajdzie dopasowania, zwłaszcza jeśli arkusz zawiera informacje o kliencie, stanie magazynowym lub zamówieniu.

Jak aktualizować komórki z Dify

Narzędzie Aktualizacja zbiorcza Umożliwia zapisywanie wartości w różnych zakresach. Można tego użyć na przykład do zmiany statusu zadania, zapisania klasyfikacji wygenerowanej przez sztuczną inteligencję lub dodania wyniku zapytania.

Przed użyciem sprawdź, czy konto usługi ma uprawnienia edytora dokumentu. Jeśli ma tylko uprawnienia do odczytu, zapytania będą działać, ale Google będzie odrzucać próby zapisu.

Zaleca się również uniemożliwienie modelowi swobodnego wyboru dowolnego zakresu lub wartości. Bardziej bezpieczna konfiguracja składa się z: Najpierw sprawdź poprawność danych, ogranicz liczbę modyfikowalnych kolumn i utwórz zakres, używając zmiennych kontrolowanych. przez cały przepływ pracy.

Na przykład możesz zorganizować proces w następujący sposób:

1. El użytkownik wprowadza numer zamówienia.
2. Batch Get wraca do linii odpowiedni.
3. Węzeł warunkowy sprawdź czy zamówienie istnieje.
4. Model analizuje lub klasyfikuje informacje.
5. Aktualizacja wsadowa zapisuje wynik w konkretnej kolumnie.
6. Węzeł wyjściowy potwierdza, który rekord został zmodyfikowany.

W miarę możliwości korzystaj z arkusza kalkulacyjnego podczas konfiguracji. Źle skonstruowana aktualizacja może nadpisać istniejące informacje, zwłaszcza gdy zakres obejmuje więcej wierszy lub kolumn niż zamierzono.

Typowe błędy przy łączeniu Dify z Arkuszami Google

W przypadku wystąpienia błędu uwierzytelniania sprawdź, czy wkleiłeś cały plik JSON i czy jego format nie został zmieniony. Klucze prywatne zawierają podziały wierszy, które muszą być zachowane w strukturze dokumentu.

Jeśli Dify wskazuje, że nie może znaleźć arkusza lub uzyskać do niego dostępu, sprawdź następujące punkty:

• Interfejs API Arkuszy Google jest włączony w odpowiednim projekcie.
• Arkusz udostępniono z dokładną wartością client_email.
• Identyfikator arkusza nie zawiera żadnych dodatkowych części adresu URL.
• Nazwa zakładki jest taka sama, łącznie z kapitalizacją, spacjami i akcentami.
• Zakres wykorzystuje prawidłową notację, taką jak Datos!A2:C20.
• Konto ma uprawnienia edytora, jeśli przepływ pracy próbuje zapisać.

Jeśli usunąłeś lub dezaktywowałeś klucz w Google Cloud, musisz utworzyć nowy i zastąpić dane logowania zapisane w Dify. Powinieneś również wygenerować nowy klucz, jeśli podejrzewasz, że plik JSON został ujawniony.

Różnice między wtyczkami Arkuszy Google i Dysku Google

Arkuszy Google i Dysku Google nie należy traktować jako jednej integracji. Wtyczka społecznościowa Arkuszy jest przeznaczona do: przeglądaj i modyfikuj zakresy komórek poprzez konto usługi.

W przeciwieństwie do tego oficjalna wtyczka Google Drive dostępna jako źródło danych wykorzystuje OAuth 2.0Umożliwia przeglądanie folderów, tworzenie list plików i pobieranie ich zawartości w celu przetwarzania lub włączenia do strumienia wiedzy Dify.

Konektor Dysku działa tylko do odczytu: nie tworzy plików, nie porządkuje folderów ani nie modyfikuje ani nie usuwa dokumentów. Po pobraniu plików natywnych z Google Workspace, automatycznie eksportuje je do zgodnych formatów. Arkusze Google są konwertowane do plików XLSX, a Dokumenty Google i Prezentacje Google są eksportowane do plików PDF.

Dlatego należy wybrać integrację w zależności od zadania:

• Użyj wtyczki do Arkusze Google do odczytywania lub zapisywania wartości w komórkach.
• Użyj źródła danych Dysk Google aby zlokalizować i pobrać pliki.
• Połącz oba rozwiązania tylko wtedy, gdy przepływ pracy musi obejmować komórki i całe dokumenty.

Jak rozszerzyć integrację za pomocą n8n

Dodatek Arkuszy Google jest przydatny dla wykonaj czynności z DifyJednak samo w sobie nie obejmuje wszystkich scenariuszy automatyzacji. Jeśli potrzebujesz wyzwalaczy, zaplanowanych wykonań lub połączeń z wieloma aplikacjami, możesz umieścić n8n jako pośrednik.

W tej architekturze, Dify może wysłać dane do webhooka n8n za pośrednictwem żądania HTTP. n8n odbiera żądanie, Wykonuje węzły Arkuszy Google i zwraca wynik do przepływu pracy.

Można również odwrócić ten proces. Na przykład, n8n może wykryć nowy wiersz, przetworzyć jego wartości i wywołać API aplikacji opublikowanej w Dify. Wynik wygenerowany przez sztuczną inteligencję można następnie zapisać w innej kolumnie w tym samym arkuszu.

System ten umożliwia tworzenie automatyzacji takich jak:

• Automatycznie klasyfikuj odpowiedzi dodane do arkusza.
• Generuj podsumowania w określonym czasie.
• Aktualizuj rekordy i wysyłaj powiadomienia w tym samym czasie.
• Połącz dane z Arkuszy Google z danymi z poczty e-mail, CRM i innych aplikacji.
• Zastosuj walidacje przed zezwoleniem sztucznej inteligencji na modyfikację komórki.

W zamian konfiguracja jest bardziej złożona i wymaga ochrony webhooków, danych uwierzytelniających i kluczy API używanych przez obie usługi.

Połączenie Dify z Arkuszami Google pozwala przekształcić standardowy arkusz kalkulacyjny w łatwo dostępne źródło informacji dla agentów lub przepływów pracy. Najprostszym sposobem jest włączenie API Arkuszy, utworzenie konta usługi, zainstalowanie wtyczki i udostępnienie tylko niezbędnych arkuszy na swoim adresie e-mail.

Stamtąd, Funkcja Batch Get umożliwia zapytanie o zakresy, a funkcja Batch Update zapisuje wyniki.Jeśli projekt wymaga pracy z kompletnymi dokumentami, reagowania na zdarzenia lub koordynowania wielu aplikacji, możesz uzupełnić tę konfigurację o Dysk Google lub n8n, nie myląc funkcji każdego narzędzia.