Buat evaluasi online
CreateOnlineEvaluationConfigAPI membuat konfigurasi evaluasi online baru yang terus memantau kinerja agen Anda menggunakan lalu lintas langsung. Operasi asinkron ini mengatur layanan untuk mengevaluasi jejak agen saat dihasilkan selama operasi normal.
Saat membuat evaluasi online, Anda menentukan nama konfigurasi unik, sumber data yang akan dipantau (baik daftar grup CloudWatch log atau titik akhir agen), dan daftar evaluator yang akan diterapkan (hingga 10, menggabungkan evaluator bawaan dan kustom). Anda juga menyediakan ARN peran layanan IAM untuk eksekusi. enableOnCreateParameter diperlukan dan menentukan apakah evaluasi mulai berjalan segera setelah pembuatan (executionStatus= true) atau tetap dinonaktifkan hingga diaktifkan secara eksplisit (executionStatus= false).
Topik
Kontrol status eksekusi
executionStatusParameter menentukan apakah pekerjaan evaluasi secara aktif memproses jejak:
-
DIAKTIFKAN - Pekerjaan evaluasi berjalan terus menerus, memproses jejak yang masuk dan menghasilkan hasil evaluasi.
-
DINONAKTIFKAN - Konfigurasi evaluasi ada tetapi pekerjaan dijeda. Tidak ada jejak yang diproses atau dievaluasi.
Anda dapat mengontrol status eksekusi menggunakan CLI:
# Pause a running online evaluation agentcore pause online-eval "your_config_name" # Resume a paused online evaluation agentcore resume online-eval "your_config_name"
Perlindungan evaluator
Saat Anda membuat konfigurasi evaluasi dengan executionStatus set toENABLED, sistem secara otomatis mengunci evaluator kustom yang Anda pilih. Setelah terkunci:
-
Modifikasi tidak diperbolehkan — Anda tidak dapat memperbarui konfigurasi, prompt, atau pengaturan evaluator. Kloning evaluator baru jika Anda perlu melakukan perubahan.
-
Tidak diperbolehkan penghapusan - Anda tidak dapat menghapus evaluator saat pekerjaan evaluasi apa pun menggunakannya (berjalan).
Contoh kode untuk AgentCore CLI, AgentCore SDK, dan AWS SDK
Contoh kode berikut menunjukkan cara membuat konfigurasi evaluasi online menggunakan pendekatan pengembangan yang berbeda. Pilih metode yang paling sesuai dengan lingkungan dan preferensi pengembangan Anda.
contoh
Konsol
Anda dapat membuat konfigurasi evaluasi online menggunakan antarmuka visual AgentCore konsol Amazon Bedrock. Metode ini menyediakan formulir dan validasi terpandu untuk membantu Anda mengonfigurasi pengaturan evaluasi.
Untuk membuat evaluasi AgentCore online
-
Buka AgentCore konsol Amazon Bedrock.
-
Di panel navigasi kiri, pilih Evaluasi.
-
Pilih Buat konfigurasi evaluasi.
-
(Opsional) Untuk nama Evaluasi, masukkan nama untuk konfigurasi evaluasi online.
-
(Opsional) Untuk mengaktifkan konfigurasi evaluasi setelah dibuat, pilih kotak centang di bawah nama evaluasi.
-
(Opsional) Untuk deskripsi konfigurasi Evaluasi, masukkan deskripsi untuk konfigurasi AgentCore evaluasi.
-
(Opsional) Untuk batas waktu siaga sesi, masukkan durasi antara 1 dan 60 menit. Pengaturan default-nya adalah 15 menit.
-
-
Untuk Sumber data, pilih salah satu dari berikut ini:
-
Tentukan dengan titik akhir agen — Pilih agen yang sebelumnya Anda buat di AgentCore Runtime, atau buat agen baru dengan memilih Agen. Kemudian, pilih titik akhir dari agen.
-
Pilih grup CloudWatch log — Pilih hingga 5 grup log. Masukkan nama layanan yang digunakan oleh agen Anda untuk observabilitas. <agent-runtime-name>Untuk agen yang di-host di AgentCore Runtime, nama layanan mengikuti format. <agent-runtime-endpoint-name>. Untuk agen yang berjalan di luar AgentCore Runtime, nama layanan dikonfigurasi dalam variabel lingkungan OTEL_RESOURCE_ATTRIBUTES.
-
-
Untuk Evaluator, pilih hingga 10 evaluator per konfigurasi evaluasi, termasuk evaluator bawaan dan kustom.
-
(Opsional) Untuk Filter, tambahkan hingga 5 filter untuk mengidentifikasi sesi mana yang akan dievaluasi.
-
(Opsional) Untuk Sampling, pilih persentase antara 0,01% dan 100% untuk mengontrol persentase sesi yang dievaluasi. Defaultnya adalah 10%.
-
Untuk peran Amazon Bedrock IAM, pilih salah satu dari berikut ini:
-
Gunakan peran yang ada — Pilih peran layanan IAM yang sudah memiliki izin yang diperlukan.
-
Buat peran baru — Buat peran layanan IAM baru.
-
-
Pilih Buat konfigurasi evaluasi untuk membuat konfigurasi evaluasi AgentCore online.