View a markdown version of this page

Panduan migrasi registri yang komprehensif - Batu Dasar Amazon AgentCore

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

Panduan migrasi registri yang komprehensif

AWS Agen Registry - Bermigrasi ke namespace baru agent-registry

Pengantar

Sebagai bagian dari peluncuran agent-registry namespace baru 6 Agustus 2026, AWS Agen Registry memperkenalkan perubahan signifikan pada prinsip layanan, data, dan model API. Jika Anda menggunakan Registry AWS Agen di bawah bedrock-agentcore namespace, Anda harus menyelesaikan migrasi yang mencakup tiga area:

  1. Namespace dan perubahan konfigurasi — Kami memindahkan AWS Agen Registry dari namespace AWS Bedrock ke AgentCore namespace khusus sendiri. Perubahan namespace ini hanya berlaku untuk AWS Agen Registry. Semua penawaran lainny AgentCore a—seperti Identity, Gateway, Runtime, dan Policy—tetap tidak terpengaruh. Untuk AWS Agen Registry, namespace layanan berubah dari bedrock-agentcore menjadiagent-registry. Ini mempengaruhi setiap permukaan yang mereferensikan layanan: titik akhir, kebijakan IAM, klien SDK, perintah CLI, ARN sumber daya, dan integrasi pengamatan. Anda harus memperbarui kode dan infrastruktur Anda untuk menggunakan namespace baru.

  2. Perubahan skema API — Model data catatan registri dan registri diperbarui berdasarkan umpan balik pelanggan dari bedrock-agentcore namespace. Perubahan ini merusak kompatibilitas mundur dengan skema API yang ada. Kode aplikasi Anda yang membuat atau mengurai permintaan dan tanggapan API harus diperbarui untuk mencerminkan skema baru, sebagai bagian dari migrasi ke namespace baru.

  3. Migrasi data — Anda harus memigrasikan registri dan catatan registri yang ada dari namespace lama ke yang baru. Kami menyediakan alat migrasi untuk mengekstrak data Anda, mengubahnya ke skema baru, dan memuatnya ke namespace baru. Data dimigrasikan ke akun dan wilayah yang sama — hanya namespace yang berubah.

Panduan ini mencakup setiap area secara rinci dengan contoh sebelum dan sesudah untuk membantu Anda merencanakan dan menjalankan migrasi Anda.

Apa garis waktu migrasi?

Ada dua tonggak penting yang harus Anda ingat untuk migrasi ini:

  • 6 Agustus 2026 — agent-registry Namespace baru untuk AWS Agen Registry resmi diluncurkan. Akses layanan di konsol AWS Agen Registry. Jika Anda memiliki registri dan catatan yang ada, Anda memiliki akses simultan ke ruang nama bedrock-agentcore danagent-registry. Alat migrasi tersedia di repositori https://github.com/awslabs/agentcore-samples/tree/main/01-features/07-centralize-and-govern-your-ai-infrastructure/03-registry/04-migrate-to-new-namespace sampel agen di situs web. GitHub Anda dapat memulai proses migrasi.

    catatan

    Jika Anda adalah pelanggan baru tanpa registri atau catatan yang ada pada 6 Agustus 2026, Anda tidak dapat mengakses Registry AWS Agen melalui namespace. bedrock-agentcore Mulai gunakan AWS Agent Registry langsung dari agent-registry namespace.

  • 17 September 2026 - Jendela migrasi ditutup. bedrock-agentcoreNamespace lama dimatikan pada tanggal ini. Anda kehilangan read/write akses ke layanan dan data yang tersisa di namespace lama. Setelah tanggal ini, Anda harus menggunakan agent-registry namespace.

Namespace dan perubahan konfigurasi

agent-registryNamespace menggantikan bedrock-agentcore di tempat-tempat berikut. Bagian ini mencantumkan setiap permukaan yang berubah dan memberikan contoh cara memperbarui kode Anda.

penting

Perubahan namespace hanya memengaruhi API yang ditawarkan oleh AWS Agen Registry, tetapi tidak pada AWS Bedrock lainnya AgentCore, seperti AWS AgentCore Identity. Dengan demikian, identitas beban kerja dan sumber daya penyedia kredensia OAuth tetap berada di bawah namespace. bedrock-agentcore

Titik akhir layanan

Aplikasi Anda harus menunjuk ke nama host titik akhir yang baru. Titik akhir baru menggunakan .api.aws domain.

Permukaan Nilai lama Nilai baru

Titik akhir bidang data

bedrock-agentcore.{region}.amazonaws.com

agent-registry.{region}.api.aws

Titik akhir bidang kontrol

bedrock-agentcore-control.{region}.amazonaws.com

agent-registry-control.{region}.api.aws

IAM dan keamanan

Semua kebijakan IAM, kebijakan kontrol layanan (SCP), dan batas izin yang referensi bedrock-agentcore harus diperbarui. ARN sumber daya juga berubah untuk mencerminkan namespace baru.

