Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Buat dan simpan petunjuk yang dapat digunakan kembali dengan manajemen Prompt di Amazon Bedrock
Amazon Bedrock memberi Anda kemampuan untuk membuat dan menyimpan prompt Anda sendiri menggunakan manajemen Prompt sehingga Anda dapat menghemat waktu dengan menerapkan prompt yang sama ke alur kerja yang berbeda. Saat Anda membuat prompt, Anda dapat memilih model untuk menjalankan inferensi di atasnya dan memodifikasi parameter inferensi yang akan digunakan. Anda dapat menyertakan variabel dalam prompt sehingga Anda dapat menyesuaikan prompt untuk kasus penggunaan yang berbeda.
Saat menguji prompt, Anda memiliki opsi untuk membandingkan varian prompt yang berbeda dan memilih varian yang menghasilkan output yang paling cocok untuk kasus penggunaan Anda. Saat melakukan iterasi pada prompt Anda, Anda dapat menyimpan versinya. Anda mengintegrasikan prompt ke dalam aplikasi Anda dengan bantuan [Amazon Bedrock Flows](flows.md).
Berikut ini adalah alur kerja umum untuk menggunakan manajemen Prompt:
1. Buat prompt dalam manajemen Prompt yang ingin Anda gunakan kembali di berbagai kasus penggunaan. Sertakan variabel untuk memberikan fleksibilitas dalam prompt model.
1. Pilih model, profil inferensi, atau agen untuk menjalankan inferensi pada prompt dan memodifikasi konfigurasi inferensi seperlunya.
1. Isi nilai uji untuk variabel dan jalankan prompt. Anda dapat membuat varian prompt Anda dan membandingkan output dari varian yang berbeda untuk memilih yang terbaik untuk kasus penggunaan Anda.
1. Integrasikan prompt ke dalam aplikasi Anda dengan salah satu cara berikut:
+ Tentukan prompt saat [menjalankan inferensi model](inference.md).
+ Tambahkan simpul prompt ke [aliran](flows.md) dan tentukan prompt.
**Topics**
+ [Definisi kunci](#prompt-management-definitions)
+ [Wilayah dan model yang Didukung untuk manajemen Prompt](prompt-management-supported.md)
+ [Prasyarat untuk manajemen yang cepat](prompt-management-prereq.md)
+ [Buat prompt menggunakan manajemen Prompt](prompt-management-create.md)
+ [Melihat informasi tentang petunjuk menggunakan manajemen Prompt](prompt-management-view.md)
+ [Ubah prompt menggunakan manajemen Prompt](prompt-management-modify.md)
+ [Uji prompt menggunakan manajemen Prompt](prompt-management-test.md)
+ [Optimalkan prompt](prompt-management-optimize.md)
+ [Menerapkan prompt ke aplikasi Anda menggunakan versi dalam manajemen Prompt](prompt-management-deploy.md)
+ [Hapus prompt dalam manajemen Prompt](prompt-management-delete.md)
+ [Jalankan contoh kode manajemen Prompt](prompt-management-code-ex.md)
## Definisi kunci
Daftar berikut memperkenalkan Anda pada konsep dasar manajemen Prompt:
+ **Prompt** — Masukan yang diberikan kepada model untuk membimbingnya menghasilkan respons atau output yang sesuai.
+ **Variabel** - Placeholder yang dapat Anda sertakan dalam prompt. Anda dapat menyertakan nilai untuk setiap variabel saat menguji prompt atau saat Anda memanggil model saat runtime.
+ **Varian prompt** — Konfigurasi alternatif prompt, termasuk pesannya atau konfigurasi model atau inferensi yang digunakan. Anda dapat membuat varian prompt yang berbeda, mengujinya, dan menyimpan varian yang ingin Anda simpan.
+ **Prompt builder** — Alat di konsol Amazon Bedrock yang memungkinkan Anda membuat, mengedit, dan menguji prompt dan variannya dalam antarmuka visual.
# Wilayah dan model yang Didukung untuk manajemen Prompt
Manajemen yang cepat didukung sebagai berikutWilayah AWS:
+ ap-northeast-1
+ ap-northeast-2
+ ap-northeast-3
+ ap-south-1
+ ap-south-2
+ ap-southeast-1
+ ap-southeast-2
+ ca-sentral-1
+ eu-central-1
+ eu-central-2
+ eu-north-1
+ eu-south-1
+ eu-south-2
+ eu-west-1
+ eu-west-2
+ eu-west-3
+ sa-east-1
+ us-east-1
+ us-east-2
+ us-gov-east-1
+ us-gov-west-1
+ us-west-2
Anda dapat menggunakan manajemen Prompt dengan model teks apa pun yang didukung untuk [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) API. Untuk daftar model yang didukung, lihat[Model dan fitur model yang didukung](conversation-inference-supported-models-features.md).
**catatan**
[InvokeModel](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModel.html)dan [InvokeModelWithResponseStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithResponseStream.html)hanya bekerja pada prompt dari manajemen Prompt yang konfigurasinya menentukan model Anthropic Claude atau MetaLlama.
# Prasyarat untuk manajemen yang cepat
Agar peran menggunakan manajemen prompt, Anda harus mengizinkannya melakukan serangkaian tindakan API tertentu. Tinjau prasyarat berikut dan penuhi prasyarat yang berlaku untuk kasus penggunaan Anda:
1. Jika peran Anda memiliki kebijakan [AmazonBedrockFullAccess](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonBedrockFullAccess)AWSterkelola yang dilampirkan, Anda dapat melewati bagian ini. Jika tidak, ikuti langkah-langkah di [Memperbarui kebijakan izin untuk peran](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_update-role-permissions.html#id_roles_update-role-permissions-policy) dan lampirkan kebijakan berikut ke peran untuk memberikan izin untuk melakukan tindakan yang terkait dengan manajemen Prompt:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "PromptManagementPermissions",
"Effect": "Allow",
"Action": [
"bedrock:CreatePrompt",
"bedrock:UpdatePrompt",
"bedrock:GetPrompt",
"bedrock:ListPrompts",
"bedrock:DeletePrompt",
"bedrock:CreatePromptVersion",
"bedrock:OptimizePrompt",
"bedrock:GetFoundationModel",
"bedrock:ListFoundationModels",
"bedrock:GetInferenceProfile",
"bedrock:ListInferenceProfiles",
"bedrock:InvokeModel",
"bedrock:InvokeModelWithResponseStream",
"bedrock:RenderPrompt",
"bedrock:TagResource",
"bedrock:UntagResource",
"bedrock:ListTagsForResource"
],
"Resource": "*"
}
]
}
```
------
Untuk membatasi izin lebih lanjut, Anda dapat menghilangkan tindakan, atau Anda dapat menentukan sumber daya dan kunci kondisi yang digunakan untuk memfilter izin. Untuk informasi selengkapnya tentang tindakan, sumber daya, dan kunci kondisi, lihat topik berikut di *Referensi Otorisasi Layanan*:
+ [Tindakan yang ditentukan oleh Amazon Bedrock](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonbedrock.html#amazonbedrock-actions-as-permissions) — Pelajari tentang tindakan, jenis sumber daya yang dapat Anda cakupannya di `Resource` bidang, dan kunci kondisi tempat Anda dapat memfilter izin di `Condition` bidang.
+ [Jenis sumber daya yang ditentukan oleh Amazon Bedrock](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonbedrock.html#amazonbedrock-resources-for-iam-policies) — Pelajari tentang jenis sumber daya di Amazon Bedrock.
+ [Kunci kondisi untuk Amazon Bedrock](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonbedrock.html#amazonbedrock-policy-keys) - Pelajari tentang kunci kondisi di Amazon Bedrock.
**catatan**
Jika Anda berencana untuk menerapkan prompt menggunakan [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) API, lihat [Prasyarat untuk menjalankan inferensi model](inference-prereq.md) untuk mempelajari tentang izin yang harus Anda atur untuk memanggil prompt.
Jika Anda berencana untuk menggunakan [alur](flows.md) di Amazon Bedrock Flows untuk menerapkan prompt Anda, lihat [Prasyarat untuk Amazon Bedrock Flows](flows-prereq.md) untuk mempelajari tentang izin yang harus Anda atur untuk membuat alur.
1. Jika Anda berencana untuk mengenkripsi prompt Anda dengan kunci yang dikelola pelanggan daripada menggunakan Kunci yang dikelola AWS (untuk informasi selengkapnya, lihat [AWS KMSkunci](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html)), buat kebijakan berikut:
1. Ikuti langkah-langkah di [Membuat kebijakan kunci dan lampirkan kebijakan](https://docs.aws.amazon.com/kms/latest/developerguide/key-policy-overview.html) kunci berikut ke kunci KMS untuk memungkinkan Amazon Bedrock mengenkripsi dan mendekripsi prompt dengan kunci, menggantikan yang diperlukan. *values* Kebijakan ini berisi kunci kondisi opsional (lihat [Kunci kondisi untuk Amazon Bedrock](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonbedrock.html#amazonbedrock-policy-keys) dan [kunci konteks kondisi AWS global](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonbedrock.html#amazonbedrock-policy-keys)) di `Condition` bidang yang kami sarankan Anda gunakan sebagai praktik terbaik keamanan.
```
{
"Sid": "EncryptFlowKMS",
"Effect": "Allow",
"Principal": {
"Service": "bedrock.amazonaws.com"
},
"Action": [
"kms:GenerateDataKey",
"kms:Decrypt"
],
"Resource": "*",
"Condition": {
"StringEquals": {
"kms:EncryptionContext:aws:bedrock-prompts:arn": "arn:${partition}:bedrock:${region}:${account-id}:prompt/${prompt-id}"
}
}
}
```
1. Ikuti langkah-langkah di [Perbarui kebijakan izin untuk peran](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_update-role-permissions.html#id_roles_update-role-permissions-policy) dan lampirkan kebijakan berikut ke peran manajemen prompt, ganti yang diperlukan, untuk memungkinkannya menghasilkan dan mendekripsi kunci terkelola pelanggan untuk prompt. *values* Kebijakan ini berisi kunci kondisi opsional (lihat [Kunci kondisi untuk Amazon Bedrock](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonbedrock.html#amazonbedrock-policy-keys) dan [kunci konteks kondisi AWS global](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonbedrock.html#amazonbedrock-policy-keys)) di `Condition` bidang yang kami sarankan Anda gunakan sebagai praktik terbaik keamanan.
```
{
"Sid": "KMSPermissions",
"Effect": "Allow",
"Action": [
"kms:GenerateDataKey",
"kms:Decrypt"
],
"Resource": [
"arn:aws:kms:${region}:${account-id}:key/${key-id}"
],
"Condition": {
"StringEquals": {
"aws:ResourceAccount": "${account-id}"
}
}
}
```
# Buat prompt menggunakan manajemen Prompt
Saat Anda membuat prompt, Anda memiliki opsi berikut:
+ Tulis pesan prompt yang berfungsi sebagai input untuk FM untuk menghasilkan output.
+ Gunakan tanda kurung kurawal ganda untuk menyertakan variabel (seperti dalam*\$1\$1variable\$1\$1*) dalam pesan prompt yang dapat diisi saat Anda memanggil prompt.
+ Pilih model yang dapat digunakan untuk memanggil prompt atau, jika Anda berencana untuk menggunakan prompt dengan agen, biarkan tidak ditentukan. Jika Anda memilih model, Anda juga dapat memodifikasi konfigurasi inferensi yang akan digunakan. Untuk melihat parameter inferensi untuk model yang berbeda, lihat[Parameter permintaan inferensi dan bidang respons untuk model dasar](model-parameters.md).
Semua *prompt *mendukung parameter inferensi dasar berikut:
+ **maxTokens** – Jumlah maksimum token yang diizinkan dalam respons yang dihasilkan.
+ **StopSequences** — Daftar urutan berhenti. *Stop sequence *adalah rangkaian karakter yang menyebabkan model berhenti menghasilkan respons.
+ **temperature** – Kemungkinan model memilih opsi dengan probabilitas lebih tinggi saat menghasilkan respons.
+ **topP** – Persentase kandidat yang paling memungkinkan yang dipertimbangkan model untuk token berikutnya.
Jika model mendukung parameter inferensi tambahan, Anda dapat menentukannya sebagai *bidang tambahan* untuk prompt Anda. Anda menyediakan bidang tambahan dalam objek JSON. Contoh berikut ini menunjukkan cara mengatur `top_k`, yang tersedia dalam model Anthropic Claude, tetapi bukan parameter inferensi dasar.
```
{
"top_k": 200
}
```
Untuk informasi tentang parameter inferensi model, lihat [Parameter permintaan inferensi dan bidang respons untuk model fondasi](https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters.html).
Mengatur parameter inferensi dasar sebagai bidang tambahan tidak mengesampingkan nilai yang Anda tetapkan di konsol.
Jika model yang Anda pilih untuk prompt mendukung [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) API (untuk informasi selengkapnya, lihat[Melakukan percakapan dengan operasi Converse API](conversation-inference.md)), Anda dapat menyertakan yang berikut ini saat membuat prompt:
+ Prompt sistem untuk memberikan instruksi atau konteks pada model.
+ Permintaan sebelumnya (pesan pengguna) dan respons model (pesan asisten) sebagai riwayat percakapan untuk dipertimbangkan model saat menghasilkan respons untuk pesan pengguna akhir.
+ (Jika didukung oleh model) [Alat](tool-use.md) untuk model yang akan digunakan saat menghasilkan respons.
+ (Jika didukung oleh model) Gunakan [caching Prompt untuk mengurangi biaya dengan menyimpan prompt](prompt-caching.md) besar atau sering digunakan. Bergantung pada modelnya, Anda dapat menyimpan instruksi, alat, dan pesan sistem cache (pengguna dan asisten). Caching prompt membuat pos pemeriksaan cache untuk prompt jika awalan prompt total Anda memenuhi jumlah minimum token yang dibutuhkan model. Ketika variabel yang diubah ditemui dalam prompt, caching prompt membuat pos pemeriksaan cache baru (jika jumlah token input mencapai minimum yang dibutuhkan model).
Untuk mempelajari cara membuat prompt menggunakan manajemen Prompt, pilih tab untuk metode pilihan Anda, lalu ikuti langkah-langkahnya:
------
#### [ Console ]
**Untuk membuat prompt**
1. Masuk ke Konsol Manajemen AWS dengan identitas IAM yang memiliki izin untuk menggunakan konsol Amazon Bedrock. Kemudian, buka konsol Amazon Bedrock di [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock).
1. Pilih **Manajemen Prompt** dari panel navigasi kiri. Kemudian, pilih **Create prompt**.
1. Berikan nama untuk prompt dan deskripsi opsional.
1. Untuk mengenkripsi prompt Anda dengan kunci yang dikelola pelanggan, pilih **Sesuaikan pengaturan enkripsi (lanjutan)** di bagian **pemilihan kunci KMS**. Jika Anda menghilangkan bidang ini, prompt Anda akan dienkripsi dengan file. Kunci yang dikelola AWS Untuk informasi selengkapnya, lihat [AWS KMS kunci](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html).
1. Pilih **Buat prompt**. Prompt Anda dibuat dan Anda akan dibawa ke **pembuat Prompt untuk prompt** yang baru dibuat, di mana Anda dapat mengonfigurasi prompt Anda.
1. Anda dapat melanjutkan ke prosedur berikut untuk mengonfigurasi prompt Anda atau kembali ke pembuat prompt nanti.
**Untuk mengonfigurasi prompt Anda**
1. Jika Anda belum berada di pembuat prompt, lakukan hal berikut:
1. Masuk ke Konsol Manajemen AWS dengan identitas IAM yang memiliki izin untuk menggunakan konsol Amazon Bedrock. Kemudian, buka konsol Amazon Bedrock di [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock).
1. Pilih **Manajemen Prompt** dari panel navigasi kiri. Kemudian, pilih prompt di bagian **Prompts**.
1. Di bagian **Prompt draft**, pilih **Edit di pembangun prompt**.
1. Gunakan panel **Prompt** untuk membuat prompt. Masukkan prompt di kotak **pesan Pengguna** terakhir. Jika model mendukung API [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) atau [API AnthropicClaude Pesan](model-parameters-anthropic-claude-messages.md), Anda juga dapat menyertakan **prompt Sistem** dan **pesan Pengguna sebelumnya serta pesan** **Asisten** untuk konteks.
Saat Anda menulis prompt, Anda dapat menyertakan variabel dalam kurung kurawal ganda (seperti dalam*\$1\$1variable\$1\$1*). Setiap variabel yang Anda sertakan muncul di bagian **Variabel uji**.
1. (Opsional) Anda dapat memodifikasi prompt Anda dengan cara berikut:
+ Di panel **Konfigurasi**, lakukan hal berikut:
1. Pilih **sumber daya AI Generatif** untuk menjalankan inferensi.
**catatan**
Jika Anda memilih agen, Anda hanya dapat menguji prompt di konsol. Untuk mempelajari cara menguji prompt dengan agen di API, lihat[Uji prompt menggunakan manajemen Prompt](prompt-management-test.md).
1. Dalam **parameter Inferensi atur parameter** inferensi yang ingin Anda gunakan.
1. Jika model mendukung [penalaran](inference-reasoning.md), aktifkan Penalaran untuk memasukkan **penalaran** model dalam responsnya. Dalam **Reasoning token**, Anda dapat mengonfigurasi jumlah token penalaran yang dapat digunakan model.
1. Di **bidang permintaan model tambahan**, pilih **Konfigurasi** untuk menentukan parameter inferensi tambahan, di luar parameter **Inferensi**.
1. Jika model yang Anda pilih mendukung alat, pilih **Konfigurasi alat** untuk menggunakan alat dengan prompt.
1. Jika model yang Anda pilih mendukung [caching prompt](prompt-caching.md), pilih salah satu opsi berikut (ketersediaan bervariasi menurut model):
+ **Tidak ada** - Tidak ada caching prompt yang dilakukan.
+ **Alat** - Hanya alat dalam prompt yang di-cache.
+ **Alat, instruksi sistem** — Alat dan instruksi sistem dalam prompt di-cache.
+ **Alat, instruksi sistem, dan pesan** — Alat, instruksi sistem, dan pesan (pengguna dan asisten) dalam prompt di-cache.
+ Untuk membandingkan berbagai varian prompt Anda, pilih **Bandingkan varian**. Anda dapat melakukan hal berikut di halaman perbandingan:
+ Untuk menambahkan varian, pilih tanda plus. Anda dapat menambahkan hingga tiga varian.
+ Setelah Anda menentukan detail varian, Anda dapat menentukan **variabel Uji** apa pun dan memilih **Jalankan** untuk menguji output varian.
+ Untuk menghapus varian, pilih tiga titik dan pilih **Hapus dari bandingkan**.
+ Untuk mengganti draf kerja dan meninggalkan mode perbandingan, pilih **Simpan sebagai konsep**. Semua varian lainnya akan dihapus.
+ Untuk meninggalkan mode perbandingan, pilih **Keluar dari mode perbandingan**.
1. Anda memiliki opsi berikut ketika Anda selesai mengonfigurasi prompt:
+ Untuk menyimpan prompt Anda, pilih **Simpan draf**. Untuk informasi selengkapnya tentang versi draf, lihat[Menerapkan prompt ke aplikasi Anda menggunakan versi dalam manajemen Prompt](prompt-management-deploy.md).
+ Untuk menghapus prompt Anda, pilih **Hapus**. Untuk informasi selengkapnya, lihat [Hapus prompt dalam manajemen Prompt](prompt-management-delete.md).
+ Untuk membuat versi prompt Anda, pilih **Buat versi**. Untuk informasi selengkapnya tentang pembuatan versi cepat, lihat. [Menerapkan prompt ke aplikasi Anda menggunakan versi dalam manajemen Prompt](prompt-management-deploy.md)
------
#### [ API ]
Untuk membuat prompt, kirim [CreatePrompt](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreatePrompt.html)permintaan dengan titik akhir waktu [pembuatan Agen untuk Amazon Bedrock.](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)
Bidang berikut diperlukan:
****
| Bidang | Deskripsi singkat |
| --- | --- |
| name | Sebuah nama untuk prompt. |
| varian | Daftar konfigurasi yang berbeda untuk prompt (lihat di bawah). |
| DefaultVariant | Nama varian default. |
Setiap varian dalam `variants` daftar adalah [PromptVariant](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PromptVariant.html)objek dari struktur umum berikut:
```
{
"name": "string",
# modelId or genAiResource (see below)
"templateType": "TEXT",
"templateConfiguration": # see below,
"inferenceConfiguration": {
"text": {
"maxTokens": int,
"stopSequences": ["string", ...],
"temperature": float,
"topP": float
}
},
"additionalModelRequestFields": {
"key": "value",
...
},
"metadata": [
{
"key": "string",
"value": "string"
},
...
]
}
```
Isi kolom sebagai berikut:
+ name — Masukkan nama untuk varian.
+ Sertakan salah satu bidang ini, tergantung pada sumber daya pemanggilan model yang akan digunakan:
+ ModelID — Untuk menentukan [model dasar](models-supported.md) atau [profil inferensi](cross-region-inference.md) yang akan digunakan dengan prompt, masukkan ARN atau ID-nya.
+ genAiResource — Untuk menentukan [agen](agents.md), masukkan ID atau ARN. Nilai dari `genAiResource` adalah objek JSON dari format berikut:
```
{
"genAiResource": {
"agent": {
"agentIdentifier": "string"
}
}
```
**catatan**
Jika Anda menyertakan `genAiResource` bidang, Anda hanya dapat menguji prompt di konsol. Untuk menguji prompt dengan agen di API, Anda harus memasukkan teks prompt langsung ke `inputText` bidang [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html)permintaan.
+ TemplateType - Masukkan atau. `TEXT` `CHAT` `CHAT`hanya kompatibel dengan model yang mendukung [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) API. Jika Anda ingin menggunakan caching prompt, Anda harus menggunakan jenis `CHAT` template.
+ TemplateConfiguration - Nilai tergantung pada jenis template yang Anda tentukan:
+ Jika Anda ditentukan `TEXT` sebagai jenis template, nilainya harus menjadi objek [TextPromptTemplateConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_TextPromptTemplateConfiguration.html.html)JSON.
+ Jika Anda ditentukan `CHAT` sebagai jenis template, nilainya harus menjadi objek [ChatPromptTemplateConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ChatPromptTemplateConfiguration.html.html)JSON.
+ InferenceConfiguration — Bidang memetakan ke `text` a. [PromptModelInferenceConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PromptModelInferenceConfiguration.html.html) Bidang ini berisi parameter inferensi yang umum untuk semua model. Untuk mempelajari lebih lanjut tentang parameter inferensi, lihat[Mempengaruhi generasi respons dengan parameter inferensi](inference-parameters.md).
+ additionalModelRequestBidang — Gunakan bidang ini untuk menentukan parameter inferensi yang spesifik untuk model yang Anda gunakan untuk inferensi. Untuk mempelajari lebih lanjut tentang parameter inferensi khusus model, lihat. [Parameter permintaan inferensi dan bidang respons untuk model dasar](model-parameters.md)
+ metadata — Metadata untuk diasosiasikan dengan varian prompt. Anda dapat menambahkan pasangan kunci-nilai ke array untuk menandai varian prompt dengan metadata.
Bidang berikut adalah opsional:
****
| Bidang | Kasus penggunaan |
| --- | --- |
| deskripsi | Untuk memberikan deskripsi untuk prompt. |
| clientToken | Untuk memastikan permintaan API selesai hanya sekali. Untuk informasi selengkapnya, lihat [Memastikan idempotensi](https://docs.aws.amazon.com/ec2/latest/devguide/ec2-api-idempotency.html). |
| tag | Untuk mengaitkan tag dengan aliran. Untuk informasi selengkapnya, lihat [Menandai sumber daya Amazon Bedrock](tagging.md). |
Respons membuat `DRAFT` versi dan mengembalikan ID dan ARN yang dapat Anda gunakan sebagai pengidentifikasi prompt untuk permintaan API terkait prompt lainnya.
------
# Melihat informasi tentang petunjuk menggunakan manajemen Prompt
Untuk mempelajari cara melihat informasi tentang petunjuk menggunakan manajemen Prompt, pilih tab untuk metode pilihan Anda, lalu ikuti langkah-langkahnya:
------
#### [ Console ]
**Untuk melihat informasi tentang prompt**
1. Masuk ke Konsol Manajemen AWS dengan identitas IAM yang memiliki izin untuk menggunakan konsol Amazon Bedrock. Kemudian, buka konsol Amazon Bedrock di [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock).
1. Pilih **Manajemen Prompt** dari panel navigasi kiri. Kemudian, pilih prompt di bagian **Prompts**.
1. Halaman **detail Prompt** mencakup bagian-bagian berikut:
+ **Ikhtisar** - Berisi informasi umum tentang prompt dan kapan dibuat dan terakhir diperbarui.
+ **Draf Prompt** - Berisi pesan prompt dan konfigurasi untuk versi draf terbaru yang disimpan dari prompt.
+ **Versi prompt** — Daftar semua versi prompt yang telah dibuat. Untuk informasi selengkapnya tentang versi prompt, lihat[Menerapkan prompt ke aplikasi Anda menggunakan versi dalam manajemen Prompt](prompt-management-deploy.md).
------
#### [ API ]
Untuk mendapatkan informasi tentang prompt, kirim [GetPrompt](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetPrompt.html)permintaan dengan [titik akhir waktu pembuatan Agen untuk Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) dan tentukan ARN atau ID prompt sebagai. `promptIdentifier` Untuk mendapatkan informasi tentang versi prompt tertentu, tentukan `DRAFT` atau nomor versi di `promptVersion` bidang.
Untuk mencantumkan informasi tentang agen Anda, kirim [ListPrompts](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListPrompts.html)permintaan dengan titik akhir waktu [pembuatan Agen untuk Amazon Bedrock.](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) Anda dapat menentukan parameter opsional berikut:
****
| Bidang | Deskripsi singkat |
| --- | --- |
| maxResults | Jumlah maksimum hasil yang akan dikembalikan sebagai respons. |
| nextToken | Jika ada lebih banyak hasil daripada angka yang Anda tentukan di maxResults bidang, respons mengembalikan nextToken nilai. Untuk melihat kumpulan hasil berikutnya, kirim nextToken nilai dalam permintaan lain. |
------
# Ubah prompt menggunakan manajemen Prompt
Untuk mempelajari cara mengubah prompt menggunakan manajemen Prompt, pilih tab untuk metode pilihan Anda, lalu ikuti langkah-langkahnya:
------
#### [ Console ]
**Untuk memodifikasi prompt**
1. Masuk ke Konsol Manajemen AWS dengan identitas IAM yang memiliki izin untuk menggunakan konsol Amazon Bedrock. Kemudian, buka konsol Amazon Bedrock di [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock).
1. Pilih **Manajemen Prompt** dari panel navigasi kiri. Kemudian, pilih prompt di bagian **Prompts**.
1. Untuk mengedit **Nama** atau **Deskripsi** prompt, pilih **Edit** di bagian **Ikhtisar**. Setelah Anda melakukan pengeditan, pilih **Simpan**.
1. Untuk mengubah prompt dan konfigurasinya, pilih **Edit di pembuat prompt**
1. Untuk mempelajari bagian-bagian prompt yang dapat Anda modifikasi, lihat[Buat prompt menggunakan manajemen Prompt](prompt-management-create.md).
------
#### [ API ]
Untuk mengubah prompt, kirim [UpdatePrompt](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdatePrompt.html)permintaan dengan titik akhir waktu [pembuatan Agen untuk Amazon Bedrock.](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) Sertakan kedua bidang yang ingin Anda pertahankan dan bidang yang ingin Anda ubah.
------
# Uji prompt menggunakan manajemen Prompt
Untuk mempelajari cara menguji prompt yang Anda buat di Manajemen Prompt, pilih tab untuk metode pilihan Anda, lalu ikuti langkah-langkahnya:
------
#### [ Console ]
**Untuk menguji prompt dalam manajemen Prompt**
1. Masuk ke Konsol Manajemen AWS dengan identitas IAM yang memiliki izin untuk menggunakan konsol Amazon Bedrock. Kemudian, buka konsol Amazon Bedrock di [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock).
1. Pilih **Manajemen Prompt** dari panel navigasi kiri. Kemudian, pilih prompt di bagian **Prompts**.
1. Pilih **Edit di Prompt builder** di bagian **Prompt draft**, atau pilih versi prompt di bagian **Versi**.
1. (Opsional) Untuk memberikan nilai variabel dalam prompt Anda, Anda harus terlebih dahulu memilih model di panel **Konfigurasi.** Kemudian, masukkan **nilai Uji** untuk setiap variabel di **variabel Uji** panel.
**catatan**
Nilai pengujian ini bersifat sementara dan tidak disimpan jika Anda menyimpan prompt Anda.
1. Untuk menguji prompt Anda, pilih **Jalankan** di panel **jendela Uji**.
1. Ubah prompt Anda atau konfigurasinya dan kemudian jalankan prompt Anda lagi seperlunya. Jika Anda puas dengan prompt Anda, Anda dapat memilih **Buat versi** untuk membuat snapshot dari prompt Anda yang dapat digunakan dalam produksi. Untuk informasi selengkapnya, lihat [Menerapkan prompt ke aplikasi Anda menggunakan versi dalam manajemen Prompt](prompt-management-deploy.md).
Anda juga dapat menguji prompt dengan cara berikut:
+ Untuk menguji prompt dalam aliran, sertakan node prompt dalam aliran. Untuk informasi selengkapnya, lihat [Buat dan rancang alur di Amazon Bedrock](flows-create.md) dan [Jenis node untuk alur Anda](flows-nodes.md).
+ Jika tidak mengonfigurasi prompt Anda dengan agen, Anda masih dapat menguji prompt dengan agen dengan mengimpornya saat menguji agen. Untuk informasi selengkapnya, lihat [Uji dan pecahkan masalah perilaku agen](agents-test.md).
------
#### [ API ]
Anda dapat menguji prompt Anda dengan cara berikut:
+ Untuk menjalankan inferensi pada prompt, kirim [InvokeModel[InvokeModelWithResponseStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithResponseStream.html)](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModel.html), [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html), atau [ConverseStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_ConverseStream.html)permintaan dengan titik [akhir runtime Amazon Bedrock dan](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#br-rt) tentukan ARN prompt dalam parameter. `modelId`
**catatan**
Pembatasan berikut berlaku saat Anda menggunakan prompt manajemen Prompt dengan `Converse` atau`ConverseStream`:
Anda tidak dapat menyertakan`additionalModelRequestFields`,`inferenceConfig`,`system`, atau `toolConfig` bidang.
Jika Anda menyertakan `messages` bidang, pesan akan ditambahkan setelah pesan yang ditentukan dalam prompt.
Jika Anda menyertakan `guardrailConfig` bidang, pagar pembatas diterapkan ke seluruh prompt. Jika Anda memasukkan `guardContent` blok di [ContentBlock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_ContentBlock.html)lapangan, pagar pembatas hanya akan diterapkan pada blok tersebut.
+ Untuk menguji prompt Anda dalam alur, buat atau edit alur dengan mengirimkan [CreateFlow](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateFlow.html)atau [UpdateFlow](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateFlow.html)permintaan dengan titik akhir waktu [pembuatan Agen untuk Amazon Bedrock.](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) Sertakan SDK untuk JavaScript dalam Node.js dari `PromptNode` jenis dan sertakan ARN prompt di `promptArn` bidang. Kemudian, kirim [InvokeFlow](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeFlow.html)permintaan dengan titik akhir [runtime Agen untuk Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-rt). Untuk informasi selengkapnya, lihat [Buat dan rancang alur di Amazon Bedrock](flows-create.md) dan [Jenis node untuk alur Anda](flows-nodes.md).
+ Untuk menguji prompt Anda dengan agen, gunakan konsol Amazon Bedrock (lihat tab **Konsol**), atau masukkan teks prompt ke `inputText` bidang [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html)permintaan.
------
# Optimalkan prompt
Amazon Bedrock menawarkan alat untuk mengoptimalkan permintaan. Penulisan ulang pengoptimalan meminta untuk menghasilkan hasil inferensi yang lebih cocok untuk kasus penggunaan Anda. Anda dapat memilih model yang ingin Anda optimalkan prompt dan kemudian menghasilkan prompt yang direvisi.
Setelah Anda mengirimkan prompt untuk mengoptimalkan, Amazon Bedrock menganalisis komponen prompt. Jika analisis berhasil, maka akan menulis ulang prompt. Anda kemudian dapat menyalin dan menggunakan teks prompt yang dioptimalkan.
**catatan**
Untuk hasil terbaik, kami sarankan mengoptimalkan petunjuk dalam bahasa Inggris.
**Topics**
+ [Daerah dan model yang didukung untuk optimasi cepat](#prompt-management-optimize-supported)
+ [Kirim prompt untuk pengoptimalan](#prompt-management-optimize-submit)
## Daerah dan model yang didukung untuk optimasi cepat
Tabel berikut menunjukkan dukungan model untuk optimasi cepat:
| Penyedia | Model | ID Model | Dukungan model wilayah tunggal |
| --- | --- | --- | --- |
| Amazon | Nova Lite | Amazon. nova-lite-v1:0 | ap-southeast-2 eu-west-2 us-east-1 |
| Amazon | Nova Mikro | Amazon. nova-micro-v1:0 | ap-southeast-2 eu-west-2 us-east-1 |
| Amazon | Nova Premier | Amazon. nova-premier-v1:0 | |
| Amazon | Nova Pro | Amazon. nova-pro-v1:0 | ap-southeast-2 eu-west-2 us-east-1 |
| Antropik | Claude 3 Haiku | anthropic.claude-3-haiku-20240307-v 1:0 | ap-south-1 ap-southeast-2 ca-sentral-1 eu-central-1 eu-west-1 eu-west-2 eu-west-3 sa-east-1 us-east-1 us-west-2 |
| Antropik | Claude 3 Opus | anthropic.claude-3-opus-20240229-v 1:0 | |
| Antropik | Claude 3 Soneta | anthropic.claude-3-sonnet-20240229-v 1:0 | ap-south-1 ap-southeast-2 ca-sentral-1 eu-central-1 eu-west-1 eu-west-2 eu-west-3 sa-east-1 us-east-1 us-west-2 |
| Antropik | Claude 3.5 Haiku | anthropic.claude-3-5-haiku-20241022-v 1:0 | us-west-2 |
| Antropik | Claude 3.5 Soneta | anthropic.claude-3-5-sonnet-20240620-v 1:0 | eu-central-1 us-east-1 us-west-2 |
| Antropik | Claude 3.5 Soneta v2 | anthropic.claude-3-5-sonnet-20241022-v 2:0 | ap-southeast-2 us-west-2 |
| Antropik | Claude 3.7 Soneta | anthropic.claude-3-7-sonnet-20250219-v 1:0 | eu-west-2 |
| Antropik | Claude Opus 4 | anthropic.claude-opus-4-20250514-v 1:0 | |
| Antropik | Claude Soneta 4 | anthropic.claude-sonnet-4-20250514-v 1:0 | |
| DeepSeek | DeepSeek-R1 | deepseek.r1-v 1:0 | |
| Meta | Instruksi Llama 3 70B | b-instruct-vmeta.llama3-70 1:0 | ap-south-1 ca-central-1 eu-west-2 us-east-1 us-west-2 |
| Meta | Instruksi Llama 3.1 70B | b-instruct-vmeta.llama3-1-70 1:0 | us-west-2 |
| Meta | Instruksi Llama 3.2 11B | b-instruct-vmeta.llama3-2-11 1:0 | |
| Meta | Instruksi Llama 3.3 70B | b-instruct-vmeta.llama3-3-70 1:0 | |
| Meta | Llama 4 Maverick 17B Instruksi | b-instruct-vmeta.llama4-maverick-17 1:0 | |
| Meta | Instruksi Llama 4 Scout 17B | b-instruct-vmeta.llama4-pramuka-17 1:0 | |
| Mistral AI | Mistral Besar (24,02) | mistral.mistral-besar-2402-v 1:0 | ap-south-1 ap-southeast-2 ca-central-1 eu-west-1 eu-west-2 eu-west-3 sa-east-1 us-east-1 us-west-2 |
| Mistral AI | Mistral Besar (24,07) | mistral.mistral-besar-2407-v 1:0 | us-west-2 |
## Kirim prompt untuk pengoptimalan
Untuk mempelajari cara mengoptimalkan prompt, pilih tab untuk metode pilihan Anda, lalu ikuti langkah-langkahnya:
------
#### [ Console ]
Anda dapat mengoptimalkan prompt dengan menggunakan taman bermain atau manajemen Prompt di. Konsol Manajemen AWS Anda harus memilih model sebelum Anda dapat mengoptimalkan prompt. Prompt dioptimalkan untuk model yang Anda pilih.
**Untuk mengoptimalkan prompt di taman bermain**
1. Untuk mempelajari cara menulis prompt di taman bermain Amazon Bedrock, ikuti langkah-langkahnya di. [Hasilkan tanggapan di konsol menggunakan taman bermain](playgrounds.md)
1. Setelah Anda menulis prompt dan memilih model, pilih ikon tongkat (![\[Sparkle icon representing cleaning or refreshing functionality.\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/images/icons/wand.png)). Kotak dialog **prompt Optimalkan** terbuka, dan Amazon Bedrock mulai mengoptimalkan prompt Anda.
1. Ketika Amazon Bedrock selesai menganalisis dan mengoptimalkan prompt Anda, Anda dapat membandingkan prompt asli Anda secara berdampingan dengan prompt yang dioptimalkan di kotak dialog.
1. Untuk mengganti prompt Anda dengan prompt yang dioptimalkan di taman bermain, pilih **Gunakan prompt yang dioptimalkan**. Untuk menyimpan prompt asli Anda, pilih **Batal**.
1. Untuk mengirimkan prompt dan menghasilkan respons, pilih **Jalankan**.
**Untuk mengoptimalkan prompt dalam manajemen Prompt**
1. Untuk mempelajari cara menulis prompt menggunakan manajemen Prompt, ikuti langkah-langkah di[Buat prompt menggunakan manajemen Prompt](prompt-management-create.md).
1. Setelah Anda menulis prompt dan memilih model, pilih **(![\[Sparkle icon representing cleaning or refreshing functionality.\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/images/icons/wand.png)) Optimalkan** di bagian atas kotak **Prompt**.
1. Saat Amazon Bedrock selesai menganalisis dan mengoptimalkan prompt Anda, prompt yang dioptimalkan ditampilkan sebagai varian berdampingan dengan prompt asli.
1. Untuk menggunakan prompt yang dioptimalkan alih-alih yang asli, pilih **Ganti prompt asli**. Untuk menjaga prompt asli Anda, pilih **Exit comparison** dan pilih untuk menyimpan prompt asli.
**catatan**
Jika Anda memiliki 3 petunjuk dalam tampilan perbandingan dan mencoba mengoptimalkan prompt lain, Anda diminta untuk mengganti dan mengganti prompt asli atau salah satu varian.
1. Untuk mengirimkan prompt dan menghasilkan respons, pilih **Jalankan**.
------
#### [ API ]
Untuk mengoptimalkan prompt, kirim [OptimizePrompt](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_OptimizePrompt.html)permintaan dengan titik akhir [waktu proses Agen untuk Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-rt). Berikan prompt untuk mengoptimalkan `input` objek dan tentukan model yang akan dioptimalkan di `targetModelId` lapangan.
Aliran respons mengembalikan peristiwa berikut:
1. [analyzePromptEvent](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_AnalyzePromptEvent.html)— Muncul ketika prompt selesai dianalisis. Berisi pesan yang menjelaskan analisis prompt.
1. [optimizedPromptEvent](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_OptimizedPromptEvent.html)— Muncul ketika prompt telah selesai ditulis ulang. Berisi prompt yang dioptimalkan.
Jalankan contoh kode berikut untuk mengoptimalkan prompt:
```
import boto3
# Set values here
TARGET_MODEL_ID = "anthropic.claude-3-sonnet-20240229-v1:0" # Model to optimize for. For model IDs, see https://docs.aws.amazon.com/bedrock/latest/userguide/model-ids.html
PROMPT = "Please summarize this text: " # Prompt to optimize
def get_input(prompt):
return {
"textPrompt": {
"text": prompt
}
}
def handle_response_stream(response):
try:
event_stream = response['optimizedPrompt']
for event in event_stream:
if 'optimizedPromptEvent' in event:
print("========================== OPTIMIZED PROMPT ======================\n")
optimized_prompt = event['optimizedPromptEvent']
print(optimized_prompt)
else:
print("========================= ANALYZE PROMPT =======================\n")
analyze_prompt = event['analyzePromptEvent']
print(analyze_prompt)
except Exception as e:
raise e
if __name__ == '__main__':
client = boto3.client('bedrock-agent-runtime')
try:
response = client.optimize_prompt(
input=get_input(PROMPT),
targetModelId=TARGET_MODEL_ID
)
print("Request ID:", response.get("ResponseMetadata").get("RequestId"))
print("========================== INPUT PROMPT ======================\n")
print(PROMPT)
handle_response_stream(response)
except Exception as e:
raise e
```
------
# Menerapkan prompt ke aplikasi Anda menggunakan versi dalam manajemen Prompt
Ketika Anda menyimpan prompt Anda, Anda membuat *versi draf* itu. Anda dapat terus mengulangi versi draf dengan memodifikasi prompt dan konfigurasinya dan menyimpannya.
Ketika Anda siap untuk menyebarkan prompt ke produksi, Anda membuat versi untuk digunakan dalam aplikasi Anda. Versi adalah snapshot dari prompt Anda yang Anda buat pada titik waktu ketika Anda mengulangi draf kerja prompt. Buat versi prompt Anda saat Anda puas dengan serangkaian konfigurasi. Versi memungkinkan Anda untuk dengan mudah beralih di antara konfigurasi yang berbeda untuk prompt Anda dan memperbarui aplikasi Anda dengan versi yang paling tepat untuk kasus penggunaan Anda.
**Topics**
+ [Buat versi prompt dalam manajemen Prompt](prompt-management-version-create.md)
+ [Melihat informasi tentang versi prompt dalam manajemen Prompt](prompt-management-version-view.md)
+ [Bandingkan versi prompt dalam manajemen Prompt](prompt-management-version-compare.md)
+ [Menghapus versi prompt dalam manajemen Prompt](prompt-management-version-delete.md)
# Buat versi prompt dalam manajemen Prompt
Untuk mempelajari cara membuat versi prompt Anda, pilih tab untuk metode pilihan Anda, lalu ikuti langkah-langkahnya:
------
#### [ Console ]
Jika Anda berada di pembuat prompt, Anda dapat membuat versi prompt Anda dengan memilih **Buat versi**. Jika tidak, lakukan tindakan berikut:
**Untuk membuat versi prompt Anda**
1. Masuk ke Konsol Manajemen AWS dengan identitas IAM yang memiliki izin untuk menggunakan konsol Amazon Bedrock. Kemudian, buka konsol Amazon Bedrock di [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock).
1. Pilih **Manajemen Prompt** dari panel navigasi kiri. Kemudian, pilih prompt di bagian **Prompts**.
1. Di bagian **Versi Prompt**, pilih **Buat versi** untuk mengambil snapshot versi draf Anda.
------
#### [ API ]
Untuk membuat versi prompt Anda, kirim [CreatePromptVersion](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreatePromptVersion.html)permintaan dengan [titik akhir waktu pembuatan Agen untuk Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) dan tentukan ARN atau ID prompt sebagai. `promptIdentifier`
Respons mengembalikan ID dan ARN untuk versi. Versi dibuat secara bertahap, mulai dari 1.
------
# Melihat informasi tentang versi prompt dalam manajemen Prompt
Untuk mempelajari cara melihat informasi tentang versi prompt Anda, pilih tab untuk metode pilihan Anda, lalu ikuti langkah-langkahnya:
------
#### [ Console ]
**Untuk melihat informasi tentang versi prompt Anda**
1. Masuk ke Konsol Manajemen AWS dengan identitas IAM yang memiliki izin untuk menggunakan konsol Amazon Bedrock. Kemudian, buka konsol Amazon Bedrock di [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock).
1. Pilih **Manajemen Prompt** dari panel navigasi kiri. Kemudian, pilih prompt di bagian **Prompts**.
1. Di bagian **Versi Prompt**, pilih versi.
1. Di halaman **Detail versi**, Anda dapat melihat informasi tentang versi, pesan prompt, dan konfigurasinya. Untuk informasi selengkapnya tentang menguji versi prompt, lihat[Uji prompt menggunakan manajemen Prompt](prompt-management-test.md).
------
#### [ API ]
Untuk mendapatkan informasi tentang versi prompt Anda, kirim [GetPrompt](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetPrompt.html)permintaan dengan [titik akhir waktu pembuatan Agen untuk Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) dan tentukan ARN atau ID prompt sebagai. `promptIdentifier` Di `promptVersion` lapangan, tentukan nomor versi.
------
# Bandingkan versi prompt dalam manajemen Prompt
Konsol Amazon Bedrock menawarkan alat untuk memungkinkan Anda membandingkan versi prompt yang telah Anda buat di manajemen Prompt. Alat ini menyoroti bidang yang ada di satu versi yang tidak ada di versi lain.
**Untuk membandingkan versi yang cepat**
1. Masuk ke Konsol Manajemen AWS dengan identitas IAM yang memiliki izin untuk menggunakan konsol Amazon Bedrock. Kemudian, buka konsol Amazon Bedrock di [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock).
1. Pilih **Manajemen Prompt** dari panel navigasi kiri. Kemudian, pilih prompt di bagian **Prompts**.
1. Di bagian **Versi**, pilih kotak centang di samping dua petunjuk untuk membandingkan.
1. Pilih **Bandingkan**.
1. Objek JSON yang mendefinisikan setiap versi prompt ditampilkan berdampingan. Perbedaan antara versi ditampilkan sebagai berikut:
+ Bidang yang ada di satu versi, tetapi tidak ada di versi lain, ditandai dengan simbol plus (\$1) dan disorot dengan warna hijau.
+ Bidang yang tidak ada dalam satu versi, tetapi ada di versi lain, ditandai dengan simbol minus (-) dan disorot dengan warna merah.
1. Untuk membandingkan respons model keluaran untuk versi yang berbeda, isi **variabel Uji** dan pilih **Run prompt**.
# Menghapus versi prompt dalam manajemen Prompt
Untuk mempelajari cara menghapus versi prompt Anda, pilih tab untuk metode pilihan Anda, lalu ikuti langkah-langkahnya:
------
#### [ Console ]
**Untuk menghapus versi prompt Anda**
1. Masuk ke Konsol Manajemen AWS dengan identitas IAM yang memiliki izin untuk menggunakan konsol Amazon Bedrock. Kemudian, buka konsol Amazon Bedrock di [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock).
1. Pilih **Manajemen Prompt** dari panel navigasi kiri. Kemudian, pilih prompt di bagian **Prompts**.
1. Di bagian **Versi Prompt**, pilih versi dan pilih **Hapus**.
1. Di halaman **Detail versi**, Anda dapat melihat informasi tentang versi, pesan prompt, dan konfigurasinya. Untuk informasi selengkapnya tentang menguji versi prompt, lihat[Uji prompt menggunakan manajemen Prompt](prompt-management-test.md).
1. Tinjau peringatan yang muncul, ketik **konfirmasi**, lalu pilih **Hapus**.
------
#### [ API ]
Untuk menghapus versi prompt Anda, kirim [DeletePrompt](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DeletePrompt.html)permintaan dengan [titik akhir waktu pembuatan Agen untuk Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) dan tentukan ARN atau ID prompt sebagai. `promptIdentifier` Di `promptVersion` bidang, tentukan nomor versi yang akan dihapus.
------
# Hapus prompt dalam manajemen Prompt
Jika Anda tidak lagi membutuhkan prompt, Anda dapat menghapusnya. Permintaan yang Anda hapus disimpan di AWS server hingga empat belas hari. Untuk mempelajari cara menghapus prompt menggunakan manajemen Prompt, pilih tab untuk metode pilihan Anda, lalu ikuti langkah-langkahnya:
------
#### [ Console ]
Jika Anda berada di halaman **Detail Prompt** untuk prompt atau di pembuat prompt, pilih **Hapus** untuk menghapus prompt.
**catatan**
Jika Anda menghapus prompt, semua versinya juga akan dihapus. Sumber daya apa pun yang menggunakan prompt Anda mungkin mengalami kesalahan runtime. Ingatlah untuk memisahkan prompt dari sumber daya apa pun yang menggunakannya.
**Untuk menghapus prompt**
1. Masuk ke Konsol Manajemen AWS dengan identitas IAM yang memiliki izin untuk menggunakan konsol Amazon Bedrock. Kemudian, buka konsol Amazon Bedrock di [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock).
1. Pilih **Manajemen Prompt** dari panel navigasi kiri.
1. Pilih prompt dan pilih **Hapus**.
1. Tinjau peringatan yang muncul, ketik **konfirmasi**, lalu pilih **Hapus**.
------
#### [ API ]
Untuk menghapus prompt, kirim [DeletePrompt](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DeletePrompt.html)permintaan dengan [titik akhir waktu pembuatan Agen untuk Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) dan tentukan ARN atau ID prompt sebagai. `promptIdentifier` Untuk menghapus versi prompt tertentu, tentukan nomor versi di `promptVersion` bidang.
------
# Jalankan contoh kode manajemen Prompt
Untuk mencoba beberapa contoh kode untuk manajemen Prompt, pilih tab untuk metode pilihan Anda, lalu ikuti langkah-langkahnya: Contoh kode berikut mengasumsikan bahwa Anda telah menyiapkan kredensi Anda untuk menggunakan API. AWS Jika belum, lihat[Memulai dengan API](getting-started-api.md).
------
#### [ Python ]
1. Jalankan cuplikan kode berikut untuk memuat AWS SDK untuk Python (Boto3), membuat klien, dan membuat prompt yang membuat daftar putar musik menggunakan dua variabel (`genre`dan`number`) dengan membuat titik akhir waktu build Agents [CreatePrompt](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreatePrompt.html)[for Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt):
```
# Create a prompt in Prompt management
import boto3
# Create an Amazon Bedrock Agents client
client = boto3.client(service_name="bedrock-agent")
# Create the prompt
response = client.create_prompt(
name="MakePlaylist",
description="My first prompt.",
variants=[
{
"name": "Variant1",
"modelId": "amazon.titan-text-express-v1",
"templateType": "TEXT",
"inferenceConfiguration": {
"text": {
"temperature": 0.8
}
},
"templateConfiguration": {
"text": {
"text": "Make me a {{genre}} playlist consisting of the following number of songs: {{number}}."
}
}
}
]
)
prompt_id = response.get("id")
```
1. Jalankan cuplikan kode berikut untuk melihat prompt yang baru saja Anda buat (bersama petunjuk lain di akun Anda) untuk membuat titik akhir waktu pembuatan Agen [ListPrompts](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListPrompts.html)[untuk Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt):
```
# List prompts that you've created
client.list_prompts()
```
1. Anda akan melihat ID dari prompt yang Anda buat di `id` bidang di objek di `promptSummaries` bidang. Jalankan cuplikan kode berikut untuk menampilkan informasi prompt yang Anda buat dengan membuat titik akhir waktu pembuatan [GetPrompt](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetPrompt.html)[Agen untuk Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt):
```
# Get information about the prompt that you created
client.get_prompt(promptIdentifier=prompt_id)
```
1. Buat versi prompt dan dapatkan ID-nya dengan menjalankan cuplikan kode berikut untuk membuat titik akhir waktu pembuatan [CreatePromptVersion](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreatePromptVersion.html)[Agen untuk Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt):
```
# Create a version of the prompt that you created
response = client.create_prompt_version(promptIdentifier=prompt_id)
prompt_version = response.get("version")
prompt_version_arn = response.get("arn")
```
1. Lihat informasi tentang versi prompt yang baru saja Anda buat, bersama informasi tentang versi draf, dengan menjalankan cuplikan kode berikut untuk membuat titik akhir waktu pembuatan [ListPrompts](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListPrompts.html)[Agen untuk Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt):
```
# List versions of the prompt that you just created
client.list_prompts(promptIdentifier=prompt_id)
```
1. Lihat informasi untuk versi prompt yang baru saja Anda buat dengan menjalankan cuplikan kode berikut untuk membuat titik akhir waktu pembuatan [GetPrompt](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetPrompt.html)[Agen untuk Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt):
```
# Get information about the prompt version that you created
client.get_prompt(
promptIdentifier=prompt_id,
promptVersion=prompt_version
)
```
1. Uji prompt dengan menambahkannya ke aliran dengan mengikuti langkah-langkah di[Jalankan contoh kode Amazon Bedrock Flows](flows-code-ex.md). Pada langkah pertama saat Anda membuat alur, jalankan cuplikan kode berikut sebagai gantinya untuk menggunakan prompt yang Anda buat alih-alih mendefinisikan prompt sebaris dalam alur (ganti ARN versi prompt di bidang `promptARN` dengan ARN versi prompt yang Anda buat):
```
# Import Python SDK and create client
import boto3
client = boto3.client(service_name='bedrock-agent')
FLOWS_SERVICE_ROLE = "arn:aws:iam::123456789012:role/MyPromptFlowsRole" # Flows service role that you created. For more information, see https://docs.aws.amazon.com/bedrock/latest/userguide/flows-permissions.html
PROMPT_ARN = prompt_version_arn # ARN of the prompt that you created, retrieved programatically during creation.
# Define each node
# The input node validates that the content of the InvokeFlow request is a JSON object.
input_node = {
"type": "Input",
"name": "FlowInput",
"outputs": [
{
"name": "document",
"type": "Object"
}
]
}
# This prompt node contains a prompt that you defined in Prompt management.
# It validates that the input is a JSON object that minimally contains the fields "genre" and "number", which it will map to the prompt variables.
# The output must be named "modelCompletion" and be of the type "String".
prompt_node = {
"type": "Prompt",
"name": "MakePlaylist",
"configuration": {
"prompt": {
"sourceConfiguration": {
"resource": {
"promptArn": ""
}
}
}
},
"inputs": [
{
"name": "genre",
"type": "String",
"expression": "$.data.genre"
},
{
"name": "number",
"type": "Number",
"expression": "$.data.number"
}
],
"outputs": [
{
"name": "modelCompletion",
"type": "String"
}
]
}
# The output node validates that the output from the last node is a string and returns it as is. The name must be "document".
output_node = {
"type": "Output",
"name": "FlowOutput",
"inputs": [
{
"name": "document",
"type": "String",
"expression": "$.data"
}
]
}
# Create connections between the nodes
connections = []
# First, create connections between the output of the flow input node and each input of the prompt node
for input in prompt_node["inputs"]:
connections.append(
{
"name": "_".join([input_node["name"], prompt_node["name"], input["name"]]),
"source": input_node["name"],
"target": prompt_node["name"],
"type": "Data",
"configuration": {
"data": {
"sourceOutput": input_node["outputs"][0]["name"],
"targetInput": input["name"]
}
}
}
)
# Then, create a connection between the output of the prompt node and the input of the flow output node
connections.append(
{
"name": "_".join([prompt_node["name"], output_node["name"]]),
"source": prompt_node["name"],
"target": output_node["name"],
"type": "Data",
"configuration": {
"data": {
"sourceOutput": prompt_node["outputs"][0]["name"],
"targetInput": output_node["inputs"][0]["name"]
}
}
}
)
# Create the flow from the nodes and connections
client.create_flow(
name="FlowCreatePlaylist",
description="A flow that creates a playlist given a genre and number of songs to include in the playlist.",
executionRoleArn=FLOWS_SERVICE_ROLE,
definition={
"nodes": [input_node, prompt_node, output_node],
"connections": connections
}
)
```
1. Hapus versi prompt yang baru saja Anda buat dengan menjalankan cuplikan kode berikut untuk membuat titik akhir waktu pembuatan [DeletePrompt](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DeletePrompt.html)[Agen untuk Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt):
```
# Delete the prompt version that you created
client.delete_prompt(
promptIdentifier=prompt_id,
promptVersion=prompt_version
)
```
1. Hapus sepenuhnya prompt yang baru saja Anda buat dengan menjalankan cuplikan kode berikut untuk membuat titik akhir waktu pembuatan [DeletePrompt](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DeletePrompt.html)[Agen untuk Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt):
```
# Delete the prompt that you created
client.delete_prompt(
promptIdentifier=prompt_id
)
```
------