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

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

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

この記事を使って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桁の数字です。

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

  • ファイルがカスタマーマネージドKMSキーで暗号化されている場合のみ、AWS Key Management Service (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つのフォルダのみ同期します。プレフィックスに*、?、$は含められません。

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

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

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

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

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

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

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

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

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

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

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

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

Amazon S3のリアルタイム更新をオンにする方法(オプション)

Amazon S3のリアルタイム更新は、1日に1回ではなく数分以内にファイルの変更を同期します。リアルタイム更新は、バケット所有のAWSアカウント内のAmazon Simple Notification Service(SNS)イベントトピックを使用します。

Amazon S3ソースのConnectタブでリアルタイム更新をオンにするには:

  1. Real-time updatesをオンにします。

  2. CloudFormation(推奨)の下で、Download templateをクリックし、Finが表示するAWSリージョンのAWSアカウントでスタックをデプロイします。トピックを自分で設定する場合は、Manual setupを使用してください。

  3. Topic subscribedが「Connected」と表示されるまで待ちます。

  4. Amazon S3コンソールでバケットにイベント通知を追加します。宛先をSNSトピックに設定し、スタックのTopicArn出力(CloudFormation > your stack > Outputs > TopicArn)を使用します。Finがセットアップ手順で示すプレフィックスとイベントを使用してください:すべてのオブジェクト作成イベント、すべてのオブジェクト削除イベント、ライフサイクルの有効期限、すべてのオブジェクトタグ付けイベント。

Topic subscribedとBucket eventsの両方が「Connected」と表示されたら、Amazon S3のリアルタイム更新が設定されています。Last eventはFinが最後にバケットから変更を受信した時刻を示します。

注意: Amazon S3ソースを保存した後にリアルタイム更新の設定を完了できます。リアルタイム更新はバケットからのイベントが届くまで待機状態のままです。

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

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

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

  • ファイルタイプマッピング: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を選択してください。

また、Finが同期されたコンテンツを使用する顧客を制限するためにオーディエンスルールを追加できます。設定を確認するにはNextをクリックしてください。

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

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

  • Ongoing sync:バケットと毎日コンテンツを最新の状態に保ちます。リアルタイム更新をオンにしている場合、ファイルの変更は数分以内に同期されます。

  • One-time import:ファイルを一度だけコピーします。後のバケットの変更は同期されません。

継続的な同期の場合は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ソースを編集するとき、変更できない設定があります:

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

  • File type mapping:最初のインポート後は変更できません。変更するには、ソースを削除して再接続してください。

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

  • Content access:変更は新しく同期されたコンテンツにのみ適用されます。既存のコンテンツは現在の設定を維持します。


よくある質問

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キーで暗号化されたファイルを読み取ります。AWS管理キー(aws/s3)で暗号化されたファイルはFinが読み取れません。これらのファイルを同期するには、代わりに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は同期されたコンテンツをワークスペースのリージョンに保存します。

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