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

外部ソースから内部記事を同期またはインポートする

Confluence、Guru、または Notion からサポートコンテンツを同期またはインポートする方法。

Confluence、Guru、または Notion から内部コンテンツを Fin ワークスペースに同期またはインポートでき、Fin および/または Copilot で有効にできます。Confluence と Notion のソースは、より豊富なメタデータ、事前フィルタールール、新しいメタデータレビューのフローをサポートし、どのページが Fin に取り込まれ、どこで使用されるかを正確に制御できます。

コンテンツが同期されるとき:

  • Fin では編集できません。コンテンツの変更は元のツール(Confluence、Notion、Guru)で行う必要があります。

  • 24時間ごとに自動的に再同期され、新しいコンテンツの変更が Fin に反映されます。手動で再同期することも可能です。

  • 前回の同期以降にソースに更新がない場合、毎日の同期はスキップされます。実行しても新しいものは生成されないためです。

  • コンテンツは Fin の新しい同期フォルダーに追加されます。同期フォルダーは変更できず、すべてのフォルダーはアルファベット順に表示されます。

コンテンツがインポートされるとき:

  • ネイティブの内部記事に変換され、Fin ワークスペース内で編集・削除が可能になります。

  • コンテンツは Fin の新しいネイティブフォルダーに追加されます。ネイティブフォルダーは変更可能です。


内部記事を同期またはインポートする

新しい内部ソースを同期するには、Train > Content に移動し、「コンテンツを追加」セクションの下にある すべて表示 をクリックします。

次に、以下のような内部ナレッジソースを選択します:

  • Notion

  • Confluence

  • Guru

関連する Confluence/Guru/Notion アカウントにアクセスするための認証情報を求められます。

Confluence

  1. Train > Content で Confluence ソースを開きます。

  2. ソースの横にある三点メニューから ソースを編集 をクリックします。

  3. 接続 → メタデータ → ターゲット → レビュー の手順を進めます。

  4. メタデータフィルター、対象ユーザー設定、Fin AI Agent/Copilot の利用可能性を設定します。

  5. 更新して同期 をクリックします。

注意: これは v1 と v2 の両方のソース(フォルダー対応ソース)で機能します。既存の OAuth 認証情報は引き継がれますが、接続が期限切れの場合は再認証を求められることがあります。権限が制限されたスペースは正しく同期できない場合があります。Confluence に接続するユーザーアカウントが、同期対象のスペースの閲覧およびアクセス権限を適切に持っていることを常に確認してください。

メタデータのステップでは、Fin に取り込むページを事前にフィルタリングできます。Confluence では、構造化フィールドとして同期されるメタデータにラベル、タイトル、親ページ、作成者、作成・編集日が含まれます。文字列条件(is、is not、contains、starts with、ends with)やラベル条件(is、is not)を使って事前フィルタールールを作成できます。

注意:

  • この統合は現在 Confluence Cloud のみ をサポートしています。オンプレミス版の Confluence との統合は試みないでください。

  • インポートする Confluence スペースは「global」タイプのみです。

  • Fin に同期またはインポートするコンテンツに対して適切な権限を持つユーザーアカウントでサインインしていることを確認してください。

Confluence 内でフォルダーを作成できるようになりましたが、現在この同期ではサポートされていません。これらのページとサブページは「フォルダー選択」ドロップダウンにのみ表示されます。👇

注意:

  • フォルダーの除外はフィルターで処理されます:「Ancestor page」フィルターを使ってページのサブツリー全体を除外します。以前に拒否フォルダーを設定していた場合、次回の同期時に自動的にフィルタールールに移行されます。操作は不要です。

  • 単一ページの同期はサポートしていません。完全同期のみ対応しています。

  • Confluence からはフォルダーの同期はサポートしていますが、ホワイトボードはサポートしていません。

Confluence スペースの同期問題のトラブルシューティング

