本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 連接 ServiceNow 資料來源
<a name="kb-managed-ds-servicenow-connect"></a>

在您設定身分驗證並將登入資料存放在 AWS Secrets Manager 秘密之後，請在知識庫中建立 ServiceNow 資料來源。此頁面說明如何使用 AWS 管理主控台 或 API 建立資料來源，後面接著您可以設定的連接器參數參考。

**注意**  
請先完成身分驗證設定。請參閱 [設定 ServiceNow 的 OAuth 2.0 用戶端登入資料驗證](kb-managed-servicenow-oauth2-setup.md)。您需要秘密 ARN。

## 建立資料來源
<a name="kb-managed-ds-servicenow-create"></a>

------
#### [ Console ]

**將 ServiceNow 連線至您的受管知識庫**

1. 開啟位於 [https://console.aws.amazon.com/bedrock/](https://console.aws.amazon.com/bedrock/) 的 Amazon Bedrock 主控台。在導覽窗格中，選擇**知識庫**並開啟您的受管知識庫。

1. 在**資料來源**下，提供資料來源的名稱。

1. 從**資料來源類型**清單中，選取 **ServiceNow**。

1. 針對**主機 URL**，輸入您的 ServiceNow 執行個體 URL （例如 `https://{{INSTANCE}}.service-now.com`)。

1. 在**身分驗證**下，選取或建立包含您的 `clientId`、 `clientSecret`和 的 AWS Secrets Manager 秘密`instanceUrl`。

1. 在**同步範圍**下，選取要爬取的內容：知識文章、服務目錄項目及其附件。您也可以選擇是否編目非作用中的服務目錄項目，以及是否僅將編目限制為公有知識文章。

1. （選用） 若要限制網路爬取，請新增知識庫、知識文章類別或服務目錄篩選條件。

------
#### [ API ]

若要建立 ServiceNow 資料來源，請使用 Amazon Bedrock 建置時間端點的代理程式傳送 [CreateDataSource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateDataSource.html) 請求。下列 AWS Command Line Interface 範例會建立 ServiceNow 資料來源。如需每個欄位的說明，請參閱以下連接器參數參考。

```
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` 檔案包含下列項目：

```
{
    "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` 欄位控制連接器爬取的實體。`filterConfiguration` 欄位為選用；用來將網路爬取範圍限定為特定知識庫、知識文章類別或服務目錄，以及設定檔案大小上限。如果沒有篩選條件，連接器會編目所有作用中的知識文章和服務目錄項目。

對於受管知識庫， `CreateDataSource`是非同步的：當操作完成`CREATING``AVAILABLE`時，資料來源狀態會從 轉換為 。

------

## 連接器參數
<a name="kb-managed-config-servicenow"></a>

資料來源組態使用下列連接器參數。在 中`connectorParameters`，同時將 `type`和 `connectorType` 設定為 `SERVICENOW`，並將 `version`設定為 `1`。如需包裝的欄位 `connectorParameters`（例如 `deletionProtectionConfiguration`和 `mediaExtractionConfiguration`)，請參閱 [連接資料來源](kb-managed-connect-ds.md)。

下表說明`connectionConfiguration`欄位。


**connectionConfiguration**  

| 欄位 | 必要 | 描述 | 
| --- | --- | --- | 
| secretArn | 是 | 包含您 clientId、 clientSecret和 之 AWS Secrets Manager 秘密的 ARNinstanceUrl。 | 
| hostUrl | 是 | 您的 ServiceNow 執行個體 URL （例如 https://{{INSTANCE}}.service-now.com)。 | 
| authType | 是 | 驗證類型。ServiceNow 支援 OAUTH2。請參閱 [身分驗證方法](kb-managed-ds-servicenow.md#kb-managed-servicenow-auth-methods)。 | 

下表說明欄位，這些`dataEntityConfiguration`欄位控制連接器爬取的實體。


**dataEntityConfiguration**  

| 欄位 | 必要 | 描述 | 
| --- | --- | --- | 
| crawlKnowledgeArticles | 是 | 是否要編目知識文章 (kb\_knowledge)。 | 
| crawlServiceCatalogs | 是 | 是否編目服務目錄項目 (sc\_cat\_item)。 | 
| crawlKnowledgeArticleAttachments | 是 | 是否在知識文章上爬取附件。 | 
| crawlServiceCatalogAttachments | 是 | 是否在服務目錄項目上爬取附件。 | 
| crawlInactiveServiceCatalogItems | 是 | 是否編目非作用中的服務目錄項目。 | 
| crawlPublicKnowledgeArticlesOnly | 是 | 是否僅將網路爬取限制為公有知識文章。 | 

下表說明選用`filterConfiguration`欄位，也就是網路爬取的範圍。


**filterConfiguration （選用）**  

| 欄位 | 必要 | 說明 | 
| --- | --- | --- | 
| knowledgeArticleFilter | 否 | 範圍知識文章爬取。包含 inclusionKnowledgeBaseSysIds（知識庫 sys IDs 清單） 和 inclusionKnowledgeArticleCategorySysIds（知識庫文章類別 sys IDs清單）。 | 
| serviceCatalogFilter | 否 | Scopes 服務目錄爬取。包含 inclusionServiceCatalogSysIds（服務目錄 sys IDs的清單） 和 inclusionServiceCatalogCategorySysIds（服務目錄類別 sys IDs的清單）。在大型執行個體上，依 sys ID 篩選可大幅縮短同步時間。 | 
| maxFileSizeInMegaBytes | 否 | 連接器擷取之任何單一檔案的大小上限，以 MB 為單位。提供 做為數值字串 （例如，"500")。 | 

## 後續步驟
<a name="kb-managed-ds-servicenow-connect-next"></a>

建立資料來源之後，請同步資料來源，以將內容擷取到您的知識庫。如需詳細資訊，請參閱[同步資料來源](kb-managed-sync.md)。由於 ServiceNow 不支援文件層級存取控制，因此所有可查詢知識庫的已驗證使用者都可以查看所有編目的內容。