Indeks konten Dropbox Anda menggunakan konektor Dropbox untuk Amazon Kendra

AmazonKendra adalah layanan pencarian cerdas yang sangat akurat dan mudah digunakan yang didukung oleh pembelajaran mesin (ML). Amazon Kendra menawarkan rangkaian konektor sumber data untuk menyederhanakan proses penyerapan dan pengindeksan konten Anda, di mana pun konten itu berada.

Data berharga dalam organisasi disimpan dalam repositori terstruktur dan tidak terstruktur. Solusi pencarian perusahaan harus dapat mengumpulkan data di beberapa repositori terstruktur dan tidak terstruktur untuk diindeks dan dicari.

Salah satu tempat penyimpanan data tersebut adalah Dropbox. Pengguna perusahaan menggunakan Dropbox untuk mengunggah, mentransfer, dan menyimpan dokumen ke cloud. Seiring dengan kemampuan untuk menyimpan dokumen, Dropbox menawarkan Dropbox Paper, alat pengeditan bersama yang memungkinkan pengguna berkolaborasi dan membuat konten di satu tempat. Dropbox Paper secara opsional dapat menggunakan templat untuk menambahkan struktur ke dokumen. Selain file dan kertas, Dropbox juga memungkinkan Anda menyimpan pintasan ke halaman web di folder Anda.

Dengan senang hati kami umumkan bahwa Anda sekarang dapat menggunakan konektor Amazon Kendra untuk Dropbox untuk mencari informasi yang disimpan di akun Dropbox Anda. Dalam posting ini, kami menunjukkan cara mengindeks informasi yang disimpan di Dropbox dan menggunakan fungsi pencarian cerdas Amazon Kendra. Selain itu, pencarian cerdas bertenaga ML Amazon Kendra dapat secara akurat menemukan informasi dari dokumen tidak terstruktur yang memiliki konten naratif bahasa alami, yang pencarian kata kuncinya tidak terlalu efektif.

Ikhtisar solusi

Dengan Amazon Kendra, Anda dapat mengonfigurasi beberapa sumber data untuk menyediakan tempat terpusat untuk mencari di seluruh repositori dokumen Anda. Untuk solusi kami, kami mendemonstrasikan cara mengindeks repositori atau folder Dropbox menggunakan konektor Amazon Kendra untuk Dropbox. Solusinya terdiri dari langkah-langkah berikut:

1. Konfigurasikan aplikasi di Dropbox dan dapatkan detail koneksi.
2. Simpan detailnya di Manajer Rahasia AWS.
3. Buat sumber data Dropbox melalui konsol Amazon Kendra.
4. Indeks data di repositori Dropbox.
5. Jalankan kueri sampel untuk mendapatkan informasi.

Prasyarat

Untuk mencoba konektor Amazon Kendra untuk Dropbox, Anda memerlukan yang berikut ini:

Konfigurasikan aplikasi Dropbox dan kumpulkan detail koneksi

Sebelum kami menyiapkan sumber data Dropbox, kami memerlukan beberapa detail tentang repositori Dropbox Anda. Mari kita kumpulkan mereka terlebih dahulu.

1. Pergi ke www.dropbox.com/developers.
2. Pilih Konsol aplikasi.
   
3. Masuk dengan kredensial Anda (pastikan Anda masuk ke akun Perusahaan).
   
4. Pilih Buat aplikasi.
   
5. Pilih Akses terbatas.
6. Pilih Dropbox Penuh (atau nama folder tertentu yang ingin Anda indeks).
7. Masukkan nama untuk aplikasi Anda.
8. Pilih Buat aplikasi.
   
   Anda dapat melihat layar konfigurasi dengan sekumpulan tab.
9. Untuk mengatur izin, pilih izin Tab.
   
10. Pilih satu set izin minimal, seperti yang ditunjukkan pada tangkapan layar berikut.
    
11. Pilih Kirim.
    
    Muncul pesan yang mengatakan bahwa perubahan izin berhasil.
    
12. pada Settings tab, salin kunci aplikasi.
13. Pilih Tampilan sebelah Rahasia aplikasi dan menyalin rahasia.
14. Bawah Token akses yang dihasilkan, pilih Menghasilkan dan salin tokennya.
    

