Cara menghubungkan Dify dengan Google Sheets dan Google Drive

Jika Anda ingin agen AI Anda bekerja dengan informasi yang nyata dan terkini, Hubungkan Dify dengan Google Sheets Ini adalah salah satu cara paling sederhana untuk mencapainya. Spreadsheet dapat berfungsi sebagai tempat penyimpanan data kecil yang dapat digunakan untuk menanyakan produk, pelanggan, tugas, atau catatan lain yang digunakan oleh aplikasi Anda.

Integrasi ini memungkinkan alur kerja Dify untuk membaca rentang yang berbeda dan menulis nilai baru tanpa memerlukan penyalinan data manual. Misalnya, Anda dapat membuat wizard yang memeriksa status pesanan, mengkategorikan respons formulir, atau memperbarui tabel setelah memproses permintaan.

Ada beberapa cara untuk melakukan ini. Rute paling langsung menggunakan... Plugin Google Sheets dan akun layanan Google Cloud.Jika Anda perlu bereaksi secara otomatis terhadap perubahan, menjalankan tugas terjadwal, atau menggabungkan spreadsheet dengan aplikasi lain, Anda juga dapat menggunakan platform perantara seperti n8n.

Yang Anda butuhkan untuk menghubungkan Dify dengan Google Sheets

Sebelum kita mulai, ada baiknya kita klarifikasi terlebih dahulu bahwa add-on ini omluc/google_sheets Tersedia di Dify Marketplace, ini adalah plugin komunitas. Plugin ini bukan bagian dari plugin resmi yang dikembangkan oleh tim Dify, meskipun dapat diinstal dari marketplace ekstensi mereka.

Plugin ini saat ini menggabungkan dua alat utama:

• Pengambilan Massal: Mengambil data dari satu atau lebih rentang dalam spreadsheet.
• Pembaruan Massal: Memperbarui beberapa rentang dalam operasi yang sama.

Fungsi-fungsi ini dapat ditambahkan sebagai alat dalam alur kerja atau disediakan untuk agen agar dapat digunakan sesuai kebutuhan. Untuk mengkonfigurasinya, Anda memerlukan:

• A Akun Google dengan akses ke Google Cloud.
• Un Proyek ini dibuat di Google Cloud..
• La API Google Sheets diaktifkan.
• Akun layanan dengan kunci dalam format JSON.
• A lembar bersama dengan alamat email akun tersebut.

Akun layanan berfungsi sebagai identitas terpisah. Oleh karena itu, Dify tidak menggunakan akun Google pribadi Anda secara langsung, dan juga tidak dapat mengakses semua spreadsheet Anda secara otomatis. Dify hanya akan memiliki akses ke dokumen yang Anda bagikan secara eksplisit kepadanya.

Cara membuat akun layanan di Google Cloud

Langkah pertama adalah membuka Google Cloud Console dan membuat proyek baru atau memilih proyek yang sudah ada. Di dalam proyek tersebut, buka bagian API dan Layanan, masuk ke pustaka, dan cari... API Google SheetsKemudian, ketuk opsi tersebut untuk mengaktifkannya.

Selanjutnya, masuk IAM dan administrasi > Akun layanan lalu buat akun baru. Anda bisa memberinya nama yang mudah dikenali untuk apa akun tersebut digunakan, misalnya "Dify Google Sheets".

Selama proses ini, Google mungkin menawarkan opsi untuk menetapkan peran dalam proyek. Untuk integrasi ini, Anda tidak perlu menetapkan peran pemilik atau editor umum untuk seluruh proyek. Akses ke lembar kerja tertentu dikontrol kemudian melalui opsi berbagi Google Sheets.

Setelah akun dibuat:

1. Buka detail Anda dari bagian akun layanan.
2. Buka tab Kunci.
3. Klik pada Tambah kunci > Buat kunci baru.
4. Pilih formatnya JSON.
5. Unduh dan simpan file tersebut. di tempat yang aman.

File JSON tersebut berisi informasi sensitif, termasuk kunci pribadi. Anda tidak boleh mempublikasikannya, mengirimkannya melalui email, atau mengunggahnya ke repositori. Siapa pun yang memperoleh kunci tersebut dapat bertindak dengan izin akun layanan.

Cara menginstal dan mengkonfigurasi plugin di Dify

Di Dify, buka Plugin Marketplace dan cari add-on Google Sheets yang diterbitkan oleh omlukPeriksa nama pembuatnya sebelum menginstalnya untuk menghindari kebingungan dengan ekstensi lain yang mungkin menawarkan fungsi berbeda.

