# 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](registry-faq.md). ## Buat catatan registri ### Konsol 1. Buka halaman detail registri. 1. Di bagian **Catatan registri**, pilih **Buat catatan**. 1. 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](registry-sync-records.md) untuk detailnya. 1. **Manual** - Konfigurasikan detail catatan dan konfigurasi protokol secara manual. **Sinkronisasi dari titik akhir** 1. 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. 1. Masukkan URL **Endpoint**. Harus URL HTTPS yang valid. 1. Di bawah **Jenis kredensyal**, pilih cara registri mengotorisasi dengan titik akhir: 1. **IAM** **— Menyediakan **ARN Peran** untuk penandatanganan SigV4 dan nama Layanan (misalnya`bedrock-agentcore`,,,).** `execute-api` `lambda` Secara opsional menentukan **Region** untuk ditandatangani. 1. **OAuth** — Pilih atau masukkan **penyedia Kredensyal ARN** dari Identity. AgentCore Secara opsional mengkonfigurasi **Cakupan** dan **parameter Kustom** di bawah Konfigurasi tambahan. 1. **Tidak ada** - Tidak ada otorisasi (untuk titik akhir publik). 1. 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](registry-troubleshooting.md#registry-troubleshooting-sync-errors). 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](registry-sync-records.md) eksternal. **Manual** 1. 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. 1. **Deskripsi** (opsional) - 1 hingga 4.096 karakter. 1. **Versi rekaman** - Tentukan versi catatan ini (misalnya, 1.0.0, v2.1). 1. Di bawah **Jenis Rekam**, pilih salah satu dari: **MCP**, **Agen**, **Keterampilan Agen**, atau **Kustom**. 1. 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. 1. Konsol memvalidasi JSON Anda terhadap skema resmi dan menampilkan kesalahan sebaris (misalnya, “Nama 'properti hilang”) dengan tombol Diagnosa **dengan Amazon Q**. 1. Pilih salah satu dari: 1. **Buat sebagai draf** - Membuat catatan dalam status Draf. 1. **Buat dan kirimkan untuk persetujuan** - Membuat catatan dan segera mengirimkannya untuk persetujuan. ### AWS CLI ``` aws bedrock-agentcore-control create-registry-record \ --registry-id \ --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='', 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 1. Buka halaman detail registri. 1. Bagian **catatan Registri** menampilkan: 1. **Penghitung ringkasan status** — Total yang dikirimkan, Persetujuan tertunda, Disetujui, Tidak Digunakan Lagi, Ditolak. 1. **Tabel rekaman** dengan kolom: Nama, Deskripsi, Status, Jenis rekaman, Rekam ARN, Terakhir diperbarui. 1. Gunakan bilah **Rekaman pencarian** untuk memfilter berdasarkan nama. 1. 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 "" \ --region us-east-1 ``` ### AWS SDK ``` import boto3 client = boto3.client('bedrock-agentcore-control') response = client.list_registry_records( registryId='' ) for record in response['registryRecords']: print(f"{record['name']} - {record['status']} - {record['descriptorType']}") ``` ## Lihat detail catatan ### Konsol 1. Dari halaman detail registri, pilih nama rekaman dari tabel catatan. 1. 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. 1. 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). 1. Bagian **konfigurasi protokol** - Konten deskriptor ditampilkan sebagai JSON yang diformat (misalnya, “Kartu agen” untuk catatan A2A, “Server” dan “Alat” untuk catatan MCP). 1. 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. 1. **Update status** dropdown — Kirim untuk persetujuan, Menyetujui, Menolak, atau Menghentikan. 1. **Three-dot menu ()** — Edit atau Hapus. ### AWS CLI ``` aws bedrock-agentcore-control get-registry-record \ --registry-id "" \ --record-id "" \ --region us-east-1 ``` ### AWS SDK ``` import boto3 client = boto3.client('bedrock-agentcore-control') response = client.get_registry_record( registryId='', 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 1. Dari halaman detail rekam, pilih menu tiga titik (), lalu pilih **Edit**. 1. Pada halaman **Edit catatan**, perbarui salah satu dari berikut ini: 1. **Nama**, **Deskripsi**, **Rekam versi** di bawah Rincian rekam. 1. **Jenis rekaman** - Ubah jenis protokol jika diperlukan. 1. (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.](registry-record-lifecycle.md) 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. 1. 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. 1. Pilih **Re-sync dari titik akhir** untuk memicu sinkronisasi baru saat menyimpan. Rekaman transisi ke status UPDATE selama sinkronisasi. 1. Untuk menghapus sinkronisasi, pilih tombol hapus di sebelah bidang titik akhir. Ini mengatur ulang titik akhir dan semua bidang kredensi. 1. 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. 1. Konsol memvalidasi JSON Anda terhadap skema resmi dan menampilkan kesalahan sebaris dengan tombol Diagnosa **dengan Amazon Q**. 1. Pilih salah satu dari: 1. **Simpan perubahan** - Menyimpan catatan sebagai draf. 1. **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 "" \ --record-id "" \ --description "Updated description" \ --region us-east-1 ``` ### AWS SDK ``` import boto3 client = boto3.client('bedrock-agentcore-control') response = client.update_registry_record( registryId='', recordId='', description='Updated description' ) print(f"Updated: {response['name']} - Status: {response['status']}") ``` ## Kirim catatan untuk persetujuan ### Konsol Dari halaman detail catatan - 1. Pilih **dropdown status Perbarui** 1. 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 "" \ --record-id "" \ --region us-east-1 ``` ### AWS SDK ``` import boto3 client = boto3.client('bedrock-agentcore-control') response = client.submit_registry_record_for_approval( registryId='', recordId='' ) print(f"Status: {response['status']}") # PENDING_APPROVAL or APPROVED ``` ## Hapus catatan registri ### Konsol 1. Dari halaman detail rekam, pilih menu tiga titik (), lalu pilih **Hapus**. 1. 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 "" \ --record-id "" \ --region us-east-1 ``` ### AWS SDK ``` import boto3 client = boto3.client('bedrock-agentcore-control') response = client.delete_registry_record( registryId='', 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](registry-supported-record-types.md).