Zum Hauptinhalt springen

Inhalte von Amazon S3 synchronisieren

Synchronisieren Sie Markdown-, PDF-, DOCX- und HTML-Dateien aus einem Amazon S3-Bucket täglich oder einmalig in Fin, Copilot und Ihr Help Center.

Verfasst von Beth-Ann Sher

Verwenden Sie diesen Artikel, um einen Amazon S3-Bucket mit Fin zu verbinden, auszuwählen, welche Dateien synchronisiert werden und was sie werden, und um die Grenzen der Amazon S3-Inhaltssynchronisierung zu verstehen.

Die Amazon S3-Inhaltssynchronisierung kopiert Dateien von 1 Amazon S3-Bucket in Fin, damit Fin AI Agent, Copilot und Ihr Help Center sie verwenden können. Sie wählen aus, welche Ordner und Dateien synchronisiert werden und was jeder Dateityp wird: ein öffentlicher Artikel, ein interner Artikel, ein Snippet oder ein Dokument. Sie können die Inhalte mit einer täglichen Synchronisierung aktuell halten oder sie einmalig importieren.

Hinweis: Die Amazon S3-Inhaltssynchronisierung befindet sich in der offenen Beta. Sie ist verfügbar, egal ob Sie Fin mit Intercom oder mit einem anderen helpdesk verwenden.


Was Sie benötigen, bevor Sie Inhalte von Amazon S3 synchronisieren

Um die Amazon S3-Inhaltssynchronisierung einzurichten, benötigen Sie:

  • Der Bucket-Name. Jede Amazon S3-Quelle liest Dateien aus 1 Bucket, der sich in jeder AWS-Region befinden kann.

  • Die AWS-Konto-ID des Kontos, dem der Bucket gehört. Dies ist eine 12-stellige Nummer.

  • Berechtigung zur Bearbeitung der Bucket-Richtlinie im AWS-Konto, dem der Bucket gehört.

  • Berechtigung zur Bearbeitung der AWS Key Management Service (KMS)-Schlüsselrichtlinie, nur wenn Ihre Dateien mit einem vom Kunden verwalteten KMS-Schlüssel verschlüsselt sind.

Sie müssen keine AWS Identity and Access Management (IAM)-Rolle oder einen Zugriffsschlüssel für die Amazon S3-Inhaltssynchronisierung erstellen. Fin verwendet seine eigene schreibgeschützte Rolle, sodass keine AWS-Anmeldeinformationen in Ihrem Workspace gespeichert werden. Sie gewähren dieser Rolle Zugriff in Ihrer Bucket-Richtlinie, nur für diese Quelle.

Welche Berechtigungen gibt die Amazon S3-Bucket-Richtlinie Fin?

Fin generiert die Bucket-Richtlinienaussagen für Ihre Amazon S3-Quelle während der Einrichtung. Diese Tabelle zeigt die 4 schreibgeschützten Berechtigungen, die die Aussagen Fin geben:

Aussage

Berechtigung

Was es Fin erlaubt

Auflisten

s3:ListBucket

Listet die Dateien im Bucket oder nur die Dateien unter Ihrem Präfix auf

Standort

s3:GetBucketLocation

Findet die AWS-Region des Buckets

Lesen

s3:GetObject

Liest die Dateien

Tags

s3:GetObjectTagging

Liest Dateitags, damit Sie nach ihnen filtern können

Hinweis: Die Amazon S3-Bucket-Richtlinie gibt Fin keine Berechtigung, Dateien in Ihrem Bucket zu schreiben, zu ändern oder zu löschen.

Dieses Beispiel zeigt die generierten Bucket-Richtlinienaussagen für eine Amazon S3-Quelle, die das Präfix docs/ verwendet. Die Werte in Großbuchstaben, wie YOUR_BUCKET und SOURCE_ID, sind Platzhalter. Fin füllt die echten Werte für Ihre Quelle während der Einrichtung aus.

[
  {
    "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" }
    }
  }
]

