Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Slack
Slack adalah aplikasi komunikasi perusahaan yang memungkinkan pengguna mengirim pesan dan lampiran melalui berbagai saluran publik dan pribadi. Anda dapat menggunakan Amazon Kendra untuk mengindeks saluran publik dan pribadi Slack Anda, pesan bot dan arsip, file dan lampiran, pesan langsung dan grup. Anda juga dapat memilih konten tertentu untuk difilter.
**catatan**
Amazon Kendrasekarang mendukung konektor Slack yang ditingkatkan.
Konsol telah ditingkatkan secara otomatis untuk Anda. Konektor baru apa pun yang Anda buat di konsol akan menggunakan arsitektur yang ditingkatkan. Jika Anda menggunakan API, Anda sekarang harus menggunakan [https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)objek alih-alih `SlackConfiguration` objek untuk mengonfigurasi konektor Anda.
Konektor yang dikonfigurasi menggunakan konsol lama dan arsitektur API akan terus berfungsi seperti yang dikonfigurasi. Namun, Anda tidak akan dapat mengedit atau memperbaruinya. Jika Anda ingin mengedit atau memperbarui konfigurasi konektor Anda, Anda harus membuat konektor baru.
Kami merekomendasikan untuk memigrasikan alur kerja konektor Anda ke versi yang ditingkatkan. Support untuk konektor yang dikonfigurasi menggunakan arsitektur lama dijadwalkan berakhir pada Juni 2024.
Anda dapat terhubung Amazon Kendra ke sumber data Slack menggunakan [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/) atau [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html)API.
Untuk memecahkan masalah konektor sumber data Amazon Kendra Slack, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md)
**Topics**
+ [Fitur yang didukung](#supported-features-slack)
+ [Prasyarat](#prerequisites-slack)
+ [Instruksi koneksi](#data-source-procedure-slack)
+ [Pelajari selengkapnya](#slack-learn-more)
## Fitur yang didukung
Amazon KendraKonektor sumber data Slack mendukung fitur-fitur berikut:
+ Pemetaan bidang
+ Kontrol akses pengguna
+ Filter inklusi/pengecualian
+ Sinkronisasi konten penuh dan tambahan
+ Cloud privat virtual (VPC)
## Prasyarat
Sebelum Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber data Slack Anda, buat perubahan ini di Slack dan AWS akun Anda.
**Di Slack, pastikan Anda memiliki:**
+ Mengkonfigurasi token Pengguna Slack Bot atau OAuth token Pengguna OAuth Slack. Anda dapat memilih salah satu token untuk terhubung Amazon Kendra ke sumber data Slack Anda. Token diperlukan untuk digunakan sebagai kredensi otentikasi Anda. Lihat [dokumentasi Slack pada token akses](https://api.slack.com/authentication/token-types) untuk informasi selengkapnya.
**catatan**
Jika Anda menggunakan token bot sebagai bagian dari kredensyal Slack Anda, Anda tidak dapat mengindeks pesan langsung dan pesan grup dan Anda harus menambahkan token bot ke saluran yang ingin Anda indeks.
**catatan**
Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku).
+ Mencatat ID tim ruang kerja Slack Anda dari URL halaman utama ruang kerja Slack Anda. Misalnya, *https://app.slack.com/client/T0123456789/... * di *T0123456789* mana ID tim.
+ Menambahkan cakupan/izin Oauth berikut:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/data-source-slack.html)
+ Memeriksa setiap dokumen unik di Slack dan di seluruh sumber data lain yang Anda rencanakan untuk digunakan untuk indeks yang sama. Setiap sumber data yang ingin Anda gunakan untuk indeks tidak boleh berisi dokumen yang sama di seluruh sumber data. Dokumen IDs bersifat global untuk indeks dan harus unik per indeks.
**Di dalam AndaAkun AWS, pastikan Anda memiliki:**
+ [Membuat Amazon Kendra indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) dan, jika menggunakan API, mencatat ID indeks.
+ [Membuat IAM peran](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) untuk sumber data Anda dan, jika menggunakan API, catat ARN peran tersebutIAM.
**catatan**
Jika Anda mengubah jenis otentikasi dan kredensyal, Anda harus memperbarui IAM peran Anda untuk mengakses ID rahasia yang benarAWS Secrets Manager.
+ Menyimpan kredensi otentikasi Slack Anda secara AWS Secrets Manager rahasia dan, jika menggunakan API, catat ARN rahasia tersebut.
**catatan**
Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku).
Jika Anda tidak memiliki IAM peran atau rahasia yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran dan Secrets Manager rahasia baru saat menghubungkan sumber data Slack. Amazon Kendra Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks.
## Instruksi koneksi
Untuk terhubung Amazon Kendra ke sumber data Slack Anda, Anda harus memberikan rincian yang diperlukan dari sumber data Slack Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengkonfigurasi Slack untukAmazon Kendra, lihat[Prasyarat](#prerequisites-slack).
------
#### [ Console ]
**Untuk terhubung Amazon Kendra ke Slack**
1. Masuk ke Konsol Manajemen AWS dan buka [Amazon Kendrakonsol](https://console.aws.amazon.com/kendra/).
1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks.
**catatan**
Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** di bawah **Pengaturan indeks**.
1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**.
1. Pada halaman **Tambahkan sumber data**, pilih **konektor Slack**, lalu pilih **Tambah konektor**. Jika menggunakan versi 2 (jika ada), pilih **konektor Slack dengan tag** “V2.0".
1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut:
1. Di **Nama dan deskripsi**, untuk **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi.
1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda.
1. Dalam **Bahasa default** —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen mengesampingkan bahasa yang dipilih.
1. Di **Tag**, untuk **Tambahkan tag baru —Sertakan tag** opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda.
1. Pilih **Berikutnya**.
1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi berikut:
1. Untuk **ID tim ruang kerja Slack —ID** tim ruang kerja Slack Anda. Anda dapat menemukan ID tim Anda di URL halaman utama ruang kerja Slack Anda. Misalnya, *https://app.slack.com/client/T0123456789/...* di *T0123456789* mana ID tim.
1. **Otorisasi** — Aktifkan atau nonaktifkan informasi daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL dan ingin menggunakannya untuk kontrol akses. ACL menentukan dokumen mana yang dapat diakses pengguna dan grup. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources).
1. **AWS Secrets Managerrahasia** —Pilih rahasia yang ada atau buat Secrets Manager rahasia baru untuk menyimpan kredensyal otentikasi Slack Anda. Jika Anda memilih untuk membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka.
1. Masukkan informasi berikut di **jendela Buat AWS Secrets Manager rahasia**:
1. **Nama rahasia** —Nama untuk rahasiamu. Awalan 'AmazonKendra-Slack-' secara otomatis ditambahkan ke nama rahasia Anda.
1. Untuk **token Slack** —Masukkan nilai kredensi otentikasi yang Anda konfigurasikan Slack.
1. Simpan dan tambahkan rahasia Anda.
1. **Virtual Private Cloud (VPC)** —Anda dapat memilih untuk menggunakan VPC. Jika demikian, Anda harus menambahkan **Subnet** dan grup keamanan **VPC**.
1. **Perayap identitas —Tentukan apakah akan mengaktifkan crawler** Amazon Kendra identitas. Perayap identitas menggunakan informasi daftar kontrol akses (ACL) untuk dokumen Anda untuk memfilter hasil penelusuran berdasarkan akses pengguna atau grup mereka ke dokumen. Jika Anda memiliki ACL untuk dokumen Anda dan memilih untuk menggunakan ACL Anda, Anda juga dapat memilih untuk mengaktifkan crawler Amazon Kendra identitas untuk mengonfigurasi [pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) dari hasil pencarian. Sebaliknya, jika perayap identitas dinonaktifkan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup untuk pemfilteran konteks pengguna.
1. **IAMperan** —Pilih peran yang ada atau buat IAM IAM peran baru untuk mengakses kredensi repositori dan mengindeks konten.
**catatan**
IAMperan yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan.
1. Pilih **Berikutnya**.
1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut:
1. **Pilih jenis konten** —Pilih entitas Slack atau jenis konten yang ingin dirayapi. Anda dapat memilih dari semua saluran, saluran publik, saluran pribadi, pesan grup, dan pesan pribadi.
1. **Pilih tanggal mulai crawl —Masukkan tanggal** yang ingin Anda mulai merayapi konten Anda.
1. Untuk **konfigurasi Tambahan** —Pilih untuk menyertakan bot dan pesan yang diarsipkan dan gunakan pola ekspresi reguler untuk menyertakan atau mengecualikan konten tertentu.
**catatan**
Jika Anda memilih untuk menyertakan nama saluran IDs dan saluran, konektor Amazon Kendra Slack akan memprioritaskan saluran IDs daripada nama saluran.
Jika Anda memilih untuk menyertakan pesan pribadi dan grup tertentu, konektor Amazon Kendra Slack akan mengabaikan semua pesan pribadi dan grup dan hanya merayapi pesan pribadi dan grup yang Anda tentukan.
1. **Mode sinkronisasi** —Pilih cara Anda ingin memperbarui indeks saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda.
+ Sinkronisasi penuh: Indeks baru semua konten, ganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda.
+ Sinkronisasi baru, dimodifikasi, dihapus: Indeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir.
1. Di **Jadwal lari Sinkronisasi**, untuk **Frekuensi** —Pilih seberapa sering menyinkronkan konten sumber data Anda dan memperbarui indeks Anda.
1. Pilih **Berikutnya**.
1. Pada halaman **Setel pemetaan bidang**, masukkan informasi berikut:
1. Bidang **sumber data default —Pilih dari bidang** sumber data default yang Amazon Kendra dihasilkan yang ingin Anda petakan ke indeks Anda.
1. **Tambahkan bidang** —Untuk menambahkan bidang sumber data kustom untuk membuat nama bidang indeks untuk dipetakan dan tipe data bidang.
1. Pilih **Berikutnya**.
1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan.
------
#### [ API ]
**Untuk terhubung Amazon Kendra ke Slack**
Anda harus menentukan JSON dari [skema sumber data](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-schema-slack) menggunakan API. [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html) Anda harus memberikan informasi berikut ini:
+ **Sumber data** —Tentukan tipe sumber data seperti `SLACK` saat Anda menggunakan skema [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Tentukan juga sumber data seperti `TEMPLATE` saat Anda memanggil [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API.
+ **ID tim ruang kerja Slack —ID tim** Slack yang Anda salin dari URL halaman utama Slack Anda.
+ **Sejak tanggal —Tanggal** untuk mulai merayapi data Anda dari tim ruang kerja Slack Anda. Tanggal harus mengikuti format ini: yyyy-mm-dd.
+ **Mode sinkronisasi** —Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. Anda dapat memilih antara:
+ `FORCED_FULL_CRAWL`untuk mengindeks semua konten baru, mengganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda.
+ `FULL_CRAWL`untuk mengindeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir.
+ `CHANGE_LOG`untuk mengindeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir.
+ **Perayap identitas —Tentukan apakah akan mengaktifkan crawler** Amazon Kendra identitas. Perayap identitas menggunakan informasi daftar kontrol akses (ACL) untuk dokumen Anda untuk memfilter hasil penelusuran berdasarkan akses pengguna atau grup mereka ke dokumen. Jika Anda memiliki ACL untuk dokumen Anda dan memilih untuk menggunakan ACL Anda, Anda juga dapat memilih untuk mengaktifkan crawler Amazon Kendra identitas untuk mengonfigurasi [pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) dari hasil pencarian. Sebaliknya, jika perayap identitas dinonaktifkan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup untuk pemfilteran konteks pengguna.
+ **Rahasia Nama Sumber Daya Amazon (ARN)** —Berikan Nama Sumber Daya Amazon (ARN) Secrets Manager rahasia yang berisi kredensyal otentikasi untuk akun Slack Anda. Rahasianya disimpan dalam struktur JSON dengan kunci berikut:
```
{
"slackToken": "token"
}
```
+ **IAMperan** —Tentukan `RoleArn` kapan Anda menelepon `CreateDataSource` untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik yang diperlukan APIs untuk konektor Slack dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAMperan untuk sumber data Slack](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Anda juga dapat menambahkan fitur opsional berikut:
+ **Virtual Private Cloud (VPC) `VpcConfiguration` —Tentukan** kapan Anda menelepon. `CreateDataSource` Untuk informasi selengkapnya, lihat [Mengkonfigurasi Amazon Kendra untuk menggunakan Amazon VPC](vpc-configuration.md).
+ **Saluran tertentu** —Filter berdasarkan saluran publik atau pribadi, dan tentukan saluran tertentu berdasarkan ID mereka.
+ **Jenis saluran dan pesan** —Apakah Amazon Kendra harus mengindeks saluran publik dan pribadi Anda, grup dan pesan langsung Anda, serta bot Anda dan pesan yang diarsipkan. Jika Anda menggunakan token bot sebagai bagian dari kredensyal otentikasi Slack Anda, Anda harus menambahkan token bot ke saluran yang ingin Anda indeks. Anda tidak dapat mengindeks pesan langsung dan pesan grup menggunakan token bot.
+ **Lihat ke belakang** —Anda dapat memilih untuk mengonfigurasi `lookBack` parameter sehingga konektor Slack merayapi konten yang diperbarui atau dihapus hingga jumlah jam tertentu sebelum sinkronisasi konektor terakhir Anda.
+ **Filter inklusi dan pengecualian** —Tentukan apakah akan menyertakan atau mengecualikan konten Slack tertentu. Jika Anda menggunakan token bot sebagai bagian dari kredensyal otentikasi Slack Anda, Anda harus menambahkan token bot ke saluran yang ingin Anda indeks. Anda tidak dapat mengindeks pesan langsung dan pesan grup menggunakan token bot.
**catatan**
Sebagian besar sumber data menggunakan pola ekspresi reguler, yang merupakan pola inklusi atau pengecualian yang disebut sebagai filter. Jika Anda menentukan filter inklusi, hanya konten yang cocok dengan filter inklusi yang diindeks. Dokumen apa pun yang tidak cocok dengan filter inklusi tidak diindeks. Jika Anda menentukan filter inklusi dan pengecualian, dokumen yang cocok dengan filter pengecualian tidak akan diindeks, meskipun sesuai dengan filter inklusi.
+ **Pemetaan bidang** —Pilih untuk memetakan bidang sumber data Slack Anda ke bidang indeks Anda. Amazon Kendra Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**catatan**
Bidang badan dokumen atau badan dokumen yang setara untuk dokumen Anda diperlukan Amazon Kendra untuk mencari dokumen Anda. Anda harus memetakan nama bidang badan dokumen Anda di sumber data Anda ke nama bidang indeks`_document_body`. Semua kolom lain bersifat opsional.
Untuk daftar kunci JSON penting lainnya untuk dikonfigurasi, lihat [skema Slack template](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-schema-slack).
------
## Pelajari selengkapnya
Untuk mempelajari lebih lanjut tentang mengintegrasikan Amazon Kendra dengan sumber data Slack Anda, lihat:
+ [Mengungkap pengetahuan di ruang kerja Slack dengan pencarian cerdas menggunakan konektor Slack Amazon Kendra](https://aws.amazon.com/blogs/machine-learning/unravel-the-knowledge-in-slack-workspaces-with-intelligent-search-using-the-amazon-kendra-slack-connector/)