Menambahkan grup tindakan ke agen Anda di Amazon Bedrock

Untuk menambahkan grup aksi ke agen

1. Masuk ke AWS Management Console 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 Agen dari panel navigasi kiri. Kemudian, pilih agen di bagian Agen.

3. Pilih Edit di Pembangun Agen.

4. Di bagian Grup tindakan, pilih Tambah.

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 yang akan diperoleh agen Anda 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 dijalankan 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 Tentukan 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:

   • Buat fungsi Lambda baru dengan cepat — direkomendasikan — Biarkan Amazon Bedrock membuat fungsi Lambda dasar untuk agen Anda yang nantinya dapat Anda modifikasi untuk kasus AWS Lambda 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, lampirkan kebijakan berbasis sumber daya ke fungsi Lambda untuk mengizinkan prinsipal layanan Amazon Bedrock mengakses fungsi Lambda.

   • Kontrol pengembalian - Daripada 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 tipe grup Action, Anda akan melihat salah satu bagian berikut:

   • Jika Anda memilih Tentukan 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 Diaktifkan. Meminta konfirmasi sebelum menjalankan fungsi dapat melindungi aplikasi Anda dari mengambil tindakan karena suntikan cepat berbahaya.

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

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

     4. Untuk menambahkan parameter lain, pilih Tambah 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 memilih untuk mendefinisikan fungsi dengan menggunakan objek JSON, pilih editor JSON bukan Table. 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 set parameter lain, pilih Tambahkan fungsi grup tindakan.

   • Jika memilih skema Define with API, Anda akan memiliki bagian skema grup Action 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 Define via in-line schema editor. 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 skema Impor, 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 Tambah. Jika Anda menetapkan skema API, spanduk sukses hijau akan muncul jika tidak ada masalah. Jika ada masalah dalam memvalidasi skema, spanduk merah akan muncul. Anda memiliki opsi berikut:

   • Gulir skema untuk melihat baris 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 Mempersiapkan untuk menerapkan perubahan yang telah Anda buat pada agen sebelum mengujinya.