Confluence スペースを Fin と統合する際に、特定のスペースが表示されなかったり正しく同期されなかったりすることがあります。このガイドはこれらの一般的な問題の診断と解決を支援します。

見えない Confluence スペースのタイプを確認する

  • Confluence で スペース設定 > スペース管理 > スペース詳細 に移動します。

  • スペースの「タイプ」を確認します。

  • Fin は 「global」タイプ のスペースのみ同期をサポートしています。「personal」や「knowledge_base」とマークされたスペースは同期に含まれません。

新しいカスタムスペースを作成する(サポートされていないタイプの場合)

  • 見えない Confluence スペースがサポートされていないタイプ(例:「personal」や「knowledge_base」)の場合、新しい「Custom」スペースを作成して問題を解決できます。

  • Confluence で 新しいカスタムスペース を作成します。

  • サポートされていないスペースのコンテンツをこの新しく作成したカスタムスペースに移行します。

表示設定を確認する

  • Confluence で、同期したいスペースが 「current」ステータス に設定されていることを確認します。

  • このステータスのスペースのみが Fin との同期対象になります。

フォルダーとページ階層のトラブルシューティング

  • Fin は同期のために Confluence 内のフォルダーを直接サポートしていません。代わりに、個々の ページとサブページ に基づいて同期します。

  • コンテンツが正しく同期されるように、ページとサブページを使って構造化してください。特定のコンテンツを除外する必要がある場合は、それらのページをFinと同期しない別のConfluenceスペースに移動してください。

上記の手順で問題が解決しない場合、ワークスペースの特定のバックエンド設定を有効にする必要があるかもしれません。解決のためにサポートチームに連絡し、トラブルシューティング手順を既に実施したことを伝えてください。その上で、非個人用のConfluenceスペースをすべて表示できるように、デフォルトの制限を回避するバックエンド設定の有効化を依頼してください。スムーズに動作するようサポートします。

注意:権限が制限されたスペースは正しく同期されない場合があります。ConfluenceとIntercomを接続するために使用するユーザーアカウントが、同期対象のスペースに対して適切な閲覧およびアクセス権限を持っていることを常に確認してください。

Guru

  1. Train > ContentでGuruのソースを開いてください。

  2. 三点リーダーメニューのソースを編集をクリックしてください。

  3. Connect → Metadata → Target → Reviewの手順を順に進んでください。

  4. メタデータフィルター、オーディエンスターゲティング、Fin AI Agent/Copilotの利用可能性を設定してください。

  5. 更新して同期をクリックしてください。

メタデータステップでは、Finに取り込むカードを事前にフィルタリングできます。Guruの場合、構造化フィールドとして同期されるメタデータにはタグ、タイトル、ボード、著者、日付、コレクション、検証ステータス、共有ステータスが含まれます。文字列条件(is、is not、contains、starts with、ends with)やタグ条件(is、is not)を使って事前フィルタールールを作成できます。

ヒント:同期やインポート時には、Guruアカウントに正しい権限があり、API認証情報を手元に用意していることを確認してください。API認証情報はこちらの手順に従って取得でき、設定ページで確認できます。User Tokenを選択してください。

注意:ワークスペースごとに同時に同期できるGuruコレクションは1つだけです。同期中に2つ目のコレクションが追加されると、キューに入り、現在の同期が完了次第自動的に同期が開始されます。これにより同期が順次実行され、競合を防ぎます。

Notion

  1. Train > ContentでNotionのソースを開いてください。

  2. ソースの横にある三点リーダーメニューのソースを編集をクリックしてください。

  3. Connect → Metadata → Target → Reviewの手順を順に進んでください。

  4. メタデータフィルター、オーディエンスターゲティング、Fin AI Agent/Copilotの利用可能性を設定してください。

注意:Notionでは移行は不要です。次回の同期時にすべてが自動的に処理されます。動的プロパティは構造化フィールドとして自動的に取り込まれます。

ヒント:Finに同期またはインポートするコンテンツに対して正しい権限を持つユーザーアカウントでサインインしていることを確認してください。


メタデータレビューの流れ

Confluence、Guru、Notionのソースは4段階のセットアップフローを使用し、Finにどのようにコンテンツが取り込まれるかを明確にし、インポート内容と使用場所を制御できます。

接続

外部ソースに認証します。Confluenceソースの場合、既存のOAuth認証情報が引き継がれます。接続が期限切れの場合は再認証を求められることがあります。

メタデータ

外部knowledge baseのメタデータに基づく事前フィルタールールを使って、対象とするコンテンツを選択します。一般的なメタデータには以下が含まれます:

  • ラベルまたはタグ

  • タイトル

  • 親ページ/先祖ページ

  • 著者

  • 作成日および編集日

  • 動的プロパティ(Notion)

  • ボード、コレクション、検証ステータス、共有ステータス(Guru)

文字列条件(is、is not、contains、starts with、ends with)やラベル条件(is、is not)を使って、同期されるコンテンツの範囲を絞るルールを作成します。例えば、「fin-ai」とラベル付けされたページのみ、または特定の日付以降に更新されたコンテンツのみなどです。

ヒント:メタデータステップをスキップすると、インポーターはデフォルトでソースからすべての対象コンテンツを取り込みます。

ターゲット

Fin内でインポートしたコンテンツの使用場所を決定します。以下を設定してください:

  • Fin AI Agent — コンテンツを使って顧客の質問に自動で回答します(デフォルトはOFF)

  • Copilot — チームメイトに提案回答としてコンテンツを提供します

  • オーディエンスターゲティング — ソースレベルでオーディエンスルールを定義し、インポート時に自動適用します

レビュー

同期開始前に設定を確認します。レビューでは以下を表示します:

  • 接続の詳細(どの外部アカウントまたはサブドメインに接続しているか)

  • メタデータフィルター適用後の対象アイテム

  • ターゲットで有効な宛先

  • オーディエンスおよびターゲティングルール

ソースにわかりやすい名前を付けてから確定してください。例:「Confluence – Internal Support KB」や「Notion – Product Docs (EMEA)」。その後、更新して同期をクリックします。

ヒント:同じフローを後で再度開いて、Metadata、Target、Reviewの設定を調整できます。ソースを再作成する必要はありません。


同期された内部記事を管理する

同期またはインポートが完了すると、メール通知が届き、内部記事はTrain > Contentの「Content sources」セクションに表示されます。

内部記事の設定を構成する

Train > Content に移動し、コンテンツソースを選択してから内部記事を開きます。右側の「Details」パネルで設定を構成してください。

  • データ:コンテンツの種類、言語、作成日、作成者、最終更新日、最終更新者を表示します。

  • Fin: Fin と Copilot の有効化/無効化。 有効にすると、コンテンツはそれぞれFin Agentを通じて顧客に、Fin Copilotを通じてチームメイトに利用可能になります。

    • 対象者: Fin または Copilot が応答する際に、顧客が関連する回答とコンテンツのみを受け取るようにしてください。

  • リンク: 内部 knowledge base(例:Notion/Confluence/Guru)内の記事へのリンク。

  • レポート: このコンテンツがどれだけ頻繁に関与し、Fin Agent によって会話解決に使用されたかを追跡します。

  • タグ: 内部記事をグループ化し、コンテンツを整理するためのタグを追加します(インポートされたタグを含む)。

注意:

  • 同期された内部記事は編集できません。内容を変更したい場合は、元のソースから行う必要があります。

  • インポートされた内部記事は Fin 内で編集および管理できます。ソースとは同期されないため、変更は Fin ワークスペース内で行う必要があります。

内部記事の再同期または削除

外部ソースからの内部記事は24時間ごとに自動的に同期されますが、Train > Content に移動し、ソースの横の3点メニューを選択してから、再同期またはこのソースを削除を手動で選択して再同期または削除できます。

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