View a markdown version of this page

Membuat dan mengelola pendaftar - Batuan Dasar Amazon AgentCore
Buat registriDaftar pendaftarLihat detail registriPerbarui registriHapus registri

Membuat dan mengelola pendaftar

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 registri

Konsol

  1. Buka AgentCore konsol Amazon Bedrock.

  2. Di panel navigasi, di bawah Discover, pilih Registry.

  3. Di bagian Registries, pilih Create Registry.

  4. Untuk Nama, masukkan nama untuk registri Anda. 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 64 karakter.

  5. (Opsional) Perluas Detail tambahan dan masukkan Deskripsi (1—4.096 karakter).

  6. (Opsional) Perluas Otorisasi API Pencarian untuk mengonfigurasi cara konsumen mengotorisasi saat mencari registri (Otorisasi Masuk). Pilih AWS IAM untuk menggunakan AWS kredensil standar, atau token Web JSON (JWT) untuk menggunakan kredensil penyedia identitas perusahaan Anda. Jika Anda memilih JWT, Anda dapat membuat dengan cepat dengan Cognito, atau membawa IDP Anda sendiri dengan menyediakan URL penemuan, audiens, ruang lingkup, klaim khusus, dan klien.

  7. Di bawah Persetujuan Rekam, pilih apakah akan mengaktifkan Auto-approval. Ketika persetujuan otomatis dimatikan, kurator harus meninjau dan menyetujui setiap catatan sebelum dapat dicari.

  8. Pilih Buat registri.

Status registri dimulai sebagai Membuat dan transisi ke Siap saat penyediaan selesai.

catatan

Untuk pendaftar yang diaktifkan JWT, Setidaknya satu bidang konfigurasi otorisasi JWT diperlukan: audiens yang diizinkan, klien yang diizinkan, cakupan yang diizinkan, atau klaim khusus. Jika Anda mengonfigurasi lebih dari satu, AWS Agen Registri memverifikasi semuanya.

AWS CLI

IAM-based registri: 

aws bedrock-agentcore-control create-registry \
  --name "MyRegistry" \
  --description "Production registry" \
  --region us-east-1

JWT-based registri: 

aws bedrock-agentcore-control create-registry \
  --name "MyOAuthRegistry" \
  --authorizer-type CUSTOM_JWT \
  --authorizer-configuration '{"customJWTAuthorizer": {"discoveryUrl": "https://cognito-idp.us-east-1.amazonaws.com/<poolId>/.well-known/openid-configuration", "allowedClients": ["<appClientId>"]}}' \
  --region us-east-1

AWS SDK

IAM-based registri: 

import boto3

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

response = client.create_registry(
    name='MyRegistry',
    description='Production registry'
)
print(response['registryArn'])

JWT-based registri: 

import boto3

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

response = client.create_registry(
    name='MyOAuthRegistry',
    authorizerType='CUSTOM_JWT',
    authorizerConfiguration={
        'customJWTAuthorizer': {
            'discoveryUrl': 'https://cognito-idp.us-east-1.amazonaws.com/<poolId>/.well-known/openid-configuration',
            'allowedClients': ['<appClientId>']
        }
    }
)
print(response['registryArn'])

Daftar pendaftar

Konsol

  1. Buka AgentCore konsol Amazon Bedrock.

  2. Di panel navigasi, di bawah Discover, pilih Registry.

  3. Tabel Registries menampilkan semua registri di akun Anda dengan kolom berikut:

    1. Nama — Nama registri (ditautkan ke halaman detail).

    2. Deskripsi — Deskripsi registri, jika disediakan.

    3. Jenis otorisasi - Metode otorisasi masuk (AWS_IAM atau CUSTOM_JWT).

    4. Status — Status saat ini (Membuat, Siap, Memperbarui, Menghapus, atau status kegagalan).

    5. ARN — Nama Sumber Daya Amazon registri.

    6. Dibuat — Stempel waktu pembuatan.

    7. Terakhir diperbarui - Stempel waktu modifikasi terakhir.

  4. Gunakan bilah pencarian Find Registries untuk memfilter berdasarkan nama.

  5. Gunakan kontrol pagination untuk menavigasi hasil.

