Menetapkan nilai metadata kustom pada catatan

Migrasi Sekarang Terbuka

AWS Agent Registry telah diluncurkan di bawah agent-registry namespace baru. Support untuk bedrock-agentcore namespace pratinjau publik akan dihentikan pada 30 Oktober 2026. Untuk petunjuk migrasi, lihat Panduan migrasi registri komprehensif.

Bila registri memiliki skema metadata kustom, Anda mengisi bidangnya saat membuat atau mengedit rekaman. Catatan dapat membawa atribut umum registri, yang didefinisikan dalam skema defaultnya, ditambah bidang apa pun yang ditentukan untuk jenis catatannya. Untuk menyiapkan bidang, lihat Mendefinisikan skema metadata kustom.

catatan

Anda dapat membuat atau memperbarui catatan tanpa metadata kustom. Jika Anda memasukkannya, isi setiap bidang yang diperlukan. Sebelum catatan dapat diserahkan untuk persetujuan, semua bidang yang diperlukan harus memiliki nilai.

Tetapkan nilai

Konsol

1. Pada halaman Buat catatan atau Edit rekaman di AWS Agen, pilih jenis Rekaman. Jika registri memiliki atribut atau bidang umum untuk jenis rekaman tersebut, bagian Metadata kustom akan muncul.

2. Pilih cara memasukkan nilai:

   1. Formulir — Masukkan nilai untuk setiap bidang menggunakan kontrol yang cocok dengan jenisnya: kotak teks, tarik-turun untuk bidang Enum, atau sakelar untuk bidang Boolean.

   2. JSON - Masukkan nilai langsung sebagai JSON. Editor memvalidasi masukan Anda terhadap skema dan menampilkan skema di samping konten Anda untuk referensi.

3. Jika Anda memberikan metadata kustom apa pun, masukkan nilai untuk setiap bidang yang ditandai diperlukan. Nilai teks dan URL dapat memiliki hingga 128 karakter.

4. Pilih Buat catatan atau Simpan perubahan.

AWS CLI

Contoh-contoh ini menggunakan skema dari contoh di Tentukan skema metadata kustom.

aws agent-registry-control create-registry-record \
  --registry-id "<registryId>" \
  --name "my-mcp-server" \
  --record-type MCP \
  --descriptors '{"mcpServer": {"data": "{\"name\":\"my/mcp-server\",\"description\":\"My MCP server\",\"version\":\"1.0.0\"}", "dataSchemaVersion": "2025-12-11"}}' \
  --record-version "1.0" \
  --custom-metadata '{"owner": "search-team", "dataClassification": "internal"}' \
  --region us-east-1

Untuk mengubah nilai pada catatan yang ada, gunakanupdate-registry-record. --custom-metadataParameter berfungsi sebagai berikut:

• Hilangkan untuk menjaga nilai yang ada.

• Lulus {"optionalValue": {…​}} dengan set nilai lengkap. Mereka mengganti semua nilai yang ada, daripada bergabung dengan mereka.

• Lulus {"optionalValue": {}} untuk menghapus semua nilai metadata kustom dari catatan. Skema registri tidak berubah.

Contoh ini menggantikan nilai record:

aws agent-registry-control update-registry-record \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --custom-metadata '{"optionalValue": {"owner": "search-team", "dataClassification": "confidential"}}' \
  --region us-east-1

AWS SDK

import boto3
import json

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

server_content = json.dumps({
    "name": "my/mcp-server",
    "description": "My MCP server",
    "version": "1.0.0"
})

response = client.create_registry_record(
    registryId='<registryId>',
    name='my-mcp-server',
    recordType='MCP',
    descriptors={
        'mcpServer': {
            'data': server_content,
            'dataSchemaVersion': '2025-12-11'
        }
    },
    recordVersion='1.0',
    customMetadata={'owner': 'search-team', 'dataClassification': 'internal'}
)
print(f"Record ARN: {response['recordArn']}")

Untuk mengubah nilai nanti, customMetadata teruskan dibungkusoptionalValue, seperti CLI. Hilangkan customMetadata untuk menyimpan nilai yang ada, atau teruskan {'optionalValue': {}} untuk menghapus nilai catatan.

client.update_registry_record(
    registryId='<registryId>',
    recordId='<recordId>',
    customMetadata={'optionalValue': {'owner': 'search-team', 'dataClassification': 'confidential'}}
)

Lihat nilai

Konsol

Pada halaman detail rekaman, bagian Metadata kustom menunjukkan nilai rekaman. Nilai Boolean ditampilkan sebagai Ya atau Tidak, dan nilai URL ditampilkan sebagai tautan yang dapat diklik.

AWS CLI

aws agent-registry-control get-registry-record \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --region us-east-1

AWS SDK

import boto3

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

record = client.get_registry_record(registryId='<registryId>', recordId='<recordId>')
print(record['customMetadata'])

Batasan

• Nilai harus berupa string atau boolean asli (true/). false Angka, array, objek, dan null ditolak.

• Nilai teks dan URL dapat mencapai 128 karakter. Nilai Enum harus menjadi salah satu nilai yang diizinkan bidang, yang masing-masing hingga 64 karakter.

• Bidang Boolean membutuhkan boolean JSON asli. String "true" ditolak - tidak ada konversi tipe.

• Setiap kunci harus berupa bidang yang dapat dibawa oleh catatan: atribut umum atau salah satu bidang jenis catatannya. Kunci lainnya ditolak. Kunci peka huruf besar/kecil, jadi Owner tidak cocok dengan bidang bernama. owner

• Nilai Enum harus menjadi salah satu nilai yang diizinkan bidang. Jika jenis rekaman mendefinisikan ulang bidang, daftar nilai yang diizinkan akan berlaku.

Untuk batasan pada skema itu sendiri, lihat Aturan dan batasan skema.

Informasi Terkait

• Tentukan skema metadata kustom

• Membuat dan mengelola catatan

• Jenis dan deskriptor rekaman yang didukung