View a markdown version of this page

Solución de problemas - Amazon Nova
Autenticación y configuraciónAcceso denegado al modeloProblemas de disponibilidad regionalConfiguración de tiempo de esperaProblemas de respuesta de APIErrores del modo de razonamientoProblemas del uso de herramientas

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

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ámetromaxTokens 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.