View a markdown version of this page

Risoluzione dei problemi - Amazon Nova
Autenticazione e configurazioneAccesso al modello negatoProblemi di disponibilità a livello regionaleConfigurazione del timeoutProblemi di risposta delle APIErrori in modalità ragionamentoProblemi di utilizzo degli strumenti

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
    )
)
Nota

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

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 nomenova_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