Buat catatan registri Daftar catatan registri Lihat detail catatan Perbarui catatan registri Kirim catatan untuk persetujuan Hapus catatan registri Validasi skema

Membuat dan mengelola catatan

Migrasi namespace yang akan datang

AWS Agent Registry saat ini dalam pratinjau publik di bawah namespace bedrock-agentcore. Mulai 6 Agustus 2026, layanan pindah ke namespace agen-registri. Jika Anda menggunakan AWS Agen Registri, Anda harus memperbarui titik akhir, kebijakan IAM, klien SDK, skrip CLI, dan data registri. Untuk informasi selengkapnya tentang migrasi dari pratinjau publik, lihat Panduan migrasi registri komprehensif.

Buat catatan registri

Konsol

Buka halaman detail registri.
Di bagian Catatan registri, pilih Buat catatan.
Pilih jenis sumber:
1. Sinkronisasi dari titik akhir - Berikan URL titik akhir dan kredensyal opsional untuk memanggil titik akhir, dan registri mengambil metadata dari sumbernya. Hanya tersedia untuk jenis catatan MCP dan Agen. Untuk memperbarui catatan setelah sumber berubah, Anda harus memicu sinkronisasi secara manual. Lihat Menyinkronkan catatan dari sumber eksternal untuk detailnya.
2. Manual - Konfigurasikan detail catatan dan konfigurasi protokol secara manual.

Sinkronisasi dari titik akhir

Di bawah Rekam detail, pilih jenis rekaman: MCP atau Agen.

catatan
Sinkronisasi hanya didukung untuk jenis catatan MCP dan Agen. Keterampilan Agen dan jenis rekaman kustom tidak mendukung sinkronisasi — gunakan tipe sumber Manual sebagai gantinya.
Masukkan URL Endpoint. Harus URL HTTPS yang valid.
Di bawah Jenis kredensyal, pilih cara registri mengotorisasi dengan titik akhir:
1. IAM — Menyediakan ARN Peran untuk penandatanganan SigV4 dan nama Layanan (misalnyabedrock-agentcore,,,). execute-api lambda Secara opsional menentukan Region untuk ditandatangani.
2. OAuth — Pilih atau masukkan penyedia Kredensyal ARN dari Identity. AgentCore Secara opsional mengkonfigurasi Cakupan dan parameter Kustom di bawah Konfigurasi tambahan.
3. Tidak ada - Tidak ada otorisasi (untuk titik akhir publik).
Pilih Buat catatan.

Catatan dibuat dalam status CREATING. Registri terhubung ke titik akhir, mengekstrak metadata, dan mengisi deskriptor catatan. Setelah sinkronisasi selesai, catatan transisi ke DRAFT. Jika sinkronisasi gagal, catatan akan beralih ke status CREATE_FAILED dengan detail kesalahan yang tersedia di bidang Alasan Status pada halaman detail rekaman. Untuk pemecahan masalah, lihat Merekam kesalahan sinkronisasi. Untuk memperbarui rekaman saat sumber berubah, gunakan tombol Sinkronisasi pada halaman detail rekaman atau pilih Re-sync dari titik akhir selama pengeditan.

Untuk contoh AWS CLI dan SDK dalam membuat catatan dengan sinkronisasi, lihat Menyinkronkan catatan dari sumber eksternal.

Manual

