メインコンテンツにスキップ

ウェブサイトを同期および管理する

ウェブサイトの公開URLからFinをトレーニングする方法。

Finをウェブサイトのコンテンツでトレーニングしたい場合は、そのサイトの公開URLを同期することで可能です。


始める

Train > Content に移動し、「Add content」セクションの下にあるWebsite syncを選択します。

次に、ウェブサイトの公開URL(トップレベルdomain)を入力し、Next.をクリックします。

これにより、指定したウェブサイトURLのすべてのページが取得され、すべてのサブdomainページから読み取られます。

ヒント:

同期するページを確認する

URLを入力すると、有効でアクセス可能かどうかを確認します。その後、同期するページを確認する必要があります。選択した各セクションにリンクされているすべてのサブページが同期されます。関連性の高い最新のコンテンツのみを選択してください。

詳細設定 [オプション]

ウェブサイト同期の設定をさらに調整したい場合(特定のURLを含めるまたは除外するなど)は、詳細設定をクリックしてください。

追加のURL

ウェブサイトの構造はさまざまです。最も関連性の高いコンテンツを同期するために、特定のサブページの追加URLを追加することをお勧めします。

例えば、上記でhttps://myhelpcenter.com/helpを主要URLとして入力した場合、https://myhelpcenter.com/help/index.htmlのような特定のURLも追加したいかもしれません。

除外するURL

同期したくない特定のページを除外するには、URLグロブのリストを追加できます。

URLグロブとは?

グロブとは、ファイルパスやURLをマッチさせるために使用されるリテラル文字列および/またはワイルドカード文字の連なりです。グロビングは、1つ以上のグロブを使ってファイルシステム上のファイルを見つける行為です。URLグロブを使うことで、ほとんど同じで一部だけが異なる複数のURLを取得できます。

例えば、このURLグロブ https://{store,docs}.example.com/** は、https://store.example.com/ または https://docs.example.com/ で始まるすべてのURLにクロールアクセスを許可します。https://example.com/**/*\?*foo=*

含めるページ要素

