View a markdown version of this page

Sincronizzare un’origine dati - Amazon Bedrock
Imposta una pianificazione di sincronizzazione

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à.

Sincronizzare un’origine dati

Dopo aver creato la knowledge base, importa o sincronizza i dati in modo che possano essere interrogati. L'ingestion converte i dati grezzi presenti nell'origine dati in incorporamenti vettoriali.

Prima di iniziare l’importazione, verificare che l’origine dati soddisfi le seguenti condizioni:

  • Le informazioni sulla connessione dell’origine dati sono state configurate. Vedi Connettere una fonte di dati. La configurazione dell’origine dati viene effettuata nell’ambito della creazione della knowledge base.

  • Hai configurato il modello di incorporamento vettoriale scelto. Visualizza i modelli di incorporamento vettoriale supportati. La configurazione degli embedding vettoriali viene effettuata nell’ambito della creazione della knowledge base.

  • I file sono nei formati supportati. Per ulteriori informazioni, consulta Formati di documento supportati.

  • I file non superano la dimensione del file del processo di importazione specificata in Quote di servizio e quote nella Guida generale. AWS

Ogni volta che vengono aggiunti, modificati o rimossi file dall’origine dati, è necessario sincronizzare l’origine dati in modo che venga reindicizzata nella knowledge base. La sincronizzazione è incrementale, quindi Amazon Bedrock elabora solo i documenti aggiunti, modificati o eliminati dall’ultima sincronizzazione.

Per sapere come inserire i dati nella tua knowledge base e sincronizzarli con i dati più recenti, scegliere la scheda corrispondente al metodo preferito, poi seguire la procedura:

Console
Come importare i dati nella knowledge base e sincronizzarli con i dati più recenti

  1. Accedi Console di gestione AWS e vai ad Amazon Bedrock AgentCore > strumenti > Built-in Knowledge Base.

  2. Scegli la tua base di conoscenza.

  3. Nella sezione Origine dati, seleziona Sincronizza per iniziare l’importazione dei dati o la sincronizzazione dei dati più recenti. Per interrompere la sincronizzazione di un’origine dati attualmente in corso, seleziona Interrompi. Per interrompere la sincronizzazione dell’origine dati, la sincronizzazione dell’origine dati deve essere attualmente in esecuzione. Puoi selezionare nuovamente Sincronizza per importare il resto dei tuoi dati.

  4. Al termine dell’importazione di dati, se l’operazione è riuscita, viene visualizzato un banner verde di successo.

  5. Puoi scegliere un’origine dati per visualizzarne la cronologia di sincronizzazione. Seleziona Visualizza avvisi per scoprire perché un processo di importazione dei dati non è riuscito.

API

Per inserire i tuoi dati nella tua knowledge base e sincronizzarli con i dati più recenti, invia una StartIngestionJob richiesta a un endpoint build-time di Agents for Amazon Bedrock. Specifica knowledgeBaseId e dataSourceId. Puoi anche interrompere un processo di inserimento dati attualmente in esecuzione inviando una richiesta. StopIngestionJob Specifica il dataSourceId, il ingestionJobId e il knowledgeBaseId. Per interrompere l’importazione dei dati, il processo deve essere attualmente in esecuzione. Puoi inviare nuovamente una richiesta StartIngestionJob per importare il resto dei tuoi dati quando è tutto pronto.

Utilizza il valore ingestionJobId restituito nella risposta in una GetIngestionJob richiesta con un endpoint build-time di Agents for Amazon Bedrock per monitorare lo stato del processo di inserimento. Inoltre, specifica il knowledgeBaseId e il dataSourceId.

  • Al termine del processo di importazione, lo status della risposta è COMPLETE.

  • L'oggetto statistics nella risposta restituisce informazioni sull'esito, positivo o negativo, dell'importazione dei documenti nell'origine dati.

Puoi anche visualizzare le informazioni per tutti i processi di inserimento di una fonte di dati inviando una ListIngestionJobs richiesta a un endpoint build-time di Agents for Amazon Bedrock. https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt Specifica il dataSourceId e il knowledgeBaseId della knowledge base in cui vengono importati i dati.

  • Filtra i risultati specificando lo stato da cercare nell’oggetto filters.

  • Ordina in base all’ora di avvio del processo o allo stato di un processo specificando l’oggetto sortBy. Puoi scegliere l’ordinamento crescente o decrescente.

  • Puoi impostare il numero massimo di risultati che dovranno essere restituiti nella risposta nel campo maxResults. Se i risultati sono superiori al numero impostato, la risposta restituisce un nextToken che puoi inviare in un'altra richiesta ListIngestionJobs per visualizzare il successivo batch di processi.

