View a markdown version of this page

Membuat dan mengelola registri - Batu Dasar Amazon AgentCore
Buat registriDaftar pendaftarLihat detail registriMemperbarui registriMenghapus registri

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

Membuat dan mengelola registri

Migrasi Sekarang Dibuka

AWS Agen Registry telah diluncurkan di bawah agent-registry namespace baru. Dukungan untuk bedrock-agentcore namespace pratinjau publik akan dihentikan pada 17 September 2026. Untuk petunjuk migrasi, lihat Panduan migrasi registri komprehensif.

Buat registri

Konsol

contoh
AWS Agent Registry namespace

  1. Buka konsol AWS Agen Registry.

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

  3. Di bagian Registries, pilih Buat registri.

  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),. (titik), dan/(garis miring maju). Nama dapat memiliki hingga 64 karakter.

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

  6. (Opsional) Perluas O torisasi Penemuan untuk mengonfigurasi cara konsumen memberi otorisasi saat menemukan catatan di registri — mencari, menelusuri katalog rekaman yang disetujui, mendapatkan catatan yang disetujui secara batch, dan memanggil titik akhir MCP registri (Otorisasi Masuk). Pilih AWS IAM untuk menggunakan AWS kredensional standar, atau token Web JSON (JWT) untuk menggunakan kredentif penyedia identitas perusahaan Anda. Jika Anda memilih JWT, Anda dapat membuat dengan cepat dengan Cognito, atau membawa IdP Anda sendiri dengan memberikan URL penemuan, audiens, ruang lingkup, klaim khusus, dan klien.

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

  8. (Opsional) Perluas Tag untuk menambahkan tag ke registri. Tag adalah pasangan kunci-nilai yang membantu Anda mengkategorikan, mencari, dan mengelola registri Anda. Setiap tag terdiri dari kunci yang diperlukan dan nilai opsional.

  9. (Opsional) Perluas kunci KMS untuk mengonfigurasi enkripsi saat diam dengan kunci yang dikelola pelanggan. Secara default, registri Anda dienkripsi dengan kunci yang AWS dimiliki. Untuk menggunakan kunci Anda sendiri, pilih Ku stomisasi pengaturan enkripsi (lanjutan) dan masukkan ARN kunci KMS Anda, atau pilih Buat kunci AWS KMS untuk membuat kunci baru. Kunci KMS tidak dapat diubah setelah registri dibuat. Untuk informasi selengkapnya, lihat Perlindungan data di AWS Agen Registry.

  10. Pilih Buat registri.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Buka AgentCore konsol https://console.aws.amazon.com/bedrock-agentcore/home?region=us-east-1# Amazon Bedrock.

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

  3. Di bagian Registries, pilih Buat registri.

  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),. (titik), dan/(garis miring maju). Nama dapat memiliki hingga 64 karakter.

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

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

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

  8. (Opsional) Perluas kunci KMS untuk mengonfigurasi enkripsi saat diam dengan kunci yang dikelola pelanggan. Secara default, registri Anda dienkripsi dengan kunci yang AWS dimiliki. Untuk menggunakan kunci Anda sendiri, pilih Ku stomisasi pengaturan enkripsi (lanjutan) dan masukkan ARN kunci KMS Anda, atau pilih Buat kunci AWS KMS untuk membuat kunci baru. Kunci KMS tidak dapat diubah setelah registri dibuat. Untuk informasi selengkapnya, lihat Perlindungan data di AWS Agen Registry.

  9. Pilih Buat registri.

Status registri dimulai sebagai Membuat dan beralih ke Si ap saat penyediaan selesai.

catatan

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

AWS CLI

IAM-based Pendaftaran:

contoh
AWS Agent Registry namespace
aws agent-registry-control create-registry \
  --name "MyRegistry" \
  --description "Production registry" \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control create-registry \
  --name "MyRegistry" \
  --description "Production registry" \
  --region us-east-1

JWT-based Pendaftaran:

contoh
AWS Agent Registry namespace
aws agent-registry-control create-registry \
  --name "MyOAuthRegistry" \
  --discovery-configuration '{"authorizerType": "CUSTOM_JWT", "authorizerConfiguration": {"customJWTAuthorizer": {"discoveryUrl": "https://cognito-idp.us-east-1.amazonaws.com/<poolId>/.well-known/openid-configuration", "allowedClients": ["<appClientId>"]}}}' \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
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

Registri dengan kunci yang dikelola pelanggan

contoh
AWS Agent Registry namespace
aws agent-registry-control create-registry \
  --name "MyEncryptedRegistry" \
  --description "Registry with customer managed encryption" \
  --encryption-configuration '{"kmsKeyArn":"arn:aws:kms:us-east-1:111122223333:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"}' \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control create-registry \
  --name "MyEncryptedRegistry" \
  --description "Registry with customer managed encryption" \
  --encryption-configuration '{"kmsKeyArn":"arn:aws:kms:us-east-1:111122223333:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"}' \
  --region us-east-1
