Fehlerbehebung

Symptome: Zugriff auf Nova-Modelle oder -Funktionen nicht möglich

Lösung:

Lösung:

Lösung:

Ursache: Das Standard-Timeout ist für komplexe Operationen zu kurz

Lösung: Konfigurieren Sie erweiterte Timeout-Einstellungen

from botocore.config import Config

bedrock = boto3.client(
    'bedrock-runtime',
    region_name='us-east-1',
    config=Config(
        read_timeout=3600      # 60 minutes
    )
)

Normaler Abschluss. Keine Aktion erforderlich.

Token-Limit erreicht.

Lösung: Erhöhen Sie maxTokens den Parameter ininferenceConfig.

Der Inhalt verstößt gegen die Richtlinie AWS für verantwortungsvolle KI.

Lösung: Überprüfen und ändern Sie Ihre Eingaben, um sie an die Inhaltsrichtlinien zu halten.

Ungültiges Ausgabeformat.

Lösung: Überprüfen Sie Ihr Ausgabeschema und Ihre Einschränkungen; stellen Sie sicher, dass das JSON-Schema richtig formatiert ist.

Ungültiges Format für den Werkzeugaufruf.

Lösung: Stellen Sie sicher, dass die Werkzeugdefinitionen dem erwarteten Schema entsprechen. Überprüfen Sie, ob die Werkzeugeingabeparameter korrekt formatiert sind.

Der integrierte Tool-Service ist nicht verfügbar.

Lösung: Versuchen Sie die Anfrage nach einer kurzen Verzögerung erneut. Überprüfen Sie das AWS Service-Status-Dashboard.

Ungültige Abfrage für das integrierte Tool.

Lösung: Überprüfen Sie das Abfrageformat und die Parameter und stellen Sie sicher, dass die Abfrage die Werkzeuganforderungen erfüllt.

Die Wiederholungsversuche des Tools sind erschöpft.

Lösung: Vereinfachen Sie die Aufgabe oder teilen Sie sie in kleinere Schritte auf; überprüfen Sie die Fehlermeldungen des Tools auf bestimmte Probleme.

Lösung: Wenn Sie einen hohen Argumentationsaufwand benötigen, deaktivieren Sie die folgenden Parameter:,,. temperature topP maxToken Dadurch kann das Modell optimale Einstellungen für komplexe Denkaufgaben verwenden.

Fehler: „MaxTokens ist unzureichend“

Lösung: Automatisch mit erhöhtem Limit wiederholen

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

Lösung:

Lösung:

Lösung: Stellen Sie die Temperatur für den Werkzeugaufruf auf 0 ein:

inferenceConfig={
    "temperature": 0,
    "maxTokens": 10000
}

Dies ermöglicht eine Greed-Dekodierung für eine zuverlässigere Verwendung von Tools.

Problem: Fehler bei der Verwendung von benutzerdefinierten Tools mit Websuche oder Codeinterpreter

Lösung: Fügen Sie keine benutzerdefinierte ToolSpec mit Namen hinzu nova_grounding — dies steht in Konflikt mit dem Systemtool. Verwenden Sie stattdessen die Systemtool-Konfiguration:

# 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", ...}
#     }]
# }

Problem: Web Grounding und Code Interpreter funktionieren nicht

Lösung: Stellen Sie sicher, dass Ihre IAM-Richtlinie Folgendes umfasst:

{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": ["bedrock:InvokeTool"],
      "Resource": ["arn:aws:bedrock::{YOUR_ACCOUNT_ID}:system-tool/amazon.nova_grounding"]
    }
  ]
}

Problem: Web Grounding wurde von SCP blockiert

Lösung: Wenn Sie über Service Control-Richtlinien verfügen, die eine aws:requestedRegion Bedingung erfüllen, aktualisieren Sie diese, sodass die Web Grounding-Funktionalität in der Region „nicht spezifiziert“ verfügbar ist.

Einschränkung: Nova-Modelle haben nur ein begrenztes Verständnis für mehrsprachige Inhalte in visuellen Medien

Workaround:

Problem: Das Modell weigert sich, Personen auf Bildern zu identifizieren

Erwartetes Verhalten: Models werden sich aus Datenschutz- und Sicherheitsgründen weigern, Personen in Bildern, Dokumenten oder Videos zu identifizieren oder zu benennen

Problemumgehung: Fragen Sie nach allgemeinen Merkmalen oder dem Kontext statt nach spezifischen Identitäten

Problem: Ungenaue Lokalisierungs- oder Layoutanalyse

Einschränkung: Eingeschränkte Fähigkeiten für präzises räumliches Denken

Workaround:

Problem: Kleiner Text in Medien kann nicht gelesen werden

Lösung:

Problem: Die PDF-Verarbeitung schlägt fehl

Ursachen:

Lösung:

Problem: Unerwartete Token-Nutzung mit PDFs

Richtlinie: Schätzungsweise etwa 2.560 Token pro Standard-PDF-Seite mit einer Größe von 8,5 × 11 Zoll

Lösung: Passen maxTokens Sie das Dokument entsprechend an die Länge des Dokuments an