--- sourceDocument: Xanadu Now Platform の管理 sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/platform-administration Release : - xanadu ft:locale : - ja-JP ft:publication_title : - Xanadu Now Platform の管理 ft:clusterId : - platadm bundleId : - platadm workflow : - Platform --- # AI 検索 での外部コンテンツのインデックス作成と検索 # AI 検索 での外部コンテンツのインデックス作成と検索 {#ariaid-title1} * リリースバージョン: Xanadu * * 更新日 2024年08月01日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：7分 AI 検索 プラグインのサブスクリプションを使用すると、AI 検索 ユーザーが外部リポジトリのドキュメントとリモートテーブルのドキュメントからコンテンツとメタデータを検索できるようになります。 AI 検索 プラグインを使用すると、Now Platform インスタンスの外部にあるドキュメント (SharePoint コレクションや Confluence サイトに保存されているドキュメント、[リモートテーブル](https://www.servicenow.com/docs/access?context=remote-tables&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US)に保存されているドキュメントなど) のインデックスを作成できます。これらのドキュメントのインデックスを作成すると、AI 検索 でコンテンツとメタデータを検索できるようになります。 AI 検索 は、インデックス化された Now Platform レコードの場合と同様に、インデックス化された外部ドキュメントの検索結果を表示します。ユーザーは、外部ドキュメントのコンテンツとメタデータを照合するために特別な検索を実行する必要はありません。 インデックス作成では、外部ドキュメントが Now Platform インスタンスのレコードとして複製されることはありません。ユーザーが外部ドキュメント検索結果を選択すると、元の場所にあるソースドキュメントに移動します。 ## 外部コンテンツのインデックス作成ツール {#external-content-ais__section_f2n_klx_ksb} 次の図は、AI 検索 が外部ドキュメントのコンテンツとメタデータのインデックス作成と検索を可能にする仕組みを示しています。 図 : 1. AI 検索 外部コンテンツのアーキテクチャ図 アーキテクチャ図に示すように、次のいずれかまたはすべてのツールを使用して、外部ドキュメントのコンテンツとメタデータをインデックス化できます。 {#external-content-ais__table_cyt_kyw_ksb__entry__2} | 外部コンテンツのインデックス作成ツール | 説明 | |-|-| | 検索コネクタアプリケーション | ServiceNow Store で利用可能な検索コネクタアプリケーションは、サポートされている外部ソースのドキュメントからコンテンツとメタデータのインデックスを作成するための簡単なツールを提供します。外部コンテンツスキーマテーブルの作成など、一部の構成作業を処理します。 各検索コネクタアプリケーションは、特定の外部ドキュメントソース (または一連のソース) をサポートしています。たとえば、 [SharePoint Online 検索コネクタ](https://store.servicenow.com/sn_appstore_store.do#!/store/application/32e3b8addb2a5450e7048d7e13961908/) は SharePoint コレクション内のドキュメントのみをサポートしますが、 [Raytionコネクタハブ用 AI 検索](https://store.servicenow.com/sn_appstore_store.do#!/store/application/f7a8af54db9ee01035d0c6cd13961901/) は複数のドキュメントソースをサポートします。外部ドキュメントソースに使用できる検索コネクタアプリケーションがない場合は、統合ハブ AI 検索 スポークまたは外部コンテンツ REST API を使用して、そのソースのドキュメントのコンテンツとメタデータをインデックス化する必要があります。 検索コネクタアプリケーションは、サポートされている外部ソースからドキュメントのコンテンツとメタデータを簡単にインデックス化できるようにします。 | | 統合ハブ AI 検索 スポーク | 統合ハブ AI 検索 スポークは、インデックス作成のために外部ドキュメントを取り込む際に使用できる ワークフロースタジオ アクションを提供します。 * Ingest Document：外部ドキュメントのプロパティの名前と値のペアを定義し、そのドキュメントを AI 検索 に送信してインデックスを作成します。 * Ingest Document Using Download URL：外部ドキュメントの URL を指定し、AI 検索 でダウンロードしてインデックスを作成します。 {#external-content-ais__ul_xjy_ldx_ksb} これらのアクションを使用して取り込んだドキュメントに対して、セキュリティプリンシパルのアクセス権限を指定できます。外部ドキュメントコンテンツのアクセス権限とセキュリティの詳細については、「[AI 検索 の外部コンテンツセキュリティ](https://servicenow-prod.fluidtopics.net/CjRxz0rDl_KhysWUh_wNWA "AI 検索 は、外部ソースからインデックスを付けたドキュメントに指定されたユーザーおよびグループのセキュリティアクセス権限を保持します。外部で定義されたユーザーとグループを Now Platform ユーザーにマッピングすることで、外部コンテンツ検索結果へのアクセスを制御できます。")」を参照してください。 AI 検索 スポークによって提供されるワークフロースタジオアクションの完全なリストについては、以下を参照してください。 [AI 検索 スポーク](https://www.servicenow.com/docs/access?context=ai-search-spoke&version=xanadu&pubname=xanadu-integrate-applications&ft:locale=en-US). 統合ハブ AI 検索 スポークは、柔軟な構成と処理をシンプルなドラッグアンドドロップの ワークフロースタジオ インターフェイスと組み合わせています。 | | 外部コンテンツ REST API | 外部コンテンツ REST API は、外部ドキュメントのコンテンツとメタデータのインデックスを作成するために使用できるエンドポイントを提供します。 * ingestDocuments API エンドポイントを使用して、外部ドキュメントのテキストコンテンツとメタデータを AI 検索 に送信してインデックスを作成します。 * storeContent API エンドポイントを使用して、外部ドキュメントのバイナリコンテンツを AI 検索 にアップロードします。ingestDocuments エンドポイントを使用して、保存されたバイナリコンテンツをドキュメントフィードに関連付けることができます。 {#external-content-ais__ul_cph_nbx_ksb} 注: 外部コンテンツ REST API エンドポイントにアクセスするには、ais_external_content ロールまたは admin ロールのいずれかが必要です。 ingestDocuments エンドポイントを使用して取り込まれたドキュメントのセキュリティプリンシパルアクセス権限を指定できます。外部ドキュメントコンテンツのアクセス権限とセキュリティの詳細については、「[AI 検索 の外部コンテンツセキュリティ](https://servicenow-prod.fluidtopics.net/CjRxz0rDl_KhysWUh_wNWA "AI 検索 は、外部ソースからインデックスを付けたドキュメントに指定されたユーザーおよびグループのセキュリティアクセス権限を保持します。外部で定義されたユーザーとグループを Now Platform ユーザーにマッピングすることで、外部コンテンツ検索結果へのアクセスを制御できます。")」を参照してください。 External Content REST API の詳細については、「[External Content Ingestion REST API](https://www.servicenow.com/docs/access?context=external-content-ingestion-api&version=xanadu&pubname=xanadu-api-reference&ft:locale=en-US)」を参照してください。 外部コンテンツ REST API は、外部ドキュメントのコンテンツとメタデータのインデックスを作成するための最も複雑なツールですが、最も柔軟性があります。 | [ ] {#external-content-ais__table_cyt_kyw_ksb} ## 外部コンテンツ検索の前提条件 {#external-content-ais__section_kh5_ssw_ksb} AI 検索 で外部ドキュメントコンテンツとメタデータのインデックスを作成するには、次の要件を満たす必要があります。表に記載されている場合を除き、これらの要件は、使用する外部コンテンツのインデックス作成ツールに関係なく適用されます。 {#external-content-ais__table_eyp_xsw_ksb__entry__2} | 要件 | 説明 | |-|-| | AI 検索 プラグイン (com.glide.ais.external_content) のアクティブなサブスクリプションがある | AI 検索 プラグインは、外部データソースのコンテンツのインデックスを作成する機能を提供します。 プラグインのサブスクリプションを購入してアクティブ化する手順については、「[AI 検索 プラグインのために外部コンテンツを要求する](https://servicenow-prod.fluidtopics.net/aFNkj3AlJLipudPnBU_ncw "AI 検索 プラグインの外部コンテンツ (com.glide.ais.external_content) の有効化を要求して、外部データソースのレコードからの検索可能なコンテンツとメタデータのインデックス作成を有効にします。")」を参照してください。 | | 外部ドキュメントソースの外部コンテンツスキーマテーブルを定義する | 外部コンテンツスキーマテーブルは、外部ドキュメントのコンテンツをデータベースに保存しません。代わりに、その列は、外部データソースのコンテンツにインデックスを付けるときに入力する AI 検索 インデックスフィールドのマップとして機能します。 新しい外部コンテンツスキーマテーブルの作成手順については、「[外部コンテンツスキーマテーブルの作成](https://servicenow-prod.fluidtopics.net/D7YT7ANFUWKIjFBNwTrWXA "外部データソースのレコードのフィールドに対応する列を持つスキーマテーブルを定義します。AI 検索 は、外部データソースのコンテンツのインデックスを作成するときにスキーマを使用します。")」を参照してください。 複数の外部データソースのドキュメントが同じフィールドセットを共有し、一意のドキュメント識別子を持つ場合は、それらすべてに対して単一の外部コンテンツスキーマテーブルを使用できます。データ損失を回避するには、外部データソースがこれらの条件を満たす必要があります。 * 外部データソースのすべてのドキュメントには、コンテンツスキーマテーブルで定義されている列と一致する同じフィールドが含まれている必要があります。 * AI 検索 インデックスでドキュメントが互いに上書きされないように、外部データソース内のすべてのドキュメントには一意の識別子が必要です。 {#external-content-ais__ul_f2f_mrw_rnb} 外部データソースがこれらの条件を満たすことができない場合は、データソースごとに個別の外部コンテンツスキーマテーブルを作成します。 注: ServiceNow Store からの検索コネクタアプリケーションは、必要に応じて外部コンテンツスキーマテーブルを自動的に作成します。統合ハブ AI 検索 スポークまたは外部コンテンツ REST API を使用して外部ドキュメントをインデックス作成する場合は、独自の外部コンテンツスキーマテーブルのみ作成する必要があります。 | | インデックス化するテーブルとして指定された外部コンテンツスキーマテーブルを使用して、インデックス付きソースを作成する | インデックス付きソースは、外部ドキュメントのコンテンツとメタデータを AI 検索 インデックスに送信します。 インデックス付きソースを作成する手順については、「[インデックス付きソースを作成する](https://servicenow-prod.fluidtopics.net/LD1~DdcetgkOrVytPuWWhQ "AI 検索 を使用して Now Platform テーブルレコードからのコンテンツやメタデータを検索可能にするためのインデックス付きソースを定義します。")」を参照してください。 | | インデックス付きソースの検索ソースを 1 つ以上作成する | 各検索ソースは、AI 検索 でコンテンツを検索可能にするインデックス付きソースからの外部ドキュメントのサブセットを指定します。 検索ソースを作成する手順については、「[検索ソースの作成](https://servicenow-prod.fluidtopics.net/ErXaod~KH9rF9voRPJOBYw "検索ソースを定義することで、インデックス付きソースの検索可能コンテンツをユーザー検索エクスペリエンスで利用できるようになります。")」を参照してください。 | [ ] {#external-content-ais__table_eyp_xsw_ksb} * **[AI 検索 プラグインのために外部コンテンツを要求する](https://servicenow-prod.fluidtopics.net/aFNkj3AlJLipudPnBU_ncw)** AI 検索 プラグインの外部コンテンツ (com.glide.ais.external_content) の有効化を要求して、外部データソースのレコードからの検索可能なコンテンツとメタデータのインデックス作成を有効にします。 * **[外部コンテンツスキーマテーブルの作成](https://servicenow-prod.fluidtopics.net/D7YT7ANFUWKIjFBNwTrWXA)** 外部データソースのレコードのフィールドに対応する列を持つスキーマテーブルを定義します。AI 検索 は、外部データソースのコンテンツのインデックスを作成するときにスキーマを使用します。 * **[AI 検索 の外部コンテンツセキュリティ](https://servicenow-prod.fluidtopics.net/CjRxz0rDl_KhysWUh_wNWA)** AI 検索 は、外部ソースからインデックスを付けたドキュメントに指定されたユーザーおよびグループのセキュリティアクセス権限を保持します。外部で定義されたユーザーとグループを Now Platform ユーザーにマッピングすることで、外部コンテンツ検索結果へのアクセスを制御できます。 * **[External Content for AI 検索 と一緒にインストールされるコンポーネント](https://servicenow-prod.fluidtopics.net/mkmimPXyJo4Ng5tOMZff7w)** AI 検索 プラグイン (com.glide.ais.external_content) を有効にすると、新しい仮想テーブルが作成されます。