

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

# Risoluzione dei problemi relativi alle basi di conoscenza multimodali
<a name="kb-multimodal-troubleshooting"></a>

Questa sezione fornisce una guida per risolvere i problemi più comuni riscontrati quando si lavora con basi di conoscenza multimodali. Le informazioni sulla risoluzione dei problemi sono organizzate in base a limitazioni generali, scenari di errore comuni con le relative cause e soluzioni e consigli per l'ottimizzazione delle prestazioni. Utilizzate queste informazioni per diagnosticare e risolvere i problemi durante la configurazione, l'inserimento o l'interrogazione dei vostri contenuti multimodali.

## Limitazioni generali
<a name="kb-multimodal-general-limitations"></a>

Tieni presente queste limitazioni attuali quando lavori con basi di conoscenza multimodali:
+ **Limiti di dimensione dei file: ** massimo 1,5 GB per file video, 1 GB per file audio (Nova Multimodal Embeddings) o 1,5 GB per file (BDA)
+ **File per processo di inserimento: ** massimo 15.000 file per processo (Nova Multimodal Embeddings) o 1.000 file per processo (BDA)
+ **Limiti di interrogazione: massimo un'immagine per query **
+ **Restrizioni relative alle fonti di dati: ** solo Amazon S3 e le fonti di dati personalizzate supportano contenuti multimodali
+ **Limitazioni alla suddivisione in blocchi BDA: ** quando si utilizza Bedrock Data Automation con suddivisione in blocchi di dimensioni fisse, le impostazioni della percentuale di sovrapposizione non vengono applicate ai contenuti audio e video
+ **Limiti di processi BDA simultanei: limite predefinito di 20 lavori BDA simultanei. ** Per l'elaborazione su larga scala, valuta la possibilità di richiedere un aumento della quota di servizio
+ **Limitazioni del modello Reranker: i modelli ** Reranker non sono supportati per i contenuti multimodali
+ **Limitazioni di riepilogo: il riepilogo delle risposte di recupero contenenti contenuti non testuali non è ** supportato
+ **Limitazioni all'immissione delle query: ** l'input contenente testo e immagine non è attualmente supportato. È possibile utilizzare interrogazioni di testo o immagini, ma non entrambe contemporaneamente.
+ **Filtri per il contenuto delle immagini Guardrail: ** quando si utilizzano interrogazioni di immagini con un guardrail in cui sono configurati i filtri per il contenuto delle immagini, l'immagine in ingresso viene valutata rispetto al guardrail. L'immagine potrebbe essere bloccata se viola le soglie di filtro configurate.
+ **Mancata corrispondenza tra input e tipo: ** per impostazione predefinita, si presume che l'input sia testo quando il tipo non è specificato. Quando si utilizzano modalità diverse dal testo, è necessario specificare il tipo corretto

## Errori e soluzioni comuni
<a name="kb-multimodal-common-errors"></a>

Se riscontri problemi con la tua knowledge base multimodale, esamina questi scenari comuni:

**Errore 4xx durante l'utilizzo di interrogazioni di immagini **  
**Causa: ** tentativo di utilizzare interrogazioni di immagini con modelli di incorporamento di solo testo o basi di conoscenza. BDA-processed   
**Soluzione: ** scegli Amazon Nova Multimodal Embeddings per creare la tua knowledge base per il supporto delle query di immagini.

**RAG restituisce un errore 4xx con contenuti multimodali **  
**Causa: ** utilizzo `RetrieveAndGenerate` con una knowledge base contenente solo contenuti multimodali e il modello Amazon Nova Multimodal Embeddings.  
**Soluzione: ** utilizza il parser BDA per la funzionalità RAG o assicurati che la tua knowledge base contenga contenuti testuali.

**Errore richiesto nella destinazione di archiviazione multimodale **  
**Causa: ** utilizzo di Nova Multimodal Embeddings senza configurare una destinazione di archiviazione multimodale.  
**Soluzione: ** specificare una destinazione di archiviazione multimodale quando si utilizza Nova Multimodal Embeddings.

**L'origine dati e lo storage multimodale utilizzano lo stesso bucket S3 **  
**Causa: ** configurazione dell'origine dati e della destinazione di archiviazione multimodale per utilizzare lo stesso bucket Amazon S3 senza prefissi di inclusione appropriati.  
**Soluzione: ** utilizza bucket separati per l'origine dei dati e lo storage multimodale o configura i prefissi di inclusione per evitare di reinserire i file multimediali estratti.

**Il prefisso di inclusione non può iniziare con «aws/» **  
**Causa: ** utilizzo di un prefisso di inclusione che inizia con «aws/» quando l'origine dati e la destinazione di archiviazione multimodale condividono lo stesso bucket Amazon S3.  
**Soluzione: specificare un prefisso di inclusione diverso. ** Il percorso «aws/» è riservato all'archiviazione multimediale estratta e non può essere utilizzato come prefisso di inclusione per evitare di reinserire il contenuto elaborato.