Simpan nilai-nilai ini di tempat yang aman—kita perlu merujuknya nanti.

Token sesi berlaku hingga 4 jam. Anda harus membuat token sesi baru setiap kali Anda mengindeks konten.

Simpan kredensial Dropbox di Manajer Rahasia

Untuk menyimpan kredensial Dropbox Anda di Secrets Manager, ikuti langkah-langkah berikut:

1. Pada konsol Manajer Rahasia, pilih Simpan rahasia baru.
2. Pilih Jenis rahasia lainnya.
3. Buat tiga pasangan nilai kunci untuk appKey, appSecret, dan refreshToken dan masukkan nilai yang disimpan dari Dropbox.
4. Pilih Save.
   
5. Untuk Nama rahasia, masukkan nama (misalnya, AmazonKendra-dropbox-secret).
6. Masukkan deskripsi opsional.
7. Pilih Selanjutnya.
   
8. Dalam majalah Konfigurasikan rotasi bagian, pertahankan semua pengaturan pada defaultnya dan pilih Selanjutnya.
   
9. pada ULASAN halaman, pilih Toko.
   

Konfigurasikan konektor Amazon Kendra untuk Dropbox

Untuk mengonfigurasi konektor Amazon Kendra, selesaikan langkah-langkah berikut:

1. Di konsol Amazon Kendra, pilih Buat Indeks.
   
2. Untuk Nama indeks, masukkan nama untuk indeks (misalnya, my-dropbox-index).
3. Masukkan deskripsi opsional.
4. Untuk Nama peran, masukkan nama peran IAM.
5. Konfigurasikan pengaturan dan tag enkripsi opsional.
6. Pilih Selanjutnya.
   
7. Dalam majalah Konfigurasikan kontrol akses pengguna bagian, biarkan pengaturan pada default dan pilih Selanjutnya.
   
8. Untuk Edisi penyediaan, pilih Edisi pengembang.
9. Pilih membuat.
   
   Ini membuat dan menyebarkan peran IAM dan kemudian membuat indeks Amazon Kendra, yang dapat memakan waktu hingga 30 menit.
10. Pilih Sumber data di panel navigasi.
    
11. Bawah dropbox, pilih Tambahkan konektor.
    
12. Untuk Nama sumber data, masukkan nama (misalnya, my-dropbox-connector).
13. Masukkan deskripsi opsional.
14. Pilih Selanjutnya.
    
15. Untuk Jenis token otentikasi, pilih Token Akses (penggunaan sementara).
16. Untuk Rahasia AWS Secrets Manager, pilih rahasia yang Anda buat sebelumnya.
17. Untuk Peran IAM, pilih Buat peran baru.
18. Untuk Nama peran, masukkan nama (misalnya, AmazonKendra-dropbox-role).
19. Pilih Selanjutnya.
    
20. Untuk Pilih entitas atau tipe konten, pilih jenis konten Anda.
21. Untuk Frekuensi, pilih Jalankan sesuai permintaan.
22. Pilih Selanjutnya.
    
23. Tetapkan pemetaan bidang opsional apa pun dan pilih Selanjutnya.
24. Pilih Tinjau dan Buat Dan pilihlah Tambahkan sumber data.
25. Pilih Sync sekarang.
    
26. Tunggu hingga sinkronisasi selesai.
    

Uji solusinya

Sekarang setelah Anda menyerap konten dari akun Dropbox Anda ke dalam indeks Amazon Kendra, Anda dapat menguji beberapa kueri.

Buka indeks Anda dan pilih Cari konten yang diindeks. Masukkan contoh kueri penelusuran dan uji hasil penelusuran Anda (kueri Anda akan bervariasi berdasarkan konten akun Anda).

Konektor Dropbox juga merayapi informasi identitas lokal dari Dropbox. Untuk pengguna, ini menetapkan id email pengguna sebagai prinsipal. Untuk grup, ini menetapkan id grup sebagai prinsipal. Untuk memfilter hasil penelusuran menurut pengguna/grup, buka Search Console.

Klik "Uji kueri dengan nama pengguna atau grup” untuk memperluasnya dan klik tombol yang bertuliskan “terapkan nama pengguna atau grup".

