View a markdown version of this page

Buat evaluasi online - Batu Dasar Amazon AgentCore

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.

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
AgentCore CLI
  1. # Create online evaluation configuration agentcore add online-eval \ --name "your_config_name" \ --runtime "your_runtime_name" \ --evaluator "Builtin.GoalSuccessRate" "Builtin.Helpfulness" \ --sampling-rate 1.0 \ --enable-on-create

    Perintah ini menambahkan konfigurasi evaluasi online ke lokal Andaagentcore.json. J agentcore deploy alankan untuk membuatnya di AWS akun Anda.

    catatan

    Jalankan ini dari dalam direktori AgentCore proyek (dibuat denganagentcore create).

Interactive
  1. Masukkan nama untuk konfigurasi evaluasi online Anda.

    Input nama konfigurasi eval online
  2. Pilih evaluator yang akan disertakan. Anda dapat memilih dari evaluator bawaan dan evaluator khusus apa pun yang telah Anda buat.

    Daftar multi-pilihan evaluator
  3. Tetapkan tingkat pengambilan sampel — persentase permintaan agen yang akan dievaluasi.

    Input laju pengambilan sampel
  4. Pilih apakah akan mengaktifkan evaluasi secara otomatis setelah penerapan.

    Aktifkan pada pemilihan penerapan
  5. Tinjau konfigurasi dan tekan Enter untuk mengonfirmasi.

    Tinjau konfigurasi eval online
AgentCore SDK
  1. from bedrock_agentcore_starter_toolkit import Evaluation # Initialize the evaluation client eval_client = Evaluation() # Replace these with your actual values config_name = "YOUR_CONFIG_NAME" agent_id = "YOUR_AGENT_ID" # e.g., agent_myagent-ABC123xyz # Create online evaluation configuration config = eval_client.create_online_config( config_name=config_name, # Must use underscores, not hyphens agent_id=agent_id, # Agent ID (e.g., agent_myagent-ABC123xyz) sampling_rate=1.0, # Percentage to evaluate (0-100). 1.0 = evaluate 1% of interactions evaluator_list=["Builtin.GoalSuccessRate", "Builtin.Helpfulness"], # List of evaluator IDs config_description="Online Evaluation Config", # Optional description auto_create_execution_role=True, # Automatically creates IAM role (default: True) enable_on_create=True # Enable immediately after creation (default: True) ) print("✅ Online evaluation configuration created!") print(f"Config ID: {config['onlineEvaluationConfigId']}") print(f"Status: {config['status']}") # Save the config ID for later operations config_id = config['onlineEvaluationConfigId'] print(f"\nSaved config_id: {config_id}")
AWS SDK
  1. import boto3 # Your input log group that contains agent traces LOG_GROUP_NAME = "/aws/agentcore/test-agent-traces" # The service.name attribute from Otel SERVICE_NAME = "strands_healthcare_single_agent.DEFAULT" # The role created earlier with the required permissions for eval role_arn = f"arn:aws:iam::{ACCOUNT_ID}:role/AgentCoreEvaluationRole" client = boto3.client('bedrock-agentcore-control') create_config_response = client.create_online_evaluation_config( onlineEvaluationConfigName="strands_healthcare_agent_1", description="Continuous evaluation of a healthcare agent", rule={ "samplingConfig": {"samplingPercentage": 80.0} }, dataSourceConfig={ "cloudWatchLogs": { "logGroupNames": [LOG_GROUP_NAME], "serviceNames": [SERVICE_NAME] } }, evaluators=[{"evaluatorId":"Builtin.Helpfulness"}], evaluationExecutionRoleArn=role_arn, enableOnCreate=True )
AWS CLI
  1. aws bedrock-agentcore-control create-online-evaluation-config \ --online-evaluation-config-name "strands_healthcare_agent_1" \ --description "Continuous evaluation of a healthcare agent" \ --rule '{"samplingConfig": {"samplingPercentage": 80.0}}' \ --data-source-config '{"cloudWatchLogs": {"logGroupNames": ["/aws/agentcore/test-agent-traces"], "serviceNames": ["strands_healthcare_single_agent.DEFAULT"]}}' \ --evaluators '[{"evaluatorId": "Builtin.Helpfulness"}]' \ --evaluation-execution-role-arn "arn:aws:iam::{YOUR_ACCOUNT_ID}:role/AgentCoreEvaluationRole" \ --enable-on-create

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

  1. Buka AgentCore konsol Amazon Bedrock.

  2. Di panel navigasi kiri, pilih Evaluasi.

  3. Pilih Buat konfigurasi evaluasi.

    1. (Opsional) Untuk nama Evaluasi, masukkan nama untuk konfigurasi evaluasi online.

    2. (Opsional) Untuk mengaktifkan konfigurasi evaluasi setelah dibuat, pilih kotak centang di bawah nama evaluasi.

    3. (Opsional) Untuk deskripsi konfigurasi Evaluasi, masukkan deskripsi untuk konfigurasi AgentCore evaluasi.

    4. (Opsional) Untuk batas waktu idle sesi, masukkan durasi antara 1 dan 60 menit. Pengaturan default-nya adalah 15 menit.

  4. Untuk Sumber data, pilih salah satu dari berikut ini:

    1. 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.

    2. 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.

  5. Untuk Evaluator, pilih hingga 10 evaluator per konfigurasi evaluasi, termasuk evaluator bawaan dan kustom.

  6. (Opsional) Untuk Filter, tambahkan hingga 5 filter untuk mengidentifikasi sesi mana yang akan dievaluasi.

  7. (Opsional) Untuk Sampling, pilih persentase antara 0,01% dan 100% untuk mengontrol persentase sesi yang dievaluasi. Defaultnya adalah 10%.

  8. 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.

    1. Gunakan peran yang ada — Pilih peran layanan IAM yang sudah memiliki izin yang diperlukan.

    2. Buat peran baru — Buat peran layanan IAM baru.

  9. Pilih Buat konfigurasi evaluasi untuk membuat konfigurasi evaluasi AgentCore online.