Imposta una pianificazione di sincronizzazione per una fonte di dati

Invece di avviare manualmente una sincronizzazione ogni volta che i contenuti cambiano, puoi impostare una pianificazione di sincronizzazione in modo che Amazon Bedrock sincronizzi automaticamente una fonte di dati con una frequenza ricorrente. Le sincronizzazioni pianificate aiutano a mantenere aggiornata la tua knowledge base senza azioni manuali. La pianificazione della sincronizzazione viene impostata quando si collega un'origine dati e può essere modificata in un secondo momento modificando l'origine dati.

Puoi scegliere una delle seguenti frequenze:

On-demand

Il contenuto viene sincronizzato solo quando si avvia una sincronizzazione manualmente. Non si verifica alcuna pianificazione automatica. Questa è la frequenza predefinita.

Giornaliero

I contenuti vengono sincronizzati una volta al giorno a un orario programmato automaticamente, che può variare.

Settimanale

I contenuti vengono sincronizzati una volta alla settimana, in un giorno della settimana specificato, a un'ora pianificata automaticamente.

Mensile

Il contenuto viene sincronizzato una volta al mese, in un giorno del mese specificato, a un'ora pianificata automaticamente. Scegli un giorno specifico compreso tra 1 e 28 oppure scegli la fine del mese.

Per impostare una pianificazione di sincronizzazione per un'origine dati, scegli la scheda corrispondente al tuo metodo preferito, quindi segui i passaggi:

Console

Quando colleghi un'origine dati o modifichi un'origine dati esistente, trova la sezione Pianificazione della sincronizzazione e scegli una frequenza:

  • Se scegli Settimanale, seleziona il giorno della settimana in cui viene eseguita la sincronizzazione.

  • Se scegli Mensile, seleziona un giorno specifico del mese (1—28) o seleziona la fine del mese.

Per ulteriori informazioni sulla connessione di un'origine dati, consulta Connettere un'origine dati.

API

Per impostare una pianificazione di sincronizzazione con l'API, un AWS SDK o il AWS CLI, includi un syncSchedule oggetto managedKnowledgeBaseConnectorConfiguration (all'internodataSourceConfiguration) quando invii una UpdateDataSource richiesta CreateDataSource o invii una richiesta con un endpoint di compilazione di Agents for Amazon Bedrock. Per utilizzare la sincronizzazione su richiesta, ometti. syncSchedule

InsyncSchedule, specifica esattamente uno dei seguenti campi di frequenza:

  • daily— Un oggetto vuoto ({}). Il contenuto viene sincronizzato una volta al giorno in un orario non di punta scelto dal sistema.

  • weekly— Un oggetto con un campo obbligatorio. dayOfWeek I valori validi sono SUNDAY, MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY e SATURDAY.

  • monthly— Un oggetto con un dayOfMonth campo obbligatorio. IndayOfMonth, specifica esattamente una delle seguenti opzioni:

    • dayNumber— Un giorno specifico del mese, da 1 a28.

    • lastDayOfMonth— Un oggetto vuoto ({}) che esegue la sincronizzazione l'ultimo giorno di calendario di ogni mese.

L'esempio seguente mostra un programma dataSourceConfiguration che pianifica una sincronizzazione settimanale il lunedì:

"dataSourceConfiguration": {
    "type": "MANAGED_KNOWLEDGE_BASE_CONNECTOR",
    "managedKnowledgeBaseConnectorConfiguration": {
        "connectorParameters": {
            "type": "CONNECTOR_TYPE",
            "version": "1"
        },
        "syncSchedule": {
            "weekly": {
                "dayOfWeek": "MONDAY"
            }
        }
    }
}

Per la sincronizzazione il 15 di ogni mese, sostituisci il syncSchedule valore con il seguente:

"syncSchedule": {
    "monthly": {
        "dayOfMonth": {
            "dayNumber": 15
        }
    }
}

Dopo aver impostato una pianificazione, Amazon Bedrock esegue la sincronizzazione automaticamente alla frequenza scelta. Puoi comunque avviare una sincronizzazione manuale in qualsiasi momento. Per tenere traccia dei processi di sincronizzazione pianificati e manuali, visualizza la cronologia della sincronizzazione nella pagina dei dettagli dell'origine dati. Per ulteriori informazioni, consulta Visualizzare le informazioni sulle fonti di dati per la tua knowledge base di Amazon Bedrock.