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

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

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 との統合を試みていないことを確認してください。

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

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

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

注意:

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

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

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

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

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

見えない 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. GuruのメールアドレスとAPIトークンを入力してください。

  3. コレクション、フォルダー、コンテンツのインポートまたは同期を選択してください。

  4. 同期/インポートが開始されると、Fin Contentにステータスが表示されます。

  5. 同期/インポートが完了すると、ステータスアイコンが緑のチェックマークに更新されます。

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

Notion

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

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

  3. Connect → Metadata → Target → Reviewの手順を進めてください。

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

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

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


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

ConfluenceとNotionのソースは4段階のセットアップフローを使用し、Finへのコンテンツ取得方法を明確にし、インポート内容と使用場所を制御できます。

接続

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

メタデータ

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

  • ラベルまたはタグ

  • タイトル

  • 親ページ / 先祖ページ

  • 作成者

  • 作成日と編集日

  • 動的プロパティ(Notion)

文字列条件(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)」。その後、更新して同期をクリックします。

ヒント:同じフローを後で再度開いて、メタデータ、ターゲット、レビューの設定を調整できます。ソースを再作成する必要はありません。


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

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

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

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

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

  • Fin: FinとCopilotの有効/無効を切り替えます。有効にすると、コンテンツはFin Agentを通じて顧客に、Fin Copilotを通じてチームメイトにそれぞれ提供されます。

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

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

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

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

注意:

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

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

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

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

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