Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Buat dan konfigurasikan agen secara manual
# Prasyarat untuk membuat Agen Bedrock Amazon
Pastikan peran IAM Anda memiliki [izin yang diperlukan](security_iam_id-based-policy-examples-agent.md#iam-agents-ex-all) untuk melakukan tindakan yang terkait dengan Agen Amazon Bedrock.
Sebelum membuat agen, tinjau prasyarat berikut dan tentukan mana yang perlu Anda penuhi:
1. Anda harus menyiapkan setidaknya satu dari yang berikut untuk agen Anda:
+ [Grup tindakan](agents-action-create.md) - Mendefinisikan tindakan yang dapat membantu pengguna akhir melakukan. Setiap grup tindakan menyertakan parameter yang harus diperoleh agen dari pengguna akhir. Anda juga dapat menentukan APIs yang dapat dipanggil, bagaimana menangani tindakan, dan bagaimana mengembalikan respons. Untuk melihat kuota grup aksi di agen, lihat kuota **Grup aksi per Agen** di [titik akhir Amazon Bedrock dan](https://docs.aws.amazon.com/general/latest/gr/bedrock.html) kuota di. Referensi Umum AWS Anda dapat melewati prasyarat ini jika Anda berencana untuk tidak memiliki grup tindakan untuk agen Anda.
+ [Basis pengetahuan](knowledge-base.md) — Menyediakan repositori informasi yang dapat ditanyakan agen untuk menjawab pertanyaan pelanggan dan meningkatkan tanggapan yang dihasilkan. Mengaitkan setidaknya satu basis pengetahuan dapat membantu meningkatkan respons terhadap pertanyaan pelanggan dengan menggunakan sumber data pribadi. Untuk melihat kuota basis pengetahuan yang dilampirkan pada agen, lihat **basis pengetahuan terkait per kuota Agen** di [titik akhir Amazon Bedrock dan](https://docs.aws.amazon.com/general/latest/gr/bedrock.html) kuota di. Referensi Umum AWS Anda dapat melewati prasyarat ini jika Anda berencana untuk tidak memiliki basis pengetahuan yang terkait dengan agen Anda.
1. (Opsional) [Buat [peran layanan](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-role) kustom AWS Identity and Access Management (IAM) untuk agen Anda dengan izin yang tepat](agents-permissions.md). Anda dapat melewati prasyarat ini jika Anda berencana untuk menggunakan Konsol Manajemen AWS untuk secara otomatis membuat peran layanan untuk Anda.
1. (Opsional) Buat [pagar pembatas](guardrails.md) untuk menerapkan perlindungan bagi agen Anda dan untuk mencegah perilaku yang tidak diinginkan dari respons model dan pesan pengguna. Anda kemudian dapat mengaitkannya dengan agen Anda.
1. (Opsional) Beli [Throughput](prov-throughput.md) yang Disediakan untuk meningkatkan jumlah dan tingkat token yang dapat diproses agen Anda dalam jangka waktu tertentu. Anda kemudian dapat mengaitkannya dengan alias agen Anda ketika Anda [membuat versi agen Anda dan mengaitkan alias dengannya](agents-deploy.md).
Untuk membuat agen dengan Amazon Bedrock, Anda menyiapkan komponen berikut:
+ Konfigurasi agen, yang mendefinisikan tujuan agen dan menunjukkan model pondasi (FM) yang digunakannya untuk menghasilkan petunjuk dan tanggapan.
+ Setidaknya salah satu dari berikut ini:
+ Kelompok aksi yang menentukan tindakan apa yang dirancang agen untuk dilakukan.
+ Basis pengetahuan sumber data untuk meningkatkan kemampuan generatif agen dengan memungkinkan pencarian dan kueri.
Anda minimal dapat membuat agen yang hanya memiliki nama. Untuk **Mempersiapkan** agen sehingga Anda dapat [menguji](agents-test.md) atau [menerapkannya](agents-deploy.md), Anda harus mengonfigurasi komponen berikut secara minimal:
****
| Konfigurasi | Deskripsi |
| --- | --- |
| Peran sumber daya agen | ARN [peran layanan dengan izin untuk memanggil operasi API](agents-permissions.md) pada agen |
| Model pondasi (FM) | FM untuk agen untuk memanggil untuk melakukan orkestrasi |
| Petunjuk | Bahasa alami yang menjelaskan apa yang harus dilakukan agen dan bagaimana ia harus berinteraksi dengan pengguna |
Anda juga harus mengkonfigurasi setidaknya satu kelompok tindakan atau basis pengetahuan untuk agen. Jika Anda menyiapkan agen tanpa kelompok tindakan atau basis pengetahuan, itu akan mengembalikan tanggapan hanya berdasarkan FM dan instruksi dan [templat prompt dasar](advanced-prompts.md).
Untuk mempelajari cara membuat agen, pilih tab untuk metode pilihan Anda, lalu ikuti langkah-langkahnya:
------
#### [ Console ]
**Untuk membuat agen**
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 **Agen** dari panel navigasi kiri.
1. Di bagian **Agen**, pilih **Buat Agen**.
1. (Opsional) Ubah **Nama** yang dibuat secara otomatis untuk agen dan berikan **Deskripsi** opsional untuk itu.
1. Pilih **Buat**. Agen Anda dibuat dan Anda akan dibawa ke **pembuat Agen untuk agen** Anda yang baru dibuat, di mana Anda dapat mengonfigurasi agen Anda.
1. Anda dapat melanjutkan ke prosedur berikut untuk mengonfigurasi agen Anda atau kembali ke pembuat Agen nanti.
**Untuk mengkonfigurasi agen Anda**
1. Jika Anda belum berada di agen builder, 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 **Agen** dari panel navigasi kiri. Kemudian, pilih agen di bagian **Agen**.
1. Pilih **Edit di Pembangun Agen**.
1. Di bagian **Detail agen**, Anda dapat mengatur konfigurasi berikut:
1. Edit **nama Agen** atau **deskripsi Agen**.
1. Untuk **peran sumber daya Agen**, pilih salah satu opsi berikut:
+ **Buat dan gunakan peran layanan baru** — Biarkan Amazon Bedrock membuat peran layanan dan menyiapkan izin yang diperlukan atas nama Anda.
+ **Gunakan peran layanan yang ada** — Gunakan [peran kustom](agents-permissions.md) yang Anda atur sebelumnya.
1. Untuk **model Select**, pilih FM untuk agen Anda untuk dipanggil selama orkestrasi.
Secara default, model yang dioptimalkan untuk agen ditampilkan. Untuk melihat semua model yang didukung oleh Amazon Bedrock Agents, bersihkan Agen **Bedrock** yang dioptimalkan.
![\[Anda dapat membuat agen dengan model pondasi apa pun. Saat ini, beberapa model yang ditawarkan dioptimalkan dengan prompts/parsers fine-tuned untuk diintegrasikan dengan arsitektur agen. Seiring waktu, kami berencana untuk menawarkan pengoptimalan untuk semua model yang ditawarkan.\]](http://docs.aws.amazon.com/id_id/bedrock/latest/userguide/images/agents/agents-optimized-model-selection.png)
1. Dalam **Instruksi untuk Agen**, masukkan detail untuk memberi tahu agen apa yang harus dilakukan dan bagaimana ia harus berinteraksi dengan pengguna. [Instruksi menggantikan placeholder \$1instructions\$1 di template prompt orkestrasi.](prompt-placeholders.md#placeholders-orchestration) Berikut ini adalah contoh instruksi:
```
You are an office assistant in an insurance agency. You are friendly and polite. You help with managing insurance claims and coordinating pending paperwork.
```
1. Jika Anda memperluas **Pengaturan tambahan**, Anda dapat mengubah konfigurasi berikut:
+ **Code Interpreter** - (Opsional) Pilih apakah akan mengaktifkan agen untuk menangani tugas yang melibatkan penulisan, menjalankan, menguji, dan memecahkan masalah kode. Lihat perinciannya di [Hasilkan, jalankan, dan uji kode dengan interpretasi kode](agents-code-interpretation.md).
+ **Masukan pengguna** — (Opsional) Pilih apakah akan mengizinkan agen untuk meminta informasi lebih lanjut dari pengguna jika tidak memiliki informasi yang cukup. Lihat perinciannya di [Konfigurasikan agen untuk meminta informasi dari pengguna](agents-user-input.md).
+ **Pemilihan kunci KMS** — (Opsional) Secara default, AWS mengenkripsi sumber daya agen dengan file. Kunci yang dikelola AWS Untuk mengenkripsi agen Anda dengan kunci terkelola pelanggan Anda sendiri, untuk bagian pemilihan kunci KMS, pilih **Sesuaikan pengaturan enkripsi (lanjutan)**. Untuk membuat kunci baru, pilih **Buat AWS KMS kunci** dan kemudian segarkan jendela ini. Untuk menggunakan kunci yang ada, pilih tombol untuk **Pilih AWS KMS kunci**.
+ Batas **waktu sesi idle** — Secara default, jika pengguna tidak merespons selama 30 menit dalam sesi dengan agen Amazon Bedrock, agen tidak lagi menyimpan riwayat percakapan. Riwayat percakapan digunakan untuk melanjutkan interaksi dan untuk menambah respons dengan konteks dari percakapan. Untuk mengubah jangka waktu default ini, masukkan angka di bidang **batas waktu sesi** dan pilih satuan waktu.
1. Untuk bagian **izin IAM**, untuk **peran sumber daya Agen, pilih peran** [layanan](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-role). Untuk mengizinkan Amazon Bedrock membuat peran layanan atas nama Anda, pilih **Buat dan gunakan peran layanan baru**. Untuk menggunakan [peran kustom](agents-permissions.md) yang Anda buat sebelumnya, pilih **Gunakan peran layanan yang ada**.
**catatan**
Peran layanan yang dibuat Amazon Bedrock untuk Anda tidak menyertakan izin untuk fitur yang ada di pratinjau. Untuk menggunakan fitur ini, [lampirkan izin yang benar ke peran layanan](agents-permissions.md).
1. (Opsional) Secara default, AWS mengenkripsi sumber daya agen dengan file. Kunci yang dikelola AWS Untuk mengenkripsi agen Anda dengan kunci terkelola pelanggan Anda sendiri, untuk bagian **pemilihan kunci KMS**, pilih **Sesuaikan pengaturan enkripsi (lanjutan)**. Untuk membuat kunci baru, pilih **Buat AWS KMS kunci** dan kemudian segarkan jendela ini. Untuk menggunakan kunci yang ada, pilih tombol untuk **Pilih AWS KMS kunci**.
1. (Opsional) Untuk mengaitkan tag dengan agen ini, untuk bagian **Tags — opsional**, pilih **Tambahkan tag baru** dan berikan pasangan nilai kunci.
1. Setelah selesai menyiapkan konfigurasi agen, pilih **Berikutnya**.
1. Di bagian **Grup tindakan**, Anda dapat memilih **Tambah** untuk menambahkan grup tindakan ke agen Anda. Untuk informasi selengkapnya tentang menyiapkan grup tindakan, lihat[Gunakan grup tindakan untuk menentukan tindakan yang akan dilakukan agen Anda](agents-action-create.md). Untuk mempelajari cara menambahkan grup tindakan ke agen Anda, lihat[Tambahkan grup tindakan ke agen Anda di Amazon Bedrock](agents-action-add.md).
1. Di bagian **Basis pengetahuan**, Anda dapat memilih **Tambahkan** untuk mengaitkan grup pengetahuan dengan agen Anda. Untuk informasi lebih lanjut tentang pengaturan basis pengetahuan, lihat[Ambil data dan hasilkan respons AI dengan Pangkalan Pengetahuan Amazon Bedrock](knowledge-base.md). Untuk mempelajari cara mengaitkan basis pengetahuan dengan agen Anda, lihat[Meningkatkan generasi respons untuk agen Anda dengan basis pengetahuan](agents-kb-add.md).
1. Di bagian **Detail Guardrails**, Anda dapat memilih **Edit** untuk mengaitkan pagar pembatas dengan agen Anda untuk memblokir dan menyaring konten berbahaya. **Pilih pagar pembatas yang ingin Anda gunakan dari menu tarik-turun di bawah **Pilih pagar pembatas dan kemudian pilih versi yang akan digunakan di bawah versi Guardrail**.** Anda dapat memilih **View** untuk melihat pengaturan Guardrail Anda. Untuk informasi selengkapnya, lihat [Mendeteksi dan memfilter konten berbahaya dengan menggunakan Amazon Bedrock Guardrails](guardrails.md).
1. Di bagian **Strategi orkestrasi**, Anda dapat memilih **Edit** untuk menyesuaikan orkestrasi agen Anda. Untuk informasi lebih lanjut tentang strategi orkestrasi yang dapat Anda gunakan untuk agen Anda, lihat. [Sesuaikan strategi orkestrasi agen](orch-strategy.md)
1. Di bagian **Kolaborasi multi-agen**, Anda dapat memilih **Edit** untuk membuat tim kolaborasi multi-agen. Untuk informasi selengkapnya tentang kolaborasi multi-agen, lihat[Gunakan kolaborasi multi-agen dengan Amazon Bedrock Agents](agents-multi-agent-collaboration.md).
1. Setelah Anda selesai mengonfigurasi agen Anda, pilih salah satu opsi berikut:
+ Untuk tetap berada di **pembuat Agen**, pilih **Simpan**. Anda kemudian dapat **Mempersiapkan** agen untuk mengujinya dengan konfigurasi yang diperbarui di jendela pengujian. Untuk mempelajari cara menguji agen Anda, lihat[Uji dan pecahkan masalah perilaku agen](agents-test.md).
+ Untuk kembali ke halaman **Detail Agen**, pilih **Simpan dan keluar**.
------
#### [ API ]
Untuk membuat agen, kirim [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateAgent.html)permintaan (lihat tautan untuk format permintaan dan respons serta detail bidang) dengan titik akhir waktu [pembuatan Agen untuk Amazon Bedrock.](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)
[Lihat contoh kode](bedrock-agent_example_bedrock-agent_CreateAgent_section.md)
Untuk mempersiapkan agen Anda dan menguji atau menerapkannya, sehingga Anda dapat [menguji](agents-test.md) atau [menerapkannya](agents-deploy.md), Anda harus menyertakan bidang-bidang berikut secara minimal (jika Anda mau, Anda dapat melewati konfigurasi ini dan mengonfigurasinya nanti dengan mengirimkan permintaan): [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateAgent.html)
****
| Bidang | Kasus penggunaan |
| --- | --- |
| agentResourceRoleArn | Untuk menentukan ARN peran layanan dengan izin untuk memanggil operasi API pada agen |
| FoundationModel | Untuk menentukan model pondasi (FM) bagi agen untuk mengatur |
| instruksi | Untuk memberikan instruksi untuk memberi tahu agen apa yang harus dilakukan. Digunakan dalam placeholder \$1instructions\$1 dari template prompt orkestrasi. |
Bidang berikut adalah opsional:
****
| Bidang | Kasus penggunaan |
| --- | --- |
| deskripsi | Menjelaskan apa yang dilakukan agen |
| Detik IdleSession TTLIn | Durasi setelah agen mengakhiri sesi dan menghapus informasi yang tersimpan. |
| customerEncryptionKeyArn | ARN dari kunci KMS untuk mengenkripsi sumber daya agen |
| tag | Untuk mengaitkan [tag](tagging.md) dengan agen Anda. |
| promptOverrideConfiguration | Untuk [menyesuaikan petunjuk yang](advanced-prompts.md) dikirim ke FM pada setiap langkah orkestrasi. |
| GuardrailConfiguration | Untuk menambahkan [pagar pembatas](guardrails.md) ke agen. Tentukan ID atau ARN pagar pembatas dan versi yang akan digunakan. |
| 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). |
| CachingState | Untuk mengaktifkan caching input yang cepat ke agen. Untuk informasi selengkapnya, lihat [Caching cepat untuk inferensi model yang lebih cepat](prompt-caching.md). |
| alasan\$1config | Untuk mengaktifkan penalaran model sehingga model menjelaskan bagaimana ia mencapai kesimpulannya. Gunakan di dalam additionalModelRequestFields bidang. Anda harus menentukan jumlah budget\$1tokens yang digunakan untuk penalaran model, yang merupakan bagian dari token output. Untuk informasi lebih lanjut, lihat [Meningkatkan respons model dengan penalaran model](https://docs.aws.amazon.com/bedrock/latest/userguide/inference-reasoning.html). |
Respons mengembalikan [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_Agent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_Agent.html)objek yang berisi detail tentang agen Anda yang baru dibuat. Jika agen Anda gagal dibuat, [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_Agent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_Agent.html)objek dalam respons mengembalikan daftar `failureReasons` dan daftar `recommendedActions` untuk Anda pecahkan masalah.
```
def create_agent(self, agent_name, foundation_model, role_arn, instruction):
"""
Creates an agent that orchestrates interactions between foundation models,
data sources, software applications, user conversations, and APIs to carry
out tasks to help customers.
:param agent_name: A name for the agent.
:param foundation_model: The foundation model to be used for orchestration by the agent.
:param role_arn: The ARN of the IAM role with permissions needed by the agent.
:param instruction: Instructions that tell the agent what it should do and how it should
interact with users.
:return: The response from Amazon Bedrock Agents if successful, otherwise raises an exception.
"""
try:
response = self.client.create_agent(
agentName=agent_name,
foundationModel=foundation_model,
agentResourceRoleArn=role_arn,
instruction=instruction,
)
except ClientError as e:
logger.error(f"Error: Couldn't create agent. Here's why: {e}")
raise
else:
return response["agent"]
```
Lihat informasi yang lebih lengkap di [Halo Agen Bedrock Amazon](bedrock-agent_example_bedrock-agent_Hello_section.md).
------