View a markdown version of this page

ServiceNow konektor V2.0 - Amazon Kendra
Fitur yang didukungPrasyaratInstruksi koneksiPelajari selengkapnya

Amazon Kendra Tidak lagi terbuka untuk pelanggan baru. Untuk kemampuan yang mirip dengan Amazon Kendra, jelajahi Amazon Bedrock Knowledge Bases. Pelajari selengkapnya.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

ServiceNow konektor V2.0

ServiceNow menyediakan sistem manajemen layanan berbasis cloud untuk membuat dan mengelola alur kerja tingkat organisasi, seperti layanan TI, sistem tiket, dan dukungan. Anda dapat menggunakannya Amazon Kendra untuk mengindeks ServiceNow katalog, artikel pengetahuan, insiden, dan lampirannya.

Untuk mengatasi masalah konektor sumber Amazon Kendra ServiceNow data Anda, lihatMengatasi masalah sumber data.

Fitur yang didukung

Amazon Kendra ServiceNow konektor sumber data mendukung fitur berikut:

  • Pemetaan bidang

  • Kontrol akses pengguna

  • Inclusion/exclusion filter

  • Sinkronisasi konten penuh dan tambahan

  • ServiceNow versi contoh: Roma, Sandiego, Tokyo, Lainnya

  • Cloud privat virtual (VPC)

Prasyarat

Sebelum Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber ServiceNow data Anda, buat perubahan ini di AWS akun ServiceNow dan Anda.

Di ServiceNow, pastikan Anda memiliki:

  • Membuat Instans Pengembang Pribadi atau Perusahaan dan memiliki ServiceNow instance dengan peran administratif.

  • Menyalin host URL ServiceNow instans Anda. Format untuk URL host yang Anda masukkan adalahyour-domain.service-now.com. Anda memerlukan URL ServiceNow instans untuk terhubung Amazon Kendra.

  • Catat kredentif otentikasi dasar Anda dari nama pengguna dan kata sandi Amazon Kendra untuk memungkinkan tersambung ke ServiceNow instance Anda.

    catatan

    Kami menyarankan Anda menyegarkan atau memutar kredenSIAL dan rahasia Anda secara teratur. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami tidak menyarankan Anda menggunakan kembali kredensi dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku).

  • Opsional: Konfigurasi kredentif klien OAuth 2.0 yang dapat mengidentifikasi Amazon Kendra menggunakan nama pengguna, kata sandi, dan ID klien yang dihasilkan, dan rahasia klien. Lihat ServiceNow dokumentasi tentang otentikasi OAuth 2.0 untuk informasi selengkapnya.

  • Menambahkan izin berikut:

    • kb_category

    • kb_knowledge

    • kb_knowledge_base

    • kb_uc_cannot_read_mtom

    • kb_uc_can_read_mtom

    • sc_catalog

    • sc_category

    • sc_cat_item

    • sys_attachment

    • sys_attachment_doc

    • sys_user_role

  • Diperiksa setiap dokumen unik di dalam ServiceNow 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. ID dokumen bersifat global untuk indeks dan harus unik per indeks.

Di dalam Anda Akun AWS, pastikan Anda memiliki:

  • Membuat Amazon Kendra indeks dan, jika menggunakan API, catat ID indeks.

  • Membuat IAM peran untuk sumber data Anda dan, jika menggunakan API, catat ARN IAM peran tersebut.

    catatan

    Jika Anda mengubah jenis dan kredentif otentikasi, Anda harus memperbarui IAM peran Anda untuk mengakses ID AWS Secrets Manager rahasia yang benar.

  • Meny ServiceNow impan kredentif otentikasi Anda secara AWS Secrets Manager rahasia dan, jika menggunakan API, catat ARN rahasia tersebut.

    catatan

    Kami menyarankan Anda menyegarkan atau memutar kredenSIAL dan rahasia Anda secara teratur. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami tidak menyarankan Anda menggunakan kembali kredensi 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 ServiceNow data Anda ke Amazon Kendra. Jika Anda menggunakan API, Anda harus memberikan ARN dari IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks.

Instruksi koneksi

Untuk terhubung Amazon Kendra ke sumber ServiceNow data Anda, Anda harus memberikan rincian yang diperlukan dari sumber ServiceNow data Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengonfigurasi ServiceNow untuk Amazon Kendra lihatPrasyarat.

Console

