AI 検索 での外部コンテンツのインデックス作成と検索

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間:7分
  • の外部コンテンツ AI 検索 プラグインのサブスクリプションを使用すると、AI 検索 ユーザーが外部リポジトリのドキュメントとリモートテーブルのドキュメントからコンテンツとメタデータを検索できるようになります。

    の外部コンテンツ AI 検索 プラグインを使用すると、ServiceNow AI Platform® インスタンスの外部にあるドキュメント (SharePoint コレクションや Confluence サイトに保存されているドキュメント、リモートテーブルに保存されているドキュメントなど) のインデックスを作成できます。これらのドキュメントのインデックスを作成すると、AI 検索 でコンテンツとメタデータを検索できるようになります。

    AI 検索 は、インデックス化された ServiceNow AI Platform レコードの場合と同様に、インデックス化された外部ドキュメントの検索結果を表示します。ユーザーは、外部ドキュメントのコンテンツとメタデータを照合するために特別な検索を実行する必要はありません。

    インデックス作成では、外部ドキュメントが ServiceNow AI Platform インスタンスのレコードとして複製されることはありません。ユーザーが外部ドキュメント検索結果を選択すると、元の場所にあるソースドキュメントに移動します。

    外部コンテンツのインデックス作成ツール

    次の図は、AI 検索 が外部ドキュメントのコンテンツとメタデータのインデックス作成と検索を可能にする仕組みを示しています。

    図 : 1. AI 検索 外部コンテンツのアーキテクチャ図
    外部ドキュメントの AI 検索 インデックス作成と検索オプションを示す図。

    アーキテクチャ図に示すように、次のいずれかまたはすべてのツールを使用して、外部ドキュメントのコンテンツとメタデータをインデックス化できます。

    外部コンテンツのインデックス作成ツール 説明
    検索コネクタアプリケーション

    ServiceNow Store で利用可能な検索コネクタアプリケーションは、サポートされている外部ソースのドキュメントからコンテンツとメタデータのインデックスを作成するための簡単なツールを提供します。外部コンテンツスキーマテーブルの作成など、一部の構成作業を処理します。

    各検索コネクタアプリケーションは、特定の外部ドキュメントソース (または一連のソース) をサポートしています。たとえば、 SharePoint Online 検索コネクタ は SharePoint コレクション内のドキュメントのみをサポートしますが、 用の Raytion コネクタハブ AI 検索 は複数のドキュメントソースをサポートしています。外部ドキュメントソースに使用できる検索コネクタアプリケーションがない場合は、統合ハブ AI 検索 スポークまたは外部コンテンツ REST API を使用して、そのソースのドキュメントのコンテンツとメタデータをインデックス化する必要があります。

    検索コネクタアプリケーションは、サポートされている外部ソースからドキュメントのコンテンツとメタデータを簡単にインデックス化できるようにします。

    統合ハブ AI 検索 スポーク

    統合ハブ AI 検索 スポークは、インデックス作成のために外部ドキュメントを取り込む際に使用できる ワークフロースタジオ アクションを提供します。
    • Ingest Document:外部ドキュメントのプロパティの名前と値のペアを定義し、そのドキュメントを AI 検索 に送信してインデックスを作成します。
    • Ingest Document Using Download URL:外部ドキュメントの URL を指定し、AI 検索 でダウンロードしてインデックスを作成します。

    これらのアクションを使用して取り込んだドキュメントに対して、セキュリティプリンシパルのアクセス権限を指定できます。外部ドキュメントコンテンツのアクセス権限とセキュリティの詳細については、「AI 検索 の外部コンテンツセキュリティ」を参照してください。

    AI 検索スポークによって提供されるワークフロースタジオアクションの完全なリストについては、以下を参照してください。 AI 検索 スポーク.

    統合ハブ AI 検索 スポークは、柔軟な構成と処理をシンプルなドラッグアンドドロップの ワークフロースタジオ インターフェイスと組み合わせています。

    外部コンテンツ REST API
    外部コンテンツ REST API は、外部ドキュメントのコンテンツとメタデータのインデックスを作成するために使用できるエンドポイントを提供します。
    • ingestDocuments API エンドポイントを使用して、外部ドキュメントのテキストコンテンツとメタデータを AI 検索 に送信してインデックスを作成します。
    • storeContent API エンドポイントを使用して、外部ドキュメントのバイナリコンテンツを AI 検索 にアップロードします。ingestDocuments エンドポイントを使用して、保存されたバイナリコンテンツをドキュメントフィードに関連付けることができます。
    注:
    外部コンテンツ REST API エンドポイントにアクセスするには、ais_external_content ロールまたは admin ロールのいずれかが必要です。

    ingestDocuments エンドポイントを使用して取り込まれたドキュメントのセキュリティプリンシパルアクセス権限を指定できます。外部ドキュメントコンテンツのアクセス権限とセキュリティの詳細については、「AI 検索 の外部コンテンツセキュリティ」を参照してください。

    External Content REST API の詳細については、「External Content Ingestion REST API」を参照してください。

    外部コンテンツ REST API は、外部ドキュメントのコンテンツとメタデータのインデックスを作成するための最も複雑なツールですが、最も柔軟性があります。

    外部コンテンツ検索の前提条件

    AI 検索 で外部ドキュメントコンテンツとメタデータのインデックスを作成するには、次の要件を満たす必要があります。表に記載されている場合を除き、これらの要件は、使用する外部コンテンツのインデックス作成ツールに関係なく適用されます。

    要件 説明

    の外部コンテンツ AI 検索 プラグイン (com.glide.ais.external_content) のアクティブなサブスクリプションがある

    の外部コンテンツ AI 検索 プラグインは、外部データソースのコンテンツのインデックスを作成する機能を提供します。

    プラグインのサブスクリプションを購入してアクティブ化する手順については、「AI 検索 プラグインのために外部コンテンツを要求する」を参照してください。

    外部ドキュメントソースの外部コンテンツスキーマテーブルを定義する

    外部コンテンツスキーマテーブルは、外部ドキュメントのコンテンツをデータベースに保存しません。代わりに、その列は、外部データソースのコンテンツにインデックスを付けるときに入力する AI 検索 インデックスフィールドのマップとして機能します。

    新しい外部コンテンツスキーマテーブルの作成手順については、「外部コンテンツスキーマテーブルの作成」を参照してください。

    複数の外部データソースのドキュメントが同じフィールドセットを共有し、一意のドキュメント識別子を持つ場合は、それらすべてに対して単一の外部コンテンツスキーマテーブルを使用できます。データ損失を回避するには、外部データソースがこれらの条件を満たす必要があります。
    • 外部データソースのすべてのドキュメントには、コンテンツスキーマテーブルで定義されている列と一致する同じフィールドが含まれている必要があります。
    • AI 検索 インデックスでドキュメントが互いに上書きされないように、外部データソース内のすべてのドキュメントには一意の識別子が必要です。

    外部データソースがこれらの条件を満たすことができない場合は、データソースごとに個別の外部コンテンツスキーマテーブルを作成します。

    注:
    ServiceNow Store からの検索コネクタアプリケーションは、必要に応じて外部コンテンツスキーマテーブルを自動的に作成します。統合ハブ AI 検索 スポークまたは外部コンテンツ REST API を使用して外部ドキュメントをインデックス作成する場合は、独自の外部コンテンツスキーマテーブルのみ作成する必要があります。
    インデックス化するテーブルとして指定された外部コンテンツスキーマテーブルを使用して、インデックス付きソースを作成する

    インデックス付きソースは、外部ドキュメントのコンテンツとメタデータを AI 検索 インデックスに送信します。

    インデックス付きソースを作成する手順については、「インデックス付きソースを作成する」を参照してください。

    インデックス付きソースの検索ソースを 1 つ以上作成する

    各検索ソースは、AI 検索 でコンテンツを検索可能にするインデックス付きソースからの外部ドキュメントのサブセットを指定します。

    検索ソースを作成する手順については、「の検索ソースの作成 AI 検索」を参照してください。