Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Résolution des problèmes
Cette section fournit des solutions aux problèmes courants liés à l'utilisation des modèles Amazon Nova.
## Authentification et configuration
Missing permissions (Autorisations manquantes)
**Symptômes :** Impossible d'accéder aux modèles ou aux fonctionnalités de Nova
**Solution :**
+ Assurez-vous que votre rôle IAM dispose AmazonBedrockFullAccess des autorisations appropriées
+ Demandez l'accès à un modèle spécifique via la console Amazon Bedrock
+ Vérifiez les autorisations d'accès aux modèles et d'utilisation des outils
## Accès au modèle refusé
**Symptômes :** échec de la demande d'accès au modèle
**Solution :**
+ Demandez l'accès à un modèle spécifique via la console Amazon Bedrock
+ Vérifiez que votre compte a été autorisé à accéder au modèle demandé
+ Vérifiez la disponibilité régionale du modèle
## Problèmes de disponibilité régionaux
**Symptômes :** fonctionnalité non disponible dans la région sélectionnée
**Solution :**
+ Web Grounding n'est disponible que dans les régions des États-Unis dotées de profils CRIS américains
+ Vérifiez que le modèle et les fonctionnalités sont disponibles dans la région sélectionnée
+ Passez à une région prise en charge si nécessaire
## Configuration du délai d’attente
**Symptômes : les** demandes expirent avant d'être terminées
**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
)
)
```
Les demandes d'inférence Amazon Nova peuvent prendre jusqu'à 60 minutes pour les opérations complexes.
## Problèmes de réponse de l'API
Comprendre les raisons de l'arrêt :
end\_turn
Achèvement normal. Aucune action nécessaire.
max\_tokens
Limite de jetons atteinte.
**Solution** : augmenter `maxTokens` le paramètre dans`inferenceConfig`.
contenu\_filtré
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.
modèle de sortie mal formé
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é.
mauvaise utilisation de l'outil
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\_indisponible
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\_invalide
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.
max\_tool\_invocations
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.
## Erreurs liées au mode raisonnement
Réponses tronquées nécessitant un effort de raisonnement élevé
**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.
Des jetons insuffisants pour raisonner
**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
```
## Problèmes liés à l'utilisation des outils
### Défaillances de validation du schéma
Erreurs de validation du schéma d'outil
**Solution :**
+ Limitez les schémas JSON à deux couches d'imbrication pour de meilleures performances
+ Assurez-vous que tous les champs obligatoires sont correctement définis
+ Valider le schéma par rapport aux spécifications du schéma JSON
Le modèle n'utilise pas correctement les outils
**Solution :**
+ Assurez-vous que le nom de l'outil décrit clairement son objectif
+ Fournir une description détaillée des fonctionnalités de l'outil
+ Définissez explicitement le schéma d'entrée avec des descriptions claires des paramètres
+ Incluez des exemples dans la description lorsque cela est utile
Comportement d'appel d'outils incohérent
**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.
Conflits de choix d'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 nom`nova_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èmes liés à la base du Web
Problèmes de contrôle d'accès
**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èmes liés à la politique de contrôle des services
**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.
### Limites du traitement multimédia
Mauvaise compréhension du contenu multilingue des images/vidéos
**Limite :** les modèles Nova ont une compréhension limitée du contenu multilingue dans les médias visuels
**Solution :**
+ Fournir des traductions de texte à côté d'images
+ Utilisez des entrées textuelles pour le contenu multilingue lorsque cela est possible
Identification des personnes
**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
Limites du raisonnement spatial
**Problème :** localisation ou analyse de mise en page inexacte
**Limite :** capacités limitées pour un raisonnement spatial précis
**Solution :**
+ Utiliser la détection des cadres de délimitation pour la localisation des objets
+ Indiquez des points de référence clairs dans vos instructions
+ Divisez les requêtes spatiales complexes en composants plus simples
Petit texte dans les images/vidéos
**Problème :** Impossible de lire le petit texte dans les médias
**Solution :**
+ Recadrez les images pour vous concentrer sur les sections de texte pertinentes
+ Augmenter la résolution du média source
+ Fournissez le texte séparément si disponible
### Gestion des documents et des fichiers
Contenu non pris en charge
**Problème :** échec du traitement PDF
**Les causes :**
+ PDFs avec profils de couleurs CMJN
+ PDFs contenant des images SVG
**Solution :**
+ Convertir PDFs en profil de couleur RGB
+ Rasterisez les images SVG avant de les inclure PDFs
Estimation du jeton
**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