Untuk terhubung Amazon Kendra ke ServiceNow

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

  2. 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.

  3. Pada halaman Memulai, pilih Tambahkan sumber data.

  4. Pada halaman Tambahkan sumber data, pilih ServiceNow konektor, lalu pilih Tam bah konektor. Jika menggunakan versi 2 (jika ada), pilih ServiceNow konektor dengan tag V2.0 "”.

  5. 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 menyertakan tanda hubung tetapi bukan spasi.

    2. (Opsional) Deskripsi —Masukkan deskripsi opsional untuk sumber data Anda.

    3. Dalam bahasa Def ault —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default adalah bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen menggantikan bahasa yang dipilih.

    4. Di Tag, untuk Tambahkan tag baru —Sertakan tag opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda.

    5. Pilih Berikutnya.

  6. Pada halaman Tentukan akses dan keamanan, masukkan informasi berikut:

    1. ServiceNow host —Masukkan URL ServiceNow host. Format untuk URL host yang Anda masukkan adalahyour-domain.service-now.com.

    2. ServiceNow versi —Pilih versi ServiceNow instance Anda. Anda dapat memilih dari Roma, Sandiego, Tokyo, atau Lainnya.

    3. O torisasi — Aktifkan atau menonaktifkan 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.

    4. Otentikasi —Pilih antara otentikasi dasar dan otentikasi Oauth 2.0.

    5. AWS Secrets Manager rahasia —Pilih rahasia yang ada atau buat Secrets Manager rahasia baru untuk menyimpan kredentif ServiceNow otentikasi Anda. Jika Anda memilih untuk membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka. Masukkan informasi berikut di jendela:

      1. Nama rahasia —Nama untuk rahasia Anda. Awalan 'AmazonKendra-ServiceNow-' secara otomatis ditambahkan ke nama rahasia Anda.

      2. Jika menggunakan Otentikasi Dasar—Masukkan nama Rah asia, Nama Pengguna, dan Kata Sandi untuk akun Anda. ServiceNow

        Jika menggunakan O OAuth2.0 tentikasi—Masukkan nama Rah asia, Nama Pengguna, Kata Sandi, ID Kli en, dan Rahasia Klien yang Anda buat di akun Anda. ServiceNow

      3. Simpan dan tambahkan rahasia Anda.

    6. Virtual Private Cloud (VPC) —Anda dapat memilih untuk menggunakan VPC. Jika demikian, Anda harus menambahkan Subnets dan grup keamanan VPC.

    7. Identity crawler —Tentukan apakah akan mengaktifkan peray Amazon Kendra ap identitas. Perayap identitas menggunakan informasi daftar kontrol akses (ACL) untuk dokumen Anda untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Jika Anda memiliki ACL untuk dokumen Anda dan memilih untuk menggunakan ACL Anda, Anda juga dapat memilih untuk mengaktifkan perayap Amazon Kendra identitas untuk mengonfigurasi pemfilteran konteks pengguna hasil pencarian. Sebaliknya, jika perayap identitas dinonaktifkan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan perayap identitas dimatikan, Anda dapat menggunakan PutPrincipalMapping API untuk mengunggah informasi akses pengguna dan grup untuk pemfilteran konteks pengguna.

    8. IAM peran —Pilih peran yang ada atau buat IAM IAM peran baru untuk mengakses kredentif repositori dan konten indeks Anda.

      catatan

      IAM peran 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.

    9. Pilih Berikutnya.

  7. Pada halaman Konfigurasi pengaturan sinkronisasi, masukkan informasi berikut:

    1. Untuk artikel Peng etahuan, pilih dari opsi berikut:

      • Artikel pengetahuan —Pilih untuk mengindeks artikel pengetahuan.

      • Lampiran artikel pengetahuan —Pilih untuk mengindeks lampiran artikel pengetahuan.

      • Jenis artikel pengetahuan —Pilih antara Hanya artikel publik dan Artikel Peng etahuan berdasarkan kueri ServiceNow filter berdasarkan kasus penggunaan Anda. Jika Anda memilih Ser takan artikel berdasarkan kueri ServiceNow filter, Anda harus memasukkan kueri Filter yang disalin dari ServiceNow akun Anda. Contoh kueri filter meliputi:workflow_state=draft^EQ,kb_knowledge_base=dfc19531bf2021003f07e2c1ac0739ab^text ISNOTEMPTY^EQ,article_type=text^active=true^EQ.

        penting

        Jika Anda memilih untuk meray api Hanya artikel publik, Amazon Kendra hanya akan merayapi artikel pengetahuan yang diberi peran akses publik. ServiceNow

      • Sertakan artikel berdasarkan filter deskripsi singkat —Tentukan pola ekspresi reguler untuk menyertakan atau mengecualikan artikel tertentu.

    2. Untuk item katalog Layanan:

      • Item katalog layanan —Pilih untuk mengindeks item katalog layanan.

      • Lampiran item katalog layanan —Pilih untuk mengindeks lampiran item katalog layanan.

      • Item katalog layanan aktif —Pilih untuk mengindeks item katalog layanan aktif.

      • Item katalog layanan tidak aktif —Pilih untuk mengindeks item katalog layanan yang tidak aktif.

      • Filter query —Pilih untuk menyertakan item katalog layanan berdasarkan filter yang ditentukan dalam ServiceNow instance Anda. Contoh kueri filter meliputi:short_descriptionLIKEAccess^category=2809952237b1300054b6a3549dbe5dd4^EQ,nameSTARTSWITHService^active=true^EQ.

      • Sertakan item katalog layanan berdasarkan filter deskripsi singkat —Tentukan pola regex untuk menyertakan item katalog tertentu.

    3. Untuk Insiden:

      • Insiden —Pilih untuk mengindeks insiden layanan.

      • Lampiran insiden —Pilih untuk mengindeks lampiran insiden.

      • Insiden aktif —Pilih untuk mengindeks insiden aktif.

      • Insiden tidak aktif — Pilih untuk mengindeks insiden tidak aktif.

      • Jenis insiden aktif —Pilih antara Semua insiden, Insiden terbuka, Ter buka - insiden yang tidak ditetapkan, dan Insiden ter selesaikan tergantung pada kasus penggunaan Anda.

      • Filter query —Pilih untuk menyertakan insiden berdasarkan filter yang ditentukan dalam ServiceNow instance Anda. Contoh kueri filter meliputi:short_descriptionLIKETest^urgency=3^state=1^EQ,priority=2^category=software^EQ .

      • Sertakan insiden berdasarkan filter deskripsi singkat —Tentukan pola regex untuk menyertakan insiden tertentu.

    4. Untuk konfigurasi tambahan:

      • Informasi ACL —Daftar kontrol akses untuk entitas yang telah Anda pilih disertakan secara default. Menghapus pilihan daftar kontrol akses akan membuat semua file dalam kategori itu publik. Opsi ACL secara otomatis dinonaktifkan untuk entitas yang tidak dipilih. Untuk artikel publik ACL tidak diterapkan.

      • Untuk Ukuran file maksimum — Tentukan batas ukuran file dalam MB yang akan di-crawl oleh Amazon Kendra. Amazon Kendra hanya akan merayapi file dalam batas ukuran yang Anda tentukan. Ukuran default file adalah 50 MB. Ukuran file maksimum harus lebih besar dari 0 MB dan kurang dari atau sama dengan 50 MB.

      • Pola regex lampiran —Tambahkan pola ekspresi reguler untuk menyertakan atau mengecualikan file katalog, artikel pengetahuan, dan insiden terlampir tertentu. Anda dapat menambahkan hingga 100 pola.

    5. Mode sinkronisasi —Pilih cara Anda ingin memperbarui indeks saat konten sumber data berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten akan di-crawl dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data jika sinkronisasi awal gagal, meskipun Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi.

      • Sinkronisasi penuh: Indeks semua konten baru, 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 Kendra dapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir.

    6. Dalam jadwal jalankan Sin kronisasi, untuk Frekuensi —Pilih seberapa sering menyinkronkan konten sumber data Anda dan memperbarui indeks Anda.

    7. Pilih Berikutnya.

  8. Pada halaman Set pemetaan bidang, masukkan informasi berikut:

    1. Pemetaan bidang default —Pilih dari bidang sumber data default Amazon Kendra yang dihasilkan yang ingin Anda petakan ke indeks Anda.

    2. Tambahkan bidang —Untuk menambahkan bidang sumber data kustom untuk membuat nama bidang indeks untuk dipetakan dan jenis data bidang.

    3. Pilih Berikutnya.

  9. Pada halaman Tinjau dan buat, periksa apakah informasi yang Anda masukkan benar, lalu 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 ServiceNow

