View a markdown version of this page

AgentCore versi harness dan titik akhir - Batuan Dasar Amazon AgentCore
Bagaimana versi referensi titik akhirSkenario pembuatan versiStatus siklus hidup titik akhirMembuat titik akhirDaftar versi harness dan titik akhirTopik terkait

AgentCore versi harness dan titik akhir

Amazon Bedrock AgentCore mengimplementasikan pembuatan versi otomatis untuk AgentCore harness dan memungkinkan Anda mengelola konfigurasi yang berbeda menggunakan titik akhir. Pembuatan versi harness bekerja dengan cara yang sama seperti pembuatan versi AgentCore Runtime - harness adalah abstraksi terkelola selama Runtime - tetapi Anda mengelolanya melalui API bidang kontrol harness.

Setiap harness di Amazon Bedrock secara otomatis AgentCore berversi:

  • Saat Anda membuat harness, AgentCore secara otomatis membuat versi 1 (V1)

  • Setiap pembaruan pada harness membuat versi baru dengan konfigurasi lengkap dan mandiri

  • Versi tidak dapat diubah setelah dibuat

  • Setiap versi berisi semua konfigurasi yang diperlukan untuk eksekusi: model, prompt sistem, alat, memori, batas, dan lingkungan

Bagaimana versi referensi titik akhir

Endpoint menyediakan cara untuk mereferensikan versi tertentu dari harness Anda:

  • DEFAULTTitik akhir secara otomatis menunjuk ke versi terbaru dari harness Anda

  • Titik akhir dapat menunjuk ke versi tertentu, memungkinkan Anda mempertahankan lingkungan yang berbeda (misalnya, pengembangan, pementasan, produksi)

  • Saat Anda memperbarui harness, DEFAULT titik akhir diperbarui secara otomatis untuk menunjuk ke versi baru

  • Titik akhir harus diperbarui secara eksplisit untuk menunjuk ke versi baru

Contoh Memperbarui titik akhir ke versi baru

contoh
AWS CLI/boto3
import boto3

control_client = boto3.client('bedrock-agentcore-control', region_name='us-west-2')

response = control_client.update_harness_endpoint(
    harnessId='MyHarness-UuFdkQoXSL',
    endpointName='production-endpoint',
    targetVersion='2',
    description='Updated production endpoint'
)

print(response)

Atau dengan AWS CLI:

aws bedrock-agentcore-control update-harness-endpoint \
  --harness-id "MyHarness-UuFdkQoXSL" \
  --endpoint-name "production-endpoint" \
  --target-version "2" \
  --description "Updated production endpoint"

Skenario pembuatan versi

Tabel berikut menggambarkan bagaimana pembuatan versi dan titik akhir berinteraksi selama siklus hidup harness:

Ubah Jenis Perilaku Pembuatan Versi Versi Terbaru Perilaku Titik Akhir

Penciptaan Awal

Membuat Versi 1 (V1) secara otomatis

V1

DEFAULT menunjuk ke V1

Perubahan Model

Membuat versi baru dengan pemilihan model yang diperbarui

V2

DEFAULT secara otomatis memperbarui ke V2

Buat titik akhir “PROD” dengan V2

Tidak ada versi baru yang dibuat

V2

Titik akhir PROD menunjuk ke V2

Pembaruan Alat atau Keterampilan

Membuat versi baru dengan konfigurasi alat yang diperbarui

V3

Pembaruan DEFAULT ke V3, PROD tetap di V2

Perbarui “PROD” ke V3

Tidak ada versi baru yang dibuat

V3

Pembaruan PROD ke V3

Batas atau Modifikasi Lingkungan

Membuat versi baru dengan parameter eksekusi yang diperbarui

V4

Pembaruan DEFAULT ke V4, PROD tetap di V3

Status siklus hidup titik akhir

Titik akhir harness melewati berbagai status selama siklus hidupnya:

CREATING

Status awal saat titik akhir sedang dibuat

CREATE_FAILED

Menunjukkan kegagalan pembuatan karena izin, konfigurasi, atau masalah lainnya

SEDIA

Endpoint siap menerima permintaan

UPDATING

Endpoint sedang diperbarui ke versi baru

UPDATE_FAILED

Menunjukkan kegagalan operasi pembaruan

Membuat titik akhir

Buat titik akhir bernama untuk menyematkan lingkungan ke versi harness tertentu. Jika Anda menghilangkantargetVersion, titik akhir menunjuk ke versi terbaru pada waktu pembuatan.

contoh
AWS CLI/boto3
import boto3

control_client = boto3.client('bedrock-agentcore-control', region_name='us-west-2')

response = control_client.create_harness_endpoint(
    harnessId='MyHarness-UuFdkQoXSL',
    endpointName='production-endpoint',
    targetVersion='2',
    description='Production endpoint pinned to V2'
)

print(response)

Atau dengan AWS CLI:

aws bedrock-agentcore-control create-harness-endpoint \
  --harness-id "MyHarness-UuFdkQoXSL" \
  --endpoint-name "production-endpoint" \
  --target-version "2" \
  --description "Production endpoint pinned to V2"

Daftar versi harness dan titik akhir

Anda dapat membuat daftar semua versi harness dengan memanggil ListHarnessVersions operasi. Untuk membuat daftar titik akhir untuk harness, hubungi. ListHarnessEndpoints

contoh
AWS CLI/boto3
import boto3

control_client = boto3.client('bedrock-agentcore-control', region_name='us-west-2')

# List all versions of a harness
versions = control_client.list_harness_versions(
    harnessId='MyHarness-UuFdkQoXSL'
)
for version in versions['harnessVersions']:
    print(version)

# List all endpoints for a harness
endpoints = control_client.list_harness_endpoints(
    harnessId='MyHarness-UuFdkQoXSL'
)
for endpoint in endpoints['endpoints']:
    print(endpoint)

Atau dengan AWS CLI:

aws bedrock-agentcore-control list-harness-versions \
  --harness-id "MyHarness-UuFdkQoXSL"

aws bedrock-agentcore-control list-harness-endpoints \
  --harness-id "MyHarness-UuFdkQoXSL"

Kedua operasi mendukung pagination melalui maxResults dannextToken. Untuk mengambil konfigurasi titik akhir tunggal, panggilGetHarnessEndpoint; untuk menghapusnya, panggil. DeleteHarnessEndpoint

Topik terkait