

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Ingerir alterações diretamente em uma base de conhecimento
<a name="kb-direct-ingestion"></a>

As Bases de Conhecimento do Amazon Bedrock permitem que você modifique a fonte de dados e sincronize as alterações em uma única etapa. Você pode utilizar esse recurso se a base de conhecimento estiver conectada a um dos seguintes tipos de fonte de dados:
+ Amazon S3
+ Personalizada

Com a ingestão direta, você pode adicionar, atualizar ou excluir arquivos diretamente em uma base de conhecimento usando uma única ação e sua base de conhecimento pode ter acesso aos documentos sem a necessidade de sincronização. A ingestão direta usa as operações de API `KnowledgeBaseDocuments` para indexar os documentos que você envia diretamente no armazenamento de vetores configurado para a base de conhecimento. Também é possível visualizar os documentos em sua base de conhecimento diretamente com essas operações, em vez de precisar navegar até a fonte de dados conectada para visualizá-los.

## Diferenças em relação à sincronização de uma fonte de dados
<a name="kb-direct-ingestion-sync-diff"></a>

As Bases de Conhecimento do Amazon Bedrock também oferecem um conjunto de operações de API `IngestionJob` relacionadas à [sincronização da fonte de dados](kb-data-source-sync-ingest.md). Quando você sincroniza a fonte de dados com uma solicitação [StartIngestionJob](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_StartIngestionJob.html), as Bases de Conhecimento do Amazon Bedrock examinam cada documento na fonte de dados conectada e verificam se ele já foi indexado no armazenamento de vetores configurado para a base de conhecimento. Caso contrário, ele será indexado no armazenamento de vetores.

Com uma solicitação [IngestKnowledgeBaseDocuments](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_IngestKnowledgeBaseDocuments.html), você envia uma matriz de documentos para que sejam indexados diretamente no armazenamento de vetores. Portanto, você pula a etapa de adicionar documentos à fonte de dados. Consulte os seguintes parágrafos para entender o caso de uso desses dois conjuntos de operações de API:

**Se você usar uma fonte de dados personalizada**  
Você não precisará sincronizar nem usar as operações `IngestionJob`. Os documentos que você adicionar, modificar ou excluir com as operações `KnowledgeBaseDocuments` ou no Console de gerenciamento da AWS se tornarão parte da fonte de dados personalizada e da sua base de conhecimento.

**Se você usar uma fonte de dados do Amazon S3**  
Use os dois conjuntos de operações em casos de uso diferentes:
+ Depois de conectar a base de conhecimento à fonte de dados do S3 pela primeira vez, você deve sincronizar sua fonte de dados no Console de gerenciamento da AWS ou enviando uma solicitação [StartIngestionJob](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_StartIngestionJob.html) por meio da API do Amazon Bedrock.
+ Indexe documentos no armazenamento de vetores configurado para sua base de conhecimento ou remova os documentos indexados das seguintes formas:

  1. Adicione documentos ao seu local do S3 ou exclua documentos dele. Em seguida, sincronize sua fonte de dados no Console de gerenciamento da AWS ou envie uma solicitação `StartIngestionJob` na API. Para obter detalhes sobre a sincronização e a operação `StartIngestionJob`, consulte [Sincronizar os dados com a base de conhecimento do Amazon Bedrock](kb-data-source-sync-ingest.md).

  1. Inclua documentos do S3 na base de conhecimento diretamente com uma solicitação `IngestKnowledgeBaseDocuments`. Para obter detalhes sobre a ingestão direta de documentos, consulte [Ingerir documentos diretamente em uma base de conhecimento](kb-direct-ingestion-add.md).
**Atenção**  
Para fontes de dados do S3, todas as alterações que você indexa na base de conhecimento diretamente no Console de gerenciamento da AWS ou com as operações de API `KnowledgeBaseDocuments` não são reproduzidas no local do S3. É possível usar essas operações de API para disponibilizar imediatamente alterações na base de conhecimento em uma única etapa. No entanto, você deve continuar fazendo as mesmas alterações no local do S3 para que elas não sejam sobrescritas na próxima vez que você sincronizar a fonte de dados no Console de gerenciamento da AWS ou com `StartIngestionJob`.  
Não envie uma solicitação `IngestKnowledgeBaseDocuments` e `StartIngestionJob` ao mesmo tempo.

Selecione um tópico para saber como realizar a ingestão direta de documentos nas fontes de dados:

**Topics**
+ [Diferenças em relação à sincronização de uma fonte de dados](#kb-direct-ingestion-sync-diff)
+ [Pré-requisitos para a ingestão direta](kb-direct-ingestion-prereq.md)
+ [Ingerir documentos diretamente em uma base de conhecimento](kb-direct-ingestion-add.md)
+ [Visualizar informações sobre documentos na fonte de dados](kb-direct-ingestion-view.md)
+ [Excluir documentos de uma base de conhecimento diretamente](kb-direct-ingestion-delete.md)