View a markdown version of this page

Memulai dengan AWS Pendaftaran Agen - Batu Dasar Amazon AgentCore
PrasyaratLangkah 1: Buat registriLangkah 2: Tambahkan catatan registriLangkah 3: Kirim catatan untuk persetujuanLangkah 4: Setujui catatanLangkah 5: Temukan catatan yang disetujuiApa yang telah Anda bangunLangkah selanjutnya

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

Memulai dengan AWS Pendaftaran Agen

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.

Dalam panduan ini, Anda akan membuat registri pertama Anda, menambahkan catatan, menyetujuinya, dan mencarinya.

Prasyarat

Selesaikan langkah-langkah di Pras yarat.

Langkah 1: Buat registri

Buat registri dengan otorisasi IAM dan persetujuan manual.

Konsol

Membuat registri dengan IAM-based otorisasi

contoh
AWS Agent Registry namespace

  1. Buka konsol AWS Agen Registry.

  2. Di panel navigasi, pilih Registry.

  3. Di bagian Registries, pilih Buat registri.

  4. Di bagian rincian registri, untuk Nama, masukkan nama untuk registri Anda. Nama harus dimulai dengan karakter alfanumerik. Karakter yang valid adalah a—z, A—Z, 0—9, (garis bawah), _ (tanda hubung), - (titik), dan . (garis miring ke depan). / Nama dapat memiliki hingga 64 karakter.

  5. (Opsional) Pilih Detail tambahan untuk memperluas bagian, dan kemudian untuk Deskripsi, masukkan deskripsi untuk membantu mengidentifikasi registri ini.

  6. Di bagian O torisasi Penemuan, untuk jenis Auth, pilih Gunakan Otorisasi IAM (otorisasi masuk).

  7. Di bagian Persetujuan rekam, aktifkan atau matikan Auto-approval:

    • Saat Auto-approval aktif, saat Anda mengirimkan rekaman untuk disetujui, rekaman tersebut bergerak langsung ke status Dis etujui dan menjadi terlihat di hasil penelusuran segera setelahnya.

    • Saat Auto-approval dinonaktifkan, saat Anda mengirimkan catatan untuk disetujui, rekaman akan pindah ke status Pending persetujuan dan mengharuskan kurator untuk meninjau dan menyetujuinya sebelum diterbitkan.

  8. (Opsional) Di bagian Tag, pilih Tambahkan tag baru untuk melampirkan satu atau lebih tag ke registri. Setiap tag memiliki kunci dan nilai opsional.

  9. Pilih Buat registri.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Buka halaman AWS Agen Registry di Bedrock-AgentCore konsol.

  2. Di panel navigasi, pilih Registry.

  3. Di bagian Registries, pilih Buat registri.

  4. Di bagian rincian registri, untuk Nama, masukkan nama untuk registri Anda. Nama harus dimulai dengan karakter alfanumerik. Karakter yang valid adalah a—z, A—Z, 0—9, (garis bawah), _ (tanda hubung), - (titik), dan . (garis miring ke depan). / Nama dapat memiliki hingga 64 karakter.

  5. (Opsional) Pilih Detail tambahan untuk memperluas bagian, dan kemudian untuk Deskripsi, masukkan deskripsi untuk membantu mengidentifikasi registri ini.

  6. Di bagian O torisasi API Pencarian, untuk jenis Auth, pilih Gunakan Otorisasi IAM (otorisasi masuk).

  7. Di bagian Persetujuan rekam, aktifkan atau matikan Auto-approval:

    • Saat Auto-approval aktif, saat Anda mengirimkan rekaman untuk disetujui, rekaman tersebut bergerak langsung ke status Dis etujui dan menjadi terlihat di hasil penelusuran segera setelahnya.

    • Saat Auto-approval dinonaktifkan, saat Anda mengirimkan catatan untuk disetujui, rekaman akan pindah ke status Pending persetujuan dan mengharuskan kurator untuk meninjau dan menyetujuinya sebelum diterbitkan.

  8. Pilih Buat registri.

Membuat registri dengan JWT-based otorisasi

Otorisasi penyedia identitas menggunakan Token Web JSON (JWT) untuk mengontrol akses ke API bidang data registri yang dapat ditemukan dan titik akhir MCP. Anda dapat menggunakan Amazon Cognito untuk mengatur otorisasi dengan cepat, atau membawa penyedia identitas Anda sendiri untuk mengaktifkan OAuth 2.0.