Permukaan Nilai lama Nilai baru

Awalan tindakan IAM

bedrock-agentcore:*

agent-registry:*

Pemimpin layanan

bedrock-agentcore.amazonaws.com

agent-registry.amazonaws.com

Pendaftaran ARN

arn:aws:bedrock-agentcore:{region}:{account}:registry/{id}

arn:aws:agent-registry:{region}:{account}:registry/{id}

Rekam ARN

arn:aws:bedrock-agentcore:{region}:{account}:registry/{id}/record/{rid}

arn:aws:agent-registry:{region}:{account}:registry/{id}/record/{rid}

Jika Anda memiliki otomatisasi yang mengurai ARN atau menyimpannya, perbarui referensi tersebut juga. Kebijakan kustom dengan kondisi pada awalan tindakan IAM atau prinsipal layanan harus diperbarui agar sesuai dengan nilai baru. Untuk melihat daftar lengkap izin IAM yang terkait dengan AWS Agen Registry, lihat referensi izin IAM AWS Agen Registry.

catatan

Jika saat ini Anda menggunakan Kebijakan BedrockAgentCoreFullAccess AWS Terkelola untuk akses Registri AWS Agen (lihat detail BedrockAgentCoreFullAccess kebijakan), Anda harus menggantinya dengan kebijakan AgentRegistryFullAccess terkelola baru (tersedia pada 6 Agustus 2026). Kebijakan ter BedrockAgentCoreFullAccess kelola lama TIDAK akan diperbarui untuk menyertakan agent-registry:* izin.

SDK, CLI, dan infrastruktur

Perbarui kode aplikasi, skrip penerapan, dan templat infrastruktur sebagai kode untuk mereferensikan kelas klien baru dan namespace CLI.

Permukaan Nilai lama Nilai baru

Kelas klien Dataplane SDK

BedrockAgentCoreClient

AgentRegistryClient

Kelas klien Controlplane SDK

BedrockAgentCoreControlClient

AgentRegistryControlClient

Ruang nama CLI

aws bedrock-agentcore

aws agent-registry

Kode Kuota Layanan

bedrock-agentcore

agent-registry

Jika sebelumnya Anda meminta kenaikan kuota khusus berdasarkan kode bedrock-agentcore layanan, Anda harus memintanya kembali di bawahagent-registry.

Pengamatan dan peristiwa

Perbarui kueri CloudTrail Lake, kueri Athena, integrasi SIEM, EventBridge aturan, dasbor, dan alarm yang CloudWatch mereferensikan namespace lama.

Permukaan Nilai lama Nilai baru

CloudTrail sumber acara

bedrock-agentcore.amazonaws.com

agent-registry.amazonaws.com

EventBridge sumber

aws.bedrock-agentcore

aws.agent-registry

CloudWatch ruang nama

AWS/BedrockAgentCore

AWS/AgentRegistry

EventBridge notifikasi

Di bawah bedrock-agentcore namespace, AWS Agen Registry memancarkan dua EventBridge peristiwa Amazon di bawah sumber aws.bedrock-agentcore peristiwa. Sumber peristiwa sekarang berubah menjadiaws.agent-registry, ARN sumber daya mengadopsi namespace baru, dan cakupan notifikasi diperluas ke catatan registri penuh dan siklus hidup registri. Acara terus pergi ke EventBridge bus default di akun sumber daya itu sendiri. Anda harus memperbarui EventBridge aturan apa pun yang cocok pada sumber lama atau string tipe detail lama.

Permukaan Nilai lama Nilai baru

Sumber peristiwa

aws.bedrock-agentcore

aws.agent-registry

Namespace ARN sumber daya

arn:aws:bedrock-agentcore:{region}:{account}:registry/…​

arn:aws:agent-registry:{region}:{account}:registry/…​

Bus acara

Bus default

Bus default (tidak berubah)

Registry-record acara

1 tipe detail (Registry Record State changed to Pending Approval)

5 tipe detail (siklus hidup persetujuan penuh)

Peristiwa registri

1 tipe detail (Registry State transitions from Creating to Ready)

7 tipe detail (siklus hidup registri penuh)

Muatan detail acara

registryRecordId, registryId (catatan)

(tidak berubah)

penting

Jenis detail registri (induk) berubah dari kalimat menjadi string status pendek. Aturan yang cocok dengan tipe detail Registry State transitions from Creating to Ready tidak lagi diaktifkan - perbarui keRegistry Ready. Jenis detail rekaman registri Registry Record State changed to Pending Approval tidak berubah, jadi aturan yang cocok terus berfungsi setelah Anda memperbarui. source

Registry-record peristiwa. Dipancarkan saat rekaman registri bertransisi antara status alur kerja persetujuan. Resourcesadalah catatan lengkap ARN; detail berisi registryRecordId danregistryId.

Tipe detail Pemicu