Anda harus menentukan JSON dari skema sumber data menggunakan TemplateConfiguration API. Anda harus memberikan informasi berikut ini:

  • Sumber data —Tentukan jenis sumber data seperti SERVICENOWV2 saat Anda menggunakan skema TemplateConfiguration JSON. Juga tentukan sumber data seperti TEMPLATE saat Anda memanggil CreateDataSource API.

  • URL host —Tentukan versi instance ServiceNow host. Misalnya, your-domain.service-now.com.

  • Jenis otentikasi —Tentukan jenis otentikasi yang Anda gunakan, baik untuk instans Anda basicAuth maupun OAuth2 untuk ServiceNow instans Anda.

  • ServiceNow versi instance —Tentukan ServiceNow instance yang Anda gunakan, apakahTokyo,, SandiegoRome, atauOthers.

  • Mode sinkronisasi —Tentukan bagaimana Amazon Kendra harus memperbarui indeks Anda saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten akan di-crawl dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data jika sinkronisasi awal gagal, meskipun Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi. Anda dapat memilih antara:

    • FORCED_FULL_CRAWLuntuk mengindeks semua konten baru, mengganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda.

    • FULL_CRAWLuntuk mengindeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendra dapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir.

  • Nama Sumber Daya Amazon Rahasia (ARN) —Berikan Nama Sumber Daya Amazon (ARN) dari Secrets Manager rahasia yang berisi kredentif otentikasi yang Anda buat di ServiceNow akun Anda.

    Jika Anda menggunakan otentikasi dasar, rahasia disimpan dalam struktur JSON dengan kunci berikut:

    {
    "username": "user name",
    "password": "password"
}

  • Jika Anda menggunakan kredenSIAL klien OAuth2, rahasia disimpan dalam struktur JSON dengan kunci berikut:

    {
    "username": "user name",
    "password": "password",
    "clientId": "client id",
    "clientSecret": "client secret"
}

  • IAM role —T RoleArn entukan kapan Anda memang CreateDataSource gil untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan untuk memanggil API publik yang diperlukan untuk ServiceNow konektor dan Amazon Kendra. Untuk informasi selengkapnya, lihat IAM peran untuk sumber ServiceNow data.