Setelah instalasi, buka pengaturan kredensial plugin. Formulir akan meminta kunci akun layanan. Buka file JSON yang diunduh dengan editor teks. salin seluruh isinya lalu tempelkan di kolom yang sesuai..

Jangan hanya menyalin email, ID proyek, atau kunci pribadi secara terpisah. Add-on ini membutuhkan struktur JSON lengkap untuk mengautentikasi permintaan yang dibuat ke Google Sheets.

Selanjutnya, simpan kredensial dan buka spreadsheet yang ingin Anda gunakan. Di dalam file JSON, Anda akan menemukan kolom bernama client_emailyang nilainya akan tampak seperti ini:

[email protected]

Klik pada Membagikan di dalam Google Sheets dan tambahkan alamat tersebut seolah-olah itu adalah pengguna lain:

• Memberikan izin kepada pembaca jika Dify hanya akan mengakses data.
• Memberikan izin kepada editor jika Anda juga perlu memperbarui sel.

Tidak disarankan untuk membagikan spreadsheet secara publik melalui tautan. Akun layanan memungkinkan Anda untuk menjaga dokumen tetap pribadi dan membatasi akses hanya untuk pengguna tertentu.

Cara membaca data dari Google Sheets dari alur kerja.

Untuk mengambil informasi dari lembar kerja, tambahkan node alat ke alur kerja Dify dan pilih tindakan tersebut. Dapatkan BatchAdd-in ini memungkinkan Anda untuk melakukan query pada beberapa rentang dalam satu operasi, sehingga menghindari keharusan membuat node yang berbeda untuk setiap bagian tabel.

Anda perlu memberikan pengidentifikasi spreadsheet. Ini muncul di alamat web-nya, di antara /d/ y /editDalam URL dengan struktur seperti ini:

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

Anda hanya boleh menggunakan nilai yang ditandai sebagai IDENTIFICADOR.

Anda juga perlu menentukan nama tab dan rentang menggunakan notasi Google Sheets. Beberapa contohnya adalah:

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

Nama sebelum tanda seru sesuai dengan tab. Huruf dan angka yang mengikutinya membatasi kolom dan baris yang akan diambil.

Anda kemudian dapat meneruskan hasilnya ke node LLM untuk meringkasnya, menemukan catatan, atau menyiapkan respons. Disarankan untuk menginstruksikan model agar hanya menggunakan data yang diambil dan untuk secara jelas menunjukkan kapan model tidak menemukan kecocokan, terutama jika lembar kerja berisi informasi pelanggan, inventaris, atau pesanan.

Cara memperbarui sel dari Dify

Alat Pembaruan Massal Fitur ini memungkinkan Anda untuk menulis nilai dalam berbagai rentang. Ini dapat digunakan, misalnya, untuk mengubah status tugas, menyimpan klasifikasi yang dihasilkan AI, atau menambahkan hasil permintaan.

Sebelum menggunakannya, pastikan akun layanan memiliki izin editor pada dokumen tersebut. Jika hanya memiliki izin baca, kueri akan berfungsi, tetapi Google akan menolak upaya penulisan.

Sebaiknya juga mencegah model memilih rentang atau nilai apa pun secara bebas. Konfigurasi yang lebih aman terdiri dari: Pertama, validasi data, batasi kolom yang dapat dimodifikasi, dan bangun rentang menggunakan variabel terkontrol. melalui alur kerja.

Sebagai contoh, Anda dapat mengatur prosesnya seperti ini:

1. El pengguna memasukkan nomor pesanan.
2. Batch Get kembali mengantre sesuai.
3. Node bersyarat periksa apakah pesanan tersebut ada.
4. Model tersebut menganalisis atau mengklasifikasikan informasi.
5. Pembaruan Batch menulis hasilnya pada kolom tertentu.
6. Node keluaran tersebut mengkonfirmasi catatan mana yang telah dimodifikasi.

Jika memungkinkan, gunakan spreadsheet uji selama pengaturan. Pembaruan yang dibuat dengan buruk dapat menimpa informasi yang sudah ada, terutama jika rentang yang dicakup meliputi lebih banyak baris atau kolom daripada yang dimaksudkan.

Kesalahan umum saat menghubungkan Dify dengan Google Sheets

Jika Anda mengalami kesalahan otentikasi, pastikan Anda telah menempelkan seluruh file JSON dan formatnya tidak diubah. Kunci privat berisi jeda baris yang harus dipertahankan dalam struktur dokumen.

Jika Dify menunjukkan bahwa ia tidak dapat menemukan atau mengakses lembar kerja, periksa poin-poin berikut:

