Cari pengetahuan di dokumen Quip dengan pencarian cerdas menggunakan konektor Quip untuk Amazon Kendra

Organisasi menggunakan solusi pembuatan dokumen kolaboratif seperti Salesforce Menyindir untuk menyematkan dokumen kolaboratif real-time di dalam catatan Salesforce. Quip adalah platform produktivitas Salesforce yang mengubah cara perusahaan bekerja sama, menghadirkan kolaborasi modern dengan aman dan sederhana di semua perangkat. Repositori Quip menangkap pengetahuan organisasi yang tak ternilai dalam bentuk dokumen kolaboratif dan alur kerja. Namun, menemukan pengetahuan organisasi ini dengan mudah dan aman bersama dengan repositori dokumen lain, seperti Box atau Layanan Penyimpanan Sederhana Amazon (Amazon S3), bisa jadi menantang. Selain itu, sifat percakapan dari alur kerja kolaboratif membuat pendekatan berbasis kata kunci tradisional untuk pencarian tidak efektif karena memiliki informasi yang terfragmentasi dan tersebar di banyak tempat.

Kami senang mengumumkan bahwa Anda sekarang dapat menggunakan AmazonKendra konektor Quip untuk mencari pesan dan dokumen di repositori Quip Anda. Dalam posting ini, kami menunjukkan cara menemukan informasi yang Anda butuhkan di repositori Quip Anda menggunakan fungsi pencarian cerdas Amazon Kendra, yang didukung oleh pembelajaran mesin.

Ikhtisar solusi

Dengan Amazon Kendra, Anda dapat mengonfigurasi beberapa sumber data untuk menyediakan tempat sentral untuk mencari di seluruh repositori dokumen Anda. Untuk solusi kami, kami mendemonstrasikan cara mengonfigurasi repositori Quip sebagai sumber data indeks pencarian menggunakan konektor Amazon Kendra untuk Quip.

Tangkapan layar berikut menunjukkan contoh repositori Quip.

Ruang kerja dalam contoh ini memiliki folder pribadi yang tidak dibagikan. Folder tersebut memiliki subfolder yang digunakan untuk menyimpan kuitansi pengeluaran. Folder lain bernama example.com dibagikan dengan orang lain dan digunakan untuk berkolaborasi dengan tim. Folder ini memiliki lima subfolder yang menyimpan dokumentasi untuk pengembangan.

Untuk mengkonfigurasi konektor Quip, pertama-tama kita catat nama domain, ID folder, dan token akses dari repositori Quip. Kemudian kita cukup membuat indeks Amazon Kendra dan menambahkan Quip sebagai sumber data.

Prasyarat

Untuk mulai menggunakan konektor Quip untuk Amazon Kendra, Anda harus memiliki repositori Quip.

Kumpulkan informasi dari Quip

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

Nama domain

Cari tahu nama domainnya. Misalnya , untuk Quip URL https://example-com.quip.com/browse, nama domainnya adalah quip. Bergantung pada cara sistem masuk tunggal (SSO) disiapkan di organisasi Anda, nama domain mungkin berbeda. Simpan nama domain ini untuk digunakan nanti.

ID folder

Folder di Quip memiliki ID unik yang terkait dengannya. Kita perlu mengkonfigurasi konektor Quip untuk mengakses folder yang tepat dengan menyediakan ID folder yang benar. Untuk posting ini, kami mengindeks folder example.com.

Untuk menemukan ID folder, pilih folder. URL berubah untuk menunjukkan ID folder.

ID folder dalam hal ini adalah xj1vOyaCGB3u. Buat daftar ID folder yang akan dipindai; kami menggunakan ID ini saat mengonfigurasi konektor.

Token akses

Masuk ke Quip dan buka https://{subdomain.domain}/dev/token di peramban web. Dalam contoh berikut, kami menavigasi ke https://example-com.quip.com/dev/token. Lalu pilih Dapatkan Token Akses Pribadi.

Salin token untuk digunakan di langkah selanjutnya.

Kami sekarang memiliki informasi yang kami butuhkan untuk mengonfigurasi sumber data.

Buat indeks Amazon Kendra

Untuk mengatur indeks Amazon Kendra Anda, selesaikan langkah-langkah berikut:

1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon Kendra.

Jika Anda menggunakan Amazon Kendra untuk pertama kalinya, Anda akan melihat tangkapan layar berikut.

2. Pilih Buat indeks.
   
3. Untuk Nama indeks, Masuk my-quip-example-index.
4. Untuk Deskripsi Produk, masukkan deskripsi opsional.
5. Untuk Peran IAM, gunakan peran yang ada atau buat peran baru.
6. Pilih Selanjutnya.
   
7. Bawah Pengaturan kontrol akses, pilih Tidak untuk membuat semua konten yang diindeks tersedia untuk semua pengguna.
8. Untuk Perluasan grup pengguna, pilih None.
9. Pilih Selanjutnya.
   

Untuk Edisi penyediaan, Anda dapat memilih dari dua opsi tergantung pada volume konten dan frekuensi akses.

10. Untuk posting ini, pilih Edisi pengembang.
11. Pilih membuat.
    

Pembuatan peran membutuhkan waktu sekitar 30 detik; pembuatan indeks dapat memakan waktu hingga 30 menit. Setelah selesai, Anda dapat melihat indeks Anda di konsol Amazon Kendra.

Tambahkan Quip sebagai sumber data

Sekarang mari tambahkan Quip sebagai sumber data ke index.

