Buat agen di Amazon Bedrock - Amazon Bedrock

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

Buat agen di Amazon Bedrock

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 atau menerapkannya, Anda harus mengonfigurasi komponen berikut secara minimal:

Konfigurasi Deskripsi
Peran sumber daya agen ARN peran layanan dengan izin untuk memanggil operasi API 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.

Untuk mempelajari cara membuat agen, pilih tab yang sesuai dengan metode pilihan Anda dan ikuti langkah-langkahnya.

Console
Untuk membuat agen

  1. Masuk ke AWS Management Console menggunakan peran IAM dengan izin Amazon Bedrock, dan buka konsol Amazon Bedrock di https://console.aws.amazon.com/bedrock/.

  2. Pilih Agen dari panel navigasi kiri.

  3. Di bagian Agen, pilih Buat Agen.

  4. (Opsional) Ubah Nama yang dibuat secara otomatis untuk agen dan berikan Deskripsi opsional untuk itu.

  5. 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.

  6. 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 AWS Management Console menggunakan peran IAM dengan izin Amazon Bedrock, dan buka konsol Amazon Bedrock di https://console.aws.amazon.com/bedrock/.

    2. Pilih Agen dari panel navigasi kiri. Kemudian, pilih agen di bagian Agen.

    3. Pilih Edit di Agen builder.

  2. Di bagian Detail agen, Anda dapat mengatur konfigurasi berikut:

    1. Edit nama Agen atau deskripsi Agen.

    2. 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 yang Anda atur sebelumnya.

    3. Untuk model Select, pilih FM untuk agen Anda untuk dipanggil selama orkestrasi.

    4. Dalam Instruksi untuk Agen, masukkan detail untuk memberi tahu agen apa yang harus dilakukan dan bagaimana ia harus berinteraksi dengan pengguna. Instruksi menggantikan placeholder $instructions$ di template prompt orkestrasi. 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.

    5. Jika Anda memperluas Pengaturan tambahan, Anda dapat mengubah konfigurasi berikut:

      Masukan pengguna — Pilih apakah akan mengizinkan agen untuk meminta informasi lebih lanjut dari pengguna jika tidak memiliki informasi yang cukup.

      • Jika Anda memilih Diaktifkan, agen akan menampilkan Observasi yang meminta ulang pengguna untuk informasi selengkapnya jika perlu menjalankan API dalam grup tindakan, tetapi tidak memiliki informasi yang cukup untuk menyelesaikan permintaan API.

      • Jika Anda memilih Dinonaktifkan, agen tidak meminta pengguna untuk rincian tambahan dan sebaliknya memberi tahu pengguna bahwa itu tidak memiliki informasi yang cukup untuk menyelesaikan tugas.

      • Pemilihan kunci KMS — (Opsional) Secara default, AWS mengenkripsi sumber daya agen dengan 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 kunci AWS KMS lalu segarkan jendela ini. Untuk menggunakan kunci yang ada, pilih kunci untuk Pilih kunci AWS KMS.

      • 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.

    6. Untuk bagian izin IAM, untuk peran sumber daya Agen, pilih peran layanan. Untuk mengizinkan Amazon Bedrock membuat peran layanan atas nama Anda, pilih Buat dan gunakan peran layanan baru. Untuk menggunakan peran kustom 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.

    7. (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.

    8. (Opsional) Untuk mengaitkan tag dengan agen ini, untuk bagian Tags — opsional, pilih Tambahkan tag baru dan berikan pasangan nilai kunci.

    9. Setelah selesai menyiapkan konfigurasi agen, pilih Berikutnya.

  3. Di bagian Grup tindakan, Anda dapat memilih Tambah untuk menambahkan grup tindakan ke agen Anda. Untuk informasi selengkapnya tentang menyiapkan grup tindakan, lihatMembuat grup tindakan untuk agen Amazon Bedrock. Untuk mempelajari cara menambahkan grup tindakan ke agen Anda, lihatMenambahkan grup tindakan ke agen Anda di Amazon Bedrock.

  4. Di bagian Basis pengetahuan, Anda dapat memilih Tambahkan untuk mengaitkan grup pengetahuan dengan agen Anda. Untuk informasi lebih lanjut tentang pengaturan basis pengetahuan, lihatBasis pengetahuan untuk Amazon Bedrock. Untuk mempelajari cara mengaitkan basis pengetahuan dengan agen Anda, lihatKaitkan basis pengetahuan dengan agen Amazon Bedrock.

  5. 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 Pagar pembatas untuk Amazon Bedrock.

  6. Di bagian Prompt lanjutan, Anda dapat memilih Edit untuk menyesuaikan petunjuk yang dikirim ke FM oleh agen Anda di setiap langkah orkestrasi. Untuk informasi selengkapnya tentang templat prompt yang dapat Anda gunakan untuk penyesuaian, lihatPermintaan lanjutan di Amazon Bedrock. Untuk mempelajari cara mengonfigurasi prompt lanjutan, lihatKonfigurasikan templat prompt.

  7. 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, lihatUji agen Amazon Bedrock.

    • Untuk kembali ke halaman Detail Agen, pilih Simpan dan keluar.

API

Untuk membuat agen, kirim CreateAgentpermintaan (lihat tautan untuk format permintaan dan respons serta detail bidang) dengan titik akhir waktu pembuatan Agen untuk Amazon Bedrock.

Lihat contoh kode

Untuk mempersiapkan agen Anda dan menguji atau menerapkannya, sehingga Anda dapat menguji atau menerapkannya, Anda harus menyertakan bidang-bidang berikut secara minimal (jika Anda mau, Anda dapat melewati konfigurasi ini dan mengonfigurasinya nanti dengan mengirimkan permintaan): UpdateAgent

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 $instructions$ dari template prompt orkestrasi.

Bidang berikut adalah opsional:

Bidang Kasus penggunaan
deskripsi Menjelaskan apa yang dilakukan agen
IdleSessionTTL InSeconds Durasi setelah agen mengakhiri sesi dan menghapus informasi yang tersimpan.
customerEncryptionKeyArn ARN dari kunci KMS untuk mengenkripsi sumber daya agen
tag Untuk mengaitkan tag dengan agen Anda.
promptOverrideConfiguration Untuk menyesuaikan petunjuk yang dikirim ke FM pada setiap langkah orkestrasi.
GuardrailConfiguration Untuk menambahkan pagar pembatas ke agen. Tentukan ID atau ARN pagar pembatas dan versi yang akan digunakan.
clientToken Identifier untuk memastikan permintaan API selesai hanya sekali.

Respons mengembalikan CreateAgentobjek yang berisi detail tentang agen Anda yang baru dibuat. Jika agen Anda gagal dibuat, CreateAgentobjek dalam respons mengembalikan daftar failureReasons dan daftar recommendedActions untuk Anda pecahkan masalah.