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 a usare le API, segui queste procedure se non conosci AWS o devi installare l'interfaccia a riga di AWS comando o un AWS SDK. Se nessuna di queste condizioni ti riguarda, 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 iscriversi a AWS account
  1. Aprire https://portal.aws.amazon.com/billing/signup.

  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 crea 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 best practice di sicurezza, assegna l'accesso amministrativo a un utente e utilizza solo l'utente root per eseguire attività che richiedono l'accesso dell'utente root.

AWS ti invia un'email di conferma al termine della procedura di registrazione. Puoi visualizzare l'attività corrente del tuo account e gestire l'account in qualsiasi momento accedendo a https://aws.amazon.com/ e scegliendo My Account (Il mio account).

Proteggi il tuo AWS Utente root dell'account
  1. Accedi Console di gestione AWS come 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 utilizzando un utente root, consulta la pagina Accedere come utente root nella Guida per l’utente di AWS Sign-In.

  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) del tuo AWS account nella IAM User Guide.

Per installare la AWS CLI, segui i passaggi indicati in Installazione o aggiornamento alla versione più recente della CLI AWS .

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 (SDK) sono disponibili per molti linguaggi di programmazione diffusi. Ogni SDK fornisce un'API, esempi di codice e documentazione che facilitano agli sviluppatori la creazione di applicazioni nella lingua preferita. Gli SDK eseguono automaticamente attività utili per tuo conto, tra cui:

  • Firma crittografata delle richieste di servizio

  • Richieste di ripetizione

  • Gestione delle risposte di errore

Ottenere le credenziali per concedere l’accesso programmatico

Gli utenti hanno bisogno di un accesso programmatico se vogliono 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, agli AWS SDK o alle API. AWS Segui le istruzioni per l’interfaccia che desideri utilizzare.
Ruoli IAM Usa le credenziali temporanee per firmare le richieste programmatiche alla AWS CLI, agli AWS SDK o alle API. AWS Segui le istruzioni in Uso delle credenziali temporanee con le AWS risorse nella IAM User Guide.
Utenti gestiti in IAM Identity Center Usa le credenziali temporanee per firmare le richieste programmatiche alla AWS CLI, agli AWS SDK o alle API. AWS 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 Amazon. Bedrock-related 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 creare richieste di invocazione di modelli su modelli Amazon Nova con una richiesta Converse. https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html

Per installare la AWS CLI, segui i passaggi indicati in Installazione o aggiornamento alla versione più recente della CLI. AWS 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 a 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"}}'