Registry Record State changed to Draft

Versi rekaman masuk DRAFT

Registry Record State changed to Pending Approval

SubmitRegistryRecordForApprovaldisebut (tidak berubah)

Registry Record State changed to Approved

Rekam transisi ke APPROVED

Registry Record State changed to Rejected

Rekam transisi ke REJECTED

Registry Record State changed to Deprecated

Rekam transisi ke DEPRECATED

Acara registri. Dipancarkan pada penyediaan registri dan transisi siklus hidup. Resourcesadalah registri lengkap ARN; detail berisi registryId danregistryName.

Tipe detail Pemicu

Registry Creating

Registri masuk CREATING

Registry Ready

Registri menjadi READY (menggantikan nilai bedrock-agentcore Registry State transitions from Creating to Ready namespace)

Registry Create Failed

Registri masuk CREATE_FAILED

Registry Updating

Registri masuk UPDATING

Registry Update Failed

Registri masuk UPDATE_FAILED

Registry Deleting

Registri masuk DELETING

Registry Delete Failed

Registri masuk DELETE_FAILED

Contoh acara (catatan registri).

Sebelum (bedrock-agentcorenamespace, tidak digunakan lagi):

{ "version": "0", "detail-type": "Registry Record State changed to Pending Approval", "source": "aws.bedrock-agentcore", "account": "123456789012", "region": "us-west-2", "resources": ["arn:aws:bedrock-agentcore:us-west-2:123456789012:registry/REG_ID/record/REC_ID"], "detail": { "registryRecordId": "REC_ID", "registryId": "REG_ID" } }

Setelah (agent-registrynamespace):

{ "version": "0", "detail-type": "Registry Record State changed to Pending Approval", "source": "aws.agent-registry", "account": "123456789012", "region": "us-west-2", "resources": ["arn:aws:agent-registry:us-west-2:123456789012:registry/REG_ID/record/REC_ID"], "detail": { "registryRecordId": "REC_ID", "registryId": "REG_ID" } }
catatan

Untuk mencocokkan perubahan status catatan registri dengan satu aturan, cocokkan pada source (aws.agent-registry) ditambah detail-type awalan. Registry Record State changed to Untuk mencocokkan perubahan siklus hidup registri, cocokkan pada awalan tipe detail `Registry `.

Contoh: Memperbarui kebijakan IAM

Ganti awalan tindakan dan namespace ARN sumber daya di semua kebijakan IAM Anda.

Sebelum (bedrock-agentcorenamespace, tidak digunakan lagi):

{ "Version": "2012-10-17", "Statement": [{ "Effect": "Allow", "Action": [ "bedrock-agentcore:CreateRegistry", "bedrock-agentcore:GetRegistry", "bedrock-agentcore:UpdateRegistry", "bedrock-agentcore:ListRegistries", "bedrock-agentcore:DeleteRegistry", "bedrock-agentcore:CreateRegistryRecord", "bedrock-agentcore:GetRegistryRecord", "bedrock-agentcore:UpdateRegistryRecord", "bedrock-agentcore:ListRegistryRecords", "bedrock-agentcore:DeleteRegistryRecord", "bedrock-agentcore:SubmitRegistryRecordForApproval", "bedrock-agentcore:UpdateRegistryRecordStatus", "bedrock-agentcore:SearchRegistryRecords" ], "Resource": ["arn:aws:bedrock-agentcore:us-west-2:123456789012:*"] }] }

Setelah (agent-registrynamespace):

{ "Version": "2012-10-17", "Statement": [{ "Effect": "Allow", "Action": [ "agent-registry:CreateRegistry", "agent-registry:GetRegistry", "agent-registry:UpdateRegistry", "agent-registry:ListRegistries", "agent-registry:DeleteRegistry", "agent-registry:CreateRegistryRecord", "agent-registry:GetRegistryRecord", "agent-registry:UpdateRegistryRecord", "agent-registry:ListRegistryRecords", "agent-registry:DeleteRegistryRecord", "agent-registry:SubmitRegistryRecordForApproval", "agent-registry:UpdateRegistryRecordStatus", "agent-registry:SearchDiscoverableRegistryRecords", "agent-registry:ListDiscoverableRegistryRecords", "agent-registry:GetDiscoverableRegistryRecord" ], "Resource": ["arn:aws:agent-registry:us-west-2:123456789012:*"] }] }
catatan

BatchGetDiscoverableRegistryRecordAPI tidak memiliki tindakan IAM sendiri. Ini mengotorisasi setiap catatan yang diminta terhadap agent-registry:GetDiscoverableRegistryRecord tindakan tersebut. Pastikan kebijakan Anda termasuk GetDiscoverableRegistryRecord untuk digunakanBatchGet.

penting

Identitas beban kerja dan sumber daya penyedia kredensia OAuth tetap berada di bawah namespace. bedrock-agentcore Jika registri Anda menggunakan URL sync (source.fromUrl) dengan kredentif OAuth atau IAM, Anda harus mempertahankan izin berikut di samping izin baru Anda: agent-registry:*

