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, activar actualizaciones en tiempo real para que los cambios en los archivos se sincronicen en pocos minutos, 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 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 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 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: Añadir Amazon S3 como fuente
Para añadir Amazon S3 como fuente de contenido, ve a Fin AI Agent > Train > Content. Bajo «Añadir contenido», haz clic en Desde Amazon S3.
La configuración de Amazon S3 tiene 4 pestañas: Conectar, Filtros, Destino y Revisión.
Paso 2: Introduce los detalles de tu bucket de Amazon S3
En la pestaña Conectar, bajo Bucket, introduce los detalles de tu bucket de Amazon S3:
Nombre del bucket: por ejemplo,
my-help-docs-bucket.ID de cuenta AWS: el ID de 12 dígitos de la cuenta 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: Añade la política del bucket y verifica el acceso
Después de introducir los detalles de tu bucket, Fin muestra una sección Política del bucket 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 declaraciones de política del bucket. Haz clic en Mostrar política completa para verlas todas.
Añade 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 declaración de política de clave de Fin y añádela 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 a otros users y servicios.
Cuando la verificación pase, Fin abre la pestaña Filters. Para usar otro bucket, 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.
Cómo activar las actualizaciones en tiempo real para Amazon S3 (opcional)
Las actualizaciones en tiempo real para Amazon S3 sincronizan los cambios de archivos en pocos minutos en lugar de una vez al día. Las actualizaciones en tiempo real usan un tema de evento Amazon Simple Notification Service (SNS) en la cuenta AWS que posee el bucket.
Para activar las actualizaciones en tiempo real en la pestaña Connect de tu fuente Amazon S3:
Activa Real-time updates.
En CloudFormation (recommended), haz clic en Download template y despliega el stack en la Región AWS que Fin muestra, en la cuenta AWS que posee el bucket. Para configurar el tema tú mismo, usa Manual setup.
Espera a que Topic subscribed muestre «Connected».
En la consola de Amazon S3, añade una notificación de evento a tu bucket. Establece el destino al tema SNS y usa la salida
TopicArnde tu stack (CloudFormation > tu stack > Outputs > TopicArn). Usa el prefijo y eventos que Fin muestra en los pasos de configuración: Todos los eventos de creación de objetos, Todos los eventos de eliminación de objetos, Expiración del ciclo de vida y Todos los eventos de etiquetado de objetos.
Cuando Topic subscribed y Bucket events ambos muestran «Connected», las actualizaciones en tiempo real para Amazon S3 están configuradas. Last event muestra cuándo Fin recibió por última vez un cambio de tu bucket.
Nota: Puedes terminar de configurar las actualizaciones en tiempo real después de guardar tu fuente Amazon S3. Las actualizaciones en tiempo real esperan hasta que lleguen eventos de tu bucket.
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 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 Amazon S3 por metadatos (opcional)
Bajo Filter by file metadata, puedes añadir reglas para elegir qué archivos seleccionados de Amazon S3 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 agregar 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 finaliza
En la pestaña Review, verifica la configuración de tu fuente Amazon S3 bajo Review and finish. Luego, bajo Sync mode, elige cómo se mantiene actualizado el contenido:
Ongoing sync: mantiene el contenido actualizado con el bucket cada día. Si activaste actualizaciones en tiempo real, los cambios en archivos se sincronizan en pocos minutos.
One-time import: 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 Amazon S3
Para administrar una fuente Amazon S3, ve a la fuente y abre el menú Manage. Puedes elegir:
Re-sync: lee el bucket nuevamente ahora. Fin omite 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 Amazon S3 se está sincronizando.
Importante: Eliminar una fuente Amazon S3 borra todo su contenido sincronizado de tu espacio de trabajo y no puedes deshacerlo. Tus archivos en Amazon S3 no se ven afectados.
¿Qué no puedes cambiar al editar una fuente Amazon S3?
Al editar una fuente Amazon S3, algunas configuraciones no pueden cambiar:
Bucket, account ID, and prefix: 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 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 Amazon S3?
Una fuente 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 Amazon S3 con más de una fuente o espacio de trabajo?
Cada fuente Amazon S3 lee 1 bucket. Puedes crear varias fuentes en el mismo bucket en un espacio de trabajo, pero sus prefijos no pueden superponerse.
Un bucket 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 «Otro espacio de trabajo Fin ya usa este bucket. Usa un bucket diferente.» 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 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 se colocan en la carpeta copiada más profunda.
¿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 workspace.








