View a markdown version of this page

Hubungkan sumber ServiceNow data - Amazon Bedrock
Buat sumber dataParameter konektorLangkah selanjutnya

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

Hubungkan sumber ServiceNow data

Setelah Anda mengatur otentikasi dan menyimpan kredenSIAL Anda secara AWS Secrets Manager rahasia, buat sumber ServiceNow data di basis pengetahuan Anda. Halaman ini menjelaskan cara membuat sumber data dengan Konsol Manajemen AWS atau API, diikuti dengan referensi untuk parameter konektor yang dapat Anda konfigurasi.

catatan

Selesaikan pengaturan otentikasi terlebih dahulu. Lihat Siapkan otentikasi KredenSIAL Klien OAuth 2.0 untuk ServiceNow. Anda membutuhkan ARN rahasia.

Buat sumber data

Console
Untuk menyambungkan ServiceNow ke basis pengetahuan terkelola

  1. Buka konsol Amazon Bedrock di https://console.aws.amazon.com/bedrock/. Di panel navigasi, pilih Basis Pengetahuan dan buka basis pengetahuan terkelola Anda.

  2. Di bawah Sumber data, berikan nama untuk sumber data Anda.

  3. Dari daftar tipe sumber data, pilih ServiceNow.

  4. Untuk URL Host, masukkan URL ServiceNow instans Anda (misalnya,https://INSTANCE.service-now.com).

  5. Di bawah O tentikasi, pilih atau buat AWS Secrets Manager rahasia yang berisiclientId,clientSecret, daninstanceUrl.

  6. Di bawah cakupan sinkronisasi, pilih konten yang akan di-crawl: artikel pengetahuan, item katalog layanan, dan lampirannya. Anda juga dapat memilih apakah akan merayapi item katalog layanan yang tidak aktif dan apakah akan membatasi perayapan hanya pada artikel pengetahuan umum.

  7. (Opsional) Untuk membatasi crawling, tambahkan basis pengetahuan, kategori artikel pengetahuan, atau filter katalog layanan.

API

Untuk membuat sumber ServiceNow data, kirim CreateDataSource permintaan dengan titik akhir waktu pembuatan Agen untuk Amazon Bedrock. AWS Command Line Interface Contoh berikut membuat sumber ServiceNow data. Untuk deskripsi setiap bidang, lihat referensi parameter konektor berikut.

aws bedrock-agent create-data-source \
 --name "ServiceNow-connector" \
 --knowledge-base-id "your-knowledge-base-id" \
 --data-source-configuration file://servicenow-managed-connector.json

servicenow-managed-connector.jsonFile berisi yang berikut ini:

{
    "type": "MANAGED_KNOWLEDGE_BASE_CONNECTOR",
    "managedKnowledgeBaseConnectorConfiguration": {
        "connectorParameters": {
            "type": "SERVICENOW",
            "connectorType": "SERVICENOW",
            "version": "1",
            "connectionConfiguration": {
                "secretArn": "arn:aws:secretsmanager:us-west-2:123456789012:secret:bedrock-servicenow-creds",
                "authType": "OAUTH2",
                "hostUrl": "https://INSTANCE.service-now.com"
            },
            "dataEntityConfiguration": {
                "crawlKnowledgeArticles": true,
                "crawlServiceCatalogs": true,
                "crawlKnowledgeArticleAttachments": true,
                "crawlServiceCatalogAttachments": true,
                "crawlInactiveServiceCatalogItems": false,
                "crawlPublicKnowledgeArticlesOnly": false
            },
            "filterConfiguration": {
                "knowledgeArticleFilter": {
                    "inclusionKnowledgeBaseSysIds": ["optional-kb-sys-id"],
                    "inclusionKnowledgeArticleCategorySysIds": []
                },
                "serviceCatalogFilter": {
                    "inclusionServiceCatalogSysIds": [],
                    "inclusionServiceCatalogCategorySysIds": []
                },
                "maxFileSizeInMegaBytes": "500"
            }
        }
    }
}

dataEntityConfigurationBidang mengontrol entitas mana yang dirayapi konektor. Bid filterConfiguration ang ini opsional; gunakan untuk menjangkau crawling ke basis pengetahuan tertentu, kategori artikel pengetahuan, atau katalog layanan, dan untuk menetapkan ukuran file maksimum. Tanpa filter, konektor merayapi semua artikel pengetahuan aktif dan item katalog layanan.

Untuk basis pengetahuan terkelola, CreateDataSource tidak sinkron: transisi status sumber data dari CREATING ke AVAILABLE saat operasi selesai.

Parameter konektor

Konfigurasi sumber data menggunakan parameter konektor berikut. Di dalamconnectorParameters, atur keduanya type dan connectorType ke SERVICENOW dan atur version ke1. Untuk bidang yang membungkus connectorParameters (seperti deletionProtectionConfiguration danmediaExtractionConfiguration), lihatMenghubungkan sumber data.

Tabel berikut menjelaskan connectionConfiguration bidang.

KoneksiKonfigurasi
Bidang Diperlukan Deskripsi
secretArn Ya ARN AWS Secrets Manager rahasia yang berisi AndaclientId,clientSecret, daninstanceUrl.
hostUrl Ya URL ServiceNow instans Anda (misalnya,https://INSTANCE.service-now.com).
authType Ya Jenis otentikasi. ServiceNow mendukungOAUTH2. Lihat Metode otentikasi.

Tabel berikut menjelaskan dataEntityConfiguration bidang, yang mengontrol entitas yang dirayapi konektor.

data EntityConfiguration
Bidang Diperlukan Deskripsi
crawlKnowledgeArticles Ya Apakah akan merayapi artikel pengetahuan (kb_knowledge).
crawlServiceCatalogs Ya Apakah akan merayapi item katalog layanan (sc_cat_item).
crawlKnowledgeArticleAttachments Ya Apakah akan merayapi lampiran pada artikel pengetahuan.
crawlServiceCatalogAttachments Ya Apakah akan merayapi lampiran pada item katalog layanan.
crawlInactiveServiceCatalogItems Ya Apakah akan merayapi item katalog layanan yang tidak aktif.
crawlPublicKnowledgeArticlesOnly Ya Apakah akan membatasi crawling hanya untuk artikel pengetahuan publik.

Tabel berikut menjelaskan filterConfiguration bidang opsional, yang mencakup crawling.

FilterConfiguration (opsional)
Bidang Diperlukan Deskripsi
knowledgeArticleFilter Tidak Perayapan artikel pengetahuan cakupan. Ber inclusionKnowledgeBaseSysIds isi (daftar ID sistem basis pengetahuan) dan inclusionKnowledgeArticleCategorySysIds (daftar ID sistem kategori artikel pengetahuan).
serviceCatalogFilter Tidak Perayapan katalog layanan cakupan. Ber inclusionServiceCatalogSysIds isi (daftar ID sistem katalog layanan) dan inclusionServiceCatalogCategorySysIds (daftar ID sys kategori katalog layanan). Pada instans besar, pemfilteran dengan ID sys secara signifikan mengurangi waktu sinkronisasi.
maxFileSizeInMegaBytes Tidak Ukuran maksimum, dalam megabyte, dari setiap file tunggal yang dicerna konektor. Berikan sebagai string numerik (misalnya,"500").

Langkah selanjutnya

Setelah Anda membuat sumber data, sinkronkan untuk menelan konten ke basis pengetahuan Anda. Lihat perinciannya di Menyinkronkan sumber data. Karena ServiceNow tidak mendukung kontrol akses tingkat dokumen, semua pengguna terautentikasi yang dapat menanyakan basis pengetahuan dapat melihat semua konten yang dirayapi.