Utilisez cet article pour connecter un bucket Amazon S3 à Fin, choisir quels fichiers synchroniser et ce qu’ils deviennent, et comprendre les limites de la synchronisation de contenu Amazon S3.
La synchronisation de contenu Amazon S3 copie les fichiers d’un bucket Amazon S3 vers Fin, afin que Fin AI Agent, Copilot et votre Help Center puissent les utiliser. Vous choisissez quels dossiers et fichiers synchroniser, et ce que chaque type de fichier devient : un article public, un article interne, un extrait ou un document. Vous pouvez maintenir le contenu à jour avec une synchronisation quotidienne ou l’importer une seule fois.
Note : La synchronisation de contenu Amazon S3 est en bêta ouverte. Elle est disponible que vous utilisiez Fin avec Intercom ou avec un autre helpdesk.
Ce dont vous avez besoin avant de synchroniser le contenu depuis Amazon S3
Pour configurer la synchronisation de contenu Amazon S3, vous avez besoin de :
Le nom du bucket. Chaque source Amazon S3 lit les fichiers d’un bucket, qui peut être dans n’importe quelle région AWS.
L’ID du compte AWS du compte propriétaire du bucket. C’est un numéro à 12 chiffres.
La permission de modifier la politique du bucket dans le compte AWS propriétaire du bucket.
La permission de modifier la politique de la clé AWS Key Management Service (KMS), uniquement si vos fichiers sont chiffrés avec une clé KMS gérée par le client.
Vous n’avez pas besoin de créer un rôle AWS Identity and Access Management (IAM) ni une clé d’accès pour la synchronisation de contenu Amazon S3. Fin utilise son propre rôle en lecture seule, donc aucune information d’identification AWS n’est stockée dans votre espace de travail. Vous donnez à ce rôle l’accès dans la politique de votre bucket, uniquement pour cette source.
Quelles permissions la politique du bucket Amazon S3 donne-t-elle à Fin ?
Fin génère les déclarations de politique du bucket pour votre source Amazon S3 lors de la configuration. Ce tableau montre les 4 permissions en lecture seule que ces déclarations donnent à Fin :
Déclaration | Permission | Ce que cela permet à Fin de faire |
Lister |
| Lister les fichiers dans le bucket, ou seulement les fichiers sous votre préfixe |
Emplacement |
| Trouver la région AWS du bucket |
Lire |
| Lire les fichiers |
Tags |
| Lire les tags des fichiers, pour que vous puissiez filtrer dessus |
Note : La politique du bucket Amazon S3 ne donne à Fin aucune permission d’écrire, modifier ou supprimer des fichiers dans votre bucket.
Cet exemple montre les déclarations de politique de bucket générées pour une source Amazon S3 qui utilise le préfixe docs/. Les valeurs en majuscules, telles que YOUR_BUCKET et SOURCE_ID, sont des espaces réservés. Fin remplit les vraies valeurs pour votre source lors de la configuration.
[
{
"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" }
}
}
]
Sans préfixe, la déclaration List n’a pas de condition s3:prefix, et les déclarations Read et Tags utilisent le nom de ressource Amazon (ARN) arn:aws:s3:::YOUR_BUCKET/* comme ressource.
Si vos fichiers sont chiffrés avec une clé KMS gérée par le client, Fin génère aussi 1 déclaration de politique de clé pour votre source Amazon S3 :
{
"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"
}
}
}
La condition kms:ViaService signifie que Fin ne peut utiliser la clé KMS que pour lire les fichiers depuis Amazon S3 dans la région de votre bucket.
Comment synchroniser le contenu depuis Amazon S3
Étape 1 : Ajouter Amazon S3 comme source
Pour ajouter Amazon S3 comme source de contenu, allez dans Fin AI Agent > Train > Content. Sous « Add content », cliquez sur From Amazon S3.
La configuration Amazon S3 comporte 4 onglets : Connect, Filters, Target et Review.
Étape 2 : Saisissez les détails de votre bucket Amazon S3
Dans l’onglet Connect, sous Bucket, saisissez les détails de votre bucket Amazon S3 :
Nom du bucket : par exemple,
my-help-docs-bucket.ID du compte AWS : l’ID à 12 chiffres du compte AWS propriétaire du bucket.
Préfixe (optionnel) : un chemin de dossier, par exemple
docs/, pour synchroniser depuis un seul dossier. Le préfixe ne peut pas contenir*,?ou$.
Cliquez sur Next pour voir la politique de votre bucket.
Étape 3 : Ajoutez la politique du bucket et vérifiez l’accès
Après avoir saisi les détails de votre bucket, Fin affiche une section Bucket policy avec les déclarations générées pour votre source Amazon S3. Pour donner à Fin l’accès à votre bucket :
Ouvrez votre bucket dans la console Amazon S3 et modifiez sa politique de bucket.
Dans Fin, copiez les déclarations de politique du bucket. Cliquez sur Show full policy pour toutes les voir.
Ajoutez les déclarations à la liste Statement de la politique de votre bucket.
Si vos fichiers utilisent une clé KMS gérée par le client, copiez aussi la déclaration de politique de clé depuis Fin, et ajoutez-la à la politique de clé de cette clé.
Enregistrez la politique du bucket.
Dans Fin, cliquez sur Vérifier.
Important : Ajoutez les déclarations générées à votre politique de bucket existante. Ne remplacez pas toute la politique du bucket, car cela supprimerait tout accès déjà accordé à d'autres users et services.
Lorsque la vérification réussit, Fin ouvre l'onglet Filtres. Pour utiliser un autre bucket, cliquez sur Changer de bucket et saisissez les nouvelles informations.
Note : La vérification nécessite au moins 1 fichier non vide dans votre bucket, ou sous votre préfixe, pour tester l'accès de Fin. Si le bucket ou le préfixe est vide, ajoutez un fichier avant de cliquer sur Vérifier.
Étape 4 : Choisissez quels fichiers synchroniser et comment ils sont importés
Dans l'onglet Filtres, sous Choisir les fichiers et le mappage des types de fichiers, choisissez quels types de fichiers synchroniser depuis Amazon S3 et ce que chacun devient dans Fin :
Types de fichiers : choisissez quels types de fichiers synchroniser : Markdown, PDF, DOCX et HTML. Les 4 sont sélectionnés par défaut.
Mappage des types de fichiers : dans la colonne Importé en tant que, choisissez ce que chaque type de fichier devient dans Fin.
Ce tableau montre les options Importé en tant que et la valeur par défaut pour chaque type de fichier dans la synchronisation de contenu Amazon S3 :
Type de fichier | Options | Par défaut |
Markdown | Article public, Article interne, Extrait | Article public |
Article public, Article interne, Extrait, Document | Document | |
DOCX | Article public, Article interne, Extrait, Document | Document |
HTML | Page web | Page web |
Note : Les fichiers PDF et DOCX convertis en article ou extrait peuvent perdre une partie de leur mise en forme, comme les tableaux et les images. Pour conserver autant que possible la mise en forme originale, mappez-les en Document.
Sous Choisir quels fichiers synchroniser, sélectionnez les dossiers et fichiers dans la liste Fichiers à synchroniser :
Pour ouvrir un dossier, cliquez sur la flèche à côté.
Pour synchroniser un dossier entier, sélectionnez-le. Les dossiers sélectionnés incluent également les fichiers ajoutés ultérieurement.
Pour tout synchroniser dans le bucket, ou tout sous votre préfixe, sélectionnez Sélectionner tout.
Pour voir plus de fichiers dans un grand dossier, cliquez sur Charger plus.
La liste Fichiers à synchroniser affiche les dossiers et uniquement les types de fichiers que vous avez choisis.
Étape 5 : Filtrer les fichiers Amazon S3 par métadonnées (optionnel)
Sous Filtrer par métadonnées de fichier, vous pouvez ajouter des règles pour choisir quels fichiers Amazon S3 sélectionnés synchroniser. Vous pouvez filtrer sur ces champs de fichier :
Chemin du dossier
Nom du fichier
Taille (octets)
Dernière modification
Tags (par exemple,
owner=support)
Fin affiche combien de fichiers correspondent à vos règles.
Note : Le comptage des fichiers pendant la configuration n'inclut pas les règles de tags, car Fin ne lit les tags que lors de la synchronisation. Le nombre de fichiers réellement synchronisés peut être inférieur au nombre affiché.
Étape 6 : Choisissez qui peut utiliser le contenu synchronisé
Dans l'onglet Cible, sous Choisir l'accès au contenu, choisissez où Fin utilise le contenu synchronisé depuis Amazon S3 :
Fin AI Agent : Fin utilise le contenu pour répondre aux clients.
Copilot : les coéquipiers peuvent utiliser le contenu dans Copilot.
Help Center : les articles publics sont visibles par les clients dans votre Help Center. Si vous activez cette option, sélectionnez un help center.
Vous pouvez aussi ajouter des règles d'audience pour limiter les clients pour lesquels Fin utilise le contenu synchronisé. Cliquez sur Suivant pour revoir vos paramètres.
Étape 7 : Choisissez un mode de synchronisation et terminez
Dans l'onglet Revue, vérifiez vos paramètres source Amazon S3 sous Revoir et terminer. Puis, sous Mode de synchronisation, choisissez comment le contenu reste à jour :
Synchronisation continue : maintient le contenu à jour avec le bucket chaque jour.
Importation unique : copie les fichiers une seule fois. Les modifications ultérieures dans le bucket ne sont pas synchronisées.
Cliquez sur Synchroniser et publier pour une synchronisation continue, ou sur Importer et publier pour une importation unique. Fin commence à lire vos fichiers, et vous recevrez un email lorsque la synchronisation sera terminée.
Comment resynchroniser, modifier ou supprimer une source Amazon S3
Pour gérer une source Amazon S3, allez à la source et ouvrez le menu Gérer. Vous pouvez choisir :
Resynchroniser : relit le bucket maintenant. Fin ignore les fichiers qui n'ont pas changé.
Modifier la source : change la sélection de fichiers, les filtres, l'accès au contenu et le mode de synchronisation.
Supprimer cette source : supprime la source et tout son contenu synchronisé, y compris les dossiers et sous-dossiers, de votre espace de travail.
Note : Les options du menu Gérer ne sont pas disponibles pendant la synchronisation de la source Amazon S3.
Important : Supprimer une source Amazon S3 supprime tout son contenu synchronisé de votre espace de travail, et cette action est irréversible. Vos fichiers dans Amazon S3 ne sont pas affectés.
Qu'est-ce que vous ne pouvez pas modifier lorsque vous éditez une source Amazon S3 ?
Lorsque vous modifiez une source Amazon S3, certains paramètres ne peuvent pas être changés :
Bucket, ID de compte et préfixe : pour utiliser un bucket différent, supprimez la source et créez-en une nouvelle.
Correspondance des types de fichiers : cela ne peut pas changer après la première importation. Pour le modifier, supprimez la source et reconnectez-la.
Help center : le help center choisi lors de la configuration ne peut pas être modifié.
Accès au contenu : les modifications s'appliquent uniquement au contenu nouvellement synchronisé. Le contenu existant conserve ses paramètres actuels.
FAQ
Quels types de fichiers la synchronisation de contenu Amazon S3 prend-elle en charge ?
La synchronisation de contenu Amazon S3 prend en charge les fichiers Markdown (.md), PDF (.pdf), Word (.docx) et HTML (.html, .htm). Les autres types de fichiers, comme .doc, n'apparaissent pas dans la liste Fichiers à synchroniser et ne sont pas synchronisés.
Un fichier PDF, DOCX ou HTML est également ignoré lorsque ses métadonnées Content-Type dans Amazon S3 ne correspondent pas à son extension de fichier. Par exemple, un PDF stocké avec le Content-Type text/html n'est pas synchronisé.
Quelle est la taille maximale des fichiers pour la synchronisation de contenu Amazon S3 ?
Les fichiers Amazon S3 dépassant la taille maximale pour leur type sont ignorés et ne sont pas synchronisés. Ce tableau montre la taille maximale pour chaque type de fichier :
Type de fichier | Taille maximale |
PDF, DOCX | 100 Mo |
HTML | 16 Mo |
Markdown | 5 Mo |
Les fichiers PDF et DOCX mappés à un article ou un extrait ont une seconde limite : leur texte converti doit faire 5 Mo ou moins, sinon le fichier est ignoré.
Note : Si un fichier Amazon S3 déjà synchronisé dépasse sa taille maximale, la synchronisation échoue jusqu'à ce que vous réduisiez la taille du fichier ou que vous le supprimiez de la sélection.
Combien de fichiers une source Amazon S3 peut-elle synchroniser ?
Une source Amazon S3 synchronise jusqu'à 100 000 fichiers. Si votre sélection en contient plus, Fin synchronise les 100 000 premiers et ne supprime pas le contenu déjà synchronisé du reste. Pour rester sous la limite, utilisez un préfixe, des dossiers ou des filtres pour affiner votre sélection, ou créez plusieurs sources.
Peut-on synchroniser un bucket Amazon S3 vers plusieurs sources ou espaces de travail ?
Chaque source Amazon S3 lit 1 bucket. Vous pouvez créer plusieurs sources sur le même bucket dans un espace de travail, mais leurs préfixes ne peuvent pas se chevaucher.
Un bucket Amazon S3 ne peut appartenir qu'à un seul espace de travail, même lorsque 2 espaces de travail appartiennent à la même entreprise. Si un autre espace de travail utilise déjà le bucket, Verify affiche « Un autre espace de travail Fin utilise déjà ce bucket. Utilisez un bucket différent. » Le bucket redevient disponible lorsque la dernière source dessus est supprimée.
Quels types de chiffrement la synchronisation de contenu Amazon S3 prend-elle en charge ?
La synchronisation de contenu Amazon S3 lit les fichiers chiffrés avec des clés gérées par Amazon S3 (SSE-S3) ou avec une clé KMS gérée par le client. Fin ne peut pas lire les fichiers chiffrés avec la clé gérée par AWS (aws/s3). Pour synchroniser ces fichiers, chiffrez-les avec SSE-S3 ou une clé gérée par le client à la place.
Que se passe-t-il lorsque vous déplacez ou renommez un fichier dans Amazon S3 ?
Lorsque vous déplacez ou renommez un fichier Amazon S3 dans votre sélection sans en changer le contenu, Fin conserve le même élément synchronisé et met à jour son titre et son dossier. Parfois, AWS attribue une nouvelle empreinte au fichier déplacé, par exemple lorsqu'un gros fichier est copié en parties. Dans ce cas, Fin ajoute le fichier comme un nouvel élément et supprime l'ancien.
Combien de niveaux de dossiers la synchronisation de contenu Amazon S3 copie-t-elle ?
La synchronisation de contenu Amazon S3 copie la structure de vos dossiers jusqu'à 10 niveaux de profondeur. Les fichiers dans des dossiers plus profonds sont placés dans le dossier le plus profond copié.
Quelle langue et quelle collection utilisent les articles publics synchronisés depuis Amazon S3 ?
Les articles publics synchronisés depuis Amazon S3 utilisent la langue du help center que vous avez choisi. Ils ne sont pas ajoutés à une collection.
Où est stocké le contenu synchronisé depuis Amazon S3 ?
Votre bucket Amazon S3 peut être dans n'importe quelle région AWS. Fin stocke le contenu synchronisé dans la région de votre espace de travail.








