Usa este artículo para conectar un bucket de Amazon S3 a Fin, elegir qué archivos sincronizar y en qué se convierten, y entender los límites de la sincronización de contenido de Amazon S3.
La sincronización de contenido de Amazon S3 copia archivos de 1 bucket de Amazon S3 a Fin, para que Fin AI Agent, Copilot y tu Help Center puedan usarlos. Tú eliges qué carpetas y archivos sincronizar, y qué se convierte cada tipo de archivo: un artículo público, un artículo interno, un fragmento o un documento. Puedes mantener el contenido actualizado con una sincronización diaria o importarlo una sola vez.
Nota: La sincronización de contenido de Amazon S3 está en beta abierta. Está disponible tanto si usas Fin con Intercom como con otro helpdesk.
Qué necesitas antes de sincronizar contenido desde Amazon S3
Para configurar la sincronización de contenido de Amazon S3, necesitas:
El nombre del bucket. Cada fuente de Amazon S3 lee archivos de 1 bucket, que puede estar en cualquier región de AWS.
El ID de cuenta de AWS de la cuenta que posee el bucket. Es un número de 12 dígitos.
Permiso para editar la política del bucket en la cuenta de AWS que posee el bucket.
Permiso para editar la política de la clave del AWS Key Management Service (KMS), solo si tus archivos están cifrados con una clave KMS gestionada por el cliente.
No necesitas crear un rol de AWS Identity and Access Management (IAM) ni una clave de acceso para la sincronización de contenido de Amazon S3. Fin usa su propio rol de solo lectura, por lo que no se almacenan credenciales de AWS en tu espacio de trabajo. Das acceso a ese rol en la política de tu bucket, solo para esta fuente.
¿Qué permisos otorga la política del bucket de Amazon S3 a Fin?
Fin genera las declaraciones de política del bucket para tu fuente de Amazon S3 durante la configuración. Esta tabla muestra los 4 permisos de solo lectura que las declaraciones otorgan a Fin:
Declaración | Permiso | Qué permite hacer a Fin |
Listar |
| Listar los archivos en el bucket, o solo los archivos bajo tu prefijo |
Ubicación |
| Encontrar la región AWS del bucket |
Leer |
| Leer los archivos |
Etiquetas |
| Leer etiquetas de archivos, para que puedas filtrarlas |
Nota: La política del bucket de Amazon S3 no otorga a Fin ningún permiso para escribir, cambiar o eliminar archivos en tu bucket.
Este ejemplo muestra las declaraciones de política del bucket generadas para una fuente de Amazon S3 que usa el prefijo docs/. Los valores en mayúsculas, como YOUR_BUCKET y SOURCE_ID, son marcadores de posición. Fin completa los valores reales para tu fuente durante la configuración.
[
{
"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" }
}
}
]
Sin un prefijo, la declaración List no tiene condición s3:prefix, y las declaraciones Read y Tags usan el Amazon Resource Name (ARN) arn:aws:s3:::YOUR_BUCKET/* como recurso.
Si tus archivos están cifrados con una clave KMS gestionada por el cliente, Fin también genera 1 declaración de política de clave para tu fuente de 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 condición kms:ViaService significa que Fin solo puede usar la clave KMS para leer archivos de Amazon S3 en la región de tu bucket.
Cómo sincronizar contenido desde Amazon S3
Paso 1: Agrega Amazon S3 como fuente
Para agregar Amazon S3 como fuente de contenido, ve a Fin AI Agent > Train > Content. Bajo «Add content», haz clic en From Amazon S3.
La configuración de Amazon S3 tiene 4 pestañas: Connect, Filters, Target y Review.
Paso 2: Ingresa los detalles de tu bucket de Amazon S3
En la pestaña Connect, bajo Bucket, ingresa los detalles de tu bucket de Amazon S3:
Nombre del bucket: por ejemplo,
my-help-docs-bucket.ID de cuenta de AWS: el ID de 12 dígitos de la cuenta de AWS que posee el bucket.
Prefijo (opcional): una ruta de carpeta, por ejemplo
docs/, para sincronizar solo desde 1 carpeta. El prefijo no puede contener*,?ni$.
Haz clic en Siguiente para ver la política de tu bucket.
Paso 3: Agrega la política del bucket y verifica el acceso
Después de ingresar los detalles de tu bucket, Fin muestra una sección Bucket policy con las declaraciones generadas para tu fuente de Amazon S3. Para dar acceso a Fin a tu bucket:
Abre tu bucket en la consola de Amazon S3 y edita su política de bucket.
En Fin, copia las Bucket policy statements. Haz clic en Show full policy para verlas todas.
Agrega las declaraciones a la lista de Declaraciones de tu política de bucket.
Si tus archivos usan una clave KMS gestionada por el cliente, copia también la Key policy statement de Fin y agrégala a la política de clave de esa clave.
Guarda la política del bucket.
En Fin, haz clic en Verify.
Importante: Añade las declaraciones generadas a tu política de bucket existente. No reemplaces toda la política del bucket, porque eso elimina cualquier acceso que ya tenga para otros users y servicios.
Cuando la verificación pasa, Fin abre la pestaña Filters. Para usar un bucket diferente, haz clic en Change bucket e ingresa los nuevos detalles.
Nota: Verify necesita al menos 1 archivo no vacío en tu bucket, o bajo tu prefijo, para probar el acceso de Fin. Si el bucket o prefijo está vacío, añade un archivo antes de hacer clic en Verify.
Paso 4: Elige qué archivos sincronizar y cómo se importan
En la pestaña Filters, bajo Choose files and file type mapping, elige qué tipos de archivo sincronizan desde Amazon S3 y qué se convierte cada uno en Fin:
Tipos de archivo: elige qué tipos de archivo sincronizar: Markdown, PDF, DOCX y HTML. Los 4 están seleccionados por defecto.
Mapeo de tipos de archivo: en la columna Imports as, elige qué se convierte cada tipo de archivo en Fin.
Esta tabla muestra las opciones de Imports as y el valor predeterminado para cada tipo de archivo en la sincronización de contenido de Amazon S3:
Tipo de archivo | Opciones | Predeterminado |
Markdown | Artículo público, Artículo interno, Fragmento | Artículo público |
Artículo público, Artículo interno, Fragmento, Documento | Documento | |
DOCX | Artículo público, Artículo interno, Fragmento, Documento | Documento |
HTML | Página web | Página web |
Nota: Los archivos PDF y DOCX convertidos en artículo o fragmento pueden perder algo de formato, como tablas e imágenes. Para conservar la mayor parte del formato original posible, asígnalos a Documento.
Bajo Choose which files to sync, selecciona carpetas y archivos en la lista Files to sync:
Para abrir una carpeta, haz clic en la flecha junto a ella.
Para sincronizar una carpeta completa, selecciónala. Las carpetas seleccionadas también incluyen archivos añadidos después.
Para sincronizar todo en el bucket, o todo bajo tu prefijo, selecciona Select all.
Para ver más archivos en una carpeta grande, haz clic en Load more.
La lista Files to sync muestra carpetas y solo los tipos de archivo que elegiste.
Paso 5: Filtrar archivos de Amazon S3 por metadatos (opcional)
Bajo Filter by file metadata, puedes añadir reglas para elegir cuáles de tus archivos seleccionados de Amazon S3 se sincronizan. Puedes filtrar por estos campos de archivo:
Ruta de carpeta
Nombre de archivo
Tamaño (bytes)
Última modificación
Etiquetas (por ejemplo,
owner=support)
Fin muestra cuántos archivos coinciden con tus reglas.
Nota: El conteo de archivos durante la configuración no incluye reglas de etiquetas, porque Fin solo lee etiquetas cuando los archivos se sincronizan. El número de archivos que realmente se sincronizan puede ser menor que el conteo mostrado.
Paso 6: Elige quién puede usar el contenido sincronizado
En la pestaña Target, bajo Choose content access, elige dónde Fin usa el contenido sincronizado desde Amazon S3:
Fin AI Agent: Fin usa el contenido para responder a los clientes.
Copilot: los compañeros pueden usar el contenido en Copilot.
Help Center: los artículos públicos son visibles para los clientes en tu Help Center. Si activas esto, selecciona un help center.
También puedes añadir reglas de audiencia para limitar para qué clientes Fin usa el contenido sincronizado. Haz clic en Next para revisar tus configuraciones.
Paso 7: Elige un modo de sincronización y termina
En la pestaña Review, revisa la configuración de tu fuente Amazon S3 bajo Review and finish. Luego, bajo Sync mode, elige cómo se mantiene actualizado el contenido:
Sincronización continua: mantiene el contenido actualizado con el bucket todos los días.
Importación única: copia los archivos una vez. Los cambios posteriores en el bucket no se sincronizan.
Haz clic en Sync and publish para una sincronización continua, o en Import and publish para una importación única. Fin comienza a leer tus archivos y recibirás un correo cuando la sincronización termine.
Cómo volver a sincronizar, editar o eliminar una fuente de Amazon S3
Para administrar una fuente de Amazon S3, ve a la fuente y abre el menú Manage. Puedes elegir:
Re-sync: lee el bucket nuevamente ahora. Fin omite los archivos que no han cambiado.
Edit source: cambia la selección de archivos, filtros, acceso al contenido y modo de sincronización.
Remove this source: elimina la fuente y todo su contenido sincronizado, incluyendo carpetas y subcarpetas, de tu espacio de trabajo.
Nota: Las opciones del menú Manage no están disponibles mientras la fuente de Amazon S3 se está sincronizando.
Importante: Eliminar una fuente de Amazon S3 borra todo su contenido sincronizado de tu espacio de trabajo y no se puede deshacer. Tus archivos en Amazon S3 no se ven afectados.
¿Qué no puedes cambiar al editar una fuente de Amazon S3?
Al editar una fuente de Amazon S3, algunas configuraciones no pueden cambiar:
Bucket, account ID y prefijo: para usar un bucket diferente, elimina la fuente y crea una nueva.
File type mapping: esto no puede cambiar después de la primera importación. Para cambiarlo, elimina la fuente y conéctala de nuevo.
Help center: el help center elegido durante la configuración no puede cambiar.
Content access: los cambios se aplican solo al contenido sincronizado nuevo. El contenido existente mantiene su configuración actual.
Preguntas frecuentes
¿Qué tipos de archivo soporta la sincronización de contenido de Amazon S3?
La sincronización de contenido de Amazon S3 soporta archivos Markdown (.md), PDF (.pdf), Word (.docx) y HTML (.html, .htm). Otros tipos de archivo, como .doc, no aparecen en la lista Files to sync y no se sincronizan.
Un archivo PDF, DOCX o HTML también se omite cuando su metadato Content-Type en Amazon S3 no coincide con su extensión de archivo. Por ejemplo, un PDF almacenado con Content-Type text/html no se sincroniza.
¿Cuál es el tamaño máximo de archivo para la sincronización de contenido de Amazon S3?
Los archivos de Amazon S3 que superan el tamaño máximo para su tipo se omiten y no se sincronizan. Esta tabla muestra el tamaño máximo para cada tipo de archivo:
Tipo de archivo | Tamaño máximo |
PDF, DOCX | 100 MB |
HTML | 16 MB |
Markdown | 5 MB |
Los archivos PDF y DOCX asignados a un artículo o fragmento tienen un segundo límite: su texto convertido debe ser de 5 MB o menos, o el archivo se omite.
Nota: Si un archivo de Amazon S3 que ya se sincronizó supera su tamaño máximo, la sincronización falla hasta que reduzcas el archivo o lo elimines de la selección.
¿Cuántos archivos puede sincronizar una fuente de Amazon S3?
Una fuente de Amazon S3 sincroniza hasta 100,000 archivos. Si tu selección tiene más, Fin sincroniza los primeros 100,000 y no elimina el contenido ya sincronizado del resto. Para mantenerte dentro del límite, usa un prefijo, carpetas o filtros para reducir tu selección, o crea más fuentes.
¿Puedes sincronizar un bucket de Amazon S3 en más de una fuente o espacio de trabajo?
Cada fuente de Amazon S3 lee 1 bucket. Puedes crear varias fuentes en el mismo bucket dentro de un espacio de trabajo, pero sus prefijos no pueden superponerse.
Un bucket de Amazon S3 solo puede pertenecer a 1 espacio de trabajo, incluso cuando 2 espacios de trabajo pertenecen a la misma empresa. Si otro espacio de trabajo ya usa el bucket, Verify muestra «Another Fin workspace already uses this bucket. Use a different bucket.» El bucket vuelve a estar disponible cuando se elimina la última fuente que lo usa.
¿Qué tipos de cifrado soporta la sincronización de contenido de Amazon S3?
La sincronización de contenido de Amazon S3 lee archivos cifrados con claves gestionadas por Amazon S3 (SSE-S3) o con una clave KMS gestionada por el cliente. Fin no puede leer archivos cifrados con la clave gestionada por AWS (aws/s3). Para sincronizar esos archivos, encripta con SSE-S3 o una clave gestionada por el cliente.
¿Qué sucede cuando mueves o renombras un archivo en Amazon S3?
Cuando mueves o renombras un archivo de Amazon S3 dentro de tu selección sin cambiar su contenido, Fin mantiene el mismo elemento sincronizado y actualiza su título y carpeta. A veces AWS le da una nueva huella digital al archivo movido, por ejemplo, cuando un archivo grande se copia en partes. En ese caso, Fin agrega el archivo como un nuevo elemento y elimina el antiguo.
¿Cuántos niveles de carpetas copia la sincronización de contenido de Amazon S3?
La sincronización de contenido de Amazon S3 copia la estructura de carpetas hasta 10 niveles de profundidad. Los archivos en carpetas más profundas van a la carpeta más profunda copiada.
¿Qué idioma y colección usan los artículos públicos sincronizados desde Amazon S3?
Los artículos públicos sincronizados desde Amazon S3 usan el idioma del help center que elegiste. No se agregan a una colección.
¿Dónde se almacena el contenido sincronizado desde Amazon S3?
Tu bucket de Amazon S3 puede estar en cualquier región de AWS. Fin almacena el contenido sincronizado en la región de tu espacio de trabajo.








