Dify'ı Google Sheets ve Google Drive ile nasıl bağlayabilirsiniz?

Yapay zekâ ajanlarınızın gerçek ve güncel bilgilerle çalışmasını istiyorsanız, Dify'ı Google Sheets ile bağlayın Bunu başarmanın en basit yollarından biri budur. Elektronik tablo, uygulamanız tarafından kullanılan ürünleri, müşterileri, görevleri veya diğer kayıtları sorgulamak için küçük bir veri deposu görevi görebilir.

Bu entegrasyon, Dify iş akışının manuel veri kopyalama gerektirmeden farklı aralıkları okumasını ve yeni değerler yazmasını sağlar. Örneğin, sipariş durumunu kontrol eden, form yanıtlarını kategorize eden veya bir isteği işledikten sonra bir tabloyu güncelleyen bir sihirbaz oluşturabilirsiniz.

Bunu yapmanın birkaç yolu var. En doğrudan yol ise şunu kullanıyor: Google Sheets eklentisi ve bir Google Cloud hizmet hesabıDeğişikliklere otomatik olarak tepki vermeniz, zamanlanmış görevleri çalıştırmanız veya elektronik tabloyu diğer uygulamalarla birleştirmeniz gerekiyorsa, n8n gibi bir aracı platform da kullanabilirsiniz.

Dify'ı Google Sheets ile bağlamak için gerekenler

Başlamadan önce, tamamlayıcı unsurun ne olduğunu açıklığa kavuşturmakta fayda var. omluc/google_sheets Dify Marketplace'te bulunan bu eklenti, bir topluluk eklentisidir. Dify ekibi tarafından geliştirilen resmi eklentilerin bir parçası değildir, ancak eklenti pazarından yüklenebilir.

Bu eklenti şu anda iki ana araç içermektedir:

• Toplu Alım: Elektronik tabloda bulunan bir veya daha fazla aralıktan veri alır.
• Toplu Güncelleme: Aynı işlem içinde birden fazla aralığı günceller.

Bu işlevler, bir iş akışına araç olarak eklenebilir veya gerektiğinde kullanılmak üzere bir temsilciye sunulabilir. Bunları yapılandırmak için şunlara ihtiyacınız olacak:

• A Google Cloud'a erişim sağlayan Google hesabı.
• Un Google Cloud üzerinde oluşturulan proje.
• La Google Sheets API etkinleştirildi.
• Bir hizmet hesabı ile JSON formatındaki anahtar.
• A paylaşılan sayfa Bu hesabın e-posta adresiyle birlikte.

Hizmet hesabı ayrı bir kimlik olarak işlev görür. Bu nedenle, Dify doğrudan kişisel Google hesabınızı kullanmaz ve tüm elektronik tablolarınıza otomatik olarak erişemez. Yalnızca açıkça paylaştığınız belgelere erişimi olacaktır.

Google Cloud'da hizmet hesabı nasıl oluşturulur?

İlk adım, Google Cloud Console'a gidip yeni bir proje oluşturmak veya mevcut bir projeyi seçmektir. Proje içinde, API'ler ve Hizmetler bölümünü açın, kütüphaneye gidin ve arama yapın... Google Sheets APIArdından, etkinleştirmek için seçeneğe dokunun.

Ardından, girin Kimlik ve Erişim Yönetimi > Hizmet hesapları ve yeni bir hesap oluşturun. Bu hesaba, ne için kullanıldığını kolayca belirlemeyi sağlayacak bir isim verebilirsiniz, örneğin "Dify Google Sheets".

Bu süreçte Google, proje içinde roller atama seçeneği sunabilir. Bu entegrasyon için, tüm proje için genel bir sahip veya düzenleyici rolü atamanıza gerek yoktur. Belirli sayfalara erişim, daha sonra Google Sheets paylaşım seçenekleri aracılığıyla kontrol edilir.

Hesap oluşturulduktan sonra:

1. Hizmet hesapları bölümünden bilgilerinizi açın.
2. Sekmeye git Anahtarlar.
3. Tıklayın Anahtar ekle > Yeni bir anahtar oluştur.
4. Biçimi seçin JSON.
5. Dosyayı indirin ve kaydedin. güvenli bir yerde.

JSON dosyası, özel anahtar da dahil olmak üzere hassas bilgiler içermektedir. Bu dosyayı yayınlamamalı, e-posta yoluyla göndermemeli veya bir depoya yüklememelisiniz. Bu anahtarı ele geçiren herkes, hizmet hesabının yetkileriyle işlem yapabilir.

Dify'de eklentiyi nasıl kurup yapılandırabilirsiniz?

Dify'de Eklenti Pazaryeri'ni açın ve tarafından yayınlanan Google Sheets eklentisini arayın. omlucFarklı işlevler sunabilecek diğer eklentilerle karıştırmamak için yüklemeden önce yazarın adını kontrol edin.

Kurulumdan sonra, eklentinin kimlik bilgileri ayarlarını açın. Form, hizmet hesabı anahtarını isteyecektir. İndirilen JSON dosyasını bir metin düzenleyiciyle açın. içeriğini tamamen kopyala ve ilgili alana yapıştırın..