• API Google Sheets telah diaktifkan di proyek yang benar.
• Lembar tersebut telah dibagikan dengan nilai pasti sebesar... client_email.
• Pengidentifikasi lembar kerja tidak mengandung bagian tambahan apa pun dari URL.
• Nama tab harus sama, termasuk penggunaan huruf kapital, spasi, dan aksen.
• Rentang tersebut menggunakan notasi yang valid, seperti Datos!A2:C20.
• Akun tersebut memiliki izin editor jika alur kerja mencoba untuk menulis.

Jika Anda telah menghapus atau menonaktifkan kunci di Google Cloud, Anda perlu membuat kunci baru dan mengganti kredensial yang tersimpan di Dify. Anda juga harus membuat kunci baru jika Anda mencurigai file JSON telah terekspos.

Perbedaan antara plugin Google Sheets dan Google Drive

Google Sheets dan Google Drive tidak boleh dianggap sebagai satu integrasi tunggal. Plugin komunitas Sheets ditujukan untuk... melihat dan memodifikasi rentang sel melalui akun layanan.

Sebaliknya, plugin resmi Google Drive yang tersedia sebagai sumber data menggunakan OAuth 2.0Fitur ini memungkinkan Anda untuk menelusuri folder, membuat daftar file, dan mengunduh isinya untuk diproses atau dimasukkan ke dalam alur pengetahuan Dify.

Konektor Drive bersifat hanya baca: konektor ini tidak membuat file, mengatur folder, atau memodifikasi atau menghapus dokumen. Saat Anda mengunduh file asli dari Google Workspace, file tersebut secara otomatis diekspor ke format yang kompatibel. Google Sheets dikonversi ke file XLSX, sedangkan Google Docs dan Google Slides diekspor sebagai PDF.

Oleh karena itu, Anda harus memilih integrasi sesuai dengan tugas yang diberikan:

• Gunakan plugin untuk Google Sheets untuk membaca atau menulis nilai dalam sel.
• Gunakan sumber data dari Google Drive untuk menemukan dan mengunduh file.
• Gabungkan keduanya hanya jika alur kerja perlu bekerja dengan sel dan seluruh dokumen.

Cara memperluas integrasi menggunakan n8n

Add-on Google Sheets berguna untuk melakukan tindakan dari DifyNamun, ini saja tidak mencakup semua skenario otomatisasi. Jika Anda memerlukan pemicu, eksekusi terjadwal, atau koneksi ke beberapa aplikasi, Anda dapat menempatkannya di tempat lain. n8n sebagai perantara.

Dalam arsitektur ini, Dify dapat mengirim data ke webhook n8n. melalui permintaan HTTP. n8n menerima permintaan tersebut, Proses ini menjalankan node Google Sheets dan mengembalikan hasilnya ke alur kerja..

Anda juga dapat membalikkan prosesnya. Misalnya, n8n dapat mendeteksi baris baru, memproses nilainya, dan memanggil API dari aplikasi yang dipublikasikan di Dify. Hasil yang dihasilkan AI kemudian dapat ditulis ke kolom lain di lembar yang sama.

Sistem ini memungkinkan Anda untuk membuat otomatisasi seperti:

• Secara otomatis mengklasifikasikan jawaban yang ditambahkan ke lembar kerja.
• Hasilkan ringkasan pada waktu tertentu.
• Perbarui data dan kirim pemberitahuan secara bersamaan.
• Gabungkan data dari Google Sheets dengan email, CRM, atau aplikasi lainnya.
• Lakukan validasi sebelum mengizinkan AI memodifikasi sel.

Sebagai imbalannya, konfigurasinya lebih kompleks dan memerlukan perlindungan terhadap webhook, kredensial, dan kunci API yang digunakan oleh kedua layanan tersebut.

Menghubungkan Dify ke Google Sheets memungkinkan Anda mengubah spreadsheet standar menjadi sumber informasi yang mudah diakses untuk agen atau alur kerja. Pendekatan yang paling langsung adalah dengan mengaktifkan Sheets API, membuat akun layanan, menginstal plugin, dan hanya membagikan spreadsheet yang diperlukan dengan alamat email Anda.

Dari situ, Batch Get memungkinkan Anda untuk melakukan kueri rentang, dan Batch Update menulis hasilnya.Jika proyek tersebut perlu bekerja dengan dokumen lengkap, menanggapi peristiwa, atau mengkoordinasikan beberapa aplikasi, Anda dapat melengkapi pengaturan ini dengan Google Drive atau n8n tanpa membingungkan fungsi masing-masing alat.