Preparar archivos existentes para el ingreso

Cree archivos de sidecar de metadatos de modo que el servicio de búsqueda pueda asociar objetos de Amazon S3 existentes con archivos de Salesforce.

Nota Complete esta tarea solo para archivos que existían antes de que se activara Búsqueda de almacenamiento externo y sus permisos requeridos. Salesforce crea automáticamente los metadatos requeridos para nuevos archivos después de activar la función y los permisos.

Antes de empezar, asegúrese de que tiene:

• Una base de Knowledge de Amazon Bedrock configurada o un índice de Amazon Kendra.
• Un reporte o manifiesto de inventario de Amazon S3 que identifica los objetos existentes para procesar.
• Permiso para crear funciones Lambda y trabajos de Amazon S3 Batch Operations.
• Permiso para leer el archivo de asignación, los objetos de origen y los sidecares existentes.
• Permiso para redactar sidecars de metadatos en el depósito de origen.

1. Identifique los objetos S3 existentes para procesar.
2. Genere un archivo de asignación que asocie cada archivo existente con su ubicación de Salesforce ContentDocumentId y Amazon S3.
   Consulte Generar un archivo de asignación por lotes para archivos almacenados de forma externa.
3. Cree un archivo de metadatos de sidecar para cada archivo existente.
   Los metadatos asocian el archivo con su registro de Salesforce. Para los requisitos de metadatos, consulte Metadata y filtrado para una base de Knowledge en la documentación de AWS.
4. Agregue los valores ContentDocumentId de Salesforce asociados a cada sidecar.
5. Verifique que cada sidecar sigue el formato de metadatos Amazon Bedrock o Kendra, según corresponda.
   Para obtener más información, consulte Agregar metadatos a archivos para una base de Knowledge en la documentación de AWS, y consulte metadatos de documentos S3 en la documentación de AWS.
6. Almacenar los sidecares de metadatos:
   • Amazon Kendra: Almacene bajo __sfdcroot__/__metadata__/ en el depósito de S3 de origen.
   • Amazon Bedrock: Almacene el sidecar de metadatos junto con el objeto de origen.
7. Invoque una función Lambda con eventos por lotes de Amazon S3.

   Para obtener instrucciones, consulte Invocar una función Lambda con eventos por lotes de Amazon S3.

   

   Nota Amazon Kendra no genera transcripciones o resúmenes desde contenido de audio, video o imagen. Utilice el modelo apropiado para crear contenido de texto con capacidad de búsqueda para estos archivos antes de que Amazon Kendra los ingrese. Por ejemplo, Automatización de datos de Amazon Bedrock. Consulte Automatización de datos Amazon Bedrock.

   El siguiente ejemplo ilustra la lógica de actualización del sidecar:

   1. Load mapping file
   2. For each file in S3:
      a. Look up the salesforce content document Ids from mapping file
      b. Create sidecar metadata json file
      c. Populate the content document Ids in the json file according the correct Bedrock / Kendra format
      d. Make sure the metadata attribute key is "contentDocumentIds" and is an array of 15 digit Id strings

8. Otorgue a la función Lambda acceso al depósito de origen.
9. Cree y ejecute un trabajo de Amazon S3 Batch Operations que invoque la función Lambda para los objetos existentes.

• Generar un archivo de asignación por lotes para archivos almacenados de forma externa
  Prepare archivos existentes para Amazon Bedrock o Amazon Kendra generando un archivo de asignación que asocia archivos de Salesforce con sus ubicaciones de Amazon S3. Debe completar esta tarea solo si tiene archivos existentes en Amazon S3 que desea buscar.