# Solución de problemas
En esta sección, se proporcionan soluciones a problemas comunes al trabajar con modelos de Amazon Nova.
## Autenticación y configuración
Faltan permisos
**Síntomas:** no se puede acceder a los modelos o características de Nova
**Solución:**
+ Asegúrese de que el rol de IAM tenga AmazonBedrockFullAccess o los permisos adecuados.
+ Solicite acceso a modelos específicos a través de la consola de Amazon Bedrock.
+ Verifique los permisos de acceso al modelo y el uso de la herramienta.
## Acceso denegado al modelo
**Síntomas:** la solicitud de acceso al modelo falla
**Solución:**
+ Solicite acceso a modelos específicos a través de la consola de Amazon Bedrock.
+ Verifique que la cuenta disponga de acceso al modelo solicitado.
+ Compruebe la disponibilidad regional del modelo.
## Problemas de disponibilidad regional
**Síntomas:** la característica no está disponible en la región seleccionada
**Solución:**
+ El Anclaje web solo está disponible en las regiones de EE. UU. con perfiles CRIS estadounidenses.
+ Verifique que el modelo y las características estén disponibles en la región seleccionada.
+ Cambie a una región compatible si es necesario.
## Configuración de tiempo de espera
**Síntomas:** se agota el tiempo de espera de las solicitudes antes de finalizar
**Causa:** el tiempo de espera predeterminado es demasiado corto para operaciones complejas.
**Solución:** configure los ajustes de tiempo de espera extendido.
```
from botocore.config import Config
bedrock = boto3.client(
'bedrock-runtime',
region_name='us-east-1',
config=Config(
read_timeout=3600 # 60 minutes
)
)
```
Las solicitudes de inferencia de Amazon Nova pueden tardar hasta 60 minutos en operaciones complejas.
## Problemas de respuesta de API
Descripción de los motivos de detención:
end\_turn
Finalización normal. No es necesario ninguna acción.
max\_tokens
Límite de tokens alcanzado.
**Solución**: aumente el parámetro`maxTokens` en `inferenceConfig`.
content\_filtered
El contenido infringía la política de IA responsable de AWS.
Solución: revise y modifique la entrada para cumplir con las políticas de contenido.
malformed\_model\_output
Formato de salida no válido.
Solución: compruebe el esquema de salida y las restricciones y verifique que el esquema JSON tenga el formato correcto.
malformed\_tool\_use
Formato de llamada a la herramienta no válido.
Solución: verifique que las definiciones de las herramientas coincidan con el esquema esperado y compruebe que los parámetros de entrada de la herramienta tengan el formato correcto.
service\_unavailable
El servicio de herramientas integradas no está disponible.
Solución: vuelva a intentar la solicitud después de esperar unos segundos y consulte el panel de estado del servicio de AWS.
invalid\_query
Consulta no válida a la herramienta integrada.
Solución: revise el formato y los parámetros de la consulta y asegúrese de que la consulta cumpla con los requisitos de la herramienta.
max\_tool\_invocations
Reintentos de la herramienta agotados.
Solución: simplifique la tarea o divídala en pasos más pequeños y revise los mensajes de error de la herramienta para detectar problemas específicos.
## Errores del modo de razonamiento
Respuestas truncadas con un esfuerzo de razonamiento alto
**Solución:** para un esfuerzo de razonamiento alto, desactive estos parámetros: `temperature`, `topP`, `maxToken`. Esto permite que el modelo utilice la configuración óptima para tareas de razonamiento complejas.
Tokens insuficientes para el razonamiento
**Error:** “maxTokens es insuficiente”
**Solución:** vuelva a intentarlo automáticamente con un límite aumentado.
```
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
```
## Problemas del uso de herramientas
### Errores de validación del esquema
Errores de validación de esquemas de herramientas
**Solución:**
+ Limite los esquemas JSON a dos capas de anidación para obtener el mejor rendimiento.
+ Asegúrese de que todos los campos obligatorios estén definidos correctamente.
+ Valide el esquema según la especificación del esquema JSON.
El modelo no utiliza las herramientas correctamente
**Solución:**
+ Asegúrese de que el nombre de la herramienta describa claramente su propósito.
+ Proporcione una descripción detallada de la funcionalidad de la herramienta.
+ Defina explícitamente el esquema de entrada con descripciones claras de los parámetros.
+ Incluya ejemplos en la descripción cuando sea útil.
Comportamiento de llamadas a herramientas incoherente
**Solución:** establezca la temperatura en 0 para llamar a la herramienta.
```
inferenceConfig={
"temperature": 0,
"maxTokens": 10000
}
```
Esto permite una decodificación codiciosa para un uso más fiable de la herramienta.
Conflictos de elección de herramientas
**Problema:** error al utilizar herramientas personalizadas con la búsqueda web o Code Interpreter
**Solución:** no incluya toolSpec personalizados con el nombre `nova_grounding`, ya que entra en conflicto con la herramienta del sistema. En su lugar, utilice la configuración de la herramienta del 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", ...}
# }]
# }
```
### Problemas del Anclaje web
Problemas de control de acceso
**Problema:** el Anclaje web y Code Interpreter no funcionan
**Solución:** asegúrese de que su política de IAM incluya lo siguiente.
```
{
"Statement": [
{
"Effect": "Allow",
"Action": ["bedrock:InvokeTool"],
"Resource": ["arn:aws:bedrock::{YOUR_ACCOUNT_ID}:system-tool/amazon.nova_grounding"]
}
]
}
```
Problemas de la política de control de servicios
**Problema:** la SCP ha bloqueado el Anclaje web
**Solución:** si tiene políticas de control de servicios con la condición `aws:requestedRegion`, actualícelas para permitir una región “no especificada” para la funcionalidad del Anclaje web.
### Limitaciones de procesamiento de contenido multimedia
Comprensión deficiente del contenido multilingüe en imágenes o videos
**Limitación:** los modelos de Nova tienen una comprensión limitada del contenido multilingüe en contenido multimedia visual.
**Solución:**
+ Proporcione traducciones de texto junto con las imágenes.
+ Utilice entradas basadas en texto para el contenido multilingüe siempre que sea posible.
Identificación de personas
**Problema:** el modelo rechaza la identificación de personas en imágenes
**Comportamiento esperado:** los modelos rechazarán la identificación o el nombramiento de personas en imágenes, documentos o videos por razones de privacidad y seguridad.
**Solución alternativa:** pregunte por las características generales o el contexto en lugar de por identidades específicas.
Limitaciones de razonamiento espacial
**Problema:** análisis de ubicación o diseño imprecisos
**Limitación:** capacidades limitadas para un razonamiento espacial preciso
**Solución:**
+ Utilice la detección de cuadros delimitadores para la localización de objetos.
+ Proporcione puntos de referencia claros en las peticiones.
+ Divida las consultas espaciales complejas en componentes más sencillos.
Texto pequeño en imágenes o videos
**Problema:** no se puede leer texto pequeño en contenido multimedia
**Solución:**
+ Recorte las imágenes para centrarlas en las secciones de texto relevantes.
+ Aumente la resolución del contenido multimedia de origen.
+ Proporcione el texto por separado si está disponible.
### Gestión de documentos y archivos
Contenido no admitido
**Problema:** el procesamiento de PDF falla
**Causas:**
+ PDF con perfiles de color CMYK
+ PDF que contienen imágenes SVG
**Solución:**
+ Convierta PDF a perfiles de color RGB.
+ Rasterice imágenes SVG antes de incluirlas en archivos PDF.
Estimación de tokens
**Problema:** uso inesperado de tokens con PDF
**Directriz:** calcule aproximadamente 2560 tokens por página de PDF estándar de 8,5 × 11 pulgadas
**Solución:** ajuste `maxTokens` en consecuencia en función de la longitud del documento.