ウェブサイトのコンテンツをIntercomに追加し、Fin AI AgentとCopilotで利用可能にしたい場合は、サイトの公開URLを同期してください。ブログ記事、変更ログ、ニュース更新、または日付のあるその他のウェブページのコンテンツでFinとCopilotをトレーニングすることもできます。これにより、FinとCopilotはこれらの情報源から最新かつ関連性の高い情報を常に使用できます。

Fin AI Agent > Train > Contentに移動し、「Add content」からWebsite syncを選択します。

外部サポートコンテンツのURL（トップレベルドメイン）を入力し、Nextをクリックします:

指定したウェブサイトURLからすべてのページを取得し、サブドメインのページもすべて読み取ります。

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

追加のURL、除外するURL、除外するCSSセレクタなどを設定するには、Advanced settings ドロップダウンを選択します。

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

例えば、上で https://myhelpcenter.com/help を主要なURLとして入力した場合、特定のURL 例えば https://myhelpcenter.com/help/index.html を追加したい場合があります。

同期したくない特定のページを除外するには、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セレクタを使用できます。

これは関連性の低いページコンテンツをスキップするのに便利です。値はdocument.querySelectorAll()関数が受け付ける有効なCSSセレクタである必要があります。デフォルトでは、一般的なナビゲーション要素、ヘッダー、フッター、モーダル、スクリプト、インライン画像は既に削除されます。

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

これは、折りたたまれたセクションを展開してそのテキストコンテンツを取得するのに便利です。値はdocument.querySelectorAll()関数が受け付ける有効なCSSセレクタである必要があります。

例は "[aria-expanded=\"false\"]", #expand_section です。

複雑な条件はCSSセレクタで記述することもできます。CSSでは、セレクタをスペースなしで連結するとANDのような条件になり、例えば .button.blue.small は3つのクラスすべてを持つ要素のみ一致します。

区切り文字としてカンマ（,）を使用するとORのように機能します。例えば .button, .blue, h1 はクラスbutton、またはクラスblue、または一階見出しを持つすべての要素を対象とします。

ページ上で表示に遅延がある可能性のあるコンテンツをターゲットにするには、ウェブスクレイパーがクロール前に待機するCSSセレクタを追加できます。

これは、ネットワークのアイドルによるデフォルトのコンテンツ読み込み認識が失敗するページに有用です。このオプションを設定するとデフォルトの動作が完全に無効になり、指定したセレクタで示される要素が表示された場合にのみページが処理されます。

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

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

特定の地域や国に設定されたプロキシでウェブサイトをクロールする必要がある場合、クローラーが使用するプロキシを選択できます。

現在、以下のプロキシをサポートしています：

このウェブサイトを同期する際に、クローラーが各ページをどれだけ丁寧にレンダリングするかを選択します。

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

多くのページが1つのcanonical URLを指していて、その結果コンテンツが見逃されている場合に便利です。

詳細設定の下にさらに2つのトグルがあります。どちらもデフォルトではオフです。

Respect robots.txt：クローラーがサイトのrobots.txtのdisallowルールに従うようにします。サイトのrobots.txtがFinで取得したいコンテンツをdisallowしている場合、これをオンにすると同期される内容が減少します。

Exclude query parameters：クエリ文字列（?）を含むURLをスキップします。トラッキング、セッション、ソートパラメータによってほとんど重複に近い多くのページが生成される場合にオンにしてください。/docs?page=introのように実際のコンテンツがクエリ文字列の背後にある場合はオフにしてください — そのようなページもスキップされてしまいます。

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

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

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

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

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

最後に、同期設定を確認してからSync website をクリックして、ウェブサイトのコンテンツをIntercomと同期してください。

同期が完了すると、メール通知を受け取り、ウェブサイトがFin AI Agent > Train > Contentの下に同期済みソースとして表示されます。

