View a markdown version of this page

Nozioni di base sull’API - Amazon Nova

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 sull’API

Prima di iniziare APIs, segui queste procedure se non conosci AWS o devi installare la AWS CLI o un AWS SDK. Se nessuna di queste condizioni si applica al tuo caso, passa a. Ottenere le credenziali per concedere l’accesso programmatico

Se non disponi di un AWS account, completa i seguenti passaggi per crearne uno. In alternativa, puoi iniziare a creare gratuitamente con Amazon Nova all'indirizzo nova.amazon.com/dev.

Per creare un account AWS
  1. Apri la https://portal.aws.amazon.com/billing/registrazione.

  2. 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 si registra un AWS account, viene creato un utente root dell'AWS account. L'utente root ha accesso a tutte le risorse e i servizi AWS in tale account. Come procedura consigliata in materia di sicurezza, assegnate l'accesso amministrativo a un utente e utilizzate solo l'utente root per eseguire attività che richiedono l'accesso da parte dell'utente root.

AWS ti invia un'e-mail 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/e scegliendo Il mio account.

Proteggi il tuo AWS account (utente root).
  1. Accedi Console di gestione AWScome proprietario dell'account scegliendo Utente root e inserendo l'indirizzo email AWS del tuo account. Nella pagina successiva, inserisci la password.

    Per informazioni sull'accesso tramite utente root, consulta Accesso come utente root nella Guida per l'utente di AWS accesso.

  2. Abilita l'autenticazione a più fattori (MFA) per l'utente root.

    Per istruzioni, consulta Abilitare un dispositivo MFA virtuale per l'utente root (console) dell' AWS account nella Guida per l'utente IAM.

Per installare la AWS CLI, segui i passaggi in Installa o aggiorna alla versione più recente della AWS CLI.

Per installare un AWS SDK, seleziona la scheda corrispondente al linguaggio di programmazione che desideri utilizzare in Tools to Build on. AWS

AWS i kit di sviluppo software (SDKs) sono disponibili per molti linguaggi di programmazione più diffusi. 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 l' AWS esterno della console di AWS gestione. 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 alla AWS CLI, oppure. AWS SDKs AWS APIs Segui le istruzioni per l’interfaccia che desideri utilizzare.
Ruoli IAM Utilizza credenziali temporanee per firmare le richieste programmatiche alla AWS CLI, oppure. AWS SDKs AWS APIs Segui le istruzioni in Utilizzo di credenziali temporanee con AWS risorse nella Guida per l'utente IAM.
Utenti gestiti in IAM Identity Center Utilizza credenziali temporanee per firmare le richieste programmatiche alla AWS CLI, oppure. AWS SDKs AWS APIs Segui le istruzioni per l’interfaccia che desideri utilizzare.

Collegare autorizzazioni Amazon Bedrock a un utente o a un ruolo

Dopo aver impostato le credenziali per l'accesso programmatico, devi configurare le autorizzazioni per un utente o un ruolo IAM per avere accesso alle azioni relative ad Amazon Bedrock. Per configurare queste autorizzazioni, procedi come segue:

  1. Nella home page della console di AWS gestione, seleziona il servizio IAM o accedi alla console IAM all'indirizzo. https://console.aws.amazon.com/iam/

  2. Seleziona Utenti o Ruoli, poi seleziona l’utente o il ruolo desiderato.

  3. Nella scheda Autorizzazioni, scegli Aggiungi autorizzazioni, quindi scegli Aggiungi policy AWS gestita. Scegli la policy gestita AmazonBedrockFullAccess AWS .

  4. Per consentire all’utente o al ruolo di abbonarsi ai modelli, scegli Crea policy inline, poi specifica le seguenti autorizzazioni nell’editor JSON:

    { "Version": "2012-10-17", "Statement": [ { "Sid": "MarketplaceBedrock", "Effect": "Allow", "Action": [ "aws-marketplace:ViewSubscriptions", "aws-marketplace:Unsubscribe", "aws-marketplace:Subscribe" ], "Resource": "*" } ] }

Generare una risposta per un prompt di testo utilizzando un modello Amazon Nova

Dopo aver soddisfatto tutti i prerequisiti, puoi provare a effettuare richieste di invocazione di modelli su modelli Amazon Nova con una richiesta Converse.

Per installare la AWS CLI, segui i passaggi in Installa o aggiorna alla versione più recente della 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.

Per generare una risposta per un prompt di testo in Nova 2 Lite utilizzando la AWS CLI, esegui il seguente comando in un terminale:

aws bedrock-runtime converse \ --model-id us.amazon.nova-2-lite-v1:0 \ --messages '[{"role":"user","content":[{"text":"Write a short poem"}]}]' \ --additional-model-request-fields '{"reasoningConfig":{"type":"enabled","maxReasoningEffort":"low"}}'