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](kb-managed-servicenow-oauth2-setup.md). 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/](https://console.aws.amazon.com/bedrock/). Di panel navigasi, pilih Basis ** Pengetahuan ** dan buka basis pengetahuan terkelola Anda.
1. Di bawah Sumber ** data**, berikan nama untuk sumber data Anda.
1. Dari ** daftar tipe sumber ** data, pilih ** ServiceNow**.
1. Untuk URL ** Host**, masukkan URL ServiceNow instans Anda (misalnya,`https://{{INSTANCE}}.service-now.com`).
1. Di ** bawah O ** tentikasi, pilih atau buat AWS Secrets Manager rahasia yang berisi`clientId`,`clientSecret`, dan`instanceUrl`.
1. 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.
1. (Opsional) Untuk membatasi crawling, tambahkan basis pengetahuan, kategori artikel pengetahuan, atau filter katalog layanan.
------
#### [ API ]
Untuk membuat sumber ServiceNow data, kirim [ CreateDataSource ](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateDataSource.html) 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.json`File 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"
}
}
}
}
```
`dataEntityConfiguration`Bidang 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 dalam`connectorParameters`, atur keduanya `type` dan `connectorType` ke `SERVICENOW` dan atur `version` ke`1`. Untuk bidang yang membungkus `connectorParameters` (seperti `deletionProtectionConfiguration` dan`mediaExtractionConfiguration`), lihat[Menghubungkan sumber data](kb-managed-connect-ds.md).
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](kb-managed-ds-servicenow.md#kb-managed-servicenow-auth-methods). |
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](kb-managed-sync.md). Karena ServiceNow tidak mendukung kontrol akses tingkat dokumen, semua pengguna terautentikasi yang dapat menanyakan basis pengetahuan dapat melihat semua konten yang dirayapi.