Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Buat evaluasi online
CreateOnlineEvaluationConfigAPI membuat konfigurasi evaluasi online baru yang terus memantau kinerja agen Anda menggunakan lalu lintas langsung. Operasi asinkron ini memberitahu layanan untuk mengevaluasi jejak agen saat mereka dihasilkan selama operasi normal.
Untuk membuat evaluasi online, berikan nama konfigurasi yang unik, pilih apa yang akan dipantau, pilih hingga 10 evaluator, dan berikan peran layanan IAM ARN untuk eksekusi. Sumber data dapat berupa CloudWatch Log, dipilih dengan nama grup log yang tepat atau awalan nama grup log, atau titik akhir agen. enableOnCreateParameter yang diperlukan mengontrol awalexecutionStatus: true memulai konfigurasiENABLED, dan false memulainyaDISABLED.
Topik
Kontrol status eksekusi
executionStatusParameter menentukan apakah pekerjaan evaluasi secara aktif memproses jejak:
-
DIAKTI FKAN — Pekerjaan evaluasi berjalan terus menerus, memproses jejak yang masuk dan menghasilkan hasil evaluasi.
-
DINON AKTIFKAN — Konfigurasi evaluasi ada tetapi pekerjaan dihentikan sementara. 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"
Pilih grup log masukan
Jika sumber data Anda adalah CloudWatch Log, konfigur dataSourceConfig.cloudWatchLogs asikan dengan salah satu cara berikut:
-
logGroupNames- Berikan daftar eksplisit nama grup log. -
logGroupNamePrefixes— Berikan pre fiks nama grup log 1—5. Layanan mengevaluasi jejak dari grup log mana pun yang namanya dimulai dengan salah satu awalan tersebut, termasuk grup log yang cocok yang dibuat nanti.
Dalam kedua kasus tersebut, serviceNames atur agar layanan dapat mengidentifikasi jejak agen Anda di grup log yang dipilih.
Jika digunakan logGroupNamePrefixes untuk mencocokkan grup log AgentCore Runtime Amazon Bedrock, pastikan runtime mengirimkan rentang ke grup log agen itu sendiri. Untuk agen yang masih menggunakan grup aws/spans log bersama, atur UNIFIED_TRACES_DESTINATION_ENABLED=true pada runtime. Untuk informasi selengkapnya, lihat Tujuan rentang untuk agen yang dihosting di AgentCore runtime Amazon Bedrock.
# Match input log groups by prefix instead of exact names dataSourceConfig={ "cloudWatchLogs": { "logGroupNamePrefixes": ["/aws/agentcore/my-agent-"], "serviceNames": ["my_agent.DEFAULT"] } }
Untuk informasi selengkapnya tentang lokasi penulisan metrik hasil dan skor, termasuk grup log khusus, kustom, dan sumber, lihat Hasil dan keluaran.
Perlindungan evaluator
Saat Anda membuat konfigurasi evaluasi dengan executionStatus set toENABLED, sistem secara otomatis mengunci evaluator kustom yang telah Anda pilih. Setelah terkunci:
-
Tidak ada modifikasi yang diizinkan — Anda tidak dapat memperbarui konfigurasi, petunjuk, atau pengaturan evaluator. Kloning evaluator baru jika Anda perlu membuat perubahan.
-
Penghapusan tidak diizinkan — Anda tidak dapat menghapus evaluator saat pekerjaan evaluasi apa pun menggunakannya (sedang 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 pengembangan dan preferensi Anda.
contoh
Konsol
Anda dapat membuat konfigurasi evaluasi online menggunakan antarmuka visual AgentCore konsol Amazon Bedrock. Metode ini menyediakan formulir dan validasi yang dipandu untuk membantu Anda mengonfigurasi pengaturan evaluasi Anda.
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 idle 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 pada 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 pengamatan. Untuk agen yang dihosting di AgentCore Runtime, nama layanan mengikuti format<agent-runtime-name>. <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 yang berikut ini:
catatan
Jika manajer peran diaktifkan di akun Anda, lamp AgentCore irkan peran untuk Anda, dan langkah pemilihan peran yang dijelaskan di sini diganti dengan opsi Ku stom isasi. Untuk menggunakan peran yang berbeda, pilih Sesuaikan. Untuk informasi selengkapnya, lihat Pembuatan peran IAM dalam Panduan Pengguna IAM.
-
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.