# Introducción a Amazon Nova **nota** Esta documentación corresponde a la versión 1 de Amazon Nova. Amazon Nova 2 ya está disponible con nuevos modelos y funciones mejoradas. Para obtener información sobre cómo comenzar con Amazon Nova 2, consulte [Getting started with Amazon Nova 2](https://docs.aws.amazon.com/nova/latest/nova2-userguide/getting-started-nova-2.html). Los modelos de Amazon Nova se pueden invocar a través de una API mediante las operaciones de la API [InvokeModel](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModel.html) o [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) de Amazon Bedrock, o se pueden utilizar mediante las [áreas de juegos de chat y texto de Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/playgrounds.html). **importante** Si es la primera vez que utiliza AWS o Amazon Bedrock, primero debe configurar Amazon Bedrock siguiendo los pasos que se indican en [Introducción a Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/getting-started.html). Como alternativa, puede probar los modelos de Amazon Nova sin entrar en Amazon Bedrock en [https://nova.amazon.com](https://nova.amazon.com/chat). Seleccione un tema para empezar a usar Amazon Nova con ese método. **Topics** + [ # Introducción a Amazon Nova en la consola de Amazon Bedrock ](getting-started-console.md) + [ # Introducción a la API ](getting-started-api.md) # Introducción a Amazon Nova en la consola de Amazon Bedrock **nota** Esta documentación corresponde a la versión 1 de Amazon Nova. Amazon Nova 2 ya está disponible con nuevos modelos y funciones mejoradas. Para obtener información sobre cómo empezar a usar Amazon Nova 2, consulte [Getting started with Amazon Nova 2 in the Amazon Bedrock console](https://docs.aws.amazon.com/nova/latest/nova2-userguide/getting-started-console.html). En esta sección, se describe cómo utilizar las áreas de juegos de la consola de AWS para enviar una petición de texto a los modelos de Amazon Nova y generar una respuesta de texto o imagen. Antes de ejecutar los siguientes ejemplos, debe comprobar que cumple los requisitos previos que se indican a continuación: **Requisitos previos** + Tiene una Cuenta de AWS y permisos para acceder a un rol de esta cuenta con los permisos necesarios para Amazon Bedrock. De lo contrario, siga los pasos en [Introducción a Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/getting-started.html). + Ha solicitado acceso a los modelos de Amazon Nova. De lo contrario, siga los pasos que se indican en [Solicitud de acceso a un modelo fundacional de Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/getting-started.html#getting-started-model-access) y solicite acceso a **Amazon Nova Lite** y **Amazon Nova Canvas**. + Está en la región Este de EE. UU. (Norte de Virginia) (us-east-1). Para cambiar de región, elija el nombre de la región en la parte superior derecha de la consola, junto a su rol de IAM. A continuación, seleccione Este de EE. UU. (Norte de Virginia) (us-east-1). **Topics** + [ ## Solicitud de acceso a modelos ](#getting-started-access) + [ ## Exploración del área de juegos de texto ](#getting-started-text) + [ ## Exploración del área de juegos de imágenes ](#getting-started-image) ## Solicitud de acceso a modelos Complete los siguientes pasos para solicitar acceso a los modelos de Amazon Nova. 1. Abra la consola de Amazon Bedrock en [https://console.aws.amazon.com/bedrock/](https://console.aws.amazon.com/bedrock/). 1. Desde el panel de navegación de la izquierda, en **Configuraciones de Bedrock**, elija **Acceso a modelos**. 1. En **¿Qué es el acceso a modelos?**, elija **Activar modelos específicos**. 1. Elija **Nova Lite** y **Nova Canvas** de la lista de **Modelos base**. En los ejemplos de esta sección, se utilizan solo estos dos modelos, pero puede solicitar acceso a todos los modelos de Amazon Nova. A continuación, elija **Siguiente**. 1. En la página **Revisar y enviar**, elija **Enviar**. 1. Actualice la tabla **Modelos base**. Si ve los modelos de Amazon Nova con el estado **Acceso concedido**, está listo para continuar con las siguientes partes del ejemplo. Tenga en cuenta que la región desde la que solicita el acceso a los modelos es la única región desde la que puede utilizarlos. ## Exploración del área de juegos de texto El siguiente ejemplo muestra cómo usar el área de juegos de texto: 1. Abra la consola de Amazon Bedrock en [https://console.aws.amazon.com/bedrock/](https://console.aws.amazon.com/bedrock/). 1. En el panel de navegación de la izquierda, elija **Chat/Texto** en **Áreas de juegos**. 1. Elija **Seleccionar modelo**. A continuación, seleccione un proveedor y un modelo. Para este ejemplo, seleccione **Amazon** y, luego, **Nova Lite**. A continuación, elija **Aplicar**. 1. Seleccione una petición predeterminada debajo del panel de texto o introduzca una petición en el panel de texto, como **Describe the purpose of a "hello world" program in one line**. 1. Para explorar las capacidades de comprensión de imágenes de Amazon Nova, puede cargar una imagen en formato JPEG, PNG, GIF o WEBP que tenga un tamaño inferior o igual a 25 MB desde su computadora. Una vez cargada, puede preguntarle a Amazon Nova acerca de la imagen. 1. Para explorar las capacidades de comprensión de documentos de Amazon Nova, puede cargar un documento en formato CSV, DOC, DOCX, HTML, MD, PDF, TXT, XLS o XLSX que tenga un tamaño inferior o igual a 4,5 MB. Una vez cargados, puede preguntarle a Amazon Nova acerca de los documentos. 1. Para explorar las capacidades de comprensión de video de Amazon Nova, puede cargar un video en formato MKV, MOV o MP4 de un tamaño inferior o igual a 25 MB desde su computadora. Puede utilizar Amazon S3 para videos de hasta 1 GB. Una vez cargado, puede preguntarle a Amazon Nova acerca del video. 1. Seleccione **Ejecutar** para ejecutar la inferencia en el modelo. El texto generado aparece debajo de la petición en el panel de texto. ## Exploración del área de juegos de imágenes El siguiente ejemplo muestra cómo usar el área de juegos de imágenes. 1. Abra la consola de Amazon Bedrock en [https://console.aws.amazon.com/bedrock/](https://console.aws.amazon.com/bedrock/). 1. En el panel de navegación de la izquierda, elija **Imagen/Video** en **Áreas de juegos**. 1. Elija **Seleccionar modelo**. A continuación, seleccione un proveedor y un modelo. Para este ejemplo, seleccione **Amazon** y, a continuación, seleccione **Nova Canvas**. A continuación, elija **Aplicar**. 1. Seleccione una petición predeterminada debajo del panel de texto o introduzca una petición en el panel de texto, como **Generate an image of happy cats**. 1. En el panel **Configuraciones**, cambie la **Cantidad de imágenes** a **1**. 1. Seleccione **Ejecutar** para ejecutar la inferencia en el modelo. La imagen generada aparece encima de la petición. # Introducción a la API **nota** Esta documentación corresponde a la versión 1 de Amazon Nova. Amazon Nova 2 ya está disponible con nuevos modelos y funciones mejoradas. Para obtener información sobre cómo empezar a usar Amazon Nova 2, consulte [Getting started with the API](https://docs.aws.amazon.com/nova/latest/nova2-userguide/getting-started-api.html). Para empezar a utilizar la API, necesita credenciales para conceder el acceso programático. Si las siguientes secciones son pertinentes para usted, expándalas y siga las instrucciones. De lo contrario, continúe con las secciones restantes. ## Es la primera vez que utilizo AWS Si no dispone de una Cuenta de AWS, siga estos pasos para crear una. **Cómo registrarse en Cuenta de AWS** 1. Abra [https://portal.aws.amazon.com/billing/signup](https://portal.aws.amazon.com/billing/signup). 1. Siga las instrucciones que se le indiquen. Parte del procedimiento de registro consiste en recibir una llamada telefónica o mensaje de texto e indicar un código de verificación en el teclado del teléfono. Al registrarse en una Cuenta de AWS, se crea un *Usuario raíz de la cuenta de AWS*. El usuario raíz tendrá acceso a todos los Servicios de AWS y recursos de esa cuenta. Como práctica recomendada de seguridad, asigne acceso administrativo a un usuario y utilice únicamente el usuario raíz para realizar [Tareas que requieren acceso de usuario raíz](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks). AWS le enviará un correo electrónico de confirmación cuando complete el proceso de registro. Se puede ver la actividad de la cuenta y administrarla en cualquier momento entrando en [https://aws.amazon.com/](https://aws.amazon.com/) y seleccionando **Mi cuenta**. **Protección de Usuario raíz de la cuenta de AWS** 1. Inicie sesión en [Consola de administración de AWS](https://console.aws.amazon.com/) como propietario de la cuenta; para ello, elija **Usuario raíz** e introduzca el correo electrónico de su Cuenta de AWS. En la siguiente página, escriba su contraseña. Para obtener ayuda para iniciar sesión con el usuario raíz, consulte [Iniciar sesión como usuario raíz](https://docs.aws.amazon.com/signin/latest/userguide/console-sign-in-tutorials.html#introduction-to-root-user-sign-in-tutorial) en la *Guía del usuario de AWS Sign-In*. 1. Active la autenticación multifactor (MFA) para el usuario raíz. Para obtener instrucciones, consulte [Habilitación de un dispositivo MFA virtual para su usuario raíz de la Cuenta de AWS (consola)](https://docs.aws.amazon.com/IAM/latest/UserGuide/enable-virt-mfa-for-root.html) en la *Guía del usuario de IAM*. ## Necesito instalar la AWS CLI o un SDK de AWS Para instalar la AWS CLI, siga los pasos que se indican en [Install or update to the latest version of the AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html). Para instalar un AWS SDK, seleccione la pestaña correspondiente al lenguaje de programación que desea usar en [Herramientas para crear en AWS](https://aws.amazon.com/developer/tools/). Los kits de desarrollo de software (SDK) de AWS están disponibles en muchos lenguajes de programación conocidos. Cada SDK proporciona una API, ejemplos de código y documentación que facilitan a los desarrolladores la creación de aplicaciones en su lenguaje preferido. Los SDK realizan automáticamente tareas muy útiles para usted, como: + firma criptográfica de las solicitudes de servicio, + reintento de solicitudes, + gestión de las respuestas de error. ## Obtención de credenciales para conceder acceso programático Los usuarios necesitan acceso programático si desean interactuar con AWS fuera de la Consola de administración de AWS. La forma de conceder el acceso programático depende del tipo de usuario que acceda a AWS. Para conceder acceso programático a los usuarios, seleccione una de las siguientes opciones. **** | ¿Qué entidad principal necesita acceso programático? | Para | Mediante | | --- | --- | --- | | Usuarios de IAM | Limitar la duración de credenciales a largo plazo para firmar las solicitudes programáticas a la AWS CLI, los SDK de AWS o las API de AWS. | Siga las instrucciones de la interfaz que desea utilizar: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/nova/latest/userguide/getting-started-api.html) | | Roles de IAM | Utilizar credenciales temporales para firmar las solicitudes programáticas a la AWS CLI, los AWS SDK y las API de AWS. | Siguiendo las instrucciones de [Uso de credenciales temporales con recursos de AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html) de la Guía del usuario de IAM. | | Identidad del personal (Usuarios administrados en el IAM Identity Center) | Utiliza credenciales temporales para firmar las solicitudes programáticas a la AWS CLI, los AWS SDK y las API de AWS. | Siga las instrucciones de la interfaz que desea utilizar: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/nova/latest/userguide/getting-started-api.html) | ## Cómo configurar claves de acceso para un usuario de IAM Si decide utilizar claves de acceso para un usuario de IAM, AWS recomienda que establezca una fecha de caducidad para el usuario de IAM incluyendo una política insertada restrictiva. **importante** Preste atención a las siguientes advertencias: **NO** use las credenciales raíz de la cuenta para obtener acceso a los recursos de AWS. Estas credenciales proporcionan acceso ilimitado a la cuenta y son difíciles de revocar. **NO** incluya claves de acceso literales ni información sobre credenciales en sus archivos de aplicación. Si lo hace, puede crear un riesgo de exposición accidental de sus credenciales si, por ejemplo, carga el proyecto en un repositorio público. **NO** incluya archivos que contengan credenciales en el área del proyecto. Administre las claves de acceso de forma segura. No proporcione sus claves de acceso a terceros no autorizados, ni siquiera para que le ayuden a [buscar sus identificadores de cuenta](https://docs.aws.amazon.com/general/latest/gr/acct-identifiers.html). Si lo hace, podría conceder a otra persona acceso permanente a su cuenta. Tenga en cuenta que las credenciales almacenadas en el archivo de credenciales compartido de AWS se almacenan en texto no cifrado. Para obtener más información, consulte [Prácticas recomendadas para administrar las claves de acceso de AWS](https://docs.aws.amazon.com/general/latest/gr/aws-access-keys-best-practices.html) en la Referencia general de AWS. **Creación de un usuario de IAM** 1. En la página de inicio de Consola de administración de AWS, seleccione el servicio de IAM o vaya a la consola de IAM en [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/). 1. En el panel de navegación, seleccione **Usuarios** y, a continuación, seleccione **Crear usuario**. 1. Siga las instrucciones de la consola de IAM para configurar un usuario programático (sin acceso a la Consola de administración de AWS) y sin permisos. **Restricción del acceso del usuario a un período limitado** Todas las claves de acceso de usuario de IAM que cree son credenciales a largo plazo. Para garantizar que estas credenciales caduquen en caso de que se usen de forma incorrecta, puede establecer un límite de tiempo para estas credenciales creando una política insertada que especifique una fecha a partir de la cual las claves dejarán de ser válidas. 1. Abra el usuario de IAM que acaba de crear. En la pestaña **Permisos**, elija **Agregar permisos** y después **Crear política insertada**. 1. En el editor JSON, especifique los siguientes permisos. Para utilizar esta política, sustituya el valor de la marca temporal de `aws:CurrentTime` de la política de ejemplo por su propia fecha de finalización. **nota** IAM recomienda limitar sus claves de acceso a 12 horas. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Deny", "Action": "*", "Resource": "*", "Condition": { "DateGreaterThan": { "aws:CurrentTime": "2024-01-01T00:00:00Z" } } } ] } ``` ------ **Creación de una clave de acceso** 1. En la página **Información del usuario**, seleccione la pestaña **Credenciales de seguridad**. En la sección **Claves de acceso**, haga clic en **Crear clave de acceso**. 1. Indique que planea usar estas claves de acceso como **Otro** y elija **Crear clave de acceso**. 1. En la página **Retrieve access key page** (Recuperar clave de acceso), elija **Show** (Mostrar) para revelar el valor de la clave de acceso secreta de su usuario. Puede copiar las credenciales o descargar un archivo .csv. **importante** Cuando ya no necesite este usuario de IAM, le recomendamos que lo elimine y, de acuerdo con la [práctica recomendada de seguridad de AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#lock-away-credentials), le recomendamos que exija a sus usuarios humanos que utilicen credenciales temporales a través de [AWS IAM Identity Center](https://docs.aws.amazon.com/singlesignon/latest/userguide/getting-started.html) al acceder a AWS. ## Cómo adjuntar permisos de Amazon Bedrock a un usuario o rol Tras configurar las credenciales para el acceso programático, debe configurar los permisos para que un usuario o rol de IAM pueda acceder a un conjunto de acciones relacionadas con Amazon Bedrock. Para configurar estos permisos, haga lo siguiente: 1. En la página de inicio de Consola de administración de AWS, seleccione el servicio de IAM o vaya a la consola de IAM en [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/). 1. Seleccione **Usuarios** o **Roles** y, a continuación, seleccione su usuario o rol. 1. En la pestaña **Permisos**, elija **Agregar permisos** y, a continuación, **Agregar políticas administradas por AWS**. Elija la política administrada de AWS [AmazonBedrockFullAccess](). 1. Para permitir que el usuario o el rol se suscriban a los modelos, seleccione **Crear política insertada** y, a continuación, especifique los siguientes permisos en el editor JSON: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "MarketplaceBedrock", "Effect": "Allow", "Action": [ "aws-marketplace:ViewSubscriptions", "aws-marketplace:Unsubscribe", "aws-marketplace:Subscribe" ], "Resource": "*" } ] } ``` ------ ## Solicitud de acceso a los modelos de Amazon Nova Solicite acceso a los modelos de Amazon Nova a través de la consola de Amazon Bedrock siguiendo los pasos que se indican en [Solicitud de acceso a un modelo fundacional de Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/getting-started.html#getting-started-model-access). ## Generación de una respuesta para una petición de texto mediante un modelo de Amazon Nova Una vez que haya cumplido con todos los requisitos previos, seleccione una pestaña para probar cómo realizar solicitudes de invocación de modelos a modelos de Amazon Nova con una solicitud [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) y utilizando el método especificado en la pestaña: ------ #### [ AWS CLI ] Para instalar la AWS CLI, siga los pasos que se indican en [Install or update to the latest version of the AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html). Compruebe que ha configurado sus credenciales para usar Boto3 siguiendo los pasos que se indican en [Obtención de credenciales para conceder acceso programático](#grant-program-access). Para generar una respuesta para una petición de texto en Amazon Nova Lite mediante la AWS CLI, ejecute el siguiente comando en una terminal: ``` aws bedrock-runtime converse \ --model-id us.amazon.nova-lite-v1:0 \ --messages '[{"role": "user", "content": [{"text": "Write a short poem"}]}]' ``` ------ #### [ Python (Boto3) ] Para instalar Boto3, siga los pasos en la sección [Quickstart](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html) de la documentación de Boto3. Compruebe que ha configurado sus credenciales para usar Boto3 siguiendo los pasos que se indican en [Obtención de credenciales para conceder acceso programático](#grant-program-access). Para crear un cliente de Amazon Bedrock Runtime y generar una respuesta para una petición de texto en Amazon Nova Lite mediante el SDK de Python (Boto3), ejecute el siguiente script de Python: ``` import boto3 import json client = boto3.client(service_name="bedrock-runtime") messages = [ {"role": "user", "content": [{"text": "Write a short poem"}]}, ] model_response = client.converse( modelId="us.amazon.nova-lite-v1:0", messages=messages ) print("\n[Full Response]") print(json.dumps(model_response, indent=2)) print("\n[Response Content Text]") print(model_response["output"]["message"]["content"][0]["text"]) ``` ------ #### [ LangChain ] Para instalar LangChain para AWS, siga los pasos que se indican en [AWS](https://python.langchain.com/docs/integrations/providers/aws/) en la documentación de LangChain. Compruebe que ha configurado sus credenciales para usar Boto3 siguiendo los pasos que se indican en [Obtención de credenciales para conceder acceso programático](#grant-program-access). Para generar una respuesta para una petición de texto en Amazon Nova Lite mediante LangChain, ejecute el siguiente script: ``` from langchain_aws import ChatBedrockConverse llm = ChatBedrockConverse(model="us.amazon.nova-lite-v1:0") messages = [ ("user", "Write a short poem") ] llm.invoke(messages) ``` ------ Una vez que se haya familiarizado con Amazon Nova, puede pasar a tareas más avanzadas: 1. Intente indicarle al modelo que describa una imagen o un video. Para obtener más información, consulte [Soporte multimodal para Amazon Nova](modalities.md). 1. Intente generar imágenes con Amazon Nova Canvas. Para obtener más información, consulte [Generación de imágenes con Amazon Nova Canvas](image-generation.md). 1. Intente generar videos con Amazon Nova Reel. Para obtener más información, consulte [Generación de videos con Amazon Nova Reel](video-generation.md). 1. Envíe un documento al modelo y pregúntele por su contenido. Para obtener más información, consulte [Comprensión de documentos](modalities-document.md). 1. Proporcione herramientas al modelo y hágale una solicitud con una petición para ver cómo utiliza la herramienta. Para obtener más información, consulte [Uso de herramientas (llamada a funciones) con Amazon Nova](tool-use.md).