Fin AI Agent > Train > Contentに移動し、ウェブサイトソースを選択して、同期したページをクリックします。右側に「詳細」パネルがあり、次の項目が含まれます：

Fin AI Agentおよび/またはCopilotでウェブサイトソースを利用可能にするには、Fin AI Agent > Train > Contentに移動してウェブサイトソースを選択し、同期したライブページをクリックしてChange AI Agent state > Enable for AI Agent またはChange Copilot state > Enable for Copilot.を選択します。

個々のウェブページの「Details」 パネルからもこれらの設定を管理できます。下にスクロールしてFin 設定を見つけ、オンに切り替えるかどうかを選択してください:

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

個々のページに手動でオーディエンスを割り当てるには、Fin AI Agent > Train > Contentに移動してウェブサイトソースを選択し、同期したライブページをクリックしてMore actions > Change Fin audience.を選択します。

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

公開URLをソースとして再同期または削除する場合は、Fin AI Agent > Train > Contentに移動してソースを選択します。次に右上の設定ドロップダウンをクリックし、Re-sync またはRemove this source.を選択します。

ウェブサイト同期の詳細設定を調整するには、Fin AI Agent > Train > Contentに移動してソースを選択し、右上の設定ドロップダウンをクリックしてOpen settings.を選択します。

過去のウェブサイト同期の一覧を表示して、最後に実行された日時、見つかったページ、失敗したページを確認できます。Fin AI Agent > Train > Contentに移動してウェブサイトソースを選択し、右上の設定ドロップダウンをクリックしてView sync historyを選択します。

テーブルの各行は過去またはアクティブな実行を表し、ステータスで実行をフィルターできます。以下の情報が含まれます:

同期が失敗した場合、詳細な説明を見るためにステータスにカーソルを合わせることができます。

新しいソースは最初の90日間はスケジュールどおり同期されます。その後、次のいずれかが当てはまる場合にのみ自動的に同期を続けます:

それ以外の場合、スケジュールされた同期は一時停止します。

一時停止中: ページはKnowledge Hubに残り、FinとCopilotで使用可能なままです（何も削除されません）。再クロールのみが停止するため、サイトでの編集は反映されません。

復元するには: Sync nowボタンはコンテンツを一度更新しますが、スケジュールは再起動しません。自動同期はFinが再びそのソースを使用すると自動的に再開します。

非常に大きなサイトや完全なJavaScriptレンダリングが必要なサイトは、クロールに遠く多くのコストがかかります。ソースがリソース集約型であると判明した場合、週次から14日ごとのスケジュールに移動します。

これはソースごとに自動で発生します。大きなサイトを高速なスケジュールのままにしたい場合は、URL除外を使用してクロール範囲を狭めるか、ドメイン全体ではなく特定のサブページを追加してください。

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

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

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

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

If the content you want to use is behind a login, Fin won't be able to access or import it.

ウェブサイトの同期には2つの制限があります:

同期は、単一のページに非常に大量のコンテンツが含まれている場合にも失敗することがあります。同期が失敗すると、メールで通知されます。

Intercom’s website sync (used to add public URLs for Fin AI Agent and Copilot) does not use a dedicated, custom user-agent string at this time.

これらのリクエストを識別または許可するには:

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

コンテンツを同期すると、プロセス中に発生したことを示すさまざまなステータスが表示される場合があります。ウェブサイトの同期ステータスを表示するには、Fin AI Agent > Train > Contentに移動し、ウェブサイトのソースを選択して、Status ドロップダウンで次のようにフィルタリングします:

各ステータスの意味と次にできることはこちらです:

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

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

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

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

1. Unknown error

2. Session blocked / Rate limited

3. Network, timeout, or similar errors

4. Duplicate

5. Keyword filtering

6. Status code 400

7. ブロックされたURL

再試行するには、ページにカーソルを合わせ、三点メニューを選択してからResyncを選んで失敗したページ同期をやり直してください。