Di bawah Rincian rekam, masukkan:
1. Nama — Harus dimulai dengan huruf atau digit. Karakter yang valid adalah a-z, A-Z, 0-9, _ (garis bawah), - (tanda hubung),. (dot), dan/(garis miring ke depan). Nama dapat memiliki hingga 255 karakter.
2. Deskripsi (opsional) - 1 hingga 4.096 karakter.
3. Versi rekaman - Tentukan versi catatan ini (misalnya, 1.0.0, v2.1).
Di bawah Jenis Rekam, pilih salah satu dari: MCP, Agen, Keterampilan Agen, atau Kustom.
Editor khusus tipe muncul. Masukkan konfigurasi protokol Anda dalam format JSON.
1. Untuk jenis Agen dan MCP, alihkan Tampilkan skema resmi untuk menampilkan skema referensi secara berdampingan untuk panduan.
2. Konsol memvalidasi JSON Anda terhadap skema resmi dan menampilkan kesalahan sebaris (misalnya, “Nama 'properti hilang”) dengan tombol Diagnosa dengan Amazon Q.
Pilih salah satu dari:
1. Buat sebagai draf - Membuat catatan dalam status Draf.
2. Buat dan kirimkan untuk persetujuan - Membuat catatan dan segera mengirimkannya untuk persetujuan.

AWS CLI


aws bedrock-agentcore-control create-registry-record \
  --registry-id <registryId> \
  --name "MyMCPServer" \
  --descriptor-type MCP \
  --descriptors '{"mcp": {"server": {"inlineContent": "{\"name\": \"my/mcp-server\", \"description\": \"My MCP server\", \"version\": \"1.0.0\"}"}}}' \
  --record-version "1.0" \
  --region us-east-1

AWS SDK


import boto3
import json

client = boto3.client('bedrock-agentcore-control')

server_content = json.dumps({
    "name": "my/mcp-server",
    "description": "My MCP server",
    "version": "1.0.0"
})

response = client.create_registry_record(
    registryId='<registryId>',
    name='MyMCPServer',
    descriptorType='MCP',
    descriptors={
        'mcp': {
            'server': {
                'inlineContent': server_content
            }
        }
    },
    recordVersion='1.0'
)
print(f"Record ARN: {response['recordArn']}")
print(f"Status: {response['status']}")  # CREATING

Daftar catatan registri

Konsol

Buka halaman detail registri.
Bagian catatan Registri menampilkan:
1. Penghitung ringkasan status — Total yang dikirimkan, Persetujuan tertunda, Disetujui, Tidak Digunakan Lagi, Ditolak.
2. Tabel rekaman dengan kolom: Nama, Deskripsi, Status, Jenis rekaman, Rekam ARN, Terakhir diperbarui.
Gunakan bilah Rekaman pencarian untuk memfilter berdasarkan nama.
Gunakan menu tarik-turun Perbarui status untuk melakukan perubahan status massal pada catatan yang dipilih.

AWS CLI


aws bedrock-agentcore-control list-registry-records \
  --registry-id "<registryId>" \
  --region us-east-1

AWS SDK


import boto3

client = boto3.client('bedrock-agentcore-control')

response = client.list_registry_records(
    registryId='<registryId>'
)
for record in response['registryRecords']:
    print(f"{record['name']} - {record['status']} - {record['descriptorType']}")

Lihat detail catatan

Konsol

Dari halaman detail registri, pilih nama rekaman dari tabel catatan.
Halaman detail rekaman menampilkan:
1. Bagian detail rekam - Nama, Deskripsi, Rekam ARN, Status (ditampilkan sebagai lencana di sebelah nama rekaman), Versi, Tanggal terakhir diperbarui, Jenis rekaman, ID Rekam, Tanggal dibuat.
2. Bagian konfigurasi sinkronisasi (jika dikonfigurasi) — Jenis sinkronisasi, URL Sumber, dan detail penyedia kredensyal (ARN peran IAM, layanan, wilayah atau penyedia OAuth ARN, jenis hibah, cakupan, parameter khusus).
3. Bagian konfigurasi protokol - Konten deskriptor ditampilkan sebagai JSON yang diformat (misalnya, “Kartu agen” untuk catatan A2A, “Server” dan “Alat” untuk catatan MCP).
Tindakan yang tersedia:
1. Tombol sinkronisasi (hanya catatan MCP dan Agen) - Memicu sinkronisasi baru dari titik akhir yang dikonfigurasi. Membuka dialog konfirmasi sebelum melanjutkan. Rekaman transisi ke status UPDATE selama sinkronisasi.
2. Update status dropdown — Kirim untuk persetujuan, Menyetujui, Menolak, atau Menghentikan.
3. Three-dot menu () — Edit atau Hapus.

AWS CLI


aws bedrock-agentcore-control get-registry-record \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --region us-east-1

AWS SDK


import boto3

client = boto3.client('bedrock-agentcore-control')

response = client.get_registry_record(
    registryId='<registryId>',
    recordId='<recordId>'
)
print(f"Name: {response['name']}")
print(f"Description: {response['description']}")
print(f"Status: {response['status']}")
print(f"Descriptor Type: {response['descriptorType']}")
print(f"Version: {response['recordVersion']}")

Perbarui catatan registri

Konsol

Dari halaman detail rekam, pilih menu tiga titik (), lalu pilih Edit.
Pada halaman Edit catatan, perbarui salah satu dari berikut ini:
1. Nama, Deskripsi, Rekam versi di bawah Rincian rekam.
2. Jenis rekaman - Ubah jenis protokol jika diperlukan.
(Hanya catatan MCP dan Agen) Di bawah Sinkronisasi dari titik akhir, konfigurasikan sinkronisasi secara opsional:

Anda dapat memperbarui catatan melalui sinkronisasi terlepas dari apakah mereka awalnya dibuat dengan sinkronisasi. Ketika sinkronisasi dipicu selama pembaruan, catatan transisi ke status UPDATE. Jika berhasil, versi rekaman baru dibuat dalam status DRAFT. Jika gagal, catatan akan beralih ke status UPDATE_FAILED dengan detail kesalahan di bidang Alasan Status. Data yang disinkronkan menimpa nama rekaman, deskripsi, versi, definisi alat, dan definisi server dengan nilai yang ditemukan di sumber, tetapi tidak memodifikasi bidang yang tidak disediakan sumber. Admin atau kurator harus meninjau dan menyetujui draf baru agar terlihat dalam pencarian. Sampai saat itu, revisi yang disetujui sebelumnya (jika ada) tetap dapat dicari. Untuk informasi selengkapnya tentang perilaku revisi ganda, lihat Merekam siklus hidup.
1. Masukkan URL Endpoint untuk mengaktifkan sinkronisasi. Bidang jenis kredensi muncul saat titik akhir disediakan. Jika catatan sudah memiliki sinkronisasi yang dikonfigurasi, bidang endpoint dan penyedia kredensi sudah diisi sebelumnya dengan konfigurasi yang ada.
2. Pilih jenis Credential (IAM, OAuth, atau None) dan isi kolom yang diperlukan. Jika catatan sebelumnya dikonfigurasi dengan penyedia kredensi, nilai yang ada sudah diisi sebelumnya.
3. Pilih Re-sync dari titik akhir untuk memicu sinkronisasi baru saat menyimpan. Rekaman transisi ke status UPDATE selama sinkronisasi.
4. Untuk menghapus sinkronisasi, pilih tombol hapus di sebelah bidang titik akhir. Ini mengatur ulang titik akhir dan semua bidang kredensi.
Di bawah konfigurasi Rekam, perbarui definisi rekaman di editor JSON.
1. Anda dapat mengonfigurasi titik akhir untuk sinkronisasi dan mengedit definisi rekaman secara manual. Saat sinkronisasi dipicu, registri mengambil metadata terbaru dari titik akhir dan memperbarui nama rekaman, deskripsi, versi, definisi alat, dan definisi server dengan nilai yang ditemukan di sumber, lebih diutamakan daripada pengeditan manual apa pun ke bidang tersebut. Bidang yang tidak disediakan sumber tidak dimodifikasi.
Konsol memvalidasi JSON Anda terhadap skema resmi dan menampilkan kesalahan sebaris dengan tombol Diagnosa dengan Amazon Q.
Pilih salah satu dari:
1. Simpan perubahan - Menyimpan catatan sebagai draf.
2. Simpan dan kirimkan untuk persetujuan - Menyimpan dan mengirimkan dalam satu langkah.

Spanduk sukses mengonfirmasi: “[Nama] diperbarui dan diserahkan untuk persetujuan dengan sukses.”

AWS CLI


aws bedrock-agentcore-control update-registry-record \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --description "Updated description" \
  --region us-east-1

AWS SDK


import boto3

client = boto3.client('bedrock-agentcore-control')

response = client.update_registry_record(
    registryId='<registryId>',
    recordId='<recordId>',
    description='Updated description'
)
print(f"Updated: {response['name']} - Status: {response['status']}")

Kirim catatan untuk persetujuan

Konsol

Dari halaman detail catatan -

Pilih dropdown status Perbarui
Kemudian, pilih Kirim untuk persetujuan.
1. Atau, gunakan Buat dan kirim untuk persetujuan atau Simpan dan kirimkan untuk persetujuan selama pembuatan atau pengeditan.

catatan

Jika Auto-Approval konfigurasi Registry disetel ke TRUE, maka mengirimkan catatan untuk persetujuan secara otomatis menyetujuinya. Jika tidak, jika Auto-Approval konfigurasi disetel ke FALSE, maka catatan pindah ke status 'Persetujuan Tertunda' dan menunggu Kurator untuk Menyetujui atau Menolaknya. Selain itu, EventBridge pemberitahuan Amazon dipicu yang menunjukkan catatan baru telah diminta untuk disetujui.

AWS CLI


aws bedrock-agentcore-control submit-registry-record-for-approval \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --region us-east-1

AWS SDK


import boto3

client = boto3.client('bedrock-agentcore-control')

response = client.submit_registry_record_for_approval(
    registryId='<registryId>',
    recordId='<recordId>'
)
print(f"Status: {response['status']}")  # PENDING_APPROVAL or APPROVED

Hapus catatan registri

Konsol

Dari halaman detail rekam, pilih menu tiga titik (), lalu pilih Hapus.
Konfirmasikan penghapusan dengan mengetikkan 'hapus' saat diminta

Penghapusan bersifat permanen dan tidak dapat dibatalkan.

AWS CLI


aws bedrock-agentcore-control delete-registry-record \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --region us-east-1

AWS SDK


import boto3

client = boto3.client('bedrock-agentcore-control')

response = client.delete_registry_record(
    registryId='<registryId>',
    recordId='<recordId>'
)
print("Record deleted successfully")

Validasi skema

Saat Anda membuat atau mengedit rekaman, konsol dan API memvalidasi konfigurasi protokol Anda terhadap skema resmi untuk jenis rekaman yang dipilih. Detail selengkapnya tentang validasi dapat ditemukan di Jenis rekaman yang didukung.

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Rekam siklus hidup

Sinkronkan catatan dari sumber eksternal