Zendeskガイド外部クロールコネクタのクロール設定を構成する

  • リリースバージョン: Zurich
  • 更新日 2025年07月30日
  • 所要時間:4分
  • コンテンツのクロールを実行するときに Zendesk Guide 外部コンテンツコネクタで考慮する記事のロケールと添付ファイルタイプを指定します。ドメインの包含フィルターまたは除外フィルターを定義して、ユーザー マッピング クロールの実行時にクロールがアクセス権限を取得するユーザーのセットを制限します。

    始める前に

    クロール設定を構成する Zendesk Guide 外部コンテンツコネクターをアドミンが既に作成している必要があります。この手順の詳細については、「Zendeskガイド外部コンテンツコネクタの作成」を参照してください。

    必要なロール:ais_admin

    このタスクについて

    このタスクはオプションです。デフォルトでは、 Zendesk Guide 外部コンテンツコネクタは、ユーザーマッピングのクロール中にソースシステムからすべてのユーザーをクロールします。コンテンツのクロール中、デフォルトでは、すべてのロケールからヘルプセンターの記事を取得し、サポートされているファイル拡張子を持つすべての添付ファイルを取得します。このタスクを実行する必要があるのは、コネクタで次のデフォルト以外の設定のいずれかを使用する場合のみです。
    • ユーザーマッピングクロールの実行時に、ソースシステムでユーザーアカウントがアクセスする包含フィルターまたは除外フィルター
    • コンテンツクロールを実行するときに考慮するヘルプセンター記事ロケールの包含フィルターまたは除外フィルター
    • コンテンツのクロールの実行時に取得する添付ファイル拡張子の包含フィルターまたは除外フィルター
    重要:

    デフォルトでは、外部コンテンツコネクタは、ソースシステムから最大 100 万 (1,000,000) つのドキュメントのインデックスを作成できます。コネクターがこの制限を超えると、ソースシステムのクロールを続行しますが、新しいドキュメントを無視して、ドキュメントの削除と更新のみをインデックス作成のために AI 検索 に送信します。コネクタは、インデックス作成の制限を超えてクロールする 10,000 ドキュメントごとにエラーメッセージをログに記録します。

    コネクタのインデックス付きドキュメントの数が 800,000 を超えると、コネクタの UI に、インデックス作成の制限に近づいていることを示す警告メッセージが表示されます。コネクタがインデックス作成の制限に達すると、その UI にエラーメッセージが表示されます。

    コネクタの 1 つがインデックス作成の制限に達した場合は、クロール設定とファイルの包含/除外フィルターを更新して、取得するドキュメントの数を減らすことができます。または、 1,000,000 件を超えるドキュメントのインデックスを作成する必要がある場合は、 カスタマーサービス & サポート ケースを https://support.servicenow.com/now 作成して、コネクタの制限の引き上げを要求できます。

    手順

    1. 移動先 すべて > 外部コンテンツコネクタ > 外部コンテンツアドミンホーム.
    2. [コネクタ] リストで、設定を変更する Zendesk Guide 外部コンテンツコネクタのレコードを選択します。
    3. コネクタエディターの 設定] タブで、[ [クロール設定] を選択します。
    4. ユーザーマッピングクロールの実行時にコネクタが取得するユーザーのメールアドレスのセットを指定するには、次のいずれかの ユーザーマッピングフィルタリング オプションを選択します。
      • ソースシステムからすべてのユーザーのユーザーマッピングを取得するには、[ すべてのユーザーをマップ] を選択します。
      • ソース システム内の指定されたドメインからのみユーザーのユーザー マッピングを取得するには、[ これらのユーザーをマップする] を選択し、[ 含めるユーザー メール アドレスのドメインを追加する ] フィールドと [追加 ] ボタンを使用して、ユーザー マッピング クロールに含めるユーザーのドメインを入力します。

        たとえば、指定したドメインのユーザーのユーザーマッピングのみを含めるには、「 example.com 」と入力できます。

    5. コンテンツのクロールの実行時にクロールされる記事のロケールのセットを指定するには、次のいずれかの ロケールフィルタリング オプションを選択します。
      • ソース システムで定義されているすべてのロケールから記事をクロールするには、[ すべてのロケールをクロール] を選択します。
      • ソース システムで定義されている指定したロケール セットの記事のみをクロールするには、[ これらのロケールのみを含める] を選択し、[ 含めるロケール ] フィールドを使用して、クロールに含める記事のロケールの識別子を入力します。

        たとえば、 en-USes-MX を入力すると、英語 (米国) またはスペイン語 (メキシコ) のロケールの記事から検索可能なコンテンツのみをクロールできます。

      • ソース システムで定義されている指定したロケール セットの記事を除くすべての記事をクロールするには、[ これらのロケールのみを除外する] を選択し、[ 除外するロケール ] フィールドを使用して、クロールから除外する記事のロケールの識別子を入力します。

        たとえば、 pt-BR と入力すると、ブラジル ポルトガル語ロケールの記事から検索可能なコンテンツを除外できます。

    タスクの結果

    Zendesk Guide 外部コンテンツコネクタが、変更したクロール設定で更新されます。

    次のタスク

    変更したクロール設定を使用して Zendesk Guide ソースシステムからコンテンツを取得するには、 Zendesk Guide 外部コンテンツコネクタの 1 回限りのコンテンツクロールを作成して実行します。1 回限りのコンテンツクロールの作成と実行については、「 外部コンテンツコネクタのコンテンツクロールの作成」を参照してください。