翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 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. Amazon Bedrock コンソール ([https://console.aws.amazon.com/bedrock/](https://console.aws.amazon.com/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 | いいえ | ナレッジ記事のクロールをスコープします。(ナレッジベースの sys IDs inclusionKnowledgeBaseSysIdsのリスト) と inclusionKnowledgeArticleCategorySysIds (ナレッジ記事カテゴリの sys IDs。 | 
| serviceCatalogFilter | いいえ | サービスカタログのクローリングをスコープします。(サービスカタログの sys IDs inclusionServiceCatalogSysIdsのリスト) と inclusionServiceCatalogCategorySysIds (サービスカタログカテゴリの sys IDs。大規模なインスタンスでは、sys ID でフィルタリングすると同期時間が大幅に短縮されます。 | 
| maxFileSizeInMegaBytes | いいえ | コネクタが取り込む 1 つのファイルの最大サイズ、メガバイト単位。数値文字列として を指定します (例: "500")。 | 

## 次の手順
<a name="kb-managed-ds-servicenow-connect-next"></a>

データソースを作成したら、データソースを同期してナレッジベースにコンテンツを取り込みます。詳細については、「[データソースを同期する](kb-managed-sync.md)」を参照してください。ServiceNow はドキュメントレベルのアクセスコントロールをサポートしていないため、ナレッジベースをクエリできるすべての認証済みユーザーは、クロールされたすべてのコンテンツを表示できます。