"bedrock-agentcore:CreateWorkloadIdentity", "bedrock-agentcore:GetWorkloadIdentity", "bedrock-agentcore:DeleteWorkloadIdentity"

Jangan mengganti setiap bedrock-agentcore tindakan — sumber daya identitas ini sengaja mempertahankan namespace lama.

Contoh: Memperbarui konfigurasi klien SDK

Perbarui nama layanan, kelas klien, dan URL titik akhir dalam panggilan SDK Anda.

Sebelum (bedrock-agentcorenamespace, tidak digunakan lagi):

import boto3 session = boto3.Session(region_name="us-west-2") cp_client = session.client( "bedrock-agentcore-control", endpoint_url="https://bedrock-agentcore-control.us-west-2.amazonaws.com" ) dp_client = session.client( "bedrock-agentcore", endpoint_url="https://bedrock-agentcore.us-west-2.amazonaws.com" )

Setelah (agent-registrynamespace):

import boto3 session = boto3.Session(region_name="us-west-2") cp_client = session.client( "agent-registry-control", endpoint_url="https://agent-registry-control.us-west-2.api.aws" ) dp_client = session.client( "agent-registry", endpoint_url="https://agent-registry.us-west-2.api.aws" )

Contoh: Memperbarui perintah CLI

Ganti namespace CLI di semua skrip dan otomatisasi.

Sebelum (bedrock-agentcorenamespace, tidak digunakan lagi):

aws bedrock-agentcore-control create-registry \ --name "MyRegistry" \ --description "Production registry" \ --region us-west-2 \ --endpoint-url https://bedrock-agentcore-control.us-west-2.amazonaws.com

Setelah (agent-registrynamespace):

aws agent-registry-control create-registry \ --name "MyRegistry" \ --description "Production registry" \ --region us-west-2 \ --endpoint-url https://agent-registry-control.us-west-2.api.aws

Perubahan skema API

Selain migrasi namespace, kami memperbarui model data registri dan catatan registri di agent-registry namespace. Perubahan ini meningkatkan konsistensi dan ekstensibilitas API berdasarkan umpan balik dari bedrock-agentcore namespace. Bagian ini mencakup setiap kategori perubahan dengan contoh sebelum dan sesudah sehingga Anda dapat memperbarui kode aplikasi Anda.

Ubah 1: Pembaruan entitas registri

Konfigurasi otorisasi pada sumber daya registri — yang mengontrol bagaimana bidang data registri diakses — sekarang berada di bawah pem discoveryConfiguration bungkus khusus yang membuat tujuannya eksplisit. Konfigurasi persetujuan (yang mengontrol apakah catatan yang dikirimkan ke PENDING_APPROVAL status secara otomatis bertransisi ke APPROVED status) berpindah dari larik boolean ke larik enum yang dapat diperluas.

Perubahan bidang spesifik adalah:

  • authorizerTypedan authorizerConfiguration dipindahkan ke dalam discoveryConfiguration objek baru.

  • approvalConfiguration.autoApproval(boolean) diganti dengan approvalConfiguration.autoApprovalRules (array string enum). Nilai "APPROVE_ALL" memiliki makna semantik yang sama denganautoApproval: true. Aturan yang ditentukan dalam daftar enum diterapkan. Tidak menentukan (null) berarti persetujuan diperlukan.

Sebelum (bedrock-agentcorenamespace, tidak digunakan lagi):

{ "name": "string", "description": "string", "authorizerConfiguration": { ... }, "authorizerType": "string", "approvalConfiguration": { "autoApproval": true } }

Setelah (agent-registrynamespace): dengan Persetujuan SEMUA

{ "name": "string", "description": "string", "discoveryConfiguration": { "authorizerConfiguration": { ... }, "authorizerType": "string" }, "approvalConfiguration": { "autoApprovalRules": ["APPROVE_ALL"] } }

Setelah (agent-registrynamespace): dengan NULL dalam daftar enum

{ "name": "string", "description": "Registry with manual approval only", "approvalConfiguration": { "autoApprovalRules": [] } }

Ubah 2: Bidang wajib baru pada catatan registri

Catatan registri mendapatkan dua bidang tingkat atas baru yang diperlukan untuk mendukung kategorisasi dan deduplikasi yang lebih baik. Anda harus menentukan kedua bidang saat membuat catatan registri menggunakan CreateRegistryRecord API, dan Anda dapat mengubahnya nanti menggunakan UpdateRegistryRecord API.

Bidang Tipe Deskripsi

name

String (wajib)

Pengidentifikasi unik dalam registri yang dapat ditentukan oleh pelanggan. Setiap catatan harus memiliki nama unik dalam registri. Ketika recordVersion juga hadir, kombinasi name dan recordVersion harus unik.

