View a markdown version of this page

Memulai dengan API - Amazon Nova
Dapatkan kredenSIAL untuk memberikan akses terprogramLampirkan izin Amazon Bedrock ke pengguna atau peranMenghasilkan respons untuk prompt teks menggunakan model Amazon Nova

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Memulai dengan API

Sebelum Anda memulai dengan API, ikuti prosedur ini jika Anda baru AWS atau perlu menginstal AWS CLI atau AWS SDK. Jika tidak satu pun dari ini berlaku untuk Anda, pindah keDapatkan kredenSIAL untuk memberikan akses terprogram.

Jika Anda tidak memiliki AWS akun, selesaikan langkah-langkah berikut untuk membuatnya. Atau, Anda dapat mulai membangun secara gratis dengan Amazon Nova di nova.amazon. com/dev.

Untuk mendaftar untuk AWS akun

  1. Buka https://portal.aws.amazon.com/billing/signup.

  2. Ikuti petunjuk online.

    Bagian dari prosedur pendaftaran melibatkan menerima panggilan telepon atau pesan teks dan memasukkan kode verifikasi pada keypad telepon.

    Saat Anda mendaftar untuk AWS akun, pengguna root AWS akun dibuat. Pengguna root memiliki akses ke semua AWS layanan dan sumber daya di akun. Sebagai praktik terbaik keamanan, tetapkan akses administratif ke pengguna dan gunakan hanya pengguna root untuk melakukan tugas yang memerlukan akses pengguna root.

AWS mengirimkan email konfirmasi setelah proses pendaftaran selesai. Kapan saja, Anda dapat melihat aktivitas akun Anda saat ini dan mengelola akun Anda dengan membuka https://aws.amazon.com/ dan memilih Akun Saya.

Amankan Anda AWS pengguna root akun

  1. Masuk ke Konsol Manajemen AWS sebagai pemilik akun dengan memilih pengguna Root dan memasukkan alamat email AWS akun Anda. Di laman berikutnya, masukkan kata sandi.

    Untuk bantuan masuk dengan menggunakan pengguna root, lihat Masuk sebagai pengguna root di AWS Sign-In Panduan Pengguna.

  2. Mengaktifkan autentikasi multi-faktor (MFA) untuk pengguna root Anda.

    Untuk petunjuk, lihat Mengaktifkan perangkat MFA virtual untuk pengguna root AWS akun Anda (konsol) di Panduan Pengguna IAM.

Untuk menginstal AWS CLI, ikuti langkah-langkah di Instal atau perbarui ke versi terbaru AWS CLI.

Untuk menginstal AWS SDK, pilih tab yang sesuai dengan bahasa pemrograman yang ingin Anda gunakan di Tools to Build on AWS.

AWS perangkat pengembangan perangkat lunak (SDK) tersedia untuk banyak bahasa pemrograman populer. Setiap SDK menyediakan API, contoh kode, dan dokumentasi yang memudahkan pengembang untuk membangun aplikasi dalam bahasa pilihan mereka. SDK secara otomatis melakukan tugas-tugas yang berguna untuk Anda, seperti:

  • Tanda tangani permintaan layanan Anda secara kriptografi

  • Permintaan coba lagi

  • Menangani tanggapan kesalahan

Dapatkan kredenSIAL untuk memberikan akses terprogram

Pengguna memerlukan akses terprogram jika mereka ingin berinteraksi dengan AWS di luar Konsol AWS Manajemen. Cara untuk memberikan akses terprogram tergantung pada jenis pengguna yang mengakses AWS.

Untuk memberi pengguna akses programatis, pilih salah satu opsi berikut.

Prinsipal mana yang membutuhkan akses terprogram? Untuk Oleh
Pengguna IAM: Batasi durasi kredensional jangka panjang untuk menandatangani permintaan terprogram ke AWS CLI, AWS SDK, atau API. AWS Mengikuti petunjuk untuk antarmuka yang ingin Anda gunakan.
Peran IAM Gunakan kredenSIAL sementara untuk menandatangani permintaan terprogram ke AWS CLI, AWS SDK, atau API. AWS Ikuti petunjuk dalam Menggunakan kredenSIAL sementara dengan AWS sumber daya di Panduan Pengguna IAM.
Pengguna dikelola di Pusat Identitas IAM Gunakan kredenSIAL sementara untuk menandatangani permintaan terprogram ke AWS CLI, AWS SDK, atau API. AWS Mengikuti petunjuk untuk antarmuka yang ingin Anda gunakan.

Lampirkan izin Amazon Bedrock ke pengguna atau peran

Setelah menyiapkan kredenSIAL untuk akses terprogram, Anda perlu mengonfigurasi izin untuk pengguna atau peran IAM agar memiliki akses ke tindakan Amazon Bedrock-related . Untuk mengatur izin ini, lakukan hal berikut:

  1. Pada halaman Beranda Konsol AWS Manajemen, pilih layanan IAM atau navigasikan ke konsol IAM di. https://console.aws.amazon.com/iam/

  2. Pilih Pengguna atau Per an lalu pilih pengguna atau peran Anda.

  3. Di tab Izin, pilih Tam bah izin, lalu pilih Tambahkan kebijakan ter AWS kelola. Pilih kebijakan yang AmazonBedrockFullAccess AWS dikelola.

  4. Untuk mengizinkan pengguna atau peran berlangganan model, pilih Buat kebijakan sebaris lalu tentukan izin berikut di editor JSON:

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

Menghasilkan respons untuk prompt teks menggunakan model Amazon Nova

Setelah memenuhi semua prasyarat, Anda dapat menguji pembuatan permintaan pemanggilan model ke model Amazon Nova dengan permintaan Converse.

Untuk menginstal AWS CLI, ikuti langkah-langkah di Instal atau perbarui ke versi terbaru AWS CLI. Verifikasi bahwa Anda telah menyiapkan kredensi untuk menggunakan Boto3 dengan mengikuti langkah-langkah di. Dapatkan kredenSIAL untuk memberikan akses terprogram

Untuk menghasilkan respons untuk prompt teks di Nova 2 Lite dengan menggunakan AWS CLI, jalankan perintah berikut di terminal:

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"}}'