contoh
AWS Agent Registry namespace

  1. Buka konsol AWS Agen Registry.

  2. Di panel navigasi, pilih Registry.

  3. Di bagian Registries, pilih Buat registri.

  4. Di bagian rincian registri, untuk Nama, masukkan nama untuk registri Anda. Nama harus dimulai dengan karakter alfanumerik. Karakter yang valid adalah a—z, A—Z, 0—9, (garis bawah), _ (tanda hubung), - (titik), dan . (garis miring ke depan). / Nama dapat memiliki hingga 64 karakter.

  5. (Opsional) Pilih Detail tambahan untuk memperluas bagian, dan kemudian untuk Deskripsi, masukkan deskripsi untuk membantu mengidentifikasi registri ini.

  6. Di bagian O torisasi Penemuan, untuk jenis Auth, pilih Gunakan Token Web JSON (JWT) (otorisasi masuk).

  7. Untuk konfigurasi skema JWT, pilih salah satu opsi berikut:

    1. Buat konfigurasi cepat dengan Cognito (disarankan) — Registri AWS Agen membuat konfigurasi otorisasi atas nama Anda menggunakan Amazon Cognito sebagai penyedia identitas. Tidak diperlukan konfigurasi tambahan.

    2. Gunakan konfigurasi penyedia Identitas yang ada — Bawa penyedia identitas Anda sendiri untuk mengaktifkan OAuth 2.0. Jika Anda memilih opsi ini, selesaikan langkah-langkah berikut:

      1. Untuk URL Discovery, masukkan URL penemuan dari penyedia identitas Anda. AWS Agen Registry menggunakan URL ini untuk secara otomatis mengambil pengaturan login, token, dan verifikasi untuk penyedia Anda. Anda dapat menemukan URL ini di dasbor atau dokumentasi penyedia identitas Anda (misalnya,https://cognito-identity.amazonaws.com/.well-known/openid-configuration).

        catatan

        URL penemuan tidak dapat diubah setelah registri dibuat.

      2. (Opsional) Di bawah konfigurasi otorisasi JWT, pilih Audiens yang diizinkan untuk menyediakan daftar audiens yang diizinkan yang divalid AWS asi oleh Agen Registry terhadap aud klaim di token JWT. Klaim audiens (aud) di OAuth 2.0 menentukan server sumber daya (API) mana token dimaksudkan. Ini memastikan token adalah penerima yang benar sebelum memproses permintaan, mencegah token digunakan kembali di API lain yang tidak dikeluarkan untuknya.

      3. (Opsional) Pilih Klien yang diizinkan untuk memberikan daftar pengidentifikasi klien yang diizinkan yang divalid AWS asi oleh Agen Registry terhadap client_id klaim di token JWT. A client_id adalah pengidentifikasi unik publik untuk aplikasi yang meminta token akses untuk mengakses API bidang data registri yang dapat ditemukan atau titik akhir MCP. Jika Anda mengaktifkan opsi ini, masukkan satu atau lebih ID klien di bidang Klien, lalu pilih Tam bah klien untuk menambahkan klien tambahan.

      4. (Opsional) Pilih Cakupan yang diizinkan untuk menyediakan daftar izin yang diizinkan, didefinisikan sebagai cakupan. Jika dikonfigurasi, setidaknya satu nilai cakupan dalam token masuk harus cocok dengan salah satu nilai yang dikonfigurasi. Cakupan bertindak sebagai izin untuk membatasi apa yang dapat dilakukan aplikasi.

      5. (Opsional) Pilih Klaim khusus untuk menyediakan seperangkat aturan yang mencocokkan klaim tertentu dalam token masuk dengan nilai yang telah ditentukan sebelumnya. Untuk setiap aturan, tentukan nama klaim, jenis nilai (STR ING atau STRING_ARRAY), dan nilai kecocokan yang diperlukan.

  8. Di bagian Persetujuan rekam, aktifkan atau matikan Auto-approval:

    1. Saat Auto-approval aktif, saat Anda mengirimkan catatan untuk disetujui, rekaman bergerak langsung ke status Dis etujui dan segera terlihat di hasil penelusuran.

    2. Saat Auto-approval dinonaktifkan, saat Anda mengirimkan catatan untuk disetujui, rekaman akan pindah ke status persetujuan Tertunda dan memerlukan admin registri untuk meninjau dan menyetujuinya sebelum dipublikasikan.

  9. (Opsional) Di bagian Tag, pilih Tambahkan tag baru untuk melampirkan satu atau lebih tag ke registri. Setiap tag memiliki kunci dan nilai opsional.

  10. Pilih Buat registri.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Buka halaman AWS Agen Registry di Bedrock-AgentCore konsol.

  2. Di panel navigasi, pilih Registry.

  3. Di bagian Registries, pilih Buat registri.

  4. Di bagian rincian registri, untuk Nama, masukkan nama untuk registri Anda. Nama harus dimulai dengan karakter alfanumerik. Karakter yang valid adalah a—z, A—Z, 0—9, (garis bawah), _ (tanda hubung), - (titik), dan . (garis miring ke depan). / Nama dapat memiliki hingga 64 karakter.

  5. (Opsional) Pilih Detail tambahan untuk memperluas bagian, dan kemudian untuk Deskripsi, masukkan deskripsi untuk membantu mengidentifikasi registri ini.

  6. Di bagian O torisasi API Pencarian, untuk jenis Auth, pilih Gunakan Token Web JSON (JWT) (otorisasi masuk).

  7. Untuk konfigurasi skema JWT, pilih salah satu opsi berikut:

    1. Buat konfigurasi cepat dengan Cognito (disarankan) — Registri AWS Agen membuat konfigurasi otorisasi atas nama Anda menggunakan Amazon Cognito sebagai penyedia identitas. Tidak diperlukan konfigurasi tambahan.

    2. Gunakan konfigurasi penyedia Identitas yang ada — Bawa penyedia identitas Anda sendiri untuk mengaktifkan OAuth 2.0. Jika Anda memilih opsi ini, selesaikan langkah-langkah berikut:

      1. Untuk URL Discovery, masukkan URL penemuan dari penyedia identitas Anda. AWS Agen Registry menggunakan URL ini untuk secara otomatis mengambil pengaturan login, token, dan verifikasi untuk penyedia Anda. Anda dapat menemukan URL ini di dasbor atau dokumentasi penyedia identitas Anda (misalnya,https://cognito-identity.amazonaws.com/.well-known/openid-configuration).

        catatan

        URL penemuan tidak dapat diubah setelah registri dibuat.

      2. (Opsional) Di bawah konfigurasi otorisasi JWT, pilih Audiens yang diizinkan untuk menyediakan daftar audiens yang diizinkan yang divalid AWS asi oleh Agen Registry terhadap aud klaim di token JWT. Klaim audiens (aud) di OAuth 2.0 menentukan server sumber daya (API) mana token dimaksudkan. Ini memastikan token adalah penerima yang benar sebelum memproses permintaan, mencegah token digunakan kembali di API lain yang tidak dikeluarkan untuknya.

      3. (Opsional) Pilih Klien yang diizinkan untuk memberikan daftar pengidentifikasi klien yang diizinkan yang divalid AWS asi oleh Agen Registry terhadap client_id klaim di token JWT. A client_id adalah pengenal unik publik untuk aplikasi yang meminta token akses untuk mengakses API pencarian registri. Jika Anda mengaktifkan opsi ini, masukkan satu atau lebih ID klien di bidang Klien, lalu pilih Tam bah klien untuk menambahkan klien tambahan.

      4. (Opsional) Pilih Cakupan yang diizinkan untuk menyediakan daftar izin yang diizinkan, didefinisikan sebagai cakupan. Jika dikonfigurasi, setidaknya satu nilai cakupan dalam token masuk harus cocok dengan salah satu nilai yang dikonfigurasi. Cakupan bertindak sebagai izin untuk membatasi apa yang dapat dilakukan aplikasi.

      5. (Opsional) Pilih Klaim khusus untuk menyediakan seperangkat aturan yang mencocokkan klaim tertentu dalam token masuk dengan nilai yang telah ditentukan sebelumnya. Untuk setiap aturan, tentukan nama klaim, jenis nilai (STR ING atau STRING_ARRAY), dan nilai kecocokan yang diperlukan.

  8. Di bagian Persetujuan rekam, aktifkan atau matikan Auto-approval:

    1. Saat Auto-approval aktif, saat Anda mengirimkan catatan untuk disetujui, rekaman bergerak langsung ke status Dis etujui dan segera terlihat di hasil penelusuran.

    2. Saat Auto-approval dinonaktifkan, saat Anda mengirimkan catatan untuk disetujui, rekaman akan pindah ke status persetujuan Tertunda dan memerlukan admin registri untuk meninjau dan menyetujuinya sebelum dipublikasikan.

  9. Pilih Buat registri.

catatan

* 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. * URL penemuan tidak dapat diubah setelah registri dibuat. * Jenis otorisasi (IAM atau JWT) tidak dapat diubah setelah registri dibuat. * Registri hanya mendukung satu bentuk jenis otorisasi masuk pada satu waktu - IAM SigV4 atau JWT Bearer Token. Anda tidak dapat menggunakan keduanya secara bersamaan. Pencarian melalui IAM hanya didukung melalui IAM-based registri; dan pencarian melalui Oauth hanya didukung melalui registri berbasis Oauth.

Setelah membuat registri, konsol menavigasi ke halaman detail registri. Status registri awalnya adalah Membuat. AWS Agen Registry menetapkan registri sebuah ARN, yang dapat Anda temukan di bagian detail registri. Status registri berubah menjadi Si ap setelah penyediaan selesai. Anda dapat menambahkan catatan ke registri ketika statusnya Si ap.

AWS CLI

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

Status registri dimulai sebagai CREATING dan beralih ke READY saat penyediaan selesai.

AWS SDK

contoh
AWS Agent Registry namespace
import boto3

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

response = client.create_registry(
    name='my-agent-registry',
    description='My first Agent Registry'
)
print(response['registryArn'])
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3

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

response = client.create_registry(
    name='my-agent-registry',
    description='My first Agent Registry'
)
print(response['registryArn'])

Langkah 2: Tambahkan catatan registri

Buat catatan untuk server MCP di registri Anda.

Konsol

Catatan registri mewakili agen, alat, keterampilan, atau sumber daya khusus.

contoh
AWS Agent Registry namespace

  1. Buka konsol AWS Agen Registry.

  2. Di panel navigasi, pilih Registri, lalu pilih nama registri tempat Anda ingin menambahkan catatan.

  3. Di bagian Catatan registri, pilih Buat rekaman.

  4. Pilih jenis sumber:

    1. Sinkronisasi dari titik akhir — Menyediakan URL titik akhir dan kredenSIAL opsional untuk mengambil metadata dari server MCP atau titik akhir Agen (A2A). Lihat Men yinkronkan catatan dari sumber eksternal untuk detailnya.

    2. Manual — Konfigurasikan detail rekaman dan konfigurasi protokol secara manual. Lanjutkan dengan langkah-langkah di bawah ini.

  5. Di bagian Detail rekaman, untuk Nama, masukkan nama unik untuk catatan. Nama harus unik dalam registri — kombinasi Name dan Record version harus unik. Nama harus dimulai dengan karakter alfanumerik. Karakter yang valid adalah a—z, A—Z, 0—9, (garis bawah), _ (tanda hubung), - (titik), dan . (garis miring ke depan). / Nama dapat memiliki hingga 255 karakter.

  6. (Opsional) Untuk Nama tampilan, masukkan label yang dapat dibaca manusia untuk rekaman tersebut. Ini muncul di tabel catatan registri dan hasil pencarian di samping nama teknis catatan.

  7. (Opsional) Untuk Deskripsi, masukkan deskripsi untuk catatan. Deskripsi dapat terdiri dari 1 hingga 4.096 karakter.

  8. Untuk versi rek aman, masukkan pengidentifikasi versi untuk catatan (misalnya, 1.0.0 atauv2.1).

  9. Di bagian Jenis rekaman dan deskriptor:

    1. Di bawah Jenis, pilih jenis semantik rekaman. Jenis menentukan kunci deskriptor utama mana yang valid.

      • MCP — Protokol yang dirancang untuk alat AI dan komunikasi agen. Menangani manajemen konteks dan format pesan terstruktur.

      • Agen — Protokol yang dirancang untuk interaksi agen-ke-agen yang aman. Memungkinkan alur kerja terdistribusi dan pertukaran informasi.

      • Keterampilan - Daftarkan keterampilan agen dengan dokumentasi penurunan harga dan definisi terstruktur opsional.

      • Kustom - Implementasi protokol khusus untuk pola komunikasi khusus. Tentukan spesifikasi antarmuka Anda sendiri dan persyaratan integrasi.

    2. Di bawah Deskriptor, pilih bentuk data deskriptor catatan. Opsi yang tersedia tergantung pada Jenis yang Anda pilih:

      • MCP → Server MCP atau Kustom

      • Agen → Kartu Agen A2A, server MCP, atau K ustom

      • Keter ampilan → Definisi keterampilan agen atau K ustom

      • Kustom → K ustom

  10. Editor khusus deskriptor muncul berdasarkan pilihan Deskriptor Anda:

    1. Server MCP — Pilih versi skema dari dropdown versi Skema (misalnya,2025-12-11), dan masukkan registri Protokol Konteks Model server.json dari situs web Protokol Konteks Model di editor definisi server MCP Anda. Definisi harus sesuai dengan skema server MCP resmi untuk versi yang dipilih. Untuk melihat skema resmi sebagai referensi, aktifkan Tampilkan skema resmi. (Opsional) Pilih Tambahkan definisi alat untuk menambahkan alat yang tersedia di server ini dengan parameter input, output, dan contoh penggunaannya. Pilih versi skema (misalnya,2025-11-25) dan masukkan definisi alat Anda di editor definisi Alat Anda.

    2. Kartu Agen A2A - Versi skema adalah0.3. Masukkan definisi kartu agen Anda di editor. Untuk melihat skema resmi sebagai referensi, aktifkan Tampilkan skema resmi.

    3. Definisi keterampilan agen — Untuk dokumentasi Keter ampilan, masukkan penurunan harga yang menggambarkan keterampilan ini. (Opsional) Pilih Sertakan definisi keterampilan untuk menambahkan definisi terstruktur. Pilih versi skema dan masukkan definisi sebagai objek JSON.

    4. Kustom — Masukkan definisi kustom Anda sebagai objek JSON.

  11. (Opsional) Di bagian Tag, pilih Tambahkan tag baru untuk melampirkan satu atau lebih tag ke rekaman. Setiap tag memiliki kunci dan nilai opsional.

  12. Pilih Buat catatan.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Buka halaman AWS Agen Registry di Bedrock-AgentCore konsol.

  2. Di panel navigasi, pilih Registri, lalu pilih nama registri tempat Anda ingin menambahkan catatan.

  3. Di bagian Catatan registri, pilih Buat rekaman.

  4. Pilih jenis sumber:

    1. Sinkronisasi dari titik akhir — Menyediakan URL titik akhir dan kredenSIAL opsional untuk mengambil metadata dari server MCP atau titik akhir Agen (A2A). Lihat Men yinkronkan catatan dari sumber eksternal untuk detailnya.

    2. Manual — Konfigurasikan detail rekaman dan konfigurasi protokol secara manual. Lanjutkan dengan langkah-langkah di bawah ini.

  5. Di bagian Detail rekaman, untuk Nama, masukkan nama untuk catatan. Nama harus dimulai dengan karakter alfanumerik. Karakter yang valid adalah a—z, A—Z, 0—9, (garis bawah), _ (tanda hubung), - (titik), dan . (garis miring ke depan). / Nama dapat memiliki hingga 255 karakter.

  6. (Opsional) Untuk Deskripsi, masukkan deskripsi untuk catatan. Deskripsi dapat terdiri dari 1 hingga 4.096 karakter.

  7. Untuk versi rek aman, masukkan pengidentifikasi versi untuk catatan (misalnya, 1.0.0 atauv2.1).

  8. Di bagian Jenis rekaman, pilih jenis yang cocok dengan sumber daya Anda:

    1. MCP — Protokol yang dirancang untuk alat AI dan komunikasi agen. Menangani manajemen konteks dan format pesan terstruktur. Jika Anda memilih jenis ini, selesaikan langkah-langkah berikut:

      1. Di bagian definisi server MCP, pilih versi skema dari dropdown versi skema (misalnya,2025-12-11), lalu masukkan Model Context Protocol registry server.json dari situs web Model Context Protocol di editor definisi server MCP Anda. Definisi harus sesuai dengan skema server MCP resmi untuk versi yang dipilih. Untuk melihat skema resmi sebagai referensi, aktifkan Tampilkan skema resmi.

      2. (Opsional) Pilih Tambahkan definisi alat untuk menambahkan alat tertentu yang tersedia di server ini dengan parameter input, output, dan contoh penggunaannya untuk meningkatkan kemampuan ditemukan. Jika Anda memilih opsi ini, pilih versi skema dari dropdown versi skema (misalnya,2025-11-25), lalu masukkan definisi alat Anda di editor definisi Alat Anda. Untuk melihat skema alat resmi sebagai referensi, aktifkan Tampilkan skema resmi.

    2. Agen — Protokol yang dirancang untuk interaksi agen-ke-agen yang aman. Memungkinkan alur kerja terdistribusi dan pertukaran informasi. Jika Anda memilih jenis ini, versi skema adalah0.3. Masukkan definisi kartu agen Anda di editor. Untuk melihat skema resmi sebagai referensi, aktifkan Tampilkan skema resmi.

    3. Keterampilan Agen — Daftarkan keterampilan agen dengan dokumentasi penurunan harga dan definisi terstruktur opsional. Jika Anda memilih jenis ini, selesaikan langkah-langkah berikut:

      1. Untuk dokumentasi Keter ampilan, masukkan dokumentasi penurunan harga yang menjelaskan keterampilan ini.

      2. (Opsional) Pilih Sertakan definisi keterampilan untuk menambahkan definisi terstruktur. Jika Anda memilih opsi ini, pilih versi skema dari dropdown versi skema, lalu masukkan definisi keterampilan sebagai objek JSON di editor.

    4. Kustom - Implementasi protokol khusus untuk pola komunikasi khusus. Tentukan spesifikasi antarmuka Anda sendiri dan persyaratan integrasi. Jika Anda memilih jenis ini, masukkan definisi kustom Anda sebagai objek JSON di editor.

  9. Pilih Buat catatan.

catatan

Untuk menambahkan server atau agen ke registri yang tidak sesuai dengan skema protokol MCP atau A2A standar, gunakan jenis rekaman kustom.

Setelah Anda memilih Buat catatan, AWS Agen Registry mulai menyediakan catatan. Status rekaman awalnya Membuat. Saat penyediaan selesai, status berubah menjadi Draft. Untuk membuat catatan tersedia bagi orang lain untuk ditemukan, kirimkan untuk disetujui. Untuk informasi selengkapnya, lihat Langkah 3: Kirim catatan untuk persetujuan.

AWS CLI

contoh
AWS Agent Registry namespace
aws agent-registry-control create-registry-record \
  --registry-id <registryId> \
  --name "weather-server" \
  --display-name "WeatherServer" \
  --record-type MCP \
  --descriptors '{"mcpServer": {"data": "{\"name\": \"weather/mcp-server\", \"description\": \"Weather data service\", \"version\": \"1.0.0\"}", "dataSchemaVersion": "2025-12-11"}}' \
  --record-version "1.0" \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control create-registry-record \
  --registry-id <registryId> \
  --name "WeatherServer" \
  --descriptor-type MCP \
  --descriptors '{"mcp": {"server": {"inlineContent": "{\"name\": \"weather/mcp-server\", \"description\": \"Weather data service\", \"version\": \"1.0.0\"}"}}}' \
  --record-version "1.0" \
  --region us-east-1

Catatan dibuat dalam status CREATING dan transisi ke DRAFT saat pemrosesan selesai. Untuk contoh AWS CLI selengkapnya untuk membuat catatan jenis lain, lihat bagian Buat dan kelola catatan.

AWS SDK

contoh
AWS Agent Registry namespace
import boto3
import json

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

server_content = json.dumps({
    "name": "io.example/weather-server",
    "description": "A weather MCP server",
    "version": "1.0.0"
})

tools_content = json.dumps({
    "tools": [{
        "name": "get_weather",
        "description": "Get the current weather for a location",
        "inputSchema": {
            "type": "object",
            "properties": {
                "location": {
                    "type": "string",
                    "description": "City name"
                }
            },
            "required": ["location"]
        }
    }]
})

response = client.create_registry_record(
    registryId='<registryId>',
    name='my-mcp-server',
    displayName='My MCP Server',
    recordType='MCP',
    descriptors={
        'mcpServer': {
            'data': server_content,
            'dataSchemaVersion': '2025-12-11',
            'additionalData': {
                'tools': {
                    'data': tools_content,
                    'dataSchemaVersion': '2024-11-05'
                }
            }
        }
    },
    recordVersion='1.0'
)
print(f"Record ARN: {response['recordArn']}")
print(f"Status: {response['status']}")  # CREATING
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3
import json

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

server_content = json.dumps({
    "name": "io.example/weather-server",
    "description": "A weather MCP server",
    "version": "1.0.0"
})

tools_content = json.dumps({
    "tools": [{
        "name": "get_weather",
        "description": "Get the current weather for a location",
        "inputSchema": {
            "type": "object",
            "properties": {
                "location": {
                    "type": "string",
                    "description": "City name"
                }
            },
            "required": ["location"]
        }
    }]
})

response = client.create_registry_record(
    registryId='<registryId>',
    name='my-mcp-server',
    descriptorType='MCP',
    descriptors={
        'mcp': {
            'server': {
                'schemaVersion': '2025-12-11',
                'inlineContent': server_content
            },
            'tools': {
                'protocolVersion': '2024-11-05',
                'inlineContent': tools_content
            }
        }
    },
    recordVersion='1.0'
)
print(f"Record ARN: {response['recordArn']}")
print(f"Status: {response['status']}")  # CREATING

Langkah 3: Kirim catatan untuk persetujuan

Konsol

Mengirimkan catatan untuk persetujuan memulai proses peninjauan yang membuat catatan tersedia untuk ditemukan. Anda dapat mengirimkan catatan dari tabel catatan registri atau dari halaman detail catatan.

Untuk mengirimkan catatan untuk persetujuan dari tabel catatan registri

contoh
AWS Agent Registry namespace

  1. Buka konsol AWS Agen Registry.

  2. Di panel navigasi, pilih Registry, lalu pilih nama registri.

  3. Di bagian Catatan registri, pilih rekaman yang ingin Anda kirimkan.

  4. Pilih Perbarui status, lalu pilih K irim untuk persetujuan.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Buka halaman AWS Agen Registry di Bedrock-AgentCore konsol.

  2. Di panel navigasi, pilih Registry, lalu pilih nama registri.

  3. Di bagian Catatan registri, pilih rekaman yang ingin Anda kirimkan.

  4. Pilih Perbarui status, lalu pilih K irim untuk persetujuan.

Untuk mengirimkan catatan untuk persetujuan dari halaman detail catatan

contoh
AWS Agent Registry namespace

  1. Buka konsol AWS Agen Registry.

  2. Di panel navigasi, pilih Registry, lalu pilih nama registri.

  3. Di bagian Catatan registri, pilih nama catatan yang ingin Anda kirimkan.

  4. Pilih Perbarui status, lalu pilih K irim untuk persetujuan.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Buka halaman AWS Agen Registry di Bedrock-AgentCore konsol.

  2. Di panel navigasi, pilih Registry, lalu pilih nama registri.

  3. Di bagian Catatan registri, pilih nama catatan yang ingin Anda kirimkan.

  4. Pilih Perbarui status, lalu pilih K irim untuk persetujuan.

Setelah Anda mengirimkan catatan untuk persetujuan, status rekaman berubah berdasarkan pengaturan persetujuan registri:

  • Jika registri telah di Auto-approval aktifkan, status rekaman berubah langsung ke Dis etujui dan menjadi terlihat di hasil pencarian segera setelahnya.

  • Jika registri telah di Auto-approval matikan, status rekaman berubah menjadi Ter tunda persetujuan dan mengharuskan admin registri untuk meninjau dan menyetujuinya sebelum diterbitkan.

AWS CLI

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

Catatan pindah ke PENDING_APPROVAL (atau langsung ke APPROVED jika persetujuan otomatis diaktifkan).

AWS SDK

contoh
AWS Agent Registry namespace
import boto3

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

response = client.submit_registry_record_for_approval(
    registryId='<registryId>',
    recordId='<recordId>'
)
print(f"Record ARN: {response['recordArn']}")
print(f"Record ID: {response['recordId']}")
print(f"Status: {response['status']}")  # PENDING_APPROVAL or APPROVED
print(f"Updated At: {response['updatedAt']}")
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3

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

response = client.submit_registry_record_for_approval(
    registryId='<registryId>',
    recordId='<recordId>'
)
print(f"Record ARN: {response['recordArn']}")
print(f"Record ID: {response['recordId']}")
print(f"Status: {response['status']}")  # PENDING_APPROVAL or APPROVED
print(f"Updated At: {response['updatedAt']}")

Langkah 4: Setujui catatan

Konsol

Untuk menyetujui catatan dari tabel catatan registri

contoh
AWS Agent Registry namespace

  1. Buka konsol AWS Agen Registry.

  2. Di panel navigasi, pilih Registry, lalu pilih nama registri.

  3. Di bagian Catatan registri, pilih catatan yang ingin Anda setujui.

  4. Pilih Perbarui status, lalu pilih Setuj ui.

  5. Dalam dialog konfirmasi, masukkan alasan untuk perubahan status.

  6. Pilih Konfirmasi.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Buka halaman AWS Agen Registry di Bedrock-AgentCore konsol.

  2. Di panel navigasi, pilih Registry, lalu pilih nama registri.

  3. Di bagian Catatan registri, pilih catatan yang ingin Anda setujui.

  4. Pilih Perbarui status, lalu pilih Setuj ui.

  5. Dalam dialog konfirmasi, masukkan alasan untuk perubahan status.

  6. Pilih Konfirmasi.

Untuk menyetujui rekaman dari halaman detail catatan

contoh
AWS Agent Registry namespace

  1. Buka konsol AWS Agen Registry.

  2. Di panel navigasi, pilih Registry, lalu pilih nama registri.

  3. Di bagian Catatan registri, pilih nama catatan yang ingin Anda setujui.

  4. Di halaman detail rekaman, pilih Perbarui status, lalu pilih Setuj ui.

  5. Dalam dialog konfirmasi, masukkan alasan untuk perubahan status.

  6. Pilih Konfirmasi.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Buka halaman AWS Agen Registry di Bedrock-AgentCore konsol.

  2. Di panel navigasi, pilih Registry, lalu pilih nama registri.

  3. Di bagian Catatan registri, pilih nama catatan yang ingin Anda setujui.

  4. Di halaman detail rekaman, pilih Perbarui status, lalu pilih Setuj ui.

  5. Dalam dialog konfirmasi, masukkan alasan untuk perubahan status.

  6. Pilih Konfirmasi.

AWS CLI

contoh
AWS Agent Registry namespace
aws agent-registry-control update-registry-record-status \
  --registry-id <registryId> \
  --record-id <recordId> \
  --status APPROVED \
  --status-reason "Reviewed and approved" \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control update-registry-record-status \
  --registry-id <registryId> \
  --record-id <recordId> \
  --status APPROVED \
  --status-reason "Reviewed and approved" \
  --region us-east-1

AWS SDK

contoh
AWS Agent Registry namespace
import boto3

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

response = client.update_registry_record_status(
    registryId='<registryId>',
    recordId='<recordId>',
    status='APPROVED',
    statusReason='Meets all requirements'
)
print(f"Record ARN: {response['recordArn']}")
print(f"Status: {response['status']}")  # APPROVED
print(f"Reason: {response['statusReason']}")
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3

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

response = client.update_registry_record_status(
    registryId='<registryId>',
    recordId='<recordId>',
    status='APPROVED',
    statusReason='Meets all requirements'
)
print(f"Record ARN: {response['recordArn']}")
print(f"Status: {response['status']}")  # APPROVED
print(f"Reason: {response['statusReason']}")

Langkah 5: Temukan catatan yang disetujui

Direktori Rekam adalah halaman konsol untuk menelusuri dan mencari catatan yang disetujui dalam registri. Ketika Anda memilih registri pada halaman direktori Rekam, konsol secara otomatis mencantumkan catatan yang disetujui. Dari sana Anda dapat menelusuri daftar, atau menggunakan kotak pencarian untuk menjalankan kueri bahasa alami. Secara terprogram, gunakan ListDiscoverableRegistryRecords untuk menelus SearchDiscoverableRegistryRecords uri, mencari, dan BatchGetDiscoverableRegistryRecord mengambil detail lengkap untuk banyak catatan dalam satu panggilan.

Konsol

catatan

Console-based penemuan hanya tersedia untuk pendaftar yang menggunakan Gunakan IAM sebagai jenis otorisasi. Jika registri Anda menggunakan Token Web JSON (JWT), panggil API bidang data yang dapat ditemukan secara langsung menggunakan klien HTTP seperti curl atau Postman dengan Token Bearer JWT yang valid di header permintaan. AWS CLI dan AWS SDK menggunakan penandatanganan IAM SIGv4 dan tidak dapat digunakan dengan registri. JWT-authorized Untuk detail selengkapnya, lihat Mencari catatan registri.

contoh
AWS Agent Registry namespace

Untuk menelusuri atau mencari catatan yang disetujui

  1. Buka konsol AWS Agen Registry.

  2. Di panel navigasi, pilih Rekam direktori.

  3. Di bawah Registry, pilih registri yang catatan disetujui yang ingin Anda jelajahi. Halaman secara otomatis mencantumkan semua catatan yang disetujui dalam registri itu.

  4. (Opsional) Ber alih antara tampilan Kartu dan Tabel di kanan atas halaman.

  5. (Opsional) Di Cari catatan yang disetujui, masukkan kueri bahasa alami atau nama untuk mempersempit hasil, lalu pilih Cari.

  6. Pilih kartu atau baris untuk membuka detail lengkap catatan.

Direktori Rekam menampilkan rekaman dalam status Dis etujui saja. Catatan dalam status Draf, Penundaan persetujuan, Ditolak, atau Tidak digunakan lagi tidak muncul.

Amazon Bedrock AgentCore namespace (to be deprecated)

Untuk mencari catatan registri

  1. Buka halaman AWS Agen Registry di Bedrock-AgentCore konsol.

  2. Di panel navigasi, pilih Registry, lalu pilih nama registri.

  3. Pilih tab Cari catatan.

  4. Di bidang Cari catatan yang disetujui, masukkan kueri penelusuran Anda.

  5. (Opsional) Untuk memfilter hasil berdasarkan properti tertentu, pilih bidang pencarian untuk memperluas menu Pro perti, lalu pilih filter: Nama, Jenis Deskriptor, atau Versi.

  6. Pilih Cari.

Pencarian hanya mengembalikan catatan dalam status Disetujui. Catatan di status lain seperti status Draf, Penundaan persetujuan, Ditolak, atau Tidak digunakan lagi tidak muncul di hasil penelusuran.

AWS CLI

Jelajahi catatan yang disetujui - daftar catatan yang disetujui dalam registri:

aws agent-registry list-discoverable-registry-records \
  --registry-id "<registry-id>" \
  --region us-east-1

Cari catatan yang disetujui - jalankan pencarian semantik hibrida+kata kunci:

contoh
AWS Agent Registry namespace
aws agent-registry search-discoverable-registry-records \
  --search-query "weather" \
  --registry-ids "<registry-id>" \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore search-registry-records \
  --search-query "weather" \
  --registry-ids "<registry-id>" \
  --region us-east-1

Ambil detail lengkap untuk banyak catatan sekaligus:

aws agent-registry batch-get-discoverable-registry-record \
  --entries '[{"registryId": "<registry-id>", "recordIds": ["<recordId-1>", "<recordId-2>"]}]' \
  --region us-east-1
catatan

ListDiscoverableRegistryRecordsdan hanya BatchGetDiscoverableRegistryRecord tersedia di agent-registry namespace. Mereka tidak tersedia di bedrock-agentcore namespace.

AWS SDK

Jelajahi catatan yang disetujui:

import boto3

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

list_response = client.list_discoverable_registry_records(
    registryId='<registry-id>',
    maxResults=20
)
for record in list_response['registryRecords']:
    print(f"{record['displayName']} ({record['name']}) - {record['recordType']}")

Cari catatan yang disetujui:

contoh
AWS Agent Registry namespace
import boto3

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

response = client.search_discoverable_registry_records(
    registryIds=['arn:aws:agent-registry:us-east-1:<account>:registry/<registryId>'],
    searchQuery='weather forecast tool',
    maxResults=10
)
for record in response['registryRecords']:
    print(f"Record: {record['displayName']} ({record['recordId']})")
    print(f"  Name: {record['name']}")
    print(f"  Type: {record['recordType']}")
    print(f"  Status: {record['status']}")
    print(f"  Version: {record['recordVersion']}")
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3

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

response = client.search_registry_records(
    registryIds=['arn:aws:bedrock-agentcore:us-east-1:<account>:registry/<registryId>'],
    searchQuery='weather forecast tool',
    maxResults=10
)
for record in response['registryRecords']:
    print(f"Record: {record['name']} ({record['recordId']})")
    print(f"  Type: {record['descriptorType']}")
    print(f"  Status: {record['status']}")
    print(f"  Version: {record['version']}")

Ambil detail lengkap untuk banyak catatan sekaligus:

batch_response = client.batch_get_discoverable_registry_record(
    entries=[{'registryId': '<registry-id>', 'recordIds': ['<recordId-1>', '<recordId-2>']}]
)
for record in batch_response['registryRecords']:
    print(f"{record['displayName']} ({record['name']}) - {record['recordType']}")
for err in batch_response['errors']:
    print(f"Error for {err['recordId']}: {err['errorCode']}")

Apa yang telah Anda bangun

  • Registr i dengan otorisasi IAM dan persetujuan manual

  • Catatan registri yang menggambarkan server MCP

  • Rekaman yang disetujui dapat dijelajahi dan dicari melalui direktori Rekam

Langkah selanjutnya

  • Bangun pengalaman penemuan bergaya katalog di atas dan ListDiscoverableRegistryRecords BatchGetDiscoverableRegistryRecord

  • Siapkan EventBridge notifikasi Amazon untuk mengotomatiskan alur kerja persetujuan Anda

  • Tambahkan lebih banyak catatan untuk agen, server, keterampilan, dan sumber daya khusus Anda