Masukkan nama pengguna dan/atau grup dan klik Mendaftar. Selanjutnya, masukkan permintaan pencarian dan tekan enter. Ini memberi Anda serangkaian hasil yang difilter berdasarkan kriteria Anda.

Selamat! Anda telah berhasil menggunakan Amazon Kendra untuk memunculkan jawaban dan wawasan berdasarkan konten yang diindeks dari akun Dropbox Anda.

Hasilkan token permanen untuk akses offline

Instruksi dalam posting ini memandu Anda dalam membuat, mengonfigurasi, dan menggunakan token akses sementara. Aplikasi juga bisa mendapatkan akses jangka panjang dengan meminta akses offline, dalam hal ini aplikasi menerima token penyegaran yang dapat digunakan untuk mengambil token akses baru yang berumur pendek sesuai kebutuhan, tanpa intervensi pengguna manual lebih lanjut. Anda dapat menemukan informasi lebih lanjut di Panduan OAuth Dropbox dan Dokumentasi otorisasi Dropbox. Gunakan langkah-langkah berikut untuk membuat token penyegaran permanen (misalnya untuk menyetel sinkronisasi agar memicu pada jadwal):

1. Dapatkan kunci aplikasi dan rahasia aplikasi seperti sebelumnya.
2. Di browser baru, navigasikan ke https://www.dropbox.com/oauth2/authorize?token_access_type=offline&response_type=code&client_id=.
3. Terima default dan pilih Kirim.
4. Pilih Continue.
   
5. Pilih mengizinkan.
   
   Kode akses dibuat untuk Anda.
6. Salin kode akses.
   
   Sekarang Anda mendapatkan token penyegaran dari kode akses.
7. Di jendela terminal, jalankan perintah curl berikut:

   curl https://api.dropbox.com/oauth2/token -d code= -d grant_type=authorization_code -u :

   

Anda dapat menyimpan token penyegaran ini bersama dengan kunci aplikasi dan rahasia aplikasi untuk mengonfigurasi token permanen dalam konfigurasi sumber data untuk Amazon Kendra. Amazon Kendra membuat token akses dan menggunakannya sesuai kebutuhan untuk akses.

keterbatasan

Solusi ini memiliki batasan sebagai berikut:

• Komentar file tidak diimpor ke dalam indeks
• Anda tidak memiliki opsi untuk menambahkan metadata khusus untuk Dropbox
• Dokumen, lembar, dan slide Google memerlukan ruang kerja Google atau akun Google dan tidak termasuk

Kesimpulan

Dengan konektor Dropbox untuk Amazon Kendra, organisasi dapat memanfaatkan penyimpanan informasi yang disimpan di akun mereka dengan aman menggunakan pencarian cerdas yang didukung oleh Amazon Kendra.

Dalam posting ini, kami memperkenalkan Anda pada dasar-dasarnya, tetapi ada banyak fitur tambahan yang tidak kami bahas. Sebagai contoh:

• Anda dapat mengaktifkan kontrol akses berbasis pengguna untuk indeks Amazon Kendra Anda dan membatasi akses ke pengguna dan grup yang Anda konfigurasikan
• Anda bisa menentukan allowedUsersColumn dan allowedGroupsColumn sehingga Anda dapat menerapkan kontrol akses berdasarkan pengguna dan grup, masing-masing
• Anda dapat memetakan bidang tambahan ke atribut indeks Amazon Kendra dan mengaktifkannya untuk faceting, pencarian, dan tampilan di hasil pencarian
• Anda dapat mengintegrasikan sumber data Dropbox dengan kemampuan Pengayaan Dokumen Kustom (CDE) di Amazon Kendra untuk melakukan logika pemetaan atribut tambahan dan bahkan transformasi konten kustom selama penyerapan

Untuk mempelajari tentang kemungkinan ini dan lebih banyak lagi, lihat Panduan Pengembang Amazon Kendra.

---

Tentang Penulis

Ashish Lagwankar adalah Arsitek Solusi Perusahaan Senior di AWS. Minat utamanya meliputi AI/ML, tanpa server, dan teknologi container. Ashish berbasis di Boston, MA, area dan menikmati membaca, di luar ruangan, dan menghabiskan waktu bersama keluarganya.