Tambahkan grup tindakan ke agen Anda 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.

Tambahkan grup tindakan ke agen Anda di Amazon Bedrock

Setelah mengatur OpenAPI skema dan fungsi Lambda untuk grup tindakan Anda, Anda dapat membuat grup tindakan. Pilih tab yang sesuai dengan metode pilihan Anda dan ikuti langkah-langkahnya:

catatan

Jika Anda menggunakan Anthropic Claude 3.5 Sonnet, pastikan bahwa nama alat Anda yang akan berbentuk httpVerb__actionGroupName__apiName mengikuti format ^[a-zA-Z0-9_-]{1,64}$ nama alat Anthropic. Anda actionGroupName dan tidak apiName boleh mengandung garis bawah '__' ganda.

Console

Saat membuat agen, Anda dapat menambahkan grup tindakan ke draf kerja.

Setelah agen dibuat, Anda dapat menambahkan grup tindakan ke dalamnya dengan melakukan langkah-langkah berikut:

Untuk menambahkan grup aksi ke agen
  1. Masuk ke AWS Management Console menggunakan IAMperan 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.

  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 API skema — Tentukan API operasi yang dapat dipanggil agen dan parameternya. Gunakan API skema Buka yang Anda buat atau gunakan editor teks konsol untuk membuat skema. Untuk informasi selengkapnya tentang menyiapkan API skema Terbuka, lihat Mendefinisikan OpenAPI skema untuk grup aksi agen Anda di Amazon Bedrock

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

  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.
        Diperlukan 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 ( Trapezoid-shaped diagram showing data flow from source to destination through AWS Transfer Family. ) di baris yang berisi parameter.

      Jika Anda lebih memilih untuk mendefinisikan fungsi dengan menggunakan JSON objek, pilih JSONeditor bukan Tabel. Format JSON objek 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 Anda memilih Tentukan dengan API skema, Anda akan memiliki bagian skema grup Tindakan dengan opsi berikut:

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

      • Untuk menentukan skema Open dengan editor API 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 S3URI, 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 mendefinisikan API skema, spanduk sukses hijau muncul jika tidak ada masalah. Jika ada masalah memvalidasi skema, spanduk merah 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 isi API skema.

  10. Pastikan untuk Mempersiapkan untuk menerapkan perubahan yang telah Anda buat pada agen sebelum mengujinya.

API

Untuk membuat grup aksi, kirim CreateAgentActionGrouppermintaan (lihat tautan untuk format permintaan dan respons serta detail bidang) dengan titik akhir waktu pembuatan Agen untuk Amazon Bedrock. Anda harus menyediakan skema fungsi atau API skema Terbuka.

Lihat contoh kode

Daftar berikut menjelaskan bidang dalam permintaan:

  • Bidang berikut diperlukan:

    Bidang Deskripsi singkat
    agentId ID agen yang menjadi milik kelompok aksi.
    agentVersion Versi agen yang menjadi milik kelompok aksi.
    actionGroupName Nama grup aksi.
  • Untuk menentukan parameter untuk grup tindakan, Anda harus menentukan salah satu bidang berikut (Anda tidak dapat menentukan keduanya).

    Bidang Deskripsi singkat
    functionSchema Mendefinisikan parameter untuk grup tindakan yang ditimbulkan agen dari pengguna. Untuk informasi selengkapnya, lihat Menentukan detail fungsi untuk grup tindakan agen Anda di Amazon Bedrock.
    apiSchema Menentukan API skema Open mendefinisikan parameter untuk kelompok tindakan atau link ke objek S3 yang berisi itu. Untuk informasi selengkapnya, lihat Mendefinisikan OpenAPI skema untuk grup aksi agen Anda di Amazon Bedrock.

    Berikut ini menunjukkan format umum dari functionSchema danapiSchema:

    • Setiap item dalam functionSchema array adalah FunctionSchemaobjek. Untuk setiap fungsi, tentukan yang berikut ini:

      • Berikan name dan opsional (tetapi disarankan)description.

      • Secara opsional, tentukan requireConfirmation bidang ENABLED untuk meminta konfirmasi dari pengguna sebelum fungsi dipanggil. Meminta konfirmasi sebelum menjalankan fungsi dapat melindungi aplikasi Anda dari mengambil tindakan karena suntikan cepat berbahaya.

      • Dalam parameters objek, setiap kunci adalah nama parameter, dipetakan ke detail tentang hal itu dalam sebuah ParameterDetailobjek.

      Format umum functionSchema adalah sebagai berikut:

      "functionSchema": [ { "name": "string", "description": "string", "requireConfirmation": ENABLED | DISABLED, "parameters": { "<string>": { "type": "string" | number | integer | boolean | array, "description": "string", "required": boolean }, ... // up to 5 parameters } }, ... // up to 11 functions ]
    • APISchemaBisa dalam salah satu format berikut:

      1. Untuk format berikut, Anda dapat langsung menempelkan JSON atau YAML -format OpenAPI skema sebagai nilai.

        "apiSchema": { "payload": "string" }
      2. Untuk format berikut, tentukan nama bucket Amazon S3 dan kunci objek di mana OpenAPI skema disimpan.

        "apiSchema": { "s3": { "s3BucketName": "string", "s3ObjectKey": "string" } }
  • Untuk mengonfigurasi cara grup tindakan menangani pemanggilan grup tindakan setelah memunculkan parameter dari pengguna, Anda harus menentukan salah satu bidang berikut dalam bidang tersebut. actionGroupExecutor

    Bidang Deskripsi singkat
    lambda Untuk mengirim parameter ke fungsi Lambda untuk menangani hasil pemanggilan grup tindakan, tentukan Nama Sumber Daya Amazon () ARN dari Lambda. Untuk informasi selengkapnya, lihat Konfigurasikan fungsi Lambda untuk mengirim informasi yang diperoleh agen Amazon Bedrock dari pengguna.
    customControl Untuk melewati penggunaan fungsi Lambda dan sebagai gantinya mengembalikan grup tindakan yang diprediksi, selain parameter dan informasi yang diperlukan untuk itu, dalam InvokeAgent respons, tentukan. RETURN_CONTROL Untuk informasi selengkapnya, lihat Mengembalikan kontrol ke pengembang agen dengan mengirimkan informasi yang ditimbulkan sebagai tanggapan InvokeAgent .
  • Bidang berikut adalah opsional:

    Bidang Deskripsi singkat
    parentActionGroupTanda tangan Tentukan AMAZON.UserInput untuk mengizinkan agen meminta ulang pengguna untuk informasi lebih lanjut jika tidak memiliki informasi yang cukup untuk menyelesaikan grup tindakan lain. Anda harus membiarkandescription,apiSchema, dan actionGroupExecutor bidang kosong jika Anda menentukan bidang ini.
    deskripsi Deskripsi kelompok aksi.
    actionGroupState Apakah akan mengizinkan agen untuk memanggil grup aksi atau tidak.
    clientToken Pengidentifikasi untuk mencegah permintaan digandakan.