Anda juga dapat menambahkan fitur opsional berikut:

  • Virtual Private Cloud (VPC) —Tentukan VpcConfiguration kapan Anda menelepon. CreateDataSource Untuk informasi selengkapnya, lihat Mengkonfigurasi Amazon Kendra untuk menggunakan Amazon VPC.

  • Filter inklusi dan pengecualian —Anda dapat menentukan apakah akan menyertakan atau mengecualikan file terlampir tertentu menggunakan nama file dan jenis file artikel pengetahuan, katalog layanan, dan insiden.

    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 diindeks, bahkan jika dokumen tersebut cocok dengan filter inklusi.

  • Dokumen spesifik untuk diindeks —Anda dapat menggunakan ServiceNow kueri untuk menentukan dokumen yang Anda inginkan dari satu atau lebih basis pengetahuan, termasuk basis pengetahuan pribadi. Akses ke basis pengetahuan ditentukan oleh pengguna yang Anda gunakan untuk terhubung ke ServiceNow instance. Untuk informasi selengkapnya, lihat Menentukan dokumen untuk diindeks dengan kueri.

  • Parameter pengindeksan —Anda juga dapat memilih untuk menentukan apakah akan:

    • Indeks artikel pengetahuan, katalog layanan, dan insiden atau semua ini. Jika Anda memilih untuk mengindeks artikel pengetahuan, item katalog layanan, dan insiden, Anda harus memberikan nama ServiceNow bidang yang dipetakan ke bidang konten dokumen indeks dalam Amazon Kendra indeks.

    • Indeks lampiran untuk artikel pengetahuan, item katalog layanan, dan insiden.

    • Sertakan artikel pengetahuan, item katalog layanan, dan insiden berdasarkan pola short description filter.

    • Pilih untuk memfilter item dan insiden katalog layanan aktif dan tidak aktif.

    • Pilih untuk memfilter insiden berdasarkan jenis insiden.

    • Pilih entitas mana yang harus dirayapi ACL mereka.

    • Anda dapat menggunakan ku ServiceNow eri untuk menentukan dokumen yang Anda inginkan dari satu atau lebih basis pengetahuan, termasuk basis pengetahuan pribadi. Akses ke basis pengetahuan ditentukan oleh pengguna yang Anda gunakan untuk terhubung ke ServiceNow instance. Untuk informasi selengkapnya, lihat Menentukan dokumen untuk diindeks dengan kueri.

  • Identity crawler —Tentukan apakah akan mengaktifkan peray Amazon Kendra ap identitas. Perayap identitas menggunakan informasi daftar kontrol akses (ACL) untuk dokumen Anda untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Jika Anda memiliki ACL untuk dokumen Anda dan memilih untuk menggunakan ACL Anda, Anda juga dapat memilih untuk mengaktifkan perayap Amazon Kendra identitas untuk mengonfigurasi pemfilteran konteks pengguna hasil pencarian. Sebaliknya, jika perayap identitas dinonaktifkan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan perayap identitas dimatikan, Anda dapat menggunakan PutPrincipalMapping API untuk mengunggah informasi akses pengguna dan grup untuk pemfilteran konteks pengguna.

  • Pemetaan bidang —Pilih untuk memetakan bidang sumber ServiceNow data Anda ke bidang indeks Anda Amazon Kendra . Untuk informasi lebih lanjut, lihat Memetakan bidang sumber data.

    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 ServiceNow template.

Pelajari selengkapnya

Untuk mempelajari lebih lanjut tentang mengintegrasikan Amazon Kendra dengan sumber ServiceNow data Anda, lihat: