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

Amazon S3からコンテンツを同期する

Markdown、PDF、DOCX、HTMLファイルをAmazon S3バケットからFin、Copilot、Help Centerに毎日または一度だけ同期します。

対応者:Beth-Ann Sher

この記事では、Amazon S3バケットをFinに接続し、同期するファイルとその変換先を選択し、Amazon S3コンテンツ同期の制限を理解する方法を説明します。

Amazon S3コンテンツ同期は、1つのAmazon S3バケットからFinにファイルをコピーし、Fin AI Agent、Copilot、Help Centerで利用できるようにします。同期するフォルダとファイル、各ファイルタイプの変換先(公開記事、内部記事、スニペット、ドキュメント)を選択できます。毎日同期して最新の状態を保つか、一度だけインポートすることも可能です。

注意:Amazon S3コンテンツ同期はオープンベータ版です。FinをIntercomまたは他のhelpdeskと一緒に使用している場合でも利用可能です。


Amazon S3からコンテンツを同期する前に必要なもの

Amazon S3コンテンツ同期を設定するには、以下が必要です。

  • バケット名。 各Amazon S3ソースは1つのバケットからファイルを読み取ります。バケットは任意のAWSリージョンに存在できます。

  • AWSアカウントID バケット所有アカウントの12桁の番号です。

  • バケットポリシーを編集する権限 バケット所有のAWSアカウントで必要です。

  • AWS Key Management Service (KMS) キーポリシーを編集する権限 ファイルがカスタマーマネージドKMSキーで暗号化されている場合のみ必要です。

Amazon S3コンテンツ同期にはAWS Identity and Access Management (IAM) ロールやアクセスキーの作成は不要です。Finは独自の読み取り専用ロールを使用するため、AWS認証情報はワークスペースに保存されません。そのロールに対してバケットポリシーでこのソース専用のアクセス権を付与します。

Amazon S3バケットポリシーはFinにどのような権限を与えますか?

Finはセットアップ時にAmazon S3ソース用のバケットポリシーステートメントを生成します。この表はFinに与えられる4つの読み取り専用権限を示しています。

ステートメント

権限

Finができること

一覧

s3:ListBucket

バケット内のファイル、またはプレフィックス以下のファイルを一覧表示する

場所

s3:GetBucketLocation

バケットのAWSリージョンを特定する

読み取り

s3:GetObject

ファイルを読み取る

タグ

s3:GetObjectTagging

ファイルタグを読み取り、フィルタリングに利用できるようにする

注意:Amazon S3バケットポリシーはFinにバケット内のファイルを書き込み、変更、削除する権限を与えません。

この例は、プレフィックスdocs/を使用するAmazon S3ソースの生成されたバケットポリシーステートメントを示しています。YOUR_BUCKETやSOURCE_IDなどの大文字の値はプレースホルダーで、セットアップ時にFinが実際の値を入力します。

[
  {
    "Sid": "FinContentSyncListSOURCE_ID",
    "Effect": "Allow",
    "Principal": { "AWS": "arn:aws:iam::FIN_ACCOUNT_ID:role/s3-content-sync-role" },
    "Action": "s3:ListBucket",
    "Resource": "arn:aws:s3:::YOUR_BUCKET",
    "Condition": {
      "StringEquals": { "aws:userid": "FIN_ROLE_ID:SOURCE_ID" },
      "StringLike": { "s3:prefix": "docs/*" }
    }
  },
  {
    "Sid": "FinContentSyncLocationSOURCE_ID",
    "Effect": "Allow",
    "Principal": { "AWS": "arn:aws:iam::FIN_ACCOUNT_ID:role/s3-content-sync-role" },
    "Action": "s3:GetBucketLocation",
    "Resource": "arn:aws:s3:::YOUR_BUCKET",
    "Condition": {
      "StringEquals": { "aws:userid": "FIN_ROLE_ID:SOURCE_ID" }
    }
  },
  {
    "Sid": "FinContentSyncReadSOURCE_ID",
    "Effect": "Allow",
    "Principal": { "AWS": "arn:aws:iam::FIN_ACCOUNT_ID:role/s3-content-sync-role" },
    "Action": "s3:GetObject",
    "Resource": "arn:aws:s3:::YOUR_BUCKET/docs/*",
    "Condition": {
      "StringEquals": { "aws:userid": "FIN_ROLE_ID:SOURCE_ID" }
    }
  },
  {
    "Sid": "FinContentSyncTagsSOURCE_ID",
    "Effect": "Allow",
    "Principal": { "AWS": "arn:aws:iam::FIN_ACCOUNT_ID:role/s3-content-sync-role" },
    "Action": "s3:GetObjectTagging",
    "Resource": "arn:aws:s3:::YOUR_BUCKET/docs/*",
    "Condition": {
      "StringEquals": { "aws:userid": "FIN_ROLE_ID:SOURCE_ID" }
    }
  }
]

プレフィックスがない場合、Listステートメントにはs3:prefix条件がなく、ReadおよびTagsステートメントはAmazonリソースネーム(ARN) arn:aws:s3:::YOUR_BUCKET/*をリソースとして使用します。

ファイルがカスタマーマネージドKMSキーで暗号化されている場合、FinはAmazon S3ソース用に1つのキーポリシーステートメントも生成します。

{
  "Sid": "FinContentSyncDecryptSOURCE_ID",
  "Effect": "Allow",
  "Principal": { "AWS": "arn:aws:iam::FIN_ACCOUNT_ID:role/s3-content-sync-role" },
  "Action": "kms:Decrypt",
  "Resource": "*",
  "Condition": {
    "StringEquals": {
      "aws:userid": "FIN_ROLE_ID:SOURCE_ID",
      "kms:ViaService": "s3.BUCKET_REGION.amazonaws.com"
    }
  }
}

kms:ViaService条件は、Finがバケットのリージョン内のAmazon S3からファイルを読み取るためにのみKMSキーを使用できることを意味します。


Amazon S3からコンテンツを同期する方法

ステップ1:Amazon S3をソースとして追加する

Amazon S3をコンテンツソースとして追加するには、Fin AI Agent > Train > Contentに移動します。「コンテンツを追加」の下でFrom Amazon S3をクリックします。

Amazon S3のセットアップには4つのタブがあります:Connect、Filters、Target、Review。

ステップ2:Amazon S3バケットの詳細を入力する

ConnectタブのBucketで、Amazon S3バケットの詳細を入力します。

  • バケット名:例としてmy-help-docs-bucket。

  • AWSアカウントID:バケット所有のAWSアカウントの12桁ID。

  • プレフィックス(任意):例としてdocs/のようなフォルダパス。1つのフォルダのみ同期します。プレフィックスに*、?、$は使用できません。

次へをクリックしてバケットポリシーを表示します。

ステップ3:バケットポリシーを追加しアクセスを確認する

バケットの詳細を入力すると、FinはAmazon S3ソース用に生成されたバケットポリシーセクションを表示します。Finにバケットアクセスを許可するには:

  1. Amazon S3コンソールでバケットを開き、バケットポリシーを編集します。

  2. Finでバケットポリシーステートメントをコピーします。完全なポリシーを表示をクリックしてすべて表示します。

  3. ステートメントをバケットポリシーのステートメントリストに追加します。

  4. ファイルがカスタマーマネージドKMSキーを使用している場合は、Finからキーポリシーステートメントもコピーし、そのキーのキーポリシーに追加します。

  5. バケットポリシーを保存します。

  6. Finで、Verifyをクリックします。

重要: 生成されたステートメントを既存のバケットポリシーに追加してください。バケットポリシー全体を置き換えないでください。そうすると、他のusersやサービスへのアクセスが失われます。

Verifyチェックが通ると、FinはFiltersタブを開きます。別のバケットを使う場合は、Change bucketをクリックして新しい詳細を入力してください。

注意: VerifyはFinのアクセスをテストするために、バケットまたはプレフィックス内に少なくとも1つの空でないファイルが必要です。バケットやプレフィックスが空の場合は、Verifyをクリックする前にファイルを追加してください。

ステップ4: 同期するファイルとインポート形式を選択します。

FiltersタブのChoose files and file type mappingで、Amazon S3から同期するファイルタイプと、それぞれがFinでどのように扱われるかを選択します。

  • ファイルタイプ: 同期するファイルタイプを選択します:Markdown、PDF、DOCX、HTML。すべてデフォルトで選択されています。

  • ファイルタイプのマッピング: Imports as列で、各ファイルタイプがFinでどのように扱われるかを選択します。

この表は、Amazon S3コンテンツ同期における各ファイルタイプのImports asオプションとデフォルトを示しています。

ファイルタイプ

オプション

デフォルト

Markdown

公開記事、内部記事、スニペット

公開記事

PDF

公開記事、内部記事、スニペット、ドキュメント

ドキュメント

DOCX

公開記事、内部記事、スニペット、ドキュメント

ドキュメント

HTML

ウェブページ

ウェブページ

注意: PDFとDOCXファイルを記事やスニペットに変換すると、表や画像などの一部の書式が失われることがあります。元の書式をできるだけ保持するには、Documentにマッピングしてください。

Choose which files to syncの下で、Files to syncリストからフォルダーとファイルを選択します。

  • フォルダーを開くには、その隣の矢印をクリックします。

  • フォルダー全体を同期するには、それを選択します。選択したフォルダーには後で追加されたファイルも含まれます。

  • バケット内のすべて、またはプレフィックス以下のすべてを同期するには、Select allを選択します。

  • 大きなフォルダーでさらにファイルを見るには、Load moreをクリックします。

Files to syncリストには、フォルダーと選択したファイルタイプのみが表示されます。

ステップ5: Amazon S3ファイルをメタデータでフィルター(オプション)

Filter by file metadataの下で、選択したAmazon S3ファイルの同期対象を選ぶルールを追加できます。以下のファイルフィールドでフィルター可能です。

  • フォルダーパス

  • ファイル名

  • サイズ(バイト)

  • 最終更新日

  • タグ(例:owner=support)

Finはルールに合致するファイル数を表示します。

注意: セットアップ中のファイル数にはタグルールは含まれません。Finはファイル同期時にのみタグを読み取るため、実際に同期されるファイル数は表示される数より少なくなることがあります。

ステップ6: 同期したコンテンツを使えるユーザーを選択

TargetタブのChoose content accessで、FinがAmazon S3から同期したコンテンツをどこで使うかを選択します。

  • Fin AI Agent: Finはコンテンツを使って顧客に回答します。

  • Copilot: チームメイトはCopilotでコンテンツを使えます。

  • Help Center: 公開記事はお客様のHelp Centerで閲覧可能です。これをオンにした場合は、help centerを選択してください。

また、audienceルールを追加して、Finが同期したコンテンツを使う対象のcustomersを制限できます。設定を確認するにはNextをクリックしてください。

ステップ7: 同期モードを選択して完了

Reviewタブで、Review and finishの下にあるAmazon S3のソース設定を確認します。次に、Sync modeでコンテンツの最新状態の維持方法を選択します。

  • Ongoing sync: バケットと毎日同期してコンテンツを最新に保ちます。

  • 一度限りのインポート:ファイルを一度だけコピーします。その後、バケットの変更は同期されません。

継続的な同期にはSync and publishを、一度限りのインポートにはImport and publishをクリックしてください。Finがファイルの読み込みを開始し、同期完了時にメールが届きます。


Amazon S3ソースの再同期、編集、または削除方法

Amazon S3ソースを管理するには、ソースに移動してManageメニューを開きます。以下の選択が可能です:

  • Re-sync:バケットを再度読み込みます。Finは変更されていないファイルをスキップします。

  • Edit source:ファイル選択、フィルター、コンテンツアクセス、同期モードを変更します。

  • Remove this source:ソースとその同期済みコンテンツ(フォルダーやサブフォルダーを含む)をワークスペースから削除します。

注意:Amazon S3ソースが同期中はManageメニューのオプションは利用できません。

重要:Amazon S3ソースを削除すると、その同期済みコンテンツがすべてワークスペースから削除され、元に戻せません。Amazon S3内のファイルには影響しません。

Amazon S3ソースを編集するときに変更できないことは何ですか?

Amazon S3ソースを編集するとき、変更できない設定があります:

  • バケット、アカウントID、プレフィックス:別のバケットを使用するには、ソースを削除して新しく作成してください。

  • ファイルタイプのマッピング:最初のインポート後は変更できません。変更するには、ソースを削除して再接続してください。

  • Help center:セットアップ時に選択したhelp centerは変更できません。

  • コンテンツアクセス:変更は新たに同期されたコンテンツにのみ適用されます。既存のコンテンツは現在の設定を保持します。


よくある質問

Amazon S3コンテンツ同期はどのファイルタイプをサポートしていますか?

Amazon S3コンテンツ同期はMarkdown(.md)、PDF(.pdf)、Word(.docx)、HTML(.html、.htm)ファイルをサポートします。.docなどの他のファイルタイプはFiles to syncリストに表示されず、同期されません。

PDF、DOCX、またはHTMLファイルは、Amazon S3のContent-Typeメタデータがファイル拡張子と一致しない場合もスキップされます。例えば、Content-Typeがtext/htmlのPDFは同期されません。

Amazon S3コンテンツ同期の最大ファイルサイズはいくつですか?

Amazon S3のファイルがそのタイプの最大サイズを超えるとスキップされ、同期されません。以下の表は各ファイルタイプの最大ファイルサイズを示しています:

ファイルタイプ

最大サイズ

PDF、DOCX

100 MB

HTML

16 MB

Markdown

5 MB

記事またはスニペットにマッピングされたPDFおよびDOCXファイルには2つ目の制限があります:変換後のテキストが5 MB以下でなければならず、超える場合はファイルがスキップされます。

注意:すでに同期されたAmazon S3ファイルが最大サイズを超えた場合、ファイルを小さくするか選択から削除するまで同期は失敗します。

Amazon S3ソースは何ファイルまで同期できますか?

1つのAmazon S3ソースは最大100,000ファイルを同期します。選択がそれ以上の場合、Finは最初の100,000ファイルのみ同期し、残りの同期済みコンテンツは削除しません。制限内に収めるには、プレフィックス、フォルダー、フィルターで選択を絞るか、複数のソースを作成してください。

1つのAmazon S3バケットを複数のソースやワークスペースに同期できますか?

各Amazon S3ソースは1つのバケットを読み取ります。同じバケットで複数のソースを1つのワークスペースに作成できますが、プレフィックスは重複できません。

Amazon S3バケットは1つのワークスペースにのみ属します。たとえ2つのワークスペースが同じ会社に属していてもです。別のワークスペースがすでにバケットを使用している場合、Verifyは「Another Fin workspace already uses this bucket. Use a different bucket.」と表示します。最後のソースが削除されるとバケットは再び利用可能になります。

Amazon S3コンテンツ同期はどの暗号化タイプをサポートしていますか?

Amazon S3コンテンツ同期はAmazon S3管理キー(SSE-S3)またはカスタマー管理KMSキーで暗号化されたファイルを読み取ります。FinはAWS管理キー(aws/s3)で暗号化されたファイルは読み取れません。これらのファイルを同期するには、代わりにSSE-S3またはカスタマー管理キーで暗号化してください。

Amazon S3でファイルを移動または名前変更するとどうなりますか?

選択内でAmazon S3ファイルを移動または名前変更しても内容が変わらなければ、Finは同期済みアイテムを保持し、タイトルとフォルダーを更新します。AWSが移動したファイルに新しいフィンガープリントを付与する場合(例:大きなファイルを分割コピーした場合)、Finは新しいアイテムとして追加し、古いものを削除します。

Amazon S3コンテンツ同期は何階層のフォルダーをコピーしますか?

Amazon S3コンテンツ同期は最大10階層のフォルダー構造をコピーします。より深いフォルダー内のファイルは最も深くコピーされたフォルダーに入ります。

Amazon S3から同期された公開記事はどの言語とコレクションを使用しますか?

Amazon S3から同期された公開記事は選択したhelp centerの言語を使用します。コレクションには追加されません。

Amazon S3から同期されたコンテンツはどこに保存されますか?

Amazon S3バケットは任意のAWSリージョンに存在できます。Finは同期されたコンテンツをワークスペースのリージョンに保存します。

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