recordType

Enum (wajib)

Jenis semantik dari catatan. Nilai yang valid:AGENT,MCP,SKILL,CUSTOM. Menentukan kunci deskriptor utama mana yang valid di bawahdescriptors. Anda dapat menggunakan API seperti ListRegistryRecords dan SearchDiscoverableRegistryRecords untuk memfilter hasil berdasarkan jenis semantik ini.

Perubahan 3: Restrukturisasi catatan registri

Bid descriptors ang berubah dari penyatuan yang didiskriminasi menjadi struktur kunci datar.

Pada model sebelumnya, descriptorType bidang (MCP,, A2AAGENT_SKILLS,CUSTOM) menentukan bentuk bagian dalam. Ini menggabungkan konten deskriptor ke protokol kasar atau klasifikasi format. Bidang itu sudah tidak ada lagi. recordType, atribut tingkat atas yang terpisah, menggantikannya untuk kategorisasi semantik. API memberlakukan kunci deskriptor yang valid untuk masing-masing recordType saat runtime daripada secara struktural dalam bentuk. Setiap kunci tingkat atas di bawah descriptors sekarang mewakili tipe deskriptor primer granular (misalnya,,, a2aAgentCard mcpServeragentSkillsDefinition,custom). Deskriptor tambahan (misalnya,tools,skillMd) bersarang di bawah deskriptor utama. additionalData inlineContentLapangan menjadi data Bidang schemaVersion dan protocolVersion berkonsolidasi menjadidataSchemaVersion.

A synchronizationConfiguration tribut tingkat atas menjadi source dan bergerak di dalam setiap deskriptor (termasuk additionalData anak-anak).

nameBidang yang ada menjadidisplayName, membuat maknanya lebih eksplisit. Bidang net- name new berfungsi sebagai kunci dedup dan harus unik di semua catatan dalam registri. Jika Anda menentukan keduanya name dan recordVersion untuk catatan yang sama, kombinasinya harus unik.

Bidang berikut diganti namanya:

Sebelum Setelah Catatan

name

displayName

Menampilkan nama catatan. Juga akan ada name bidang baru yang merupakan kunci dedup.

descriptorType

Dihapus

Digantikan oleh recordType bidang tingkat atas.

inlineContent

data

Payload konten dalam setiap deskriptor.

schemaVersion / protocolVersion

dataSchemaVersion

Bidang versi terpadu untuk semua jenis deskriptor.

synchronizationConfiguration

source

Pindah di dalam setiap deskriptor (termasuk additionalData anak-anak).

Sebelum (bedrock-agentcorenamespace, tidak digunakan lagi):

