Tambahkan grup tindakan ke agen Anda di Amazon Bedrock

Untuk menambahkan grup tindakan ke 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.

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

3. Pilih Edit di Agent builder.

4. Di bagian Grup tindakan, pilih Tam bah.

5. (Opsional) Di bagian Detail grup tindakan, ubah Nama yang dibuat secara otomatis dan berikan Deskripsi opsional untuk grup tindakan Anda.

6. Di bagian Jenis grup tindakan, pilih salah satu metode berikut untuk menentukan parameter yang dapat diperoleh agen dari pengguna untuk membantu melakukan tindakan:

   1. Tentukan dengan detail fungsi — Tentukan parameter untuk agen Anda untuk dipetik dari pengguna untuk melakukan tindakan. Untuk informasi selengkapnya tentang menambahkan fungsi, lihatMenentukan detail fungsi untuk grup tindakan agen Anda di Amazon Bedrock.

   2. Tentukan dengan skema API — Tentukan operasi API yang dapat dipanggil agen dan parameternya. Gunakan skema OpenAPI yang Anda buat atau gunakan editor teks konsol untuk membuat skema. Untuk informasi selengkapnya tentang menyiapkan skema OpenAPI, lihat Mendefinisikan OpenAPI skema untuk grup tindakan agen Anda di Amazon Bedrock

7. Di bagian pemanggilan grup tindakan, Anda mengatur apa yang dilakukan agen setelah memprediksi API atau fungsi yang harus dipanggil dan menerima parameter yang dibutuhkannya. Pilih salah satu opsi berikut:

   • Cepat buat fungsi Lambda baru — disarankan — Biarkan Amazon Bedrock membuat fungsi Lambda dasar untuk agen Anda yang nantinya dapat Anda modifikasi AWS Lambda untuk kasus penggunaan Anda. Agen akan meneruskan API atau fungsi yang diprediksi dan parameter, berdasarkan sesi, ke fungsi Lambda.

   • Pilih fungsi Lambda yang ada — Pilih fungsi Lambda yang Anda buat sebelumnya AWS Lambda dan versi fungsi yang akan digunakan. Agen akan meneruskan API atau fungsi yang diprediksi dan parameter, berdasarkan sesi, ke fungsi Lambda.

     catatan

     Untuk mengizinkan prinsipal layanan Amazon Bedrock mengakses fungsi Lambda, lamp irkan kebijakan berbasis sumber daya ke fungsi Lambda untuk memungkinkan prinsipal layanan Amazon Bedrock mengakses fungsi Lambda.

   • Kontrol kembalikan — Alih-alih meneruskan parameter untuk API atau fungsi yang diprediksi ke fungsi Lambda, agen mengembalikan kontrol ke aplikasi Anda dengan meneruskan tindakan yang diprediksi harus dipanggil, selain parameter dan informasi untuk tindakan yang ditentukan dari sesi, dalam respons. InvokeAgent Untuk informasi selengkapnya, lihat Kembalikan kontrol ke pengembang agen dengan mengirimkan informasi yang diperoleh sebagai tanggapan InvokeAgent.

8. Bergantung pada pilihan Anda untuk jenis grup T indakan, Anda akan melihat salah satu bagian berikut:

   • Jika Anda memilih Definisikan dengan detail fungsi, Anda akan memiliki bagian fungsi grup tindakan. Lakukan hal berikut untuk menentukan fungsi:

     1. Berikan Nama dan Deskripsi opsional (tetapi disarankan).

     2. Untuk meminta konfirmasi dari pengguna sebelum fungsi dipanggil, pilih Di aktifkan. Meminta konfirmasi sebelum menjalankan fungsi dapat melindungi aplikasi Anda dari mengambil tindakan karena suntikan cepat yang berbahaya.

     3. Di subbagian Parameter, pilih Tambahkan parameter. Tentukan bidang berikut:

        Bidang	Deskripsi
        Nama	Berikan nama untuk parameter.
        Deskripsi (opsional)	Jelaskan parameternya.
        Tipe	Tentukan tipe data parameter.
        Diperlukan	Tentukan apakah agen memerlukan parameter dari pengguna.

     4. Untuk menambahkan parameter lain, pilih Tam bah parameter.

     5. Untuk mengedit bidang dalam parameter, pilih bidang dan edit seperlunya.

     6. Untuk menghapus parameter, pilih ikon hapus ( ) di baris yang berisi parameter.

     Jika Anda lebih suka mendefinisikan fungsi dengan menggunakan objek JSON, pilih editor JSON alih- alih Tabel. Format objek JSON adalah sebagai berikut (setiap kunci dalam parameters objek adalah nama parameter yang Anda berikan):

     {
         "name": "string",
         "description": "string",
         "parameters": [
             {
                 "name": "string",
                 "description": "string",
                 "required": "True" | "False",
                 "type": "string" | "number" | "integer" | "boolean" | "array"
             }
         ]
     }

     Untuk menambahkan fungsi lain ke grup tindakan Anda dengan menentukan kumpulan parameter lain, pilih Tambahkan fungsi grup tindakan.

   • Jika Anda memilih Definisikan dengan skema API, Anda akan memiliki bagian skema grup tindakan dengan opsi berikut:

     • Untuk menggunakan skema OpenAPI yang sebelumnya Anda siapkan dengan deskripsi, struktur, dan parameter API untuk grup tindakan, pilih Pilih skema API dan berikan tautan ke URI Amazon S3 skema.

     • Untuk menentukan skema OpenAPI dengan editor skema in-line, pilih Definisikan melalui editor skema in-line. Skema sampel muncul yang dapat Anda edit.

       1. Pilih format untuk skema dengan menggunakan menu dropdown di sebelah Format.

       2. Untuk mengimpor skema yang ada dari S3 untuk diedit, pilih Impor skema, berikan URI S3, dan pilih Impor.

       3. Untuk mengembalikan skema ke skema sampel asli, pilih Reset dan kemudian konfirmasikan pesan yang muncul dengan memilih Reset lagi.

9. Setelah selesai membuat grup tindakan, pilih Tam bah. Jika Anda mendefinisikan skema API, banner sukses hijau muncul jika tidak ada masalah. Jika ada masalah saat memvalidasi skema, spanduk merah muncul. Anda memiliki opsi berikut:

   • Gulir skema untuk melihat garis di mana ada kesalahan atau peringatan tentang pemformatan. X menunjukkan kesalahan pemformatan, sementara tanda seru menunjukkan peringatan tentang pemformatan.

   • Pilih Lihat detail di spanduk merah untuk melihat daftar kesalahan tentang konten skema API.

10. Pastikan untuk Memper siapkan untuk menerapkan perubahan yang telah Anda buat ke agen sebelum mengujinya.