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
Questa sezione fornisce soluzioni ai problemi più comuni relativi all'utilizzo dei modelli Amazon Nova.
## Autenticazione e configurazione
Autorizzazioni mancanti
**Sintomi:** impossibile accedere ai modelli o alle funzionalità di Nova
**Soluzione:**:
+ Assicurati che il tuo ruolo IAM AmazonBedrockFullAccess disponga delle autorizzazioni appropriate
+ Richiedi l'accesso a un modello specifico tramite la console Amazon Bedrock
+ Verifica le autorizzazioni per l'accesso al modello e l'utilizzo degli strumenti
## Accesso al modello negato
**Sintomi:** la richiesta di accesso al modello non riesce
**Soluzione:**:
+ Richiedi l'accesso a un modello specifico tramite la console Amazon Bedrock
+ Verifica che al tuo account sia stato concesso l'accesso al modello richiesto
+ Verifica la disponibilità regionale del modello
## Problemi di disponibilità a livello regionale
**Sintomi:** funzionalità non disponibile nella regione selezionata
**Soluzione:**:
+ Web Grounding è disponibile solo nelle regioni degli Stati Uniti con profili CRIS statunitensi
+ Verifica che il modello e le funzionalità siano disponibili nella regione selezionata
+ Passa a una regione supportata, se necessario
## Configurazione del timeout
**Sintomi:** scadono le richieste prima del completamento
**Causa:** il timeout predefinito è troppo breve per operazioni complesse
**Soluzione:** configurare le impostazioni di timeout esteso
```
from botocore.config import Config
bedrock = boto3.client(
'bedrock-runtime',
region_name='us-east-1',
config=Config(
read_timeout=3600 # 60 minutes
)
)
```
Le richieste di inferenza di Amazon Nova possono richiedere fino a 60 minuti per operazioni complesse.
## Problemi di risposta delle API
Comprensione dei motivi dell'interruzione:
end\_turn
Completamento normale. Non è richiesta alcuna operazione.
max\_tokens
Limite di token raggiunto.
**Soluzione**: aumentare `maxTokens` il parametro in`inferenceConfig`.
content\_filtered
Il contenuto ha violato AWS la politica sull'IA responsabile.
Soluzione: rivedi e modifica i tuoi input per conformarti alle politiche sui contenuti.
malformed\_model\_output
Formato di output non valido.
Soluzione: controlla lo schema di output e i vincoli; verifica che lo schema JSON sia formattato correttamente.
malformed\_tool\_use
Formato di chiamata dell'utensile non valido.
Soluzione: verificate che le definizioni degli utensili corrispondano allo schema previsto; verificate che i parametri di input dell'utensile siano formattati correttamente.
servizio\_non disponibile
Servizio utensili integrato non disponibile.
Soluzione: riprova la richiesta dopo un breve ritardo; controlla la dashboard dello stato AWS del servizio.
invalid\_query
Interrogazione non valida sullo strumento integrato.
Soluzione: rivedete il formato e i parametri della query; assicuratevi che la query soddisfi i requisiti dello strumento.
max\_tool\_invocations
Tentativi dello strumento esauriti.
Soluzione: semplificate l'operazione o suddividetela in fasi più piccole; esaminate i messaggi di errore dello strumento per problemi specifici.
## Errori in modalità ragionamento
Risposte troncate con un elevato sforzo di ragionamento
**Soluzione:** per un maggiore sforzo di ragionamento, deimposta questi parametri:,,. `temperature` `topP` `maxToken` Ciò consente al modello di utilizzare impostazioni ottimali per attività di ragionamento complesse.
Token insufficienti per il ragionamento
**Errore:** «MaxTokens è insufficiente»
**Soluzione:** riprova automaticamente con un limite maggiore
```
token_limits = {
"low": 15000,
"medium": 30000,
"high": 50000
}
try:
response = client.converse(
modelId="us.amazon.nova-2-lite-v1:0",
messages=messages,
inferenceConfig={
"maxTokens": token_limits[max_effort]
},
additionalModelRequestFields={
"reasoningConfig": {
"type": "enabled",
"maxReasoningEffort": max_effort
}
}
)
except Exception as e:
if "maxTokens is insufficient" in str(e):
higher_limit = int(token_limits[max_effort] * 1.5)
# Retry with higher limit
```
## Problemi di utilizzo degli strumenti
### Errori di convalida dello schema
Errori di convalida dello schema degli strumenti
**Soluzione:**:
+ Limita gli schemi JSON a due livelli di nidificazione per ottenere prestazioni ottimali
+ Assicurati che tutti i campi obbligatori siano definiti correttamente
+ Convalida lo schema rispetto alle specifiche dello schema JSON
Il modello non utilizza correttamente gli strumenti
**Soluzione:**:
+ Assicurati che il nome dello strumento ne descriva chiaramente lo scopo
+ Fornire una descrizione dettagliata della funzionalità dello strumento
+ Definisci in modo esplicito lo schema di input con descrizioni chiare dei parametri
+ Includi esempi nella descrizione quando utile
Comportamento incoerente di chiamata degli strumenti
**Soluzione:** impostate la temperatura su 0 per la chiamata dello strumento:
```
inferenceConfig={
"temperature": 0,
"maxTokens": 10000
}
```
Ciò consente una decodifica avida per un uso più affidabile degli strumenti.
Conflitti nella scelta degli strumenti
**Problema:** errore durante l'utilizzo di strumenti personalizzati con ricerca Web o interprete di codice
**Soluzione:** non includete un ToolSpec personalizzato con nome`nova_grounding`: ciò è in conflitto con lo strumento di sistema. Utilizzate invece la configurazione degli strumenti di sistema:
```
# Correct - use system tool
tool_config = {
"tools": [{
"systemTool": {"name": "nova_grounding"}
}]
}
# Incorrect - don't create custom tool with this name
# tool_config = {
# "tools": [{
# "toolSpec": {"name": "nova_grounding", ...}
# }]
# }
```
### Problemi relativi al Web Grounding
Problemi di controllo degli accessi
**Problema:** Web Grounding and Code Interpreter non funzionano
**Soluzione:** assicurati che la tua policy IAM includa:
```
{
"Statement": [
{
"Effect": "Allow",
"Action": ["bedrock:InvokeTool"],
"Resource": ["arn:aws:bedrock::{YOUR_ACCOUNT_ID}:system-tool/amazon.nova_grounding"]
}
]
}
```
Problemi relativi alla politica di controllo dei servizi
**Problema:** Web Grounding bloccato da SCP
**Soluzione:** se disponete di politiche di controllo dei servizi con `aws:requestedRegion` condizioni, aggiornatele per consentire la funzionalità Web Grounding nella regione «non specificata».
### Limitazioni dell'elaborazione dei file multimediali
Scarsa comprensione dei contenuti multilingue nelle immagini/video
**Limitazione:** i modelli Nova hanno una comprensione limitata dei contenuti multilingue nei media visivi
**Soluzione alternativa:**
+ Fornisci traduzioni di testo insieme alle immagini
+ Se possibile, utilizza input basati su testo per contenuti multilingue
Identificazione delle persone
**Problema:** la modella si rifiuta di identificare le persone nelle immagini
**Comportamento previsto:** le modelle si rifiuteranno di identificare o nominare le persone nelle immagini, nei documenti o nei video per motivi di privacy e sicurezza
**Soluzione alternativa:** chiedi informazioni sulle caratteristiche generali o sul contesto anziché sulle identità specifiche
Limitazioni del ragionamento spaziale
**Problema:** localizzazione o analisi del layout imprecise
**Limitazione:** capacità limitate per un ragionamento spaziale preciso
**Soluzione alternativa:**
+ Utilizza il rilevamento dei bounding box per la localizzazione degli oggetti
+ Fornisci punti di riferimento chiari nelle tue istruzioni
+ Suddividi le interrogazioni spaziali complesse in componenti più semplici
Testo di piccole dimensioni in immagini/video
**Problema:** non è possibile leggere testo di piccole dimensioni nei file multimediali
**Soluzione:**:
+ Ritaglia le immagini per concentrarti sulle sezioni di testo pertinenti
+ Aumenta la risoluzione dei file multimediali di origine
+ Fornisci il testo separatamente, se disponibile
### Gestione di documenti e file
Contenuti non supportati
**Problema:** l'elaborazione del PDF non riesce
**Cause:**
+ PDFs con profili di colore CMYK
+ PDFs contenente immagini SVG
**Soluzione:**:
+ Converti in PDFs profilo di colore RGB
+ Rasterizza le immagini SVG prima di includerle PDFs
Stima dei token
**Problema:** utilizzo imprevisto del token con PDFs
**Linea guida:** stima circa 2.560 token per pagina PDF standard da 8,5 × 11"
**Soluzione**: regolate di conseguenza in base alla lunghezza del documento `maxTokens`