Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Nozioni di base su Amazon Nova **Nota** Questa documentazione è per Amazon Nova versione 1. Amazon Nova 2 è ora disponibile con nuovi modelli e funzionalità avanzate. Per informazioni su come iniziare a usare Amazon Nova 2, visita [Guida introduttiva ad Amazon Nova 2](https://docs.aws.amazon.com/nova/latest/nova2-userguide/getting-started-nova-2.html). I modelli Amazon Nova possono essere richiamati tramite un'API che utilizza le operazioni API Amazon Bedrock [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) oppure possono essere utilizzati tramite i playground [Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/playgrounds.html) Chat and Text. **Importante** Se sei nuovo utente AWS o utilizzi Amazon Bedrock, devi prima configurare Amazon Bedrock seguendo la procedura descritta nella [Guida introduttiva ad Amazon](https://docs.aws.amazon.com/bedrock/latest/userguide/getting-started.html) Bedrock. In alternativa, puoi provare i modelli Amazon Nova senza accedere ad Amazon Bedrock su. [https://nova.amazon.com](https://nova.amazon.com/chat) Seleziona un argomento per iniziare a utilizzare Amazon Nova con tale metodo. **Topics** + [Nozioni di base su Amazon Nova nella console Amazon Bedrock](getting-started-console.md) + [Nozioni di base sull’API](getting-started-api.md) # Nozioni di base su Amazon Nova nella console Amazon Bedrock **Nota** Questa documentazione è per Amazon Nova versione 1. Amazon Nova 2 è ora disponibile con nuovi modelli e funzionalità avanzate. Per informazioni su come iniziare a usare Amazon Nova 2, visita [Guida introduttiva ad Amazon Nova 2 nella console Amazon Bedrock](https://docs.aws.amazon.com/nova/latest/nova2-userguide/getting-started-console.html). Questa sezione descrive come utilizzare i campi di gioco della AWS console per inviare un messaggio di testo ai modelli Amazon Nova e generare una risposta con testo o immagine. Prima di eseguire i seguenti esempi, devi verificare di aver soddisfatto i seguenti prerequisiti: **Prerequisiti** + Disponi Account AWS e disponi delle autorizzazioni per accedere a un ruolo in quell'account con le autorizzazioni necessarie per Amazon Bedrock. In caso contrario, segui la procedura indicata alla pagina [Getting started with Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/getting-started.html). + Hai richiesto l’accesso ai modelli Amazon Nova. In caso contrario, segui la procedura indicata alla pagina [Request access to an Amazon Bedrock foundation model](https://docs.aws.amazon.com/bedrock/latest/userguide/getting-started.html#getting-started-model-access) e richiedi l’accesso ad **Amazon Nova Lite** e **Amazon Nova Canvas**. + Assicurati di essere nella Regione Stati Uniti orientali (Virginia settentrionale) (us-east-1). Per cambiare Regione, seleziona il nome della Regione in alto a destra nella console, accanto al ruolo IAM. Quindi, seleziona Stati Uniti orientali (Virginia settentrionale) (us-east-1). **Topics** + [Richiedere l’accesso ai modelli.](#getting-started-access) + [Esplorare il playground di testo](#getting-started-text) + [Esplorazione del playground di immagini](#getting-started-image) ## Richiedere l’accesso ai modelli. Completa la seguente procedura per richiedere l’accesso ai modelli Amazon Nova. 1. Apri la console Amazon Bedrock all'indirizzo [https://console.aws.amazon.com/bedrock/](https://console.aws.amazon.com/bedrock/). 1. Dal riquadro di navigazione a sinistra, scegli **Accesso ai modelli** in **Configurazioni Bedrock**. 1. In **Cos’è l’accesso ai modelli**, scegli **Abilita modelli specifici**. 1. Scegli **Nova Lite** e **Nova Canvas** dall’elenco **Modelli di base**. Gli esempi riportati in questa sezione utilizzano solo questi due modelli, ma puoi richiedere l’accesso a tutti i modelli Amazon Nova. quindi scegliere **Next**. 1. Nella pagina **Rivedi e invia**, scegli **Invia**. 1. Aggiorna la tabella **Modelli di base**. Se i modelli Amazon Nova vengono visualizzati con lo stato **Accesso concesso**, puoi procedere alle prossime fasi dell’esempio. Tieni presente che la Regione dalla quale richiedi l’accesso ai modelli è l’unica dalla quale puoi utilizzarli. ## Esplorare il playground di testo Nell’esempio seguente viene illustrato come utilizzare il playground di testo: 1. Apri la console Amazon Bedrock all'indirizzo [https://console.aws.amazon.com/bedrock/](https://console.aws.amazon.com/bedrock/). 1. Dal riquadro di navigazione a sinistra, scegli **Chat/Testo** in **Playground**. 1. Scegli **Seleziona modello** e seleziona un provider e un modello. Per questo esempio, seleziona **Amazon**, quindi **Nova Lite**. Poi scegli **Applica**. 1. Seleziona un prompt predefinito sotto il pannello di testo oppure inserisci un prompt nel pannello di testo, ad esempio **Describe the purpose of a "hello world" program in one line**. 1. Per esplorare le funzionalità di comprensione delle immagini di Amazon Nova, puoi caricare un’immagine in formato JPEG, PNG, GIF o WEBP di dimensioni inferiori o uguali a 25 MB dal computer. Dopo averla caricata, puoi chiedere informazioni sull’immagine ad Amazon Nova. 1. Per esplorare le funzionalità di comprensione dei documenti di Amazon Nova, puoi caricare documenti in formato CSV, DOC, DOCX, HTML, MD, PDF, TXT, XLS o XLSX di dimensioni inferiori o uguali a 4,5 MB. Dopo averli caricati, puoi chiedere informazioni sui documenti ad Amazon Nova. 1. Per esplorare le funzionalità di comprensione video di Amazon Nova, puoi caricare un video in MKV, MOV o MP4 formato inferiore o uguale a 25 MB dal tuo computer. Per i video fino a 1 GB puoi utilizzare Amazon S3. Dopo averlo caricato, puoi chiedere informazioni sul video ad Amazon Nova. 1. Scegli **Esegui** per eseguire l’inferenza sul modello. Il testo generato viene visualizzato sotto il prompt nel pannello di testo. ## Esplorazione del playground di immagini Nell’esempio seguente viene illustrato come utilizzare il playground di immagini. 1. Apri la console Amazon Bedrock all'indirizzo [https://console.aws.amazon.com/bedrock/](https://console.aws.amazon.com/bedrock/). 1. Dal riquadro di navigazione a sinistra, scegli **Immagine/Video** in **Playground**. 1. Scegli **Seleziona modello** e seleziona un provider e un modello. Per questo esempio, seleziona **Amazon**, quindi **Nova Canvas**. Poi scegli **Applica**. 1. Seleziona un prompt predefinito sotto il pannello di testo oppure inserisci un prompt nel pannello di testo, ad esempio **Generate an image of happy cats**. 1. Nel riquadro **Configurazioni**, modifica il **Numero di immagini** in **1**. 1. Scegli **Esegui** per eseguire l’inferenza sul modello. L’immagine generata viene visualizzata sopra il prompt. # Nozioni di base sull’API **Nota** Questa documentazione è per Amazon Nova versione 1. Amazon Nova 2 è ora disponibile con nuovi modelli e funzionalità avanzate. Per informazioni su come iniziare a usare Amazon Nova 2, visita [Guida introduttiva all'API](https://docs.aws.amazon.com/nova/latest/nova2-userguide/getting-started-api.html). Per iniziare a utilizzare l’API, sono necessarie le credenziali per concedere l’accesso programmatico. Se le seguenti sezioni ti riguardano, espandile e segui le istruzioni riportate. In caso contrario, procedi con le sezioni rimanenti. ## Sono nuovo a AWS Se non ne hai uno Account AWS, completa i seguenti passaggi per crearne uno. **Per iscriverti a un Account AWS** 1. Apri la [https://portal.aws.amazon.com/billing/registrazione.](https://portal.aws.amazon.com/billing/signup) 1. Segui le istruzioni online. Nel corso della procedura di registrazione riceverai una telefonata o un messaggio di testo e ti verrà chiesto di inserire un codice di verifica attraverso la tastiera del telefono. Quando ti iscrivi a un Account AWS, *Utente root dell'account AWS*viene creato un. L’utente root dispone dell’accesso a tutte le risorse e tutti i Servizi AWS nell’account. Come best practice di sicurezza, assegna l’accesso amministrativo a un utente e utilizza solo l’utente root per eseguire [attività che richiedono l’accesso di un utente root](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks). AWS ti invia un'email di conferma dopo il completamento della procedura di registrazione. In qualsiasi momento, puoi visualizzare l'attività corrente del tuo account e gestirlo accedendo a [https://aws.amazon.com/](https://aws.amazon.com/)e scegliendo **Il mio account**. **Proteggi il tuo Utente root dell'account AWS** 1. Accedi [Console di gestione AWS](https://console.aws.amazon.com/)come proprietario dell'account scegliendo **Utente root** e inserendo il tuo indirizzo Account AWS email. Nella pagina successiva, inserisci la password. Per informazioni sull’accesso utilizzando un utente root, consulta la pagina [Accedere come utente root](https://docs.aws.amazon.com/signin/latest/userguide/console-sign-in-tutorials.html#introduction-to-root-user-sign-in-tutorial) nella *Guida per l’utente di Accedi ad AWS *. 1. Abilita l’autenticazione a più fattori (MFA) per l’utente root. Per istruzioni, consulta [Abilitare un dispositivo MFA virtuale per l'utente Account AWS root (console)](https://docs.aws.amazon.com/IAM/latest/UserGuide/enable-virt-mfa-for-root.html) nella Guida per l'*utente IAM*. ## Devo installare AWS CLI o un SDK AWS Per installare AWS CLI, segui i passaggi in [Installare o aggiornare alla versione più recente di AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html). Per installare un AWS SDK, seleziona la scheda corrispondente al linguaggio di programmazione che desideri utilizzare in [Tools to Build on AWS](https://aws.amazon.com/developer/tools/). AWS i kit di sviluppo software (SDKs) sono disponibili per molti linguaggi di programmazione popolari. Ogni SDK fornisce un'API, esempi di codice e documentazione che semplificano agli sviluppatori la creazione di applicazioni nella loro lingua preferita. SDKs esegue automaticamente attività utili per te, come: + Firma crittografata delle richieste di servizio + Richieste di ripetizione + Gestione delle risposte di errore ## Ottenere le credenziali per concedere l’accesso programmatico Gli utenti necessitano dell'accesso programmatico se desiderano interagire con utenti AWS esterni a. Console di gestione AWS Il modo per concedere l'accesso programmatico dipende dal tipo di utente che accede. AWS Per fornire agli utenti l’accesso programmatico, scegli una delle seguenti opzioni. **** | Quale principale necessita dell’accesso programmatico? | Per | Come | | --- | --- | --- | | Utenti IAM | Limita la durata delle credenziali a lungo termine per firmare le richieste programmatiche a AWS CLI,, AWS SDKs o. AWS APIs | Segui le istruzioni per l’interfaccia che desideri utilizzare. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/nova/latest/userguide/getting-started-api.html) | | Ruoli IAM | Utilizza credenziali temporanee per firmare le richieste programmatiche a AWS CLI, AWS SDKs, o. AWS APIs | Seguendo le istruzioni riportate in [Utilizzo delle credenziali temporanee con le AWS risorse nella Guida per](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html) l'utente IAM. | | Identità della forza lavoro (Utenti gestiti nel centro identità IAM) | Utilizza credenziali temporanee per firmare le richieste programmatiche a AWS CLI,, AWS SDKs o. AWS APIs | Segui le istruzioni per l’interfaccia che desideri utilizzare. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/nova/latest/userguide/getting-started-api.html) | ## Come configurare le chiavi di accesso per un utente IAM Se decidi di utilizzare le chiavi di accesso per un utente IAM, AWS ti consigliamo di impostare una scadenza per l'utente IAM includendo una policy in linea restrittiva. **Importante** Presta attenzione ai seguenti avvertimenti: **NON** utilizzare le credenziali root del tuo account per accedere alle risorse. AWS Queste credenziali forniscono un accesso illimitato all’account e sono difficili da revocare. **NON** inserire chiavi di accesso letterali o informazioni sulle credenziali nei file dell’applicazione. In caso contrario, rischi di esporre accidentalmente le credenziali se, per esempio, carichi il progetto in repository pubblici. **NON** includere file che contengono credenziali nell’area del progetto. Gestisci le chiavi di accesso in modo sicuro. Non fornire le chiavi di accesso a parti non autorizzate, neppure per contribuire a [trovare gli identificatori di account](https://docs.aws.amazon.com/general/latest/gr/acct-identifiers.html). In questo modo, potresti concedere a qualcuno l'accesso permanente al tuo account. Tieni presente che tutte le credenziali archiviate nel file delle AWS credenziali condivise vengono archiviate in testo non crittografato. Per ulteriori dettagli, vedere [Procedure ottimali per la gestione delle chiavi di AWS accesso](https://docs.aws.amazon.com/general/latest/gr/aws-access-keys-best-practices.html) in. Riferimenti generali di AWS **Creare un utente IAM** 1. Nella Console di gestione AWS home page, seleziona il servizio IAM o accedi alla console IAM all'indirizzo [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/). 1. Nel riquadro di navigazione, seleziona **Utenti**, quindi seleziona **Crea utente**. 1. Segui le indicazioni nella console IAM per configurare un utente programmatico (senza accesso a Console di gestione AWS) e senza autorizzazioni. **Limitare l’accesso dell’utente a una finestra a tempo limitato** Le chiavi di accesso create per un utente IAM sono credenziali a lungo termine. Per garantire che queste credenziali scadano nel caso vengano utilizzate impropriamente, puoi assegnarvi un limite di tempo creando una policy in linea che specifichi una data dopo la quale le chiavi non saranno più valide. 1. Apri l’utente IAM appena creato. Nella scheda **Autorizzazioni**, scegli **Aggiungi autorizzazioni**, poi **Crea policy inline**. 1. Nell’editor JSON, specifica le seguenti autorizzazioni. Per utilizzare questa policy, sostituisci il valore del timestamp `aws:CurrentTime` nella policy di esempio con la data di fine scelta. **Nota** IAM consiglia di limitare le chiavi di accesso a 12 ore. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Deny", "Action": "*", "Resource": "*", "Condition": { "DateGreaterThan": { "aws:CurrentTime": "2024-01-01T00:00:00Z" } } } ] } ``` ------ **Creare una chiave di accesso** 1. Nella pagina **Dettagli dell’utente**, seleziona la scheda **Credenziali di sicurezza**. Nella sezione **Chiavi di accesso**, scegliere **Crea chiave di accesso**. 1. Indica che intendi utilizzare queste chiavi di accesso come **Altro** e seleziona **Crea chiave di accesso**. 1. Nella pagina **Recupera chiave di accesso**, scegli **Mostra** per rivelare il valore della chiave di accesso segreta dell’utente. Puoi copiare le credenziali o scaricare un file .csv. **Importante** Quando non hai più bisogno di questo utente IAM, ti consigliamo di rimuoverlo e, in linea con le [best practice di AWS sicurezza](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#lock-away-credentials), di richiedere agli utenti umani di utilizzare credenziali temporanee tramite [AWS IAM Identity](https://docs.aws.amazon.com/singlesignon/latest/userguide/getting-started.html) Center durante l'accesso. AWS ## Collegare autorizzazioni Amazon Bedrock a un utente o a un ruolo Dopo aver configurato le credenziali per l’accesso programmatico, devi configurare le autorizzazioni per un utente o un ruolo IAM affinché possano accedere a una serie di operazioni legate ad Amazon Bedrock. Per configurare queste autorizzazioni, procedi come segue: 1. Nella Console di gestione AWS home page, seleziona il servizio IAM o accedi alla console IAM all'indirizzo. [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) 1. Seleziona **Utenti** o **Ruoli**, poi seleziona l’utente o il ruolo desiderato. 1. Nella scheda **Autorizzazioni**, scegli **Aggiungi autorizzazioni**, quindi scegli **Aggiungi policy AWS gestita**. Scegli la policy gestita [AmazonBedrockFullAccess]() AWS . 1. Per consentire all’utente o al ruolo di abbonarsi ai modelli, scegli **Crea policy inline**, poi specifica le seguenti autorizzazioni nell’editor JSON: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "MarketplaceBedrock", "Effect": "Allow", "Action": [ "aws-marketplace:ViewSubscriptions", "aws-marketplace:Unsubscribe", "aws-marketplace:Subscribe" ], "Resource": "*" } ] } ``` ------ ## Richiedere l’accesso ai modelli Amazon Nova Richiedi l’accesso ai modelli Amazon Nova tramite la console Amazon Bedrock seguendo i passaggi indicati alla pagina [Request access to an Amazon Bedrock foundation model](https://docs.aws.amazon.com/bedrock/latest/userguide/getting-started.html#getting-started-model-access). ## Generare una risposta per un prompt di testo utilizzando un modello Amazon Nova Dopo aver soddisfatto tutti i prerequisiti, seleziona una scheda per testare l’invio di richieste di invocazione ai modelli Amazon Nova con una richiesta [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) e utilizzando il metodo specificato nella scheda: ------ #### [ AWS CLI ] Per installare AWS CLI, segui i passaggi in [Installa o aggiorna alla versione più recente di](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html). AWS CLI Verifica di aver configurato le credenziali per utilizzare Boto3 seguendo la procedura indicata alla pagina [Ottenere le credenziali per concedere l’accesso programmatico](#grant-program-access). Per generare una risposta a un prompt di testo in Amazon Nova Lite utilizzando il AWS CLI, esegui il seguente comando in un terminale: ``` aws bedrock-runtime converse \ --model-id us.amazon.nova-lite-v1:0 \ --messages '[{"role": "user", "content": [{"text": "Write a short poem"}]}]' ``` ------ #### [ Python (Boto3) ] Per installare Boto3, segui la procedura indicata alla pagina [Quickstart](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html) della documentazione di Boto3. Verifica di aver configurato le credenziali per utilizzare Boto3 seguendo la procedura indicata alla pagina [Ottenere le credenziali per concedere l’accesso programmatico](#grant-program-access). Per creare un client Amazon Bedrock Runtime e generare una risposta per un prompt di testo in Amazon Nova Lite utilizzando Python SDK (Boto3), esegui il seguente script 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 ] LangChain Per installarlo AWS, segui i passaggi indicati [AWS](https://python.langchain.com/docs/integrations/providers/aws/)nella LangChain documentazione. Verifica di aver configurato le credenziali per utilizzare Boto3 seguendo la procedura indicata alla pagina [Ottenere le credenziali per concedere l’accesso programmatico](#grant-program-access). Per generare una risposta a un prompt di testo in Amazon Nova Lite utilizzando LangChain, esegui lo script seguente: ``` from langchain_aws import ChatBedrockConverse llm = ChatBedrockConverse(model="us.amazon.nova-lite-v1:0") messages = [ ("user", "Write a short poem") ] llm.invoke(messages) ``` ------ Dopo aver acquisito familiarità con Amazon Nova, puoi passare ad attività più avanzate: 1. Prova a chiedere al modello di descrivere un’immagine o un video con un prompt. Per ulteriori informazioni, consulta [Supporto multimodale per Amazon Nova](modalities.md). 1. Prova a generare immagini con Amazon Nova Canvas. Per ulteriori informazioni, consulta [Generazione di immagini con Amazon Nova Canvas](image-generation.md). 1. Prova a generare video con Amazon Nova Reel. Per ulteriori informazioni, consulta [Generazione di video con Amazon Nova Reel](video-generation.md). 1. Invia un documento al modello e chiedi informazioni sul contenuto. Per ulteriori informazioni, consulta [Comprensione dei documenti](modalities-document.md). 1. Fornisci strumenti al modello e fai una richiesta con un prompt per fargli utilizzare uno strumento. Per ulteriori informazioni, consulta [Utilizzo dello strumento (chiamata delle funzioni) con Amazon Nova](tool-use.md).