catatan

Anda hanya dapat mengatur --encryption-configuration parameter selama pembuatan registri. Anda tidak dapat mengubah kunci KMS setelah registri dibuat. Jika Anda menghilangkan parameter ini, registri menggunakan kunci yang AWS dimiliki secara default.

AWS SDK

IAM-based Pendaftaran:

contoh
AWS Agent Registry namespace
import boto3

client = boto3.client('agent-registry-control')

response = client.create_registry(
    name='MyRegistry',
    description='Production registry'
)
print(response['registryArn'])
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3

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

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

JWT-based Pendaftaran:

contoh
AWS Agent Registry namespace
import boto3

client = boto3.client('agent-registry-control')

response = client.create_registry(
    name='MyOAuthRegistry',
    discoveryConfiguration={
        'authorizerType': 'CUSTOM_JWT',
        'authorizerConfiguration': {
            'customJWTAuthorizer': {
                'discoveryUrl': 'https://cognito-idp.us-east-1.amazonaws.com/<poolId>/.well-known/openid-configuration',
                'allowedClients': ['<appClientId>']
            }
        }
    }
)
print(response['registryArn'])
Amazon Bedrock AgentCore namespace (to be deprecated)
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'])

Registri dengan kunci yang dikelola pelanggan

contoh
AWS Agent Registry namespace
import boto3

client = boto3.client('agent-registry-control')

response = client.create_registry(
    name='MyEncryptedRegistry',
    description='Registry with customer managed encryption',
    encryptionConfiguration={
        'kmsKeyArn': 'arn:aws:kms:us-east-1:111122223333:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE22222'
    }
)
print(response['registryArn'])
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3

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

response = client.create_registry(
    name='MyEncryptedRegistry',
    description='Registry with customer managed encryption',
    encryptionConfiguration={
        'kmsKeyArn': 'arn:aws:kms:us-east-1:111122223333:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE22222'
    }
)
print(response['registryArn'])

Daftar pendaftar

Konsol

contoh
AWS Agent Registry namespace

  1. Buka konsol AWS Agen Registry.

  2. Di panel navigasi, di bawah Temukan, 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 Auth — 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 Cari registri untuk memfilter berdasarkan nama.

  5. Gunakan kontrol pagination untuk menavigasi hasil.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Buka AgentCore konsol https://console.aws.amazon.com/bedrock-agentcore/home?region=us-east-1# Amazon Bedrock.

  2. Di panel navigasi, di bawah Temukan, 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 Cari registri untuk memfilter berdasarkan nama.

  5. Gunakan kontrol pagination untuk menavigasi hasil.

AWS CLI

contoh
AWS Agent Registry namespace
aws agent-registry-control list-registries \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control list-registries \
  --region us-east-1

AWS SDK

contoh
AWS Agent Registry namespace
import boto3

client = boto3.client('agent-registry-control')

response = client.list_registries()
for registry in response['registries']:
    print(f"{registry['name']} - {registry['status']} - {registry['registryArn']}")
Amazon Bedrock AgentCore namespace (to be deprecated)
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

contoh
AWS Agent Registry namespace

  1. Buka konsol AWS Agen Registry.

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

  3. Pilih nama registri dari tabel Registries.

  4. Halaman detail registri menampilkan bagian yang dapat dilipat berikut:

    1. Rincian registri - Menampilkan Nama, Status, Deskripsi, Auto-approval (Diaktifkan atau Dinonaktifkan), Registri ARN, Tanggal Terakhir diperbarui, dan Tanggal Dibuat.

    2. Catatan registri — Menampilkan penghitung ringkasan status (Total yang dikirimkan, Persetujuan Tertunda, Disetujui, Dusang, Ditolak) dan tabel catatan untuk catatan yang dikirimkan ke registri ini. Dari sini Anda dapat membuat, melihat, atau mengelola catatan.

    3. Otorisasi Penemuan (Otorisasi Masuk) - Menampilkan jenis otorisasi saat ini (AWS_IAM atau CUSTOM_JWT) dan, untuk JWT-authorized registri, konfigurasi otorisasi JWT.

    4. Kode sampel - Menyediakan kode sampel untuk operasi umum (membuat, menyetujui, daftar, dan temukan catatan) yang dapat Anda salin dan adaptasi.

    5. Tag — Menampilkan tag yang terkait dengan registri sebagai tabel nilai kunci. Untuk menambah, menghapus, atau memodifikasi tag, pilih Edit di bagian ini untuk membuka halaman Edit tag.

  5. Untuk memodifikasi registri, pilih Edit. Untuk menghapus registri, pilih H apus.

  6. Untuk mencari atau menelusuri catatan yang disetujui dalam registr i ini, pilih Direktori rekam di kanan atas halaman (atau di panel navigasi). Lihat Memulai dengan Agen Registry untuk panduan penemuan.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Buka AgentCore konsol https://console.aws.amazon.com/bedrock-agentcore/home?region=us-east-1# Amazon Bedrock.

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

  3. Pilih nama registri dari tabel Registries.

  4. Halaman detail registri memiliki dua tab:

    1. Mengelola catatan - Lihat dan kelola catatan registri.

    2. Cari catatan — Cari catatan yang disetujui dalam registri.

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

  6. Bagian catatan registri menampilkan penghitung ringkasan status (Total yang dikirimkan, Persetujuan Tertunda, Disetujui, Dusang, Ditolak) dan tabel catatan.

  7. Bagian Search API Authorization (Inbound Authorization) menunjukkan jenis otorisasi saat ini.

