Preparar arquivos existentes para ingestão

Crie arquivos do cartão lateral de metadados para que o serviço de pesquisa possa associar objetos existentes do Amazon S3 a arquivos do Salesforce.

Nota Conclua essa tarefa apenas para arquivos que existiam antes da habilitação da Pesquisa de armazenamento externo e suas permissões necessárias. O Salesforce cria automaticamente os metadados necessários para novos arquivos depois que o recurso e as permissões são habilitados.

Antes de começar, certifique-se de que você tem:

• Uma base de Knowledge configurada da Amazon Bedrock ou índice do Amazon Kendra.
• Um relatório ou manifesto de inventário do Amazon S3 que identifica os objetos existentes a serem processados.
• Permissão para criar trabalhos de Funções Lambda e Operações em lote do Amazon S3.
• Permissão para ler o arquivo de mapeamento, objetos de origem e carrinhos laterais existentes.
• Permissão para gravar carrinhos laterais de metadados no bucket de origem.

1. Identifique os objetos S3 existentes a serem processados.
2. Gere um arquivo de mapeamento que associe cada arquivo existente ao seu Salesforce ContentDocumentId e local do Amazon S3.
   Consulte Gerar um arquivo de mapeamento em lote para arquivos armazenados externamente.
3. Crie um arquivo de metadados lateral para cada arquivo existente.
   Os metadados associam o arquivo ao registro do Salesforce. Para os requisitos de metadados, consulte Metadados e filtragem para obter uma base de Knowledge na documentação da AWS.
4. Adicione os valores associados do Salesforce ContentDocumentId a cada carrinho lateral.
5. Verifique se cada carrinho lateral segue o formato de metadados Amazon Bedrock ou Kendra, conforme aplicável.
   Para obter mais informações, consulte Adicionar metadados a arquivos para uma base de Knowledge na documentação da AWS e consulte metadados do documento S3 na documentação da AWS.
6. Armazene os carrinhos laterais de metadados:
   • Amazon Kendra: Armazene sob __sfdcroot__/__metadata__/ no bucket S3 de origem.
   • Amazon Bedrock: Armazene o cartão lateral de metadados junto com o objeto de origem.
7. Chame uma função Lambda com eventos em lote do Amazon S3.

   Para obter instruções, consulte Invoque uma função Lambda com eventos em lote do Amazon S3.

   

   Nota O Amazon Kendra não gera transcrições ou resumos de conteúdo de áudio, vídeo ou imagem. Use o modelo apropriado para criar conteúdo de texto pesquisável para esses arquivos antes que o Amazon Kendra os ingerir. Por exemplo, Automação de dados de base da Amazon. Consulte Amazon Bedrock Data Automation.

   O exemplo a seguir ilustra a lógica de atualização do carrinho lateral:

   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. Conceda à função Lambda acesso ao bucket de origem.
9. Crie e execute um trabalho de Operações em lote do Amazon S3 que invoque a função Lambda para os objetos existentes.

• Gerar um arquivo de mapeamento em lote para arquivos armazenados externamente
  Prepare arquivos existentes para o Amazon Bedrock ou o Amazon Kendra gerando um arquivo de mapeamento que associa arquivos do Salesforce aos locais do Amazon S3. Você deve concluir essa tarefa apenas se tiver arquivos existentes no Amazon S3 que deseja pesquisar.