AWS CLI

aws bedrock-agentcore-control list-registries \
  --region us-east-1

AWS SDK

import boto3

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

response = client.list_registries()
for registry in response['registries']:
    print(f"{registry['name']} - {registry['status']} - {registry['registryArn']}")

Lihat detail registri

Konsol

  1. Buka AgentCore konsol Amazon Bedrock.

  2. Di panel navigasi, di bawah Discover, pilih Registry.

  3. Pilih nama registri dari tabel Registries.

  4. Halaman detail registri memiliki dua tab:

    1. Mengelola catatan - Melihat dan mengelola catatan registri.

    2. Catatan pencarian — Cari catatan yang disetujui di registri.

  5. Bagian Detail registri menampilkan: Nama, Status, Deskripsi, Auto-approval (Diaktifkan atau Dinonaktifkan), ARN Registri, Tanggal terakhir diperbarui, Tanggal dibuat.

  6. Bagian Catatan registri menunjukkan penghitung ringkasan status (Total yang dikirimkan, Persetujuan tertunda, Disetujui, Usang, Ditolak) dan tabel catatan.

  7. Bagian Otorisasi API Pencarian (Otorisasi Masuk) menunjukkan jenis otorisasi saat ini.

AWS CLI

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

AWS SDK

import boto3

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

response = client.get_registry(
    registryId='<registryId>'
)
print(f"Name: {response['name']}")
print(f"Status: {response['status']}")
print(f"ARN: {response['registryArn']}")

Perbarui registri

Konsol

  1. Buka AgentCore konsol Amazon Bedrock.

  2. Di panel navigasi, di bawah Discover, pilih Registry.

  3. Pilih tombol radio di sebelah registri yang ingin Anda edit, lalu pilih Edit. Atau, pilih nama registri dan kemudian pilih Edit.

  4. Pada halaman Edit registri, perbarui salah satu dari berikut ini:

    1. Nama — Ubah nama registri (aturan penamaan yang sama dengan pembuatan).

    2. Deskripsi - Di bawah Detail tambahan, perbarui atau tambahkan deskripsi.

    3. Rekam persetujuan — Aktifkan atau Auto-approvalnonaktifkan. Perubahan hanya memengaruhi catatan yang dikirimkan setelah pembaruan.

  5. Pilih Simpan perubahan.

catatan

Memperbarui konfigurasi persetujuan otomatis dari OFF ke ON hanya memengaruhi catatan yang dikirimkan setelah perubahan. Catatan yang sudah ada yang sudah 'Persetujuan Tertunda' tidak terpengaruh dan masih harus disetujui atau ditolak dengan memanggil UpdateRegistryRecordStatus API. Mengubah konfigurasi dari ON ke OFF hanya memengaruhi catatan yang diterbitkan ke 'Persetujuan Tertunda' setelah perubahan dilakukan.

catatan

URL penemuan (untuk registri resmi JWT) tidak dapat diubah setelah registri dibuat. Jenis otorisasi masuk (IAM atau JWT) tidak dapat diubah setelah registri dibuat.

AWS CLI

aws bedrock-agentcore-control update-registry \
  --registry-id "<registryId>" \
  --description '{"optionalValue": "Updated description"}' \
  --region us-east-1

AWS SDK

import boto3

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

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

Hapus registri

Konsol

  1. Buka AgentCore konsol Amazon Bedrock.

  2. Di panel navigasi, di bawah Discover, pilih Registry.

  3. Pilih tombol radio di sebelah registri yang ingin Anda hapus, lalu pilih Hapus.

  4. Dalam dialog konfirmasi, tinjau peringatan: Anda harus terlebih dahulu menghapus semua catatan registri sebelum menghapus registri.

  5. Ketik hapus di bidang konfirmasi.

  6. Pilih Hapus.

Status registri berubah menjadi Menghapus. Spanduk sukses mengkonfirmasi kapan penghapusan selesai.

AWS CLI

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

AWS SDK

import boto3

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

response = client.delete_registry(
    registryId='<registryId>'
)
print(f"Status: {response['status']}")  # DELETING