特定のセクションからのコンテンツのスクレイピングを避けるには、カスタムを選択し、含めるまたは除外するCSSセレクターのリストを追加できます。

  • Finにとって不要な部分(ナビゲーションバーやバナーなど)を除外するためにこれを使用してください。

  • 値はdocument.querySelectorAll()関数で受け入れられる有効なCSSセレクターでなければなりません(例:sidebar、#newsletter-banner)。

  • デフォルトで、ヘッダー、フッター、モーダル、スクリプト、インライン画像などの一般的な要素はすでに除外されています。

クリック可能なCSSセレクター

これにより、CSSセレクターで識別されたDOM要素がウェブ同期プロセス中にクリックされます。

  • 展開可能なセクション、タブ、ドロップダウン内に隠れているコンテンツをキャプチャするためにこれを使用してください。

  • 有効なCSSセレクターを入力してください。例:[aria-expanded="false"]#expand_section.tab

  • 複数のクラスを持つ要素にマッチさせるには、CSSチェイニング(スペースなし)を使用します。例:.button.blue.smallは3つのクラスすべてを持つ要素を対象とします。

  • 複数の異なる要素にマッチさせるには、セレクターをカンマで区切ります。例:.tabaccordionはタブとアコーディオンの両方の要素を対象とします。

読み込み待ちCSSセレクター

ページに表示されるのに遅延がある可能性のあるコンテンツを対象にするには、ウェブスクレイパーがコンテンツをスクレイピングする前に待機するCSSセレクターを追加できます。

  • コンテンツが遅れて読み込まれる場合やユーザー操作後(例:JavaScript経由)にこれを使用してください。

  • 値はdocument.querySelectorAll()関数で受け入れられる有効なCSSセレクターでなければなりません。

  • 選択した要素が表示されるまでページは処理されません—これはデフォルトのタイミング動作を上書きします。

  • 有効なCSSセレクターを入力してください。例:#load_content_idまたは.article_paragraph

XMLサイトマップ

初期URLから到達できないページにアクセスするために、サイトマップ対応のウェブサイトでより堅牢なウェブ同期を行うためにXMLサイトマップを有効にできます。

このオプションが有効な場合、ウェブスクレイパーは提供されたsource URLのdomainでSitemapsを探し、クロールしたページで見つかったリンクと同様に一致するURLをキューに入れます。また、https://www.example.com/sitemap.xmlのようにsitemap.xmlファイルを別の開始URLとして直接参照することもできます。

カノニカルURLを無視する

有効にすると、ウェブスクレイパーはカノニカルリンクタグ(rel="canonical")を無視し、各URLを別々のページとして扱います。このオプションはデフォルトで無効です。

これは、多くのページが1つのカノニカルURLを指していて、その結果コンテンツが見逃されている場合に役立ちます。

プロキシ地域

ウェブサイト同期を設定する際、プロキシ地域はサイトのトップレベルdomainに基づいて自動的に提案されます。例えば、.de domainはドイツのプロキシ、.frはフランスのプロキシがデフォルトになります。TLDの一致がない場合は、米国のプロキシがフォールバックとして使用されます。

新しい同期を作成する時や既存の同期を編集する時に、詳細設定でプロキシをいつでも変更できます。既存の同期を編集する場合、新しいプロキシ設定のみを保存するか、保存してすぐにコンテンツを再同期するかを選択できます。

利用可能なプロキシは以下の通りです:

  • ローテーション:アメリカ合衆国、オーストラリア、ドイツ、フランス、イギリス、チェコ、ハンガリー

  • 静的:

    • アメリカ合衆国 - 119.13.211.225, 161.123.167.215, 94.176.49.232, 185.223.56.90, 154.17.143.135

    • ヨーロッパ - 178.171.116.231, 206.232.77.243, 206.232.90.11, 209.20.175.180, 45.94.247.149

    • オーストラリア - 154.220.151.84, 173.254.193.121, 160.224.101.213, 160.224.100.176, 212.70.22.41

ターゲットオーディエンス

Target ステップでは、すべての同期ページのデフォルトオーディエンスを設定し、URLパターンに基づいて特定のオーディエンスを自動的に割り当てるURLベースのルールを作成できます。手動タグ付けは不要です。

まず、このソースのコンテンツが Fin AI Agent および/または Copilot 用に有効かどうかを決定します。

次に、このソースから同期されたすべてのページに適用するデフォルトの Fin オーディエンスを設定するか(デフォルトが設定されていない場合、コンテンツは Everyone にデフォルト設定されます)、URLパターンに基づいて特定のオーディエンスを割り当てるルールを作成します。

例:URLに /uk が含まれている場合、UKオーディエンスを割り当てます。 ルールは同期時に評価されるため、Fin と Copilot は常に適切なコンテンツを適切なオーディエンスに提供します。

各ルールは3つのURL比較演算子をサポートします:

  • Starts with — 指定した接頭辞で始まるURLに一致します。

  • Ends with — 指定した接尾辞で終わるURLに一致します。

  • Contains — 指定した部分文字列を含むURLに一致します。

注意:

  • ライブプレビューでは、各ルールに一致するページ数が表示され、保存前にルールの検証ができます。これは、ウェブ同期ソースにサイトマップが利用可能である必要があります。サイトマップがない場合でもルールは適用されますが、一致のプレビューはできません。

  • ルールは作成時に自動命名されますが、名前の変更も可能です。ウェブ同期ソースごとに最大10ルールが適用されます。

  • オーディエンスルールは追加のみで、コンテンツにオーディエンスを追加しますが、既存の割り当てを削除することはありません。ルールを削除しても過去のオーディエンス割り当ては元に戻りません。

同期設定を確認する

最後に同期設定を確認し、Sync website をクリックしてIntercomとのウェブサイトコンテンツの同期を開始します。


ウェブサイトソースを管理する

同期が完了すると、メール通知が届き、ウェブサイトはTrain > Contentの「Content sources」セクションに同期ソースとして表示されます。

ウェブサイトソースをクリックすると、公開URLから同期された個々のページをプレビューおよび管理できます。

注意: ウェブサイトソースは読み取り専用で、Fin ワークスペース内で編集できません。編集はソース側で行う必要があります。

設定を構成する

ウェブサイトページを表示すると、右側に「詳細」パネルがあり、以下が含まれます:

  • データ: コンテンツタイプ、言語、作成日、最終更新日(ソースと最後に同期された日時)を表示します。

  • Fin: Fin Agent と Fin Copilot の有効/無効を切り替えます。有効にすると、それぞれ顧客とチームメイトがコンテンツを利用できるようになります。

    • スケジューリング: Fin と Copilot のコンテンツのオン/オフを設定した日時で切り替えます。

    • オーディエンス: 顧客が Fin Agent から関連する回答やコンテンツのみを受け取れるようにします。

  • リンク: このウェブサイトソースの公開URL。

  • レポート: Fin Agent による会話解決にこのコンテンツがどれだけ使われたかを追跡します。

  • タグ: ウェブページをグループ化し、コンテンツを整理するためのタグを追加します。

Fin または Copilot に利用可能にする

ウェブサイトソースをFin AgentまたはFin Copilotで利用可能にするには、Train > Contentに移動し、「Content sources」セクションのウェブサイトソースをクリックして、同期した該当ウェブページを開きます。

「詳細」 パネルで下にスクロールして「Fin」を見つけ、オンに切り替えます:

  • Fin Agent - この設定により、Fin AI が顧客対応時にこのウェブページを利用できるようになります(audience rulesを尊重します)。

  • Fin Copilot - この設定により、Fin Copilot がチームメイト対応時にこのウェブページを利用できるようになります。

ウェブサイトの利用可能時間をスケジュールする

同期されたウェブサイトページが Fin と Copilot 用にオンまたはオフになる日時とタイムゾーンを将来の日付でスケジュールできます。開始日のみ設定するか、開始日と終了日の両方を設定して期間限定の利用可能時間を作成します。スケジューリングは個別ページまたは一括で適用されます。

単一ページのスケジュール設定

  1. ページを開きます。右側の詳細パネルで、Fin ドロップダウン内のスケジューリングセクションを見つけます。

  2. スケジュールの設定をクリックします。

  3. モーダルで、AI製品(Fin for Service または Fin Copilot)を選択し、利用可能状態(有効または無効)を設定し、日付、時間、タイムゾーンを選択します。

  4. オプションで終了日の設定を切り替えて終了日時を追加できます。アクションはその時点で自動的に元に戻ります。

  5. 確認のためにスケジュールをクリックします。

複数ページの一括スケジュール設定

  1. コンテンツリストから複数のページを選択します。

  2. その他の操作ドロップダウンからスケジュールの設定を選択します。

  3. 選択したすべての項目に同じスケジューリングモーダルが適用されます。

スケジューリングの仕組み

  • 開始日のみ: 有効化/無効化のアクションは予定された時間に発動し、手動で変更するまで有効のままです。

  • 開始日+終了日: コンテンツは開始時間にオン(またはオフ)になり、終了時間に自動的に元に戻ります。

  • 手動変更は保留中のスケジュールをキャンセルしません: スケジュール設定後に手動で利用可能性を切り替えた場合でも、予定された時間にスケジュールの切り替えが発動し、手動変更を上書きします。

  • アイテムごとエージェントごとに保留中のスケジュールは1つ: 新しいスケジュールを設定すると前のものが置き換えられ、重複はありません。

  • 削除されたコンテンツ: ページがスケジュール発動前に削除された場合、スケジュールは適用されずエラーは表示されません。

特定のオーディエンスに利用可能にする

URLベースのルールを使ってウェブ同期作成時に同期コンテンツに自動でオーディエンスを割り当てるか、ページごとに手動で割り当てることができます。まず、ターゲットにしたいオーディエンスを作成・定義してください。

次にTrain > Contentに移動し、「Content sources」セクションのウェブサイトソースをクリック、同期した該当ウェブページを開きます。

「Details」パネルから下にスクロールして「Fin」を見つけ、オーディエンスのドロップダウンから事前定義したオーディエンスのいずれかを選択します。

注意:

  • 公開URLのデフォルトオーディエンスは「Everyone」です。

  • Fin Agentは公開URLに適用したオーディエンスも尊重し、オーディエンスルールに合致する場合のみこの記事を使って顧客の質問に回答します。

既存の同期にオーディエンスルールを追加または編集する

オーディエンスターゲティングを追加するために同期を再作成する必要はありません。Train > Contentに行き、ソースを選択し、右上の設定ドロップダウンをクリックして設定を開くを選択します。Targetステップに移動してURLベースのルールを追加または編集してください。

注意: 既存のウェブ同期にオーディエンスルールを追加すると、そのソースから既に取り込まれたすべてのコンテンツに遡及的に適用されます。新しいコンテンツだけでなく。

ウェブサイトをソースとして再同期または削除する

公開URLをソースとして再同期または削除したい場合は、Train > Contentに行き、「Content sources」セクションのウェブサイトソースをクリックし、右上の設定ドロップダウンを開きます。

ここで、再同期またはこのソースを削除のいずれかを選択できます。

ヒント: ソースウェブサイトでの更新はIntercomにすぐには反映されません。ウェブサイトの再同期は毎週自動で行われますが、手動で再同期をトリガーして最新コンテンツを早く表示することも可能です。

ウェブサイト同期履歴を見る

過去のウェブサイト同期の一覧を見て、最後に実行された日時、見つかったページ、失敗したページを確認できます。Train > Contentに行き、「Content sources」セクションのウェブサイトソースをクリックし、同期履歴を見るを選択します。


テーブルの各行は過去または現在の実行を表し、ステータス(開始、成功、失敗)でフィルタリングできます。

以下の情報が含まれます:

  • 同期日時

  • ステータス

  • 同期されたページ数

  • 除外されたページ数

  • 失敗したページ数

  • 所要時間

  • 同期開始者

同期が失敗した場合、ステータスにカーソルを合わせると詳細な説明が表示されます。


ウェブサイト同期のトラブルシューティング

よくある問題

Finを有効にするためにウェブサイトコンテンツをインポートする際は、公開URLを入力する必要があります。これにより、そのURL以下にネストされたすべてのページが検索され、Fin AI Agentが使用できるように同期されます。

インポーターが期待したページ数を返さなかった場合、いくつかの理由があります...

提供されたURLがトップレベルドメインではない

ウェブサイト同期は、提供されたURLにアクセスし、そのURL以下にネストされたすべてのページを検索します。これらのページは提供されたURLと同じURLパターンである必要があります。

例えば、トップレベルドメインがhttps://myhelpcenter.com/homeの場合、インポートしたいすべてのページはURLに/homeプレフィックスを含む必要があります。例:https://myhelpcenter.com/home/article。含まれていない場合はプレフィックスを外し、最も基本的なURLの幹を使ってください。例:https://myhelpcenter.com、その後再度インポートを試みてください。

URLがプライベートである

使用したいコンテンツがログインの背後にある場合、Finはアクセスやインポートができません。

ページ制限

最大100の異なるトップレベルドメインを同期でき、Finは各ソースから最大30,000ページを同期します。1ページに非常に大量のコンテンツがある場合、同期が失敗することがあります(失敗した場合は通知されます)。

特定の地域IPに制限されたウェブサイト

Finのウェブサイト同期(公開URLをFin AI AgentCopilotに追加するために使用)は、現時点で専用のカスタムユーザーエージェント文字列を使用していません

サイトに厳しいクロール防止がある場合、静的プロキシを使って固定IPアドレスの許可リストを作成し、コンテンツの取り込みを確実にできます。ウェブサイト同期の作成または編集時に詳細設定で静的プロキシを選択してください。

  • IPアドレスによる: サイトが許可リストを必要とする場合、詳細設定で静的プロキシを選択してください。これにより許可リストに追加する固定IPが得られます。

  • これらのリクエストはウェブサイト同期のみに使用されます。Messengerのトラフィックやエンドユーザートラッキングには影響しません。

非英語または国際サイトのページが同期されない

サイトマップに非ASCII文字(アクセント付き文字や中国語、アラビア語などのスクリプト)が含まれるURLがある場合、一部のページが期待通りに同期されないことがあります。サイトマップの検出はこれらのURLをサポートしていますが、同期プロセスの他の部分で問題が発生することがあります。手動で再同期を試みてください。ページがまだ欠落している場合はサポートに連絡してください。

ウェブサイト同期エラー

ウェブサイトのコンテンツを同期すると、プロセス中に何が起こったかを示すさまざまなステータスが表示されることがあります。ウェブサイトの同期ステータスを確認するには、Train > Content に移動し、ウェブサイトのソースを選択してから、Status ドロップダウンでフィルタリングしてください:

  • 同期中

  • ライブ

  • 失敗

  • 除外済み

それぞれの意味と次にできることは以下の通りです:

同期中

ページの同期はまだ進行中です。初回の同期は、コンテンツの量によって数分から1時間以上かかることがあります。

ライブ

ページは正常に同期され、Fin と Copilot で有効にできます。

注意: 成功した同期は、ページ上のすべてのコンテンツをスクレイピングできたことを必ずしも意味しません。完全なカバレッジを確認したい場合は、そのページから期待される回答でFin をプレビューすることをお勧めします。

除外済み

これらのページは、高度な同期設定で除外したため、意図的に同期されていません。特に指定がない限り、再試行や含めることはできません。

失敗

これらのエラーは同期が完了しなかったことを意味し、再試行する前にあなた側で変更が必要な場合があります:

1. 不明なエラー

  • メッセージ:「このページにアクセスできませんでした。遅いかブロックされている可能性があります。再度同期を試みるか、失敗した場合はサポートに連絡してください。」

  • 意味: ページへのアクセスを妨げる何かがありましたが、原因は不明です。

2. セッションブロック / レート制限

  • メッセージ:「ウェブサイトがコンテンツへのアクセスを妨げています。アンチクローラー設定やファイアウォールでブロックされていないか確認してください。サイトの設定を確認し、再度同期を試みてください。問題が続く場合はサポートに連絡してください。」

  • 意味: あなたのサイトが当社のクローラーを積極的にブロックまたは制限しています。

3. ネットワーク、タイムアウト、または類似のエラー

  • メッセージ:「このページにアクセスできませんでした。読み込みが遅いか、アンチクローラー設定やファイアウォールでブロックされている可能性があります。サイトの設定を確認し、再度同期を試みてください。問題が続く場合はサポートに連絡してください。」

  • 意味: ページが時間内に読み込まれなかったか、ネットワークの問題やブロックにより到達できませんでした。

4. 重複

  • メッセージ:「このページは既に同期されている別のページと同じコンテンツを持っています。バージョンは1つだけ含まれます。」

  • 意味: 同一のコンテンツが他に検出されたため、コピーは1つだけ保持されます。

5. キーワードフィルタリング

  • メッセージ:「URLにcategorycollection、またはtagのようなキーワードが含まれるページは、通常ユニークなコンテンツを含まないためデフォルトで除外されます。このページを含める必要がある場合はサポートに連絡してください。」

  • 意味: これらのURLはリストを表すことが多く、単独のコンテンツページではありません。

6. ステータスコード400

  • メッセージ:「ページのコンテンツが見つかりません。URLが有効でページが問題なく読み込まれるか確認してください。」

  • 意味: URLが壊れているか、ウェブサイトでエラーを返している可能性があります。

7. ブロックされたURL

  • メッセージ:「このウェブサイトのdomainは同期からブロックされています。必要な場合はサポートに連絡してください。」

  • 意味: domainは意図的に同期から除外されています。


​ページの同期に失敗した場合は、ページにカーソルを合わせて三点メニューを選択し、再同期を選んで再試行できます。

こちらの回答で解決しましたか?