{ "recordId": "string", "name": "string", "descriptorType": "string", // A2A, MCP, AGENT_SKILL, CUSTOM "descriptors": { "agent": { "a2aAgentCard": { "inlineContent": "string", "schemaVersion": "string" } }, "agentSkills": { "skillDefinition": { "inlineContent": "string", "schemaVersion": "string" }, "skillMd": { "inlineContent": "string" } }, "mcp": { "server": { "inlineContent": "string", "schemaVersion": "string" }, "tools": { "inlineContent": "string", "protocolVersion": "string" } }, "custom": { "inlineContent": "string" } }, "synchronizationType": "URL", "synchronizationConfiguration": { "fromUrl": { "url": "string", "credentialProviderConfigurations": [ { "credentialProvider": { ... }, "credentialProviderType": "string" } ] } }, ... }

Setelah (agent-registrynamespace):

{ "recordId": "string", "displayName": "string", "name": "string", "recordVersion": "string", "recordType": "AGENT" | "MCP" | "SKILL" | "CUSTOM", "descriptors": { "a2aAgentCard": { "data": "string", "dataSchemaVersion": "string", "source": { "fromUrl": { "url": "string", "credentialProviderConfigurations": [...] } } }, "mcpServer": { "data": "string", "dataSchemaVersion": "string", "source": { "fromUrl": { ... } }, "additionalData": { "tools": { "data": "string", "dataSchemaVersion": "string" } } }, "agentSkillsDefinition": { "data": "string", "dataSchemaVersion": "string", "additionalData": { "skillMd": { "data": "string", "dataSchemaVersion": "string", "source": { "fromUrl": { ... } } } } }, "custom"?: { "data": "string" } } ... }

Batasan berikut berlaku:

Tepat satu kunci deskriptor utama dapat diisi per catatan. Deskriptor utama yang valid recordType adalah:

  • AGEN: a2aAgentCard,mcpServer, custom

  • MCP: mcpServer, custom

  • KETERAMPILAN: agentSkillsDefinition, custom

  • KUSTOM: custom

sourceadalah per-deskriptor daripada blok tingkat atas tunggal. Ini melekat pada deskriptor yang membawa source bidang dalam skema — mcpServer dana2aAgentCard. toolsAnak (di bawahmcpServer.additionalData), agentSkillsDefinition orang tua, dan custom deskriptor membawa nosource.

Di agent-registry namespace, hanya source.fromUrl didukung.

Auto-synchronization hanya dipicu untuk deskriptor mcpServer dan a2aAgentCard primer — yaitu, tipe catatan MCP dan AGENT. A source pada skillMd anak tetap ada tetapi tidak digunakan untuk menjalankan sinkronisasi, dan catatan SKILL tidak dapat disinkronkan secara otomatis. Catatan KUSTOM harus dibuat secara manual dengan menyediakan data secara langsung.

Ubah 4: Pembaruan filter bidang data

SearchRegistryRecordsmenjadi SearchDiscoverableRegistryRecords (POST /discoverable-records-search). Permintaan dan tanggapannya mengambil nama bidang dan model data baru:

  • Filter dengan recordType (menggantikandescriptorType).

  • Filter dengan recordVersion (menggantikanversion).

  • Respons mengembalikan deskriptor dalam format baru, tanpacredentialProviderConfigurations.

Alat pencarian MCP search_registry_records menjadisearch_discoverable_registry_records, mengembalikan format deskriptor baru, dan menggunakan nama filter baru.

Ubah 5: API penelusuran baru

Dua API bidang data baru mendukung pembuatan pengalaman penelusuran dan katalog di atas catatan yang disetujui. API ini tidak memerlukan migrasi eksplisit apa pun; kami menyebutkannya di sini sebagai tambahan pada model API AWS Agen Registry di agent-registry namespace.

ListDiscoverableRegistryRecords— Mengembalikan daftar halaman catatan registri yang disetujui. Gunakan ini untuk membangun antarmuka penelusuran di atas konten yang dipublikasikan.

// HTTP: POST /registries/{registryId}/discoverable-records-list { "registryId": "string", // path param, required (ARN or ID) "maxResults": 1-100, // query param, optional "nextToken": "string", // query param, optional "filters": [ { "name": "recordType", "values": ["MCP"] } ] } { "registryRecords": [ { "registryArn": "string", "recordArn": "string", "recordId": "string", "name": "string", "displayName": "string", "description": "string", "recordType": "string", "recordVersion": "string", "status": "string", "createdAt": "string", "updatedAt": "string" } ], "nextToken": "string" }

BatchGetDiscoverableRegistryRecord— Mengambil detail lengkap untuk kumpulan catatan di satu atau lebih registri dalam satu panggilan.

// HTTP: POST /discoverable-records-batch { "entries": [ { "registryId": "reg-AAA", "recordIds": ["rec-111", "rec-222"] } ] } { "registryRecords": [ { "registryArn": "string", "recordArn": "string", "recordId": "string", "name": "string", "displayName": "string", "description": "string", "recordType": "string", "descriptors": { ... }, "recordVersion": "string", "status": "string", "createdAt": "string", "updatedAt": "string" } ], "errors": [ { "registryId": "string", "recordId": "string", "errorCode": "RESOURCE_NOT_FOUND" | "ACCESS_DENIED" | "INTERNAL_ERROR", "message": "string" } ] }

Respons mencakup registryRecords array dengan detail rekaman lengkap dan errors array untuk setiap catatan yang tidak dapat diambil.

Saat peluncuran, tepat satu entri (satu registri, 1-100 ID catatan) diterima. Bentuk yang dikelompokkan kompatibel ke depan dengan batching lintas registri di rilis mendatang.

Ubah 6: Daftar API mengadopsi parameter filter terstruktur

Di bedrock-agentcore namespace, List API mengekspos setiap bidang yang dapat difilter sebagai parameter kuerinya sendiri (misalnya,--status READY,--recordType MCP). Dalam agent-registry namespace, filters parameter terstruktur tunggal menggantikan parameter diskrit ini. filtersNilai adalah daftar { "name": "<dotted.path>", "values": ["<value>"] } entri di mana name terdapat jalur atribut yang dibatasi titik. Bidang baru yang dapat disaring, termasuk yang bersarang, menjadi name jalur baru daripada parameter API baru. Operasi daftar juga berubah dari GET kePOST. Parameter paginasi (maxResults,nextToken) tidak berubah.

Sebelum (bedrock-agentcorenamespace, tidak digunakan lagi):

GET /registries?status=READY&authorizerType=AWS_IAM GET /registries/{registryId}/records?name=my-agent&status=APPROVED&recordType=MCP

Setelah (agent-registrynamespace):

// ListRegistries // POST /registries-list { "filters": [ { "name": "status", "values": ["READY"] }, { "name": "discoveryConfiguration.authorizerType", "values": ["AWS_IAM"] } ], "maxResults": 100, "nextToken": "string" } // ListRegistryRecords // POST /registries/{registryId}/records-list { "filters": [ { "name": "name", "values": ["my-agent"] }, { "name": "status", "values": ["APPROVED"] }, { "name": "recordType", "values": ["MCP"] } ], "maxResults": 100, "nextToken": "string" }

Migrasi data

Anda harus memigrasikan registri dan catatan registri yang ada dari bedrock-agentcore namespace ke namespace. agent-registry Kami menyediakan alat migrasi untuk membantu migrasi. Alat ini menangani ekstraksi data yang ada, transformasi dari skema lama ke skema baru, dan memuat ke registri di namespace baru. Alat ini membuat registri baru di agent-registry namespace dalam akun dan wilayah yang sama. Ini memigrasikan semua catatan yang ada dari registri lama Anda ke yang baru, memperhitungkan perubahan skema namespace dan API.

Alat migrasi tersedia di repositori sampel agentcore di situs web. GitHub Untuk petunjuk penyiapan lengkap, referensi perintah, dan panduan operasional, lihat repositori README.

Memilih pendekatan migrasi

Pendekatan yang tepat tergantung pada apakah migrasi penuh satu kali sudah cukup atau apakah Anda memerlukan eksekusi tanpa pengawasan dan kemampuan untuk menjalankan beban tambahan pada cutover.

Kasus 1: Migrasi sederhana

  • Profil: Migrasi penuh satu kali sudah cukup. Anda tidak perlu menjalankan beban tambahan atau membiarkan pekerjaan berjalan tanpa pengawasan.

  • Pendekatan: Jalankan alat migrasi langsung dari terminal Anda atau AWS CloudShell. Tidak ada infrastruktur untuk digunakan. Alat ini terhubung ke bedrock-agentcore namespace, mengekstrak registri dan catatan Anda, mengubah data ke agent-registry skema, dan membuatnya di namespace baru. Ini adalah jalur paling sederhana dan tidak memerlukan penyebaran infrastruktur.

Kasus 2: Migrasi terkelola dengan AWS Lem

  • Profil: Anda lebih suka eksekusi tanpa pengawasan, atau Anda berencana untuk menjalankan kedua versi registri secara paralel selama periode tertentu dan memerlukan beban tambahan pada cutover untuk menangkap catatan apa pun yang dibuat atau diperbarui di bedrock-agentcore namespace setelah proses penuh awal.

  • Pendekatan: Terapkan migrasi sebagai pekerjaan AWS Glue menggunakan tumpukan CDK yang disediakan. Pekerjaan berjalan di akun Anda tanpa bergantung pada sesi terminal terbuka.

    Alur tipikal adalah: jalankan migrasi penuh untuk memperbarui agent-registry namespace, lalu operasikan kedua ruang nama secara paralel saat Anda memvalidasi dan memperbarui integrasi Anda. Saat Anda siap untuk memotong, jalankan beban tambahan untuk menyinkronkan catatan apa pun yang berubah selama periode paralel, memverifikasi, dan mengalihkan lalu lintas ke agent-registry namespace.

Kasus 3: Active-active migrasi

  • Profil: Anda telah membangun platform atau pipeline otomatisasi di atas API bedrock-agentcore namespace dan terus menulis catatan baru dalam produksi.

  • Pendekatan: Mulailah dengan migrasi penuh menggunakan AWS Glue-based pendekatan terkelola untuk membawa semua data historis ke dalam agent-registry namespace. Kemudian arahkan platform atau pipeline Anda ke agent-registry namespace selain bedrock-agentcore namespace — aplikasi Anda menulis ke keduanya secara bersamaan. Gunakan periode aktif-aktif ini untuk memvalidasi integrasi Anda dan membangun kepercayaan pada namespace. agent-registry Setelah Anda puas, potong semua pembacaan dan penulisan ke agent-registry dan nonaktifkan integrasi bedrock-agentcore namespace.

Memverifikasi migrasi Anda

Setelah menjalankan migrasi, konfirmasikan bahwa data Anda telah dimigrasi dengan benar:

  • Daftar semua registri di namespace baru menggunakan perintah list-registries CLI dan konfirmasikan jumlah cocok dengan sumber Anda.

  • Untuk setiap registri, bandingkan jumlah catatan menggunakanlist-registry-records.

  • Spot-check catatan individu untuk mengkonfirmasi bahwa deskriptor diubah dengan benar (penggantian nama bidang, restrukturisasi deskriptor).

  • Perbarui kebijakan IAM, titik akhir, dan klien SDK seperti yang dijelaskan di bagian Namespace dan perubahan konfigurasi.

  • Pastikan aplikasi Anda berhasil membaca dan menulis menggunakan namespace baru.

Perbarui kebijakan kepercayaan IAM untuk catatan yang disinkronkan

Jika salah satu catatan registri Anda menggunakan Sinkronisasi dengan jenis kredensia peran IAM, Anda harus memperbarui kebijakan kepercayaan peran sebelum menjalankan pemuatan langsung. Prinsip layanan yang mengasumsikan peran diubah dari bedrock-agentcore.amazonaws.com ke agent-registry.amazonaws.com dalam namespace baru. Catatan yang menggunakan kredentif OAuth atau tanpa otorisasi tidak terpengaruh.

catatan

Alat migrasi tidak dapat mendeteksi ini — alat tidak pernah mengambil peran sinkronisasi. Layanan registri mengasumsikannya secara asinkron setelah catatan dibuat. Jika Anda melewatkan langkah ini, rekaman yang dimigrasi tiba di agent-registry namespace menunjuk pada peran yang sama, dan sinkronisasi gagal sampai peran mempercayai prinsipal baru.

Perbarui kebijakan kepercayaan pada peran yang direferensikan oleh setiap catatan yang terpengaruh.

Sebelum (bedrock-agentcorenamespace, tidak digunakan lagi):

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "bedrock-agentcore.amazonaws.com" }, "Action": "sts:AssumeRole" } ] }

