Memulai dengan AWS Registri Agen

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

Prasyarat

Selesaikan langkah-langkah dalam Prasyarat.

Langkah 1: Buat registri

Buat registri dengan otorisasi IAM dan persetujuan manual.

Konsol

Untuk Membuat Registri dengan Auth berbasis IAM

Untuk Membuat Registri dengan otorisasi penyedia Identitas Auth berbasis JWT menggunakan JSON Web Tokens (JWT) untuk mengontrol akses ke API pencarian registri. Anda dapat menggunakan Amazon Cognito untuk mengatur otorisasi dengan cepat, atau membawa penyedia identitas Anda sendiri untuk mengaktifkan OAuth 2.0.

Setelah membuat registri, konsol menavigasi ke halaman detail registri. Status registri awalnya Membuat. AWS Agent Registry memberikan registri ARN, yang dapat Anda temukan di bagian Detail Registry. Status registri berubah menjadi Siap setelah penyediaan selesai. Anda dapat menambahkan catatan ke registri ketika statusnya Siap.

AWS CLI

aws bedrock-agentcore-control create-registry \
  --name "MyFirstRegistry" \
  --description "My first Agent Registry" \
  --region us-east-1

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

AWS SDK

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.

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

AWS CLI

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 CREATING status dan transisi ke DRAFT saat pemrosesan selesai. Untuk contoh AWS CLI lainnya untuk membuat catatan jenis lain, lihat bagian Buat dan kelola catatan.

AWS SDK

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
            }
        }
    }
)
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

Untuk mengirimkan catatan untuk persetujuan dari halaman rincian catatan

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

AWS CLI

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

Rekaman berpindah ke PENDING_APPROVAL (atau langsung ke APPROVED jika persetujuan otomatis diaktifkan).

AWS SDK

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: Menyetujui catatan

Konsol

Untuk menyetujui catatan dari tabel catatan registri

Untuk menyetujui catatan dari halaman detail catatan

AWS CLI

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

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: Cari registri

Konsol

Anda dapat mencari catatan yang disetujui dalam registri menggunakan pencarian semantik atau kata kunci untuk menemukan agen, server MCP, keterampilan, dan sumber daya lainnya. Anda dapat memfilter hasil berdasarkan nama, protokol, atau versi untuk mempersempit pencarian Anda.

Untuk mencari catatan registri

Pencarian hanya mengembalikan catatan dalam status Disetujui. Rekaman di negara bagian lain seperti Draf, Persetujuan tertunda, Ditolak, atau Status tidak digunakan lagi tidak muncul di hasil penelusuran.

AWS CLI

aws bedrock-agentcore search-registry-records \
  --search-query "weather" \
  --registry-ids "<registry-id>" \
  --region us-east-1

Catatan Anda yang disetujui akan muncul di hasil pencarian.

AWS SDK

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']}")

Apa yang telah Anda bangun

Langkah selanjutnya