Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Menambahkan grup tindakan ke agen Anda di Amazon Bedrock
Setelah menyiapkan OpenAPI skema dan fungsi Lambda untuk grup tindakan Anda, Anda dapat membuat grup tindakan. Pilih tab untuk metode pilihan Anda, lalu ikuti langkah-langkahnya:
catatan
Jika Anda menggunakan AnthropicClaude 3.5 Sonnet, pastikan bahwa nama alat Anda yang akan berupa bentuk httpVerb__actionGroupName__apiName
mengikuti format ^[a-zA-Z0-9_-]{1,64}$
nama alat Anthropic. Anda actionGroupName dan APiname tidak 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
-
Masuk ke AWS Management Console menggunakan peran IAM dengan izin Amazon Bedrock, dan buka konsol Amazon Bedrock di. https://console.aws.amazon.com/bedrock/
-
Pilih Agen dari panel navigasi kiri. Kemudian, pilih agen di bagian Agen.
-
Pilih Edit di Pembangun Agen.
-
Di bagian Grup tindakan, pilih Tambah.
-
(Opsional) Di bagian Detail grup tindakan, ubah Nama yang dibuat secara otomatis dan berikan Deskripsi opsional untuk grup tindakan Anda.
-
Di bagian Jenis grup tindakan, pilih salah satu metode berikut untuk menentukan parameter yang dapat diperoleh agen dari pengguna untuk membantu melakukan tindakan:
-
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.
-
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
-
-
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 diprediksinya 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 .
-
-
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:
-
Berikan Nama dan Deskripsi opsional (tetapi disarankan).
-
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.
-
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. -
Untuk menambahkan parameter lain, pilih Tambah parameter.
-
Untuk mengedit bidang dalam parameter, pilih bidang dan edit seperlunya.
-
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.
-
Pilih format untuk skema dengan menggunakan menu dropdown di sebelah Format.
-
Untuk mengimpor skema yang ada dari S3 untuk diedit, pilih skema Impor, berikan URI S3, dan pilih Impor.
-
Untuk mengembalikan skema ke skema sampel asli, pilih Reset dan kemudian konfirmasikan pesan yang muncul dengan memilih Reset lagi.
-
-
-
-
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.
-
-
Pastikan untuk Mempersiapkan untuk menerapkan perubahan yang telah Anda buat pada agen sebelum mengujinya.
-
- API
-
Untuk membuat grup tindakan, kirim CreateAgentActionGrouppermintaan dengan titik akhir waktu pembuatan Agen untuk Amazon Bedrock. Anda harus menyediakan skema fungsi atau skema OpenAPI.
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 skema OpenAPI yang mendefinisikan parameter untuk grup aksi atau link ke objek S3 yang mengandungnya. Untuk informasi selengkapnya, lihat Tentukan OpenAPI skema untuk grup tindakan 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
bidangENABLED
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:
-
Untuk format berikut, Anda dapat langsung menempelkan OpenAPI skema berformat JSON atau YAML sebagai nilainya.
"apiSchema": { "payload": "string" }
-
Untuk format berikut, tentukan nama bucket Amazon S3 dan kunci objek tempat 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 Kembalikan kontrol ke pengembang agen dengan mengirimkan informasi yang diperoleh 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
, danactionGroupExecutor
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. def create_agent_action_group( self, name, description, agent_id, agent_version, function_arn, api_schema ): """ Creates an action group for an agent. An action group defines a set of actions that an agent should carry out for the customer. :param name: The name to give the action group. :param description: The description of the action group. :param agent_id: The unique identifier of the agent for which to create the action group. :param agent_version: The version of the agent for which to create the action group. :param function_arn: The ARN of the Lambda function containing the business logic that is carried out upon invoking the action. :param api_schema: Contains the OpenAPI schema for the action group. :return: Details about the action group that was created. """ try: response = self.client.create_agent_action_group( actionGroupName=name, description=description, agentId=agent_id, agentVersion=agent_version, actionGroupExecutor={"lambda": function_arn}, apiSchema={"payload": api_schema}, ) agent_action_group = response["agentActionGroup"] except ClientError as e: logger.error(f"Error: Couldn't create agent action group. Here's why: {e}") raise else: return agent_action_group
Lihat informasi yang lebih lengkap di Halo Agen Bedrock Amazon.
-