1. Di konsol Amazon Kendra, di bawah Manajemen data di panel navigasi, pilih Sumber data.
2. Pilih Tambahkan konektor bawah Menyindir.
   
3. Untuk Nama sumber data, Masuk my-quip-data-source.
4. Untuk Deskripsi Produk, masukkan deskripsi opsional.
5. Pilih Selanjutnya.
   
6. Masukkan nama domain Quip yang Anda simpan sebelumnya.
7. Bawah Rahasia, pilih Buat dan tambahkan rahasia Manajer Rahasia baru.
8. Untuk Nama rahasia, masukkan nama rahasia Anda.
9. Untuk Token menyindir, masukkan token akses yang Anda simpan sebelumnya.
10. Pilih Simpan dan tambahkan rahasia.
    
11. Bawah Peran IAM, pilih peran atau buat peran baru.
12. Pilih Selanjutnya.
    
13. Bawah Lingkup sinkronisasi, Untuk Tambahkan ID folder untuk dirayapi, masukkan ID folder yang Anda simpan sebelumnya.
14. Bawah Sinkronkan jadwal lari¸ untuk Frekuensi, pilih Jalankan sesuai permintaan.
15. Pilih Selanjutnya.
    

Konektor Quip memungkinkan Anda menangkap bidang tambahan seperti penulis, kategori, dan nama folder (dan bahkan mengganti nama sesuai kebutuhan).

16. Untuk posting ini, kami tidak mengonfigurasi pemetaan bidang apa pun.
17. Pilih Selanjutnya.
    
18. Konfirmasikan semua opsi dan tambahkan sumber data.

Sumber data Anda siap dalam beberapa menit.

19. Saat sumber data Anda sudah siap, pilih Sync sekarang.
    

Tergantung pada ukuran data dalam repositori Quip, proses ini dapat memakan waktu beberapa menit hingga beberapa jam. Sinkronisasi adalah proses dua langkah. Pertama, dokumen dirayapi untuk menentukan yang akan diindeks. Kemudian dokumen yang dipilih diindeks. Beberapa faktor yang memengaruhi kecepatan sinkronisasi termasuk throughput dan pelambatan repositori, bandwidth jaringan, dan ukuran dokumen.

Status sinkronisasi ditampilkan sebagai berhasil saat sinkronisasi selesai. Repositori Quip Anda sekarang terhubung.

Jalankan pencarian di Amazon Kendra

Mari kita uji konektor dengan menjalankan beberapa pencarian.

1. Di konsol Amazon Kendra, di bawah Manajemen data di panel navigasi, pilih Cari konten yang diindeks.
   
2. Masukkan pencarian Anda di bidang pencarian. Untuk posting ini, kami mencari EC2 on Linux.

Tangkapan layar berikut menunjukkan hasil kami.

keterbatasan

Ada beberapa batasan yang diketahui untuk penyerapan sumber data. Beberapa batasan disebabkan oleh kebutuhan akses admin untuk mengakses beberapa konten, yang lain karena detail implementasi yang spesifik. Mereka adalah sebagai berikut:

• Hanya perayapan penuh yang didukung. Jika Anda ingin konektor mendukung perayapan changelog, akses API admin diperlukan, dan Anda harus mengaktifkan API admin di situs web Quip.
• Hanya folder bersama yang dirayapi. Meskipun kami menggunakan token akses pribadi dari pengguna admin, kami tidak dapat merayapi data di folder pribadi pengguna lain.
• Solusinya tidak mendukung penentuan jenis file untuk penyertaan dan pengecualian, karena Quip tidak menyimpan ekstensi jenis file, hanya nama file.
• Peristiwa waktu nyata memerlukan langganan dan akses API admin.

Kesimpulan

Konektor Amazon Kendra untuk Quip memungkinkan organisasi membuat informasi berharga yang disimpan dalam dokumen Quip tersedia bagi pengguna mereka dengan aman menggunakan pencarian cerdas yang didukung oleh Amazon Kendra. Konektor juga menyediakan aspek untuk atribut repositori Quip seperti penulis, jenis file, URI sumber, tanggal pembuatan, file induk, dan kategori sehingga pengguna dapat menyaring hasil pencarian secara interaktif berdasarkan apa yang mereka cari.

Untuk informasi selengkapnya tentang cara membuat, memodifikasi, dan menghapus data dan metadata menggunakan pengayaan dokumen kustom saat konten diserap dari repositori Quip, lihat Menyesuaikan metadata dokumen selama proses penyerapan dan Perkaya konten dan metadata Anda untuk meningkatkan pengalaman pencarian Anda dengan pengayaan dokumen khusus di 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.

Vika Shah adalah Arsitek Solusi Perusahaan di layanan web Amazon. Dia adalah penggemar teknologi yang senang membantu pelanggan menemukan solusi inovatif untuk tantangan bisnis yang kompleks. Bidang minatnya adalah ML, IoT, robotika, dan penyimpanan. Di waktu luangnya, Vikas senang membuat robot, hiking, dan travelling.

• Coinsmart. Pertukaran Bitcoin dan Crypto Terbaik Eropa.
• Platoblockchain. Intelijen Metaverse Web3. Pengetahuan Diperkuat. AKSES GRATIS.
• CryptoHawk. Radar Altcoin. Uji Coba Gratis.
• Sumber: https://aws.amazon.com/blogs/machine-learning/search-for-knowledge-in-quip-documents-with-intelligent-search-using-the-quip-connector-for-amazon-kendra/