AWS CLI

contoh
AWS Agent Registry namespace
aws agent-registry-control get-registry \
  --registry-id "<registryId>" \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control get-registry \
  --registry-id "<registryId>" \
  --region us-east-1

AWS SDK

contoh
AWS Agent Registry namespace
import boto3

client = boto3.client('agent-registry-control')

response = client.get_registry(
    registryId='<registryId>'
)
print(f"Name: {response['name']}")
print(f"Status: {response['status']}")
print(f"ARN: {response['registryArn']}")
Amazon Bedrock AgentCore namespace (to be deprecated)
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']}")

Memperbarui registri

Konsol

contoh
AWS Agent Registry namespace

  1. Buka konsol AWS Agen Registry.

  2. Di panel navigasi, di bawah Temukan, 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. Persetujuan rekam — Auto-approval Aktifkan atau nonaktifkan. Perubahan hanya memengaruhi catatan yang dikirimkan setelah pembaruan.

    4. Otorisasi Penemuan JWT-authorized — Untuk pendaftar, perbarui konfigurasi otorisasi JWT (klien yang diizinkan, audiens, cakupan, atau klaim khusus). Jenis otorisasi masuk itu sendiri (IAM atau JWT) tidak dapat diubah setelah registri dibuat.

  5. Pilih Simpan perubahan.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Buka AgentCore konsol https://console.aws.amazon.com/bedrock-agentcore/home?region=us-east-1# Amazon Bedrock.

  2. Di panel navigasi, di bawah Temukan, 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. Persetujuan rekam — Auto-approval Aktifkan atau nonaktifkan. Perubahan hanya memengaruhi catatan yang dikirimkan setelah pembaruan.

  5. Pilih Simpan perubahan.

catatan

Tag tidak diedit dari halaman E dit registri. Untuk memodifikasi tag, buka halaman detail registri, pilih Edit di bagian Tag, tambahkan atau hapus tag pada halaman Edit tag, dan pilih S impan perubahan. (Tag hanya didukung di konsol AWS Agen Registry.)

catatan

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

catatan

Jenis otorisasi masuk (IAM atau JWT) dan URL penemuan JWT tidak dapat diubah setelah registri dibuat. Untuk JWT-authorized registri, Anda hanya dapat memperbarui konfigurasi otorizer (klien yang diizinkan, audiens, cakupan, klaim khusus).

AWS CLI

contoh
AWS Agent Registry namespace
aws agent-registry-control update-registry \
  --registry-id "<registryId>" \
  --description '{"optionalValue": "Updated description"}' \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control update-registry \
  --registry-id "<registryId>" \
  --description '{"optionalValue": "Updated description"}' \
  --region us-east-1

AWS SDK

contoh
AWS Agent Registry namespace
import boto3

client = boto3.client('agent-registry-control')

response = client.update_registry(
    registryId='<registryId>',
    description={'optionalValue': 'Updated description'}
)
print(f"Updated: {response['name']} - Status: {response['status']}")
Amazon Bedrock AgentCore namespace (to be deprecated)
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']}")

Menghapus registri

Konsol

contoh
AWS Agent Registry namespace

  1. Buka konsol AWS Agen Registry.

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

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

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

  5. Ketik delete di bidang konfirmasi.

  6. Pilih Hapus.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Buka AgentCore konsol https://console.aws.amazon.com/bedrock-agentcore/home?region=us-east-1# Amazon Bedrock.

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

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

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

  5. Ketik delete di bidang konfirmasi.

  6. Pilih Hapus.

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

AWS CLI

contoh
AWS Agent Registry namespace
aws agent-registry-control delete-registry \
  --registry-id "<registryId>" \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control delete-registry \
  --registry-id "<registryId>" \
  --region us-east-1

AWS SDK

contoh
AWS Agent Registry namespace
import boto3

client = boto3.client('agent-registry-control')

response = client.delete_registry(
    registryId='<registryId>'
)
print(f"Status: {response['status']}")  # DELETING
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3

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

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