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. Amazon Bedrock コンソール (https://console.aws.amazon.com/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は非同期です。オペレーションが完了すると、データソースのステータスは から CREATING に移行AVAILABLEします。

コネクタパラメータ

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

次の手順

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