View a markdown version of this page

AgentCore memanfaatkan versi dan titik akhir - Batu Dasar Amazon AgentCore
Bagaimana titik akhir mereferensikan versiSkenario pembuatan versiStatus siklus hidup titik akhirMembuat titik akhirDaftar versi harness dan titik akhirTopik terkait

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

AgentCore memanfaatkan versi 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 AgentCore pembuatan versi Runtime - harness adalah abstraksi terkelola melalui Runtime - tetapi Anda mengelolanya melalui API bidang kontrol harness.

Setiap harness di Amazon Bedrock secara otomatis AgentCore diberi versi:

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

  • Setiap pembaruan pada harness menciptakan versi baru dengan konfigurasi mandiri yang lengkap

  • Versi tidak dapat diubah setelah dibuat

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

Bagaimana titik akhir mereferensikan versi

Titik akhir menyediakan cara untuk mereferensikan versi tertentu dari harness Anda:

  • T DEFAULT itik akhir secara otomatis menunjuk ke versi terbaru 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 pada V2

Perbarui “PROD” ke V3

Tidak ada versi baru yang dibuat

V3

Pembaruan PROD ke V3

Batasan 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

BUAT_GAGAL

Menunjukkan kegagalan pembuatan karena izin, konfigurasi, atau masalah lainnya

SIAP

Endpoint siap menerima permintaan

UPDATING

Endpoint sedang diperbarui ke versi baru

PEMBARUAN_GAGAL

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 mencantumkan semua versi harness dengan memanggil ListHarnessVersions operasi. Untuk membuat daftar titik akhir untuk harness, hubungiListHarnessEndpoints.

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, panggilDeleteHarnessEndpoint.

Topik terkait