Résolution des problèmes

Symptômes : Impossible d'accéder aux modèles ou aux fonctionnalités de Nova

Solution :

Solution :

Solution :

Cause : délai d'expiration par défaut trop court pour les opérations complexes

Solution : configurer les paramètres de délai d'expiration prolongé

from botocore.config import Config

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

Achèvement normal. Aucune action nécessaire.

Limite de jetons atteinte.

Solution : augmenter maxTokens le paramètre dansinferenceConfig.

Le contenu enfreignait AWS la politique en matière d'IA responsable.

Solution : passez en revue et modifiez vos entrées conformément aux politiques relatives au contenu.

Format de sortie non valide.

Solution : vérifiez votre schéma de sortie et vos contraintes ; vérifiez que le schéma JSON est correctement formaté.

Format d'appel d'outil non valide.

Solution : vérifiez que les définitions d'outils correspondent au schéma attendu ; vérifiez que les paramètres d'entrée de l'outil sont correctement formatés.

Service d'outils intégré non disponible.

Solution : réessayez la demande après un bref délai ; consultez le tableau de bord AWS de santé du service.

Requête non valide vers l'outil intégré.

Solution : Vérifiez le format et les paramètres de la requête ; assurez-vous que la requête répond aux exigences de l'outil.

Les nouvelles tentatives de l'outil ont échoué.

Solution : simplifiez la tâche ou divisez-la en étapes plus petites ; consultez les messages d'erreur de l'outil pour détecter des problèmes spécifiques.

Solution : Pour un effort de raisonnement élevé, désactivez les paramètres suivants :temperature,topP,maxToken. Cela permet au modèle d'utiliser des paramètres optimaux pour les tâches de raisonnement complexes.

Erreur : « MaxTokens est insuffisant »

Solution : réessayer automatiquement avec une limite accrue

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

Solution :

Solution :

Solution : réglez la température sur 0 pour l'appel de l'outil :

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

Cela permet un décodage gourmand pour une utilisation plus fiable des outils.

Problème : erreur lors de l'utilisation d'outils personnalisés avec une recherche sur le Web ou un interpréteur de code

Solution : n'incluez pas de ToolSpec personnalisé avec un nomnova_grounding, cela entre en conflit avec l'outil système. Utilisez plutôt la configuration de l'outil système :

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

Problème : Web Grounding et l'interpréteur de code ne fonctionnent pas

Solution : assurez-vous que votre politique IAM inclut :

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

Problème : le Web Grounding est bloqué par le SCP

Solution : si vous avez des politiques de contrôle des services assorties de aws:requestedRegion conditions, mettez-les à jour pour autoriser une région « non spécifiée » à accéder à la fonctionnalité Web Grounding.

Limite : les modèles Nova ont une compréhension limitée du contenu multilingue dans les médias visuels

Solution :

Problème : le mannequin refuse d'identifier les personnes sur les images

Comportement attendu : les modèles refuseront d'identifier ou de nommer des personnes sur des images, des documents ou des vidéos pour des raisons de confidentialité et de sécurité

Solution : posez des questions sur les caractéristiques générales ou le contexte plutôt que sur des identités spécifiques

Problème : localisation ou analyse de mise en page inexacte

Limite : capacités limitées pour un raisonnement spatial précis

Solution :

Problème : Impossible de lire le petit texte dans les médias

Solution :

Problème : échec du traitement PDF

Les causes :

Solution :

Problème : utilisation inattendue de jetons avec PDFs

Ligne directrice : Estimez environ 2 560 jetons par page PDF standard de 8,5 x 11 pouces

Solution : ajustez maxTokens en conséquence en fonction de la longueur du document