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

# Buat prompt menggunakan manajemen Prompt
<a name="prompt-management-create"></a>

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{{{{variable}}}}) 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 pondasi](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{{{{variable}}}}). 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 pondasi](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.

------