Ohne Präfix hat die List-Aussage keine s3:prefix-Bedingung, und die Read- und Tags-Aussagen verwenden den Amazon Resource Name (ARN) arn:aws:s3:::YOUR_BUCKET/* als Ressource.

Wenn Ihre Dateien mit einem vom Kunden verwalteten KMS-Schlüssel verschlüsselt sind, generiert Fin auch 1 Schlüsselrichtlinienaussage für Ihre Amazon S3-Quelle:

{
  "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"
    }
  }
}

Die kms:ViaService-Bedingung bedeutet, dass Fin den KMS-Schlüssel nur verwenden kann, um Dateien aus Amazon S3 in der Region Ihres Buckets zu lesen.


So synchronisieren Sie Inhalte von Amazon S3

Schritt 1: Amazon S3 als Quelle hinzufügen

Um Amazon S3 als Inhaltsquelle hinzuzufügen, gehen Sie zu Fin AI Agent > Train > Content. Klicken Sie unter „Inhalte hinzufügen“ auf From Amazon S3.

Die Amazon S3-Einrichtung hat 4 Registerkarten: Connect, Filters, Target und Review.

Schritt 2: Geben Sie Ihre Amazon S3-Bucket-Details ein

Geben Sie auf der Registerkarte Connect unter Bucket Ihre Amazon S3-Bucket-Details ein:

  • Bucket-Name: zum Beispiel my-help-docs-bucket.

  • AWS-Konto-ID: die 12-stellige ID des AWS-Kontos, dem der Bucket gehört.

  • Präfix (optional): ein Ordnerpfad, zum Beispiel docs/, um nur aus 1 Ordner zu synchronisieren. Das Präfix darf keine *, ? oder $ enthalten.

Klicken Sie auf Weiter, um Ihre Bucket-Richtlinie anzuzeigen.

Schritt 3: Fügen Sie die Bucket-Richtlinie hinzu und überprüfen Sie den Zugriff

Nachdem Sie Ihre Bucket-Details eingegeben haben, zeigt Fin einen Abschnitt Bucket-Richtlinie mit den für Ihre Amazon S3-Quelle generierten Aussagen an. Um Fin Zugriff auf Ihren Bucket zu gewähren:

  1. Öffnen Sie Ihren Bucket in der Amazon S3-Konsole und bearbeiten Sie dessen Bucket-Richtlinie.

  2. Kopieren Sie in Fin die Bucket-Richtlinienaussagen. Klicken Sie auf Vollständige Richtlinie anzeigen, um alle anzuzeigen.

  3. Fügen Sie die Aussagen der Statement-Liste Ihrer Bucket-Richtlinie hinzu.

  4. Wenn Ihre Dateien einen vom Kunden verwalteten KMS-Schlüssel verwenden, kopieren Sie auch die Schlüsselrichtlinienaussage von Fin und fügen Sie sie der Schlüsselrichtlinie dieses Schlüssels hinzu.

  5. Speichern Sie die Bucket-Richtlinie.

  6. In Fin klicken Sie auf Verify.

Wichtig: Fügen Sie die generierten Anweisungen zu Ihrer bestehenden Bucket-Richtlinie hinzu. Ersetzen Sie nicht die gesamte Bucket-Richtlinie, da sonst der Zugriff, den sie anderen users und Diensten bereits gewährt, entfernt wird.

Wenn die Verify-Prüfung bestanden ist, öffnet Fin die Registerkarte Filters. Um einen anderen Bucket zu verwenden, klicken Sie auf Change bucket und geben Sie die neuen Details ein.

Hinweis: Verify benötigt mindestens 1 nicht leere Datei in Ihrem Bucket oder unter Ihrem Präfix, um den Zugriff von Fin zu testen. Wenn der Bucket oder das Präfix leer ist, fügen Sie vor dem Klicken auf Verify eine Datei hinzu.

Schritt 4: Wählen Sie aus, welche Dateien synchronisiert werden und wie sie importiert werden

Auf der Registerkarte Filters unter Choose files and file type mapping wählen Sie aus, welche Dateitypen von Amazon S3 synchronisiert werden und was jeder in Fin wird:

  • Dateitypen: Wählen Sie aus, welche Dateitypen synchronisiert werden: Markdown, PDF, DOCX und HTML. Alle 4 sind standardmäßig ausgewählt.

  • Dateitypen-Zuordnung: Wählen Sie in der Spalte Imports as, was jeder Dateityp in Fin wird.

Diese Tabelle zeigt die Optionen Imports as und die Standardwerte für jeden Dateityp im Amazon S3-Inhaltssync:

Dateityp

Optionen

Standard

Markdown

Public article, Internal article, Snippet

Public article

PDF

Public article, Internal article, Snippet, Document

Document

DOCX

Public article, Internal article, Snippet, Document

Document

HTML

Webseite

Webseite

Hinweis: PDF- und DOCX-Dateien, die in einen Artikel oder Snippet konvertiert werden, können einige Formatierungen verlieren, wie Tabellen und Bilder. Um so viel wie möglich vom Originalformat zu erhalten, ordnen Sie sie Document zu.

Unter Choose which files to sync wählen Sie Ordner und Dateien in der Liste Files to sync aus:

  • Um einen Ordner zu öffnen, klicken Sie auf den Pfeil daneben.

  • Um einen ganzen Ordner zu synchronisieren, wählen Sie ihn aus. Ausgewählte Ordner enthalten auch später hinzugefügte Dateien.

  • Um alles im Bucket oder unter Ihrem Präfix zu synchronisieren, wählen Sie Select all aus.

  • Um mehr Dateien zu sehen in einem großen Ordner, klicken Sie auf Load more.

Die Liste Files to sync zeigt Ordner und nur die von Ihnen gewählten Dateitypen an.

Schritt 5: Filtern Sie Amazon S3-Dateien nach Metadaten (optional)

Unter Filter by file metadata können Sie Regeln hinzufügen, um auszuwählen, welche Ihrer ausgewählten Amazon S3-Dateien synchronisiert werden. Sie können nach diesen Dateifeldern filtern:

  • Ordnerpfad

  • Dateiname

  • Größe (Bytes)

  • Zuletzt geändert

  • Tags (zum Beispiel owner=support)

Fin zeigt an, wie viele Dateien Ihren Regeln entsprechen.

Hinweis: Die Dateianzahl während der Einrichtung beinhaltet keine Tag-Regeln, da Fin Tags nur beim Synchronisieren liest. Die tatsächlich synchronisierte Dateianzahl kann niedriger sein als die angezeigte.

Schritt 6: Wählen Sie, wer den synchronisierten Inhalt verwenden kann

Auf der Registerkarte Target unter Choose content access wählen Sie, wo Fin den von Amazon S3 synchronisierten Inhalt verwendet:

  • Fin AI Agent: Fin verwendet den Inhalt, um Kunden zu antworten.

  • Copilot: Teammitglieder können den Inhalt in Copilot verwenden.

  • Help Center: Öffentliche Artikel sind für Kunden in Ihrem Help Center sichtbar. Wenn Sie dies aktivieren, wählen Sie ein help center aus.

Sie können auch Zielgruppenregeln hinzufügen, um einzuschränken, für welche Kunden Fin den synchronisierten Inhalt verwendet. Klicken Sie auf Next, um Ihre Einstellungen zu überprüfen.

Schritt 7: Wählen Sie einen Synchronisationsmodus und schließen Sie ab

Auf der Registerkarte Review überprüfen Sie Ihre Amazon S3-Quelleneinstellungen unter Review and finish. Wählen Sie dann unter Sync mode, wie der Inhalt aktuell gehalten wird:

  • Laufende Synchronisierung: Hält den Inhalt täglich mit dem Bucket auf dem neuesten Stand.

  • Einmaliger Import: kopiert die Dateien einmalig. Spätere Änderungen im Bucket werden nicht synchronisiert.

Klicken Sie auf Sync and publish für eine fortlaufende Synchronisierung oder Import and publish für einen einmaligen Import. Fin beginnt mit dem Lesen Ihrer Dateien und Sie erhalten eine E-Mail, wenn die Synchronisierung abgeschlossen ist.


So synchronisieren, bearbeiten oder entfernen Sie eine Amazon S3-Quelle erneut

Um eine Amazon S3-Quelle zu verwalten, gehen Sie zur Quelle und öffnen Sie das Manage-Menü. Sie können wählen:

  • Re-sync: liest den Bucket jetzt erneut. Fin überspringt Dateien, die sich nicht geändert haben.

  • Edit source: ändert die Dateiauswahl, Filter, Inhaltszugriff und Synchronisierungsmodus.

  • Remove this source: entfernt die Quelle und alle synchronisierten Inhalte, einschließlich Ordner und Unterordner, aus Ihrem Workspace.

Hinweis: Die Optionen im Manage-Menü sind während der Synchronisierung der Amazon S3-Quelle nicht verfügbar.

Wichtig: Das Entfernen einer Amazon S3-Quelle löscht alle synchronisierten Inhalte aus Ihrem Workspace und kann nicht rückgängig gemacht werden. Ihre Dateien in Amazon S3 bleiben unverändert.

Was können Sie beim Bearbeiten einer Amazon S3-Quelle nicht ändern?

Beim Bearbeiten einer Amazon S3-Quelle können einige Einstellungen nicht geändert werden:

  • Bucket, Konto-ID und Präfix: Um einen anderen Bucket zu verwenden, entfernen Sie die Quelle und erstellen Sie eine neue.

  • Dateitypzuordnung: Diese kann nach dem ersten Import nicht geändert werden. Um sie zu ändern, entfernen Sie die Quelle und verbinden Sie sie erneut.

  • Help center: Das während der Einrichtung gewählte help center kann nicht geändert werden.

  • Content access: Änderungen gelten nur für neu synchronisierte Inhalte. Bestehende Inhalte behalten ihre aktuellen Einstellungen.


FAQs

Welche Dateitypen unterstützt die Amazon S3-Inhaltssynchronisierung?

Die Amazon S3-Inhaltssynchronisierung unterstützt Markdown (.md), PDF (.pdf), Word (.docx) und HTML (.html, .htm) Dateien. Andere Dateitypen wie .doc werden in der Liste Files to sync nicht angezeigt und nicht synchronisiert.

Eine PDF-, DOCX- oder HTML-Datei wird ebenfalls übersprungen, wenn ihr Content-Type-Metadatenwert in Amazon S3 nicht mit der Dateierweiterung übereinstimmt. Zum Beispiel wird eine PDF mit dem Content-Type text/html nicht synchronisiert.

Was ist die maximale Dateigröße für die Amazon S3-Inhaltssynchronisierung?

Amazon S3-Dateien, die die maximale Größe für ihren Typ überschreiten, werden übersprungen und nicht synchronisiert. Diese Tabelle zeigt die maximale Dateigröße für jeden Dateityp:

Dateityp

Maximale Größe

PDF, DOCX

100 MB

HTML

16 MB

Markdown

5 MB

PDF- und DOCX-Dateien, die einem Artikel oder Snippet zugeordnet sind, haben eine zweite Grenze: Ihr konvertierter Text darf 5 MB nicht überschreiten, sonst wird die Datei übersprungen.

Hinweis: Wenn eine bereits synchronisierte Amazon S3-Datei die maximale Größe überschreitet, schlägt die Synchronisierung fehl, bis Sie die Datei verkleinern oder aus der Auswahl entfernen.

Wie viele Dateien kann eine Amazon S3-Quelle synchronisieren?

Eine Amazon S3-Quelle synchronisiert bis zu 100.000 Dateien. Wenn Ihre Auswahl mehr enthält, synchronisiert Fin die ersten 100.000 und entfernt keine bereits synchronisierten Inhalte der übrigen Dateien. Um unter dem Limit zu bleiben, verwenden Sie ein Präfix, Ordner oder Filter zur Eingrenzung oder erstellen Sie weitere Quellen.

Kann man einen Amazon S3-Bucket mit mehr als einer Quelle oder einem Workspace synchronisieren?

Jede Amazon S3-Quelle liest 1 Bucket. Sie können mehrere Quellen für denselben Bucket in einem Workspace erstellen, aber deren Präfixe dürfen sich nicht überschneiden.

Ein Amazon S3-Bucket kann nur zu 1 Workspace gehören, auch wenn 2 Workspaces zur gleichen Firma gehören. Wenn ein anderer Workspace den Bucket bereits verwendet, zeigt Verify „Another Fin workspace already uses this bucket. Use a different bucket.“ Der Bucket wird wieder verfügbar, wenn die letzte Quelle darauf entfernt wird.

Welche Verschlüsselungstypen unterstützt die Amazon S3-Inhaltssynchronisierung?

Die Amazon S3-Inhaltssynchronisierung liest Dateien, die mit Amazon S3 verwalteten Schlüsseln (SSE-S3) oder einem kundengesteuerten KMS-Schlüssel verschlüsselt sind. Fin kann Dateien, die mit dem AWS verwalteten Schlüssel (aws/s3) verschlüsselt sind, nicht lesen. Um diese Dateien zu synchronisieren, verschlüsseln Sie sie stattdessen mit SSE-S3 oder einem kundengesteuerten Schlüssel.

Was passiert, wenn Sie eine Datei in Amazon S3 verschieben oder umbenennen?

Wenn Sie eine Amazon S3-Datei innerhalb Ihrer Auswahl verschieben oder umbenennen, ohne den Inhalt zu ändern, behält Fin das gleiche synchronisierte Element und aktualisiert dessen Titel und Ordner. Manchmal vergibt AWS der verschobenen Datei einen neuen Fingerabdruck, z. B. wenn eine große Datei in Teilen kopiert wird. In diesem Fall fügt Fin die Datei als neues Element hinzu und entfernt das alte.

Wie viele Ordnerebenen kopiert die Amazon S3-Inhaltssynchronisierung?

Die Amazon S3-Inhaltssynchronisierung kopiert Ihre Ordnerstruktur bis zu 10 Ebenen tief. Dateien in tieferen Ordnern werden in den tiefsten kopierten Ordner verschoben.

Welche Sprache und Sammlung verwenden öffentliche Artikel, die von Amazon S3 synchronisiert wurden?

Öffentliche Artikel, die von Amazon S3 synchronisiert wurden, verwenden die Sprache des gewählten help center. Sie werden keiner Sammlung hinzugefügt.

Wo wird der von Amazon S3 synchronisierte Inhalt gespeichert?

Ihr Amazon S3-Bucket kann sich in jeder AWS-Region befinden. Fin speichert die synchronisierten Inhalte in der Region Ihres Workspaces.

Hat dies deine Frage beantwortet?