Setelah (agent-registrynamespace):

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "agent-registry.amazonaws.com" }, "Action": "sts:AssumeRole" } ] }

Jika catatan telah gagal karena alasan ini, catatan yang dimigrasi ada dalam CREATE_FAILED status. Alat migrasi menolak untuk mengganti catatan dalam status kegagalan, jadi memperbaiki kebijakan kepercayaan saja tidak menyelesaikannya. Untuk memulihkan:

  1. Perbarui kebijakan kepercayaan pada peran yang terpengaruh.

  2. Hapus CREATE_FAILED catatan dari agent-registry namespace.

  3. Re-run beban.

Pertanyaan yang Sering Diajukan

Apa yang berubah di AWS Pendaftaran Agen?

AWS Agen Registry bergerak dari bedrock-agentcore namespace ke agent-registry namespace khusus baru. Migrasi mencakup tiga area: perubahan namespace dan konfigurasi (titik akhir, IAM, SDK, CLI, ARN, observabilitas), perubahan skema API (model data yang direstrukturisasi untuk registri dan catatan), dan migrasi data (memindahkan registri dan catatan yang ada ke namespace baru).

Bisakah saya terus menggunakan Registry di namespace bedrock-agentcore?

Penggunaan Registry yang ada di bedrock-agentcore namespace terus bekerja tanpa gangguan selama jendela migrasi. Namun, kami menyarankan Anda memulai migrasi segera setelah alat tersedia untuk memastikan Anda memiliki cukup waktu untuk menyelesaikan migrasi data dan pembaruan kode.

