View a markdown version of this page

連接 ServiceNow 資料來源 - Amazon Bedrock
建立資料來源連接器參數後續步驟

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

連接 ServiceNow 資料來源

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

注意

請先完成身分驗證設定。請參閱 設定 ServiceNow 的 OAuth 2.0 用戶端登入資料驗證。您需要秘密 ARN。

建立資料來源

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

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

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

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

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

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

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

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

API

若要建立 ServiceNow 資料來源，請使用 Amazon Bedrock 建置時間端點的代理程式傳送 CreateDataSource 請求。下列 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是非同步的：當操作完成CREATINGAVAILABLE時，資料來源狀態會從 轉換為 。

連接器參數

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

下表說明connectionConfiguration欄位。

connectionConfiguration
欄位 必要 描述
secretArn 是 包含您 clientId、 clientSecret和 之 AWS Secrets Manager 秘密的 ARNinstanceUrl。
hostUrl 是 您的 ServiceNow 執行個體 URL （例如 https://INSTANCE.service-now.com)。
authType 是 驗證類型。ServiceNow 支援 OAUTH2。請參閱 身分驗證方法。

下表說明欄位，這些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")。

後續步驟

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