Yalnızca e-posta adresini, proje kimliğini veya özel anahtarı ayrı ayrı kopyalamayın. Eklenti, Google Sheets'e yapılan istekleri doğrulamak için eksiksiz JSON yapısına ihtiyaç duyar.

Ardından, kimlik bilgilerini kaydedin ve kullanmak istediğiniz elektronik tabloyu açın. JSON dosyasının içinde, adlı bir alan bulacaksınız. client_emailDeğeri buna benzer bir görünüme sahip olacak:

[email protected]

Tıklayın Paylaşmak Google Sheets'te bu adresi başka bir kullanıcıya aitmiş gibi ekleyin:

• İzin verir okuyucu Dify yalnızca verilere danışacaksa.
• İzin verir editör Hücreleri de güncellemeniz gerekiyorsa.

Elektronik tabloyu bir bağlantı aracılığıyla herkese açık olarak paylaşmak önerilmez. Hizmet hesabı, belgeyi gizli tutmanıza ve erişimi belirli bir kullanıcıyla sınırlandırmanıza olanak tanır.

İş akışı üzerinden Google Sheets'ten veri nasıl okunur?

Sayfadan bilgi almak için, Dify iş akışına bir araç düğümü ekleyin ve eylemi seçin. Toplu AlımBu eklenti, tek bir işlemde birden fazla aralığı sorgulamanıza olanak tanır; bu da tablonun her bölümü için farklı bir düğüm oluşturma zorunluluğunu ortadan kaldırır.

Elektronik tablo tanımlayıcısını sağlamanız gerekecek. Bu tanımlayıcı, web adresinde şu satırlar arasında yer alır: /d/ y /editŞu yapıya sahip bir URL'de:

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

Yalnızca işaretli değeri kullanmalısınız. IDENTIFICADOR.

Ayrıca Google Sheets gösterimini kullanarak sekme adını ve aralığı belirtmeniz gerekecektir. Bazı örnekler şunlardır:

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

Ünlem işaretinden önceki isim sekme karakterine karşılık gelir. Ardından gelen harf ve rakamlar ise alınacak sütun ve satırları sınırlandırır.

Ardından sonucu özetlemek, bir kaydı bulmak veya bir yanıt hazırlamak için bir LLM düğümüne iletebilirsiniz. Modelin yalnızca alınan verileri kullanmasını ve özellikle sayfa müşteri, envanter veya sipariş bilgileri içeriyorsa, eşleşme bulamadığında bunu açıkça belirtmesini sağlamak önerilir.

Dify'deki hücreler nasıl güncellenir?

Araç Toplu Güncelleme Bu özellik, çeşitli aralıklarda değerler yazmanıza olanak tanır. Örneğin, bir görevin durumunu değiştirmek, yapay zeka tarafından oluşturulan bir sınıflandırmayı kaydetmek veya bir isteğin sonucunu eklemek için kullanılabilir.

Kullanmadan önce, hizmet hesabının belge üzerinde düzenleme izinlerine sahip olduğunu doğrulayın. Yalnızca okuma izinleri varsa, sorgular çalışır ancak Google yazma girişimlerini reddeder.

Modelin herhangi bir aralığı veya değeri serbestçe seçmesini engellemek de tavsiye edilir. Daha güvenli bir yapılandırma şunlardan oluşur: Öncelikle verileri doğrulayın, değiştirilebilir sütunları sınırlandırın ve kontrollü değişkenler kullanarak aralığı oluşturun. iş akışı aracılığıyla.

Örneğin, süreci şu şekilde organize edebilirsiniz:

1. El Kullanıcı bir sipariş numarası girer..
2. Batch Get sıraya geri döndü karşılık gelen.
3. Koşullu bir düğüm Siparişin mevcut olup olmadığını kontrol edin..
4. Model bilgileri analiz eder veya sınıflandırır.
5. Toplu Güncelleme sonucu yazar. belirli bir sütunda.
6. Çıkış düğümü, hangi kaydın değiştirildiğini doğrular.

Mümkün olduğunca kurulum sırasında bir test elektronik tablosu kullanın. Kötü yapılandırılmış bir güncelleme, özellikle aralık amaçlanandan daha fazla satır veya sütunu kapsıyorsa, mevcut bilgilerin üzerine yazabilir.

Dify'ı Google Sheets ile bağlarken yapılan yaygın hatalar

Kimlik doğrulama hatasıyla karşılaşırsanız, JSON dosyasını eksiksiz yapıştırdığınızdan ve biçiminin değiştirilmediğinden emin olun. Özel anahtarlar, belge yapısı içinde korunması gereken satır sonları içerir.

Dify, sayfayı bulamadığını veya erişemediğini belirttiğinde, şu noktaları kontrol edin:

• Google Sheets API'si doğru projede etkinleştirilmiş durumda.
• Sayfa, tam değeriyle paylaşılmıştır. client_email.
• Sayfa tanımlayıcısı, URL'nin ek bölümlerini içermez.
• Sekme adı, büyük harf kullanımı, boşluklar ve aksanlar dahil olmak üzere tamamen aynıdır.
• Bu aralık, aşağıdaki gibi geçerli bir gösterim kullanır: Datos!A2:C20.
• İş akışı yazma girişiminde bulunursa, hesabın düzenleyici izni vardır.

Google Cloud'da anahtarı sildiyseniz veya devre dışı bıraktıysanız, yeni bir anahtar oluşturmanız ve Dify'de kayıtlı kimlik bilgilerini değiştirmeniz gerekecektir. JSON dosyasının ifşa edildiğinden şüpheleniyorsanız da yeni bir anahtar oluşturmalısınız.

Google Sheets ve Google Drive eklentileri arasındaki farklar

Google Sheets ve Google Drive tek bir entegrasyon olarak ele alınmamalıdır. Sheets topluluk eklentisi şu amaçla tasarlanmıştır: Hücre aralıklarını görüntüle ve değiştir Bir hizmet hesabı aracılığıyla.

Buna karşılık, veri kaynağı olarak kullanılabilen resmi Google Drive eklentisi ise şunu kullanır: OAuth 2.0Bu özellik, klasörlere göz atmanıza, dosyaları listelemenize ve içeriklerini işlenmek veya Dify bilgi akışına dahil edilmek üzere indirmenize olanak tanır.

Drive bağlantısı yalnızca okuma amaçlıdır: dosya oluşturmaz, klasör düzenlemez veya belgeleri değiştirmez veya silmez. Google Workspace'ten yerel dosyaları indirdiğinizde, bunlar otomatik olarak uyumlu formatlara dışa aktarılır. Google Sheets XLSX dosyalarına dönüştürülürken, Google Docs ve Google Slides PDF olarak dışa aktarılır.

Bu nedenle, entegrasyon yöntemini göreve göre seçmelisiniz:

• Eklentiyi şu amaçla kullanın: Google Sheets Hücrelerdeki değerleri okumak veya yazmak.
• Veri kaynağını kullanın Google Drive Dosyaları bulmak ve indirmek için.
• İş akışının hücreler ve tüm belgelerle çalışması gerekiyorsa, ikisini birden birleştirin.

n8n kullanarak entegrasyonu nasıl genişletebilirim?

Google Sheets eklentisi şu amaçlarla kullanışlıdır: Dify'den eylemleri yürütAncak, tek başına tüm otomasyon senaryolarını kapsamaz. Tetikleyicilere, zamanlanmış yürütmelere veya birden fazla uygulamaya bağlantıya ihtiyacınız varsa, bunları yerleştirebilirsiniz. n8n aracı olarak.

Bu mimaride, Dify verileri bir n8n webhook'una gönderebilir. Bir HTTP isteği aracılığıyla. n8n isteği alır, Google Sheets düğümlerini çalıştırır ve sonucu iş akışına döndürür..

İşlemi tersine de çevirebilirsiniz. Örneğin, n8n yeni bir satırı algılayabilir, değerlerini işleyebilir ve Dify'de yayınlanan bir uygulamanın API'sini çağırabilir. Yapay zeka tarafından oluşturulan sonuç daha sonra aynı sayfadaki başka bir sütuna yazılabilir.

Bu sistem, aşağıdaki gibi otomasyonlar oluşturmanıza olanak tanır:

• Bir çalışma sayfasına eklenen cevapları otomatik olarak sınıflandırın.
• Belirli bir zamanda özetler oluşturun.
• Kayıtları güncelleyin ve aynı anda bildirim gönderin.
• Google Sheets'teki verileri e-posta, CRM veya diğer uygulamalarla birleştirin.
• Yapay zekanın bir hücreyi değiştirmesine izin vermeden önce doğrulama işlemlerini uygulayın.

Bunun karşılığında, yapılandırma daha karmaşık hale gelir ve her iki hizmet tarafından kullanılan web kancalarının, kimlik bilgilerinin ve API anahtarlarının korunmasını gerektirir.

Dify'ı Google Sheets'e bağlamak, standart bir elektronik tabloyu temsilciler veya iş akışları için kolayca erişilebilir bir bilgi kaynağına dönüştürmenizi sağlar. En doğrudan yaklaşım, Sheets API'sini etkinleştirmek, bir hizmet hesabı oluşturmak, eklentiyi yüklemek ve yalnızca gerekli sayfaları e-posta adresinizle paylaşmaktır.

Oradan itibaren, Toplu Al (Batch Get) işlemi aralıkları sorgulamanıza, Toplu Güncelle (Batch Update) işlemi ise sonuçları yazmanıza olanak tanır.Eğer proje, eksiksiz belgelerle çalışmayı, olaylara tepki vermeyi veya birden fazla uygulamayı koordine etmeyi gerektiriyorsa, her aracın işlevlerini karıştırmadan bu kurulumu Google Drive veya n8n ile tamamlayabilirsiniz.