Namun, jika Anda tidak memiliki registri atau catatan yang ada pada 6 Agustus 2026, Anda tidak dapat mengakses bedrock-agentcore namespace untuk AWS Agen Registry mulai 6 Agustus 2026. Jika Anda memiliki registri atau catatan yang ada pada 6 Agustus 2026, Anda memiliki akses ke bedrock-agentcore namespace untuk AWS Agen Registry selama jendela migrasi (6 Agustus 2026 — 17 September 2026).

Apakah data saya akan dimigrasi secara otomatis?

Tidak. Anda harus memulai migrasi sendiri menggunakan alat migrasi yang kami sediakan. Lihat bagian Migrasi data untuk detail tentang pendekatan yang tersedia berdasarkan skala Anda.

Perubahan skema API apa yang disertakan?

Selain perubahan namespace, kami memperbarui model data API di enam area: entitas registri (konfigurasi otorisasi dikelompokkan di bawahdiscoveryConfiguration), rekaman registri bidang baru (namedanrecordType), restrukturisasi catatan registri (deskriptor diratakan, mengganti nama bidang), pembaruan filter API pencarian (recordType,recordVersion), API penelusuran baru (ListDiscoverableRegistryRecords,BatchGetDiscoverableRegistryRecord), dan filter terstruktur untuk operasi Daftar.

Berapa lama migrasi data akan berlangsung?

Waktu migrasi tergantung pada jumlah registri dan catatan di akun Anda. Untuk akun dengan kurang dari 100 catatan, migrasi selesai dalam hitungan menit saat dijalankan secara lokal. Untuk akun dengan ribuan catatan, perkirakan migrasi selesai dalam waktu kurang dari 15 menit saat dijalankan sebagai pekerjaan terkelola.

Bagaimana jika saya memiliki penerapan skala besar dengan penulisan aktif?

Jika Anda secara aktif menulis data ke bedrock-agentcore namespace dalam produksi, gunakan pendekatan migrasi aktif-aktif seperti yang dijelaskan dalam Kasus 3. Mulailah dengan migrasi penuh untuk memperbarui agent-registry namespace, lalu tulis ke kedua ruang nama secara bersamaan untuk memvalidasi integrasi Anda dan membangun kepercayaan pada namespace baru. Potong bacaan dan tulis agent-registry ketika Anda siap.

Di mana saya bisa mendapatkan bantuan?

Untuk pertanyaan atau bantuan terkait migrasi Anda, hubungi AWS Dukungan.