Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Memulai dengan Amazon Nova
**catatan**
Dokumentasi ini untuk Amazon Nova Versi 1. Amazon Nova 2 sekarang tersedia dengan model baru dan kemampuan yang ditingkatkan. Untuk informasi tentang memulai dengan Amazon Nova 2, kunjungi [Memulai Amazon Nova 2](https://docs.aws.amazon.com/nova/latest/nova2-userguide/getting-started-nova-2.html).
Model Amazon Nova dapat dipanggil baik melalui API menggunakan operasi Amazon Bedrock [InvokeModel](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModel.html)atau [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) API atau mereka dapat digunakan melalui taman bermain Obrolan dan Teks [Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/playgrounds.html).
**penting**
Jika Anda baru AWS atau ke Amazon Bedrock, Anda harus terlebih dahulu mengatur Amazon Bedrock dengan mengikuti langkah-langkah di [Memulai dengan Amazon](https://docs.aws.amazon.com/bedrock/latest/userguide/getting-started.html) Bedrock.
Bergantian, Anda dapat mencoba model Amazon Nova tanpa memasukkan Amazon Bedrock. [https://nova.amazon.com](https://nova.amazon.com/chat)
Pilih topik untuk memulai menggunakan Amazon Nova dengan metode itu.
**Topics**
+ [Memulai dengan Amazon Nova di konsol Amazon Bedrock](getting-started-console.md)
+ [Memulai dengan API](getting-started-api.md)
# Memulai dengan Amazon Nova di konsol Amazon Bedrock
**catatan**
Dokumentasi ini untuk Amazon Nova Versi 1. Amazon Nova 2 sekarang tersedia dengan model baru dan kemampuan yang ditingkatkan. Untuk informasi tentang cara memulai Amazon Nova 2, kunjungi [Memulai Amazon Nova 2 di konsol Amazon Bedrock](https://docs.aws.amazon.com/nova/latest/nova2-userguide/getting-started-console.html).
Bagian ini menjelaskan cara menggunakan taman bermain di AWS konsol untuk mengirimkan prompt teks ke model Amazon Nova dan menghasilkan respons teks atau gambar. Sebelum Anda menjalankan contoh berikut, Anda harus memeriksa apakah Anda telah memenuhi prasyarat berikut:
**Prasyarat**
+ Anda memiliki Akun AWS dan memiliki izin untuk mengakses peran di akun itu dengan izin yang diperlukan untuk Amazon Bedrock. Jika tidak, ikuti langkah-langkah di [Memulai dengan Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/getting-started.html).
+ Anda telah meminta akses ke model Amazon Nova. Jika tidak, ikuti langkah-langkah di [Minta akses ke model yayasan Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/getting-started.html#getting-started-model-access) dan minta akses ke **Amazon Nova Lite dan Amazon Nova** **Canvas**.
+ Anda berada di Wilayah AS Timur (Virginia Utara) (us-east-1). Untuk mengubah wilayah, pilih nama Wilayah di kanan atas konsol, di samping peran IAM Anda. Kemudian pilih US East (Virginia N.) (us-east-1).
**Topics**
+ [Meminta akses model](#getting-started-access)
+ [Jelajahi taman bermain teks](#getting-started-text)
+ [Jelajahi taman bermain gambar](#getting-started-image)
## Meminta akses model
Selesaikan langkah-langkah berikut untuk meminta akses ke model Amazon Nova.
1. Buka konsol Amazon Bedrock di [https://console.aws.amazon.com/bedrock/](https://console.aws.amazon.com/bedrock/).
1. Dari panel navigasi kiri, pilih **Akses model** di bawah Konfigurasi **batuan dasar**.
1. Di **Apa itu akses model**, pilih **Aktifkan model tertentu**.
1. Pilih **Nova Lite** dan **Nova Canvas** dari daftar **model Base**. Contoh di bagian ini hanya menggunakan dua model ini, tetapi Anda dapat meminta akses ke semua model Amazon Nova. Lalu pilih **Selanjutnya**
1. Pada halaman **Review dan submit**, pilih **Submit**.
1. Segarkan tabel **model Dasar**. Jika Anda akan melihat model Amazon Nova dalam status **Akses yang diberikan**, Anda siap untuk melanjutkan ke bagian berikutnya dari contoh.
Perhatikan bahwa wilayah tempat Anda meminta akses model adalah satu-satunya wilayah tempat Anda dapat menggunakan model.
## Jelajahi taman bermain teks
Contoh berikut menunjukkan bagaimana menggunakan taman bermain teks:
1. Buka konsol Amazon Bedrock di [https://console.aws.amazon.com/bedrock/](https://console.aws.amazon.com/bedrock/).
1. Dari panel navigasi kiri, pilih **Obrolan/Teks** di bawah **Taman Bermain**.
1. Pilih **Pilih model** dan pilih penyedia dan model. Untuk contoh ini, **Amazon**pilih **Nova Lite**. Kemudian pilih **Terapkan**
1. Pilih prompt default dari bawah panel teks, atau masukkan prompt ke panel teks, seperti**Describe the purpose of a "hello world" program in one line**.
1. Untuk menjelajahi kemampuan pemahaman gambar Amazon Nova, Anda dapat mengunggah gambar dalam format JPEG, PNG, GIF, atau WEBP yang kurang dari atau sama dengan 25 MB dari komputer Anda. Setelah gambar diunggah, Anda dapat bertanya kepada Amazon Nova tentang gambar tersebut.
1. Untuk menjelajahi kemampuan pemahaman dokumen Amazon Nova, Anda dapat mengunggah dokumen dalam format CSV, DOC, DOCX, HTML, MD, PDF, TXT, XLS, atau XLSX yang kurang dari atau sama dengan 4,5 MB. Setelah dokumen diunggah, Anda dapat bertanya kepada Amazon Nova tentang dokumen tersebut.
1. Untuk menjelajahi kemampuan pemahaman video Amazon Nova, Anda dapat mengunggah satu video dalam MKV, MOV, atau MP4 format yang kurang dari atau sama dengan 25 MB dari komputer Anda. Anda dapat menggunakan Amazon S3 untuk video hingga 1 GB. Setelah video diunggah, Anda dapat bertanya kepada Amazon Nova tentang video tersebut.
1. Pilih **Jalankan** untuk menjalankan inferensi pada model. Teks yang dihasilkan muncul di bawah prompt Anda di panel teks.
## Jelajahi taman bermain gambar
Contoh berikut menunjukkan bagaimana menggunakan taman bermain gambar.
1. Buka konsol Amazon Bedrock di [https://console.aws.amazon.com/bedrock/](https://console.aws.amazon.com/bedrock/).
1. Dari panel navigasi kiri, pilih **Gambar/Video** di bawah **Taman Bermain**.
1. Pilih **Pilih model** dan pilih penyedia dan model. Untuk contoh ini, pilih **Amazon**lalu pilih **Nova Canvas**. Kemudian pilih **Terapkan**
1. Pilih prompt default dari bawah panel teks, atau masukkan prompt ke panel teks, seperti**Generate an image of happy cats**.
1. Di panel **Konfigurasi**, ubah **Jumlah gambar menjadi**. **1**
1. Pilih **Jalankan** untuk menjalankan inferensi pada model. Gambar yang dihasilkan muncul di atas prompt.
# Memulai dengan API
**catatan**
Dokumentasi ini untuk Amazon Nova Versi 1. Amazon Nova 2 sekarang tersedia dengan model baru dan kemampuan yang ditingkatkan. Untuk informasi tentang cara memulai Amazon Nova 2, kunjungi [Memulai dengan API](https://docs.aws.amazon.com/nova/latest/nova2-userguide/getting-started-api.html).
Untuk memulai dengan API, Anda memerlukan kredensil untuk memberikan akses terprogram. Jika bagian berikut berkaitan dengan Anda, perluas dan ikuti instruksinya. Jika tidak, lanjutkan melalui bagian yang tersisa.
## Saya baru AWS
Jika Anda tidak memiliki Akun AWS, selesaikan langkah-langkah berikut untuk membuatnya.
**Untuk mendaftar untuk Akun AWS**
1. Buka [https://portal.aws.amazon.com/billing/pendaftaran.](https://portal.aws.amazon.com/billing/signup)
1. 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 sebuah Akun AWS, sebuah *Pengguna root akun AWS*dibuat. Pengguna root memiliki akses ke semua Layanan AWS dan sumber daya di akun. Sebagai praktik keamanan terbaik, tetapkan akses administratif ke pengguna, dan gunakan hanya pengguna root untuk melakukan [tugas yang memerlukan akses pengguna root](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks).
AWS mengirimkan email konfirmasi setelah proses pendaftaran selesai. Kapan saja, Anda dapat melihat aktivitas akun Anda saat ini dan mengelola akun Anda dengan masuk [https://aws.amazon.com.rproxy.goskope.comke/](https://aws.amazon.com/) dan memilih **Akun Saya**.
**Amankan Anda Pengguna root akun AWS**
1. Masuk ke [Konsol Manajemen AWS](https://console.aws.amazon.com/)sebagai pemilik akun dengan memilih **pengguna Root** dan memasukkan alamat Akun AWS email Anda. Di laman berikutnya, masukkan kata sandi.
Untuk bantuan masuk dengan menggunakan pengguna root, lihat [Masuk sebagai pengguna root](https://docs.aws.amazon.com/signin/latest/userguide/console-sign-in-tutorials.html#introduction-to-root-user-sign-in-tutorial) di *AWS Sign-In Panduan Pengguna*.
1. Mengaktifkan autentikasi multi-faktor (MFA) untuk pengguna root Anda.
Untuk petunjuk, lihat [Mengaktifkan perangkat MFA virtual untuk pengguna Akun AWS root (konsol) Anda](https://docs.aws.amazon.com/IAM/latest/UserGuide/enable-virt-mfa-for-root.html) di Panduan Pengguna *IAM*.
## Saya perlu menginstal AWS CLI atau AWS SDK
Untuk menginstal AWS CLI, ikuti langkah-langkah di [Instal atau perbarui ke versi terbaru AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html).
Untuk menginstal AWS SDK, pilih tab yang sesuai dengan bahasa pemrograman yang ingin Anda gunakan di [Tools to Build on AWS](https://aws.amazon.com/developer/tools/). AWS kit pengembangan perangkat lunak (SDKs) tersedia untuk banyak bahasa pemrograman populer. Setiap SDK menyediakan API, contoh kode, dan dokumentasi yang memudahkan pengembang untuk membangun aplikasi dalam bahasa pilihan mereka. SDKs secara otomatis melakukan tugas-tugas yang berguna untuk Anda, seperti:
+ Tanda tangani permintaan layanan Anda secara kriptografis
+ Coba lagi permintaan
+ Menangani tanggapan kesalahan
## Dapatkan kredensil untuk memberikan akses terprogram
Pengguna membutuhkan akses terprogram jika mereka ingin berinteraksi dengan AWS luar. Konsol Manajemen AWS 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 kredensyal jangka panjang untuk menandatangani permintaan terprogram ke AWS CLI,, AWS SDKs atau. AWS APIs | Mengikuti petunjuk untuk antarmuka yang ingin Anda gunakan. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/nova/latest/userguide/getting-started-api.html) |
| Peran IAM | Gunakan kredensyal sementara untuk menandatangani permintaan terprogram ke AWS CLI,, AWS SDKs atau. AWS APIs | Mengikuti petunjuk dalam [Menggunakan kredensyal sementara dengan AWS sumber daya](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html) di Panduan Pengguna IAM. |
| Identitas tenaga kerja (Pengguna yang dikelola di Pusat Identitas IAM) | Gunakan kredensyal sementara untuk menandatangani permintaan terprogram ke AWS CLI,, AWS SDKs atau. AWS APIs | Mengikuti petunjuk untuk antarmuka yang ingin Anda gunakan. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/nova/latest/userguide/getting-started-api.html) |
## Cara mengkonfigurasi kunci akses untuk pengguna IAM
Jika Anda memutuskan untuk menggunakan kunci akses untuk pengguna IAM, AWS sarankan Anda menetapkan kedaluwarsa untuk pengguna IAM dengan menyertakan kebijakan sebaris yang membatasi.
**penting**
Mengindahkan peringatan berikut:
**JANGAN** gunakan kredensi root akun Anda untuk mengakses AWS sumber daya. Kredensi ini menyediakan akses akun yang tidak terbatas dan sulit dicabut.
**JANGAN** menaruh kunci akses literal atau informasi kredensi dalam file aplikasi Anda. Jika Anda melakukannya, Anda membuat risiko secara tidak sengaja mengekspos kredensyal Anda jika, misalnya, Anda mengunggah proyek ke repositori publik.
**JANGAN** sertakan file yang berisi kredensil di area proyek Anda.
Kelola kunci akses Anda dengan aman. Jangan berikan kunci akses Anda kepada pihak yang tidak berwenang, bahkan untuk membantu [menemukan pengenal akun Anda](https://docs.aws.amazon.com/general/latest/gr/acct-identifiers.html). Dengan melakukan tindakan ini, Anda mungkin memberi seseorang akses permanen ke akun Anda.
Ketahuilah bahwa kredenal apa pun yang disimpan dalam file AWS kredensial bersama disimpan dalam teks biasa.
Untuk detail selengkapnya, lihat [Praktik terbaik untuk mengelola kunci AWS akses](https://docs.aws.amazon.com/general/latest/gr/aws-access-keys-best-practices.html) di Referensi Umum AWS.
**Mmebuat pengguna IAM**
1. Di halaman Konsol Manajemen AWS Beranda, pilih layanan IAM atau navigasikan ke konsol IAM di. [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)
1. Di panel navigasi, pilih **Pengguna** dan kemudian pilih **Buat pengguna**.
1. Ikuti panduan di konsol IAM untuk mengatur pengguna terprogram (tanpa akses ke Konsol Manajemen AWS) dan tanpa izin.
**Batasi akses pengguna ke jendela waktu terbatas**
Kunci akses pengguna IAM apa pun yang Anda buat adalah kredensi jangka panjang. Untuk memastikan bahwa kredensyal ini kedaluwarsa jika salah penanganan, Anda dapat membuat kredensyal ini terikat waktu dengan membuat kebijakan inline yang menentukan tanggal setelah kunci tidak lagi valid.
1. Buka pengguna IAM yang baru saja Anda buat. Di tab **Izin**, pilih **Tambahkan izin**, lalu pilih **Buat kebijakan sebaris**.
1. Di editor JSON, tentukan izin berikut. Untuk menggunakan kebijakan ini, ganti nilai untuk nilai `aws:CurrentTime` stempel waktu dalam kebijakan contoh dengan tanggal akhir Anda sendiri.
**catatan**
IAM merekomendasikan agar Anda membatasi kunci akses Anda hingga 12 jam.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Deny",
"Action": "*",
"Resource": "*",
"Condition": {
"DateGreaterThan": {
"aws:CurrentTime": "2024-01-01T00:00:00Z"
}
}
}
]
}
```
------
**Buat kunci akses**
1. Pada halaman **Detail pengguna**, pilih tab **Security credentials.** Pada bagian **Access key**, pilih **Buat access key**.
1. Tunjukkan bahwa Anda berencana untuk menggunakan tombol akses ini sebagai **Lainnya** dan pilih **Buat kunci akses**.
1. Pada halaman **Retrieve access key**, pilih **Tampilkan** untuk mengungkapkan nilai kunci akses rahasia pengguna Anda. Anda dapat menyalin kredensialnya atau mengunduh file.csv.
**penting**
Ketika Anda tidak lagi membutuhkan pengguna IAM ini, kami sarankan Anda menghapusnya dan menyelaraskan dengan [praktik terbaik AWS keamanan](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#lock-away-credentials), kami sarankan Anda meminta pengguna manusia Anda untuk menggunakan kredensil sementara melalui [AWS IAM Identity](https://docs.aws.amazon.com/singlesignon/latest/userguide/getting-started.html) Center saat mengakses. AWS
## Lampirkan izin Amazon Bedrock ke pengguna atau peran
Setelah menyiapkan kredensyal untuk akses terprogram, Anda perlu mengonfigurasi izin untuk peran pengguna atau IAM agar dapat mengakses serangkaian tindakan terkait Amazon Bedrock. Untuk mengatur izin ini, lakukan hal berikut:
1. Di halaman Konsol Manajemen AWS Beranda, pilih layanan IAM atau navigasikan ke konsol IAM di. [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)
1. Pilih **Pengguna** atau **Peran** lalu pilih pengguna atau peran Anda.
1. Di tab **Izin**, pilih **Tambahkan izin**, lalu pilih **Tambahkan kebijakan AWS terkelola**. Pilih kebijakan [AmazonBedrockFullAccess]() AWS terkelola.
1. Untuk mengizinkan pengguna atau peran berlangganan model, pilih **Buat kebijakan sebaris** lalu tentukan izin berikut di editor JSON:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "MarketplaceBedrock",
"Effect": "Allow",
"Action": [
"aws-marketplace:ViewSubscriptions",
"aws-marketplace:Unsubscribe",
"aws-marketplace:Subscribe"
],
"Resource": "*"
}
]
}
```
------
## Minta akses ke model Amazon Nova
Minta akses ke model Amazon Nova melalui konsol Amazon Bedrock dengan mengikuti langkah-langkah di [Minta akses ke model fondasi Amazon Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/getting-started.html#getting-started-model-access).
## Hasilkan respons untuk prompt teks menggunakan model Amazon Nova
Setelah Anda memenuhi semua prasyarat, pilih tab untuk menguji membuat permintaan pemanggilan model ke model Amazon Nova dengan permintaan Converse dan menggunakan [metode yang](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) ditentukan di tab:
------
#### [ AWS CLI ]
Untuk menginstal AWS CLI, ikuti langkah-langkah di [Instal atau perbarui ke versi terbaru AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html). Verifikasi bahwa Anda telah menyiapkan kredensil Anda untuk menggunakan Boto3 dengan mengikuti langkah-langkah di. [Dapatkan kredensil untuk memberikan akses terprogram](#grant-program-access)
Untuk menghasilkan respons untuk prompt teks di Amazon Nova Lite dengan menggunakan AWS CLI, jalankan perintah berikut di terminal:
```
aws bedrock-runtime converse \
--model-id us.amazon.nova-lite-v1:0 \
--messages '[{"role": "user", "content": [{"text": "Write a short poem"}]}]'
```
------
#### [ Python (Boto3) ]
Untuk menginstal Boto3, ikuti langkah-langkah di [Quickstart](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html) dalam dokumentasi Boto3. Verifikasi bahwa Anda telah menyiapkan kredensil Anda untuk menggunakan Boto3 dengan mengikuti langkah-langkah di. [Dapatkan kredensil untuk memberikan akses terprogram](#grant-program-access)
Untuk membuat klien Amazon Bedrock Runtime dan menghasilkan respons untuk prompt teks di Amazon Nova Lite dengan menggunakan Python SDK (Boto3), jalankan skrip Python berikut:
```
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 Untuk menginstal AWS, ikuti langkah-langkah di [AWS](https://python.langchain.com/docs/integrations/providers/aws/)dalam LangChain dokumentasi. Verifikasi bahwa Anda telah menyiapkan kredensil Anda untuk menggunakan Boto3 dengan mengikuti langkah-langkah di. [Dapatkan kredensil untuk memberikan akses terprogram](#grant-program-access)
Untuk menghasilkan respons untuk prompt teks di Amazon Nova Lite dengan menggunakan LangChain, jalankan skrip berikut:
```
from langchain_aws import ChatBedrockConverse
llm = ChatBedrockConverse(model="us.amazon.nova-lite-v1:0")
messages = [
("user", "Write a short poem")
]
llm.invoke(messages)
```
------
Setelah Anda membiasakan diri dengan Amazon Nova, Anda dapat melanjutkan ke tugas yang lebih maju:
1. Coba minta model untuk mendeskripsikan gambar atau video. Untuk informasi selengkapnya, lihat [Dukungan multimodal untuk Amazon Nova](modalities.md).
1. Coba buat gambar menggunakan Amazon Nova Canvas. Untuk informasi selengkapnya, lihat [Menghasilkan gambar dengan Amazon Nova Canvas](image-generation.md).
1. Coba buat video menggunakan Amazon Nova Reel. Untuk informasi selengkapnya, lihat [Menghasilkan video dengan Amazon Nova Reel](video-generation.md).
1. Kirim model dokumen dan tanyakan tentang kontennya. Untuk informasi selengkapnya, lihat [Pemahaman dokumen](modalities-document.md).
1. Berikan model dengan alat dan buat permintaan dengan prompt untuk melihatnya menggunakan alat. Untuk informasi selengkapnya, lihat [Penggunaan alat (panggilan fungsi) dengan Amazon Nova](tool-use.md).