**L'ingestione di BDA salta i contenuti multimodali **  
**Causa: la ** Knowledge base è stata creata senza una destinazione di archiviazione multimodale, quindi l'origine dati BDA è stata aggiunta con contenuto multimodale.  
**Soluzione: ** Re-create la knowledge base con una destinazione di archiviazione multimodale configurata per consentire l'elaborazione BDA di file audio, video e di immagine.

**Base di conoscenza creata senza un modello di incorporamento multimodale **  
**Causa: la ** Knowledge base è stata creata con un modello di incorporamento di solo testo, che limita le funzionalità multimodali.  
**Soluzione: ** create una nuova knowledge base con Nova Multimodal Embeddings per abilitare l'elaborazione multimodale nativa e le interrogazioni basate su immagini.

## Gestione dei dati transitori con le policy relative al ciclo di vita di Amazon S3
<a name="kb-multimodal-lifecycle-policy"></a>

Quando si utilizza Nova Multimodal Embeddings, Amazon Bedrock archivia i dati transitori nella destinazione di storage multimodale e tenta di eliminarli una volta completata l'elaborazione. Consigliamo di applicare una politica del ciclo di vita sul percorso dei dati transitori per garantire che sia scaduto correttamente.

------
#### [ Console ]

**Per creare una regola del ciclo di vita utilizzando la console**

1. Apri la [console Amazon S3](https://console.aws.amazon.com/s3).

1. Passa alla destinazione di archiviazione multimodale che hai configurato per la tua Knowledge Base.

1. Scegli la ** scheda ** Gestione e seleziona ** Crea regola del ciclo di vita. **

1. Per il nome ** della regola del ciclo di vita, inserisci. ** **Transient Data Deletion**

1. In Tipo di ** filtro**, scegli ** Limita l'ambito di questa regola utilizzando uno o più filtri. **

1. Per ** Prefix**, inserisci il percorso dei dati temporanei per la tua knowledge base e fonte di dati.

   Sostituisci i valori segnaposto nel seguente prefisso con i tuoi identificatori effettivi:

   ```
   aws/bedrock/knowledge_bases/{{knowledge-base-id}}/{{data-source-id}}/transient_data
   ```
**Importante**  
Non applicate politiche relative al ciclo di vita all'intero bucket o al prefisso «aws/», poiché ciò eliminerebbe i contenuti multimodali e causerebbe errori di recupero. Utilizza solo il percorso specifico dei dati transitori mostrato sopra.

1. In Azioni relative alle regole ** del ciclo di vita**, seleziona ** Scadere le versioni correnti degli oggetti. **

1. Per ** Giorni dopo la creazione ** dell'oggetto, inserisci. **1**

1. Scegli **Crea regola**.

------
#### [ AWS CLI ]

**Per creare una regola del ciclo di vita utilizzando AWS CLI**

1. Crea un file JSON denominato `lifecycle-policy.json` con il seguente contenuto.

   Sostituisci i valori segnaposto con i tuoi identificatori effettivi:
   + {{knowledge-base-id}}- L'identificatore della tua knowledge base
   + {{data-source-id}}- L'identificatore della tua fonte di dati

   ```
   {
       "Rules": [
           {
               "ID": "TransientDataDeletion",
               "Status": "Enabled",
               "Filter": {
                   "Prefix": "aws/bedrock/knowledge_bases/{{knowledge-base-id}}/{{data-source-id}}/transient_data"
               },
               "Expiration": {
                   "Days": 1
               }
           }
       ]
   }
   ```

1. Applica la politica del ciclo di vita al tuo bucket. Sostituisci {{your-multimodal-storage-bucket}} con il nome effettivo del bucket:

   ```
   aws s3api put-bucket-lifecycle-configuration \
       --bucket {{your-multimodal-storage-bucket}} \
       --lifecycle-configuration file://lifecycle-policy.json
   ```

1. Verifica che la politica del ciclo di vita sia stata applicata:

   ```
   aws s3api get-bucket-lifecycle-configuration \
       --bucket {{your-multimodal-storage-bucket}}
   ```

------

Per ulteriori informazioni sulle politiche relative al ciclo di vita di Amazon S3, consulta [ Managing the lifecycle of objects ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html) nella Amazon S3 User Guide. * *

## Considerazioni sulle prestazioni
<a name="kb-multimodal-performance-considerations"></a>

Per prestazioni ottimali con la tua knowledge base multimodale, considera questi fattori:
+ **Tempo di elaborazione: l'elaborazione ** BDA richiede più tempo a causa della conversione dei contenuti
+ **Latenza delle query: le query con ** immagini possono avere una latenza maggiore rispetto alle query di testo
+ **Durata della suddivisione in blocchi: una ** maggiore durata dei blocchi aumenta il tempo di audio/video elaborazione ma può migliorare la precisione