View a markdown version of this page

Buat evaluasi online - Batuan Dasar Amazon AgentCore

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

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
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. Jalankan agentcore deploy 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.

    Masukan nama konfigurasi eval online
  2. Pilih evaluator untuk disertakan. Anda dapat memilih dari evaluator bawaan dan evaluator kustom apa pun yang telah Anda buat.

    Daftar multi-pilih Evaluator
  3. Tetapkan laju pengambilan sampel — persentase permintaan agen yang akan dievaluasi.

    Masukan tingkat pengambilan sampel
  4. Pilih apakah akan mengaktifkan evaluasi secara otomatis setelah penerapan.

    Aktifkan 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 terpandu untuk membantu Anda mengonfigurasi pengaturan evaluasi.

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 siaga 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 di 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 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.

  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 berikut ini:

    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.