Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Importare le modifiche direttamente in una knowledge base
<a name="kb-direct-ingestion"></a>

**Importante**  
Per una precisione di recupero ottimizzata e un'esperienza gestita, consigliamo [Amazon Bedrock Managed Knowledge](kb-build-managed.md) Base.

Knowledge Base per Amazon Bedrock consente di modificare l’origine dati e sincronizzare le modifiche in un’unica fase. Puoi sfruttare questa funzionalità se la tua knowledge base è connessa a uno dei seguenti tipi di origine dati:
+ Simple Storage Service (Amazon S3)
+ Personalizzato

Con l’importazione diretta, puoi aggiungere, aggiornare o eliminare direttamente i file in una knowledge base con un’unica azione e la knowledge base può avere accesso ai documenti senza la necessità di sincronizzarli. L’importazione diretta utilizza le operazioni API `KnowledgeBaseDocuments` per indicizzare i documenti inviati direttamente nell’archivio vettoriale configurato per la knowledge base. È inoltre possibile visualizzare i documenti della knowledge base direttamente con queste operazioni, anziché dover accedere all’origine dati connessa per visualizzarli.

## Differenze rispetto alla sincronizzazione di un’origine dati
<a name="kb-direct-ingestion-sync-diff"></a>

Knowledge Base per Amazon Bedrock offre anche una serie di operazioni API `IngestionJob` relative alla [sincronizzazione dell’origine dati](kb-data-source-sync-ingest.md). Quando sincronizzi l'origine dati con una [StartIngestionJob](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_StartIngestionJob.html)richiesta, Amazon Bedrock Knowledge Bases scansiona ogni documento nell'origine dati connessa e verifica se è già stato indicizzato nel vector store configurato per la knowledge base. In caso contrario, viene indicizzato nell’archivio vettoriale.

Con una [IngestKnowledgeBaseDocuments](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_IngestKnowledgeBaseDocuments.html)richiesta, invii una serie di documenti da indicizzare direttamente nel vector store. ignorando, dunque, la fase di aggiunta di documenti nell’origine dati. Consulta i paragrafi seguenti per comprendere il caso d’uso di questi due set di operazioni API:

**In caso di utilizzo di un’origine dati personalizzata**  
Non è necessario sincronizzare o utilizzare le operazioni `IngestionJob`. I documenti che aggiungi, modifichi o elimini con le stesse `KnowledgeBaseDocuments` operazioni o Console di gestione AWS diventano parte sia della fonte di dati personalizzata che della tua knowledge base.

**In caso di utilizzo di un’origine dati Amazon S3**  
I due set di operazioni vengono utilizzati in diversi casi d’uso:
+ Dopo aver collegato la knowledge base all'origine dati S3 per la prima volta, devi sincronizzare l'origine dati in Console di gestione AWS o inviando una [StartIngestionJob](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_StartIngestionJob.html)richiesta tramite l'API Amazon Bedrock.
+ Indicizza i documenti nell’archivio vettoriale configurato per la tua knowledge base o rimuovi i documenti indicizzati nei seguenti modi:

  1. Aggiungi documenti nella tua posizione S3 o elimina documenti dal suo interno. Quindi sincronizza la tua fonte di dati nell'API Console di gestione AWS o invia una `StartIngestionJob` richiesta nell'API. Per informazioni dettagliate sulla sincronizzazione e sull’operazione `StartIngestionJob`, consulta [Sincronizzare i dati con Knowledge Base per Amazon Bedrock](kb-data-source-sync-ingest.md).

  1. Importa documenti S3 nella knowledge base direttamente con una richiesta `IngestKnowledgeBaseDocuments`. Per informazioni dettagliate sull’importazione diretta di documenti, consulta [Importare documenti direttamente in una knowledge base](kb-direct-ingestion-add.md).
**avvertimento**  
Per le fonti di dati S3, qualsiasi modifica indicizzata nella knowledge base direttamente nelle Console di gestione AWS o con le operazioni `KnowledgeBaseDocuments` API non si riflette nella posizione S3. Puoi utilizzare queste operazioni API per rendere immediatamente disponibili le modifiche nella tua knowledge base in un’unica fase. Tuttavia, dovresti continuare apportando le stesse modifiche nella tua posizione S3 in modo che non vengano sovrascritte la prossima volta che sincronizzi l'origine dati in o con. Console di gestione AWS `StartIngestionJob`  
Non inviare richieste `IngestKnowledgeBaseDocuments` e `StartIngestionJob` contemporaneamente.

Seleziona un argomento per scoprire come eseguire l’importazione diretta dei documenti nelle tue origini dati:

**Topics**
+ [Differenze rispetto alla sincronizzazione di un’origine dati](#kb-direct-ingestion-sync-diff)
+ [Prerequisiti per l’importazione diretta](kb-direct-ingestion-prereq.md)
+ [Importare documenti direttamente in una knowledge base](kb-direct-ingestion-add.md)
+ [Visualizzare le informazioni sui documenti nell’origine dati](kb-direct-ingestion-view.md)
+ [Eliminare documenti direttamente da una knowledge base](kb-direct-ingestion-delete.md)