レコードにカスタムメタデータ値を設定する

移行がオープンに

AWS エージェントレジストリが新しいagent-registry名前空間で起動されました。パブリックプレビューbedrock-agentcore名前空間のサポートは、2026 年 10 月 30 日に終了します。移行手順については、「包括的なレジストリ移行ガイド」を参照してください。

レジストリにカスタムメタデータスキーマがある場合は、レコードを作成または編集するときにそのフィールドに入力します。レコードには、デフォルトのスキーマで定義されているレジストリの共通属性と、そのレコードタイプで定義されているフィールドを含めることができます。フィールドを設定するには、「カスタムメタデータスキーマの定義」を参照してください。

注記

カスタムメタデータなしでレコードを作成または更新できます。入力する場合は、すべての必須フィールドに入力します。レコードを承認のために送信する前に、すべての必須フィールドに値が必要です。

値を設定する

コンソール

1. AWS エージェントのレコードの作成またはレコードの編集ページで、レコードタイプを選択します。レジストリにそのレコードタイプの共通の属性またはフィールドがある場合、カスタムメタデータセクションが表示されます。

2. 値の入力方法を選択します。

   1. フォーム — テキストボックス、列挙型フィールドのドロップダウン、またはブール型フィールドのトグルの型に一致するコントロールを使用して、各フィールドの値を入力します。

   2. JSON — 値を JSON として直接入力します。エディタは入力をスキーマと照合し、参照用にコンテンツとともにスキーマを表示します。

3. カスタムメタデータを指定する場合は、必須とマークされたすべてのフィールドに値を入力します。テキストと URL の値は最大 128 文字です。

4. レコードの作成または変更の保存を選択します。

AWS CLI

これらの例では、「カスタムメタデータスキーマを定義する」の例のスキーマを使用します。

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

既存のレコードの値を変更するには、 を使用しますupdate-registry-record。--custom-metadata パラメータは次のように機能します。

• 既存の値を保持するには、これを省略します。

• 値の完全なセット{"optionalValue": {…​}}を渡します。これらは、マージするのではなく、既存のすべての値を置き換えます。

• を渡{"optionalValue": {}}して、レコードからすべてのカスタムメタデータ値を削除します。レジストリのスキーマは変更されません。

この例では、レコードの値を置き換えます。

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

後で値を変更するには、 CLI と同様にoptionalValue、 でcustomMetadataラップされた を渡します。を省略customMetadataして既存の値を保持するか、 を渡{'optionalValue': {}}してレコードの値を削除します。

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

値の表示

コンソール

レコードの詳細ページで、カスタムメタデータセクションにレコードの値が表示されます。ブール値は「はい」または「いいえ」と表示され、URL 値はクリック可能なリンクとして表示されます。

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

制約

• 値は文字列またはネイティブブール値 (true/) である必要がありますfalse。数値、配列、オブジェクト、null は拒否されます。

• テキストと URL の値は最大 128 文字です。列挙値は、フィールドで許可される値の 1 つでなければならず、それぞれが最大 64 文字です。

• ブール値フィールドにはネイティブ JSON ブール値が必要です。文字列"true"は拒否されます。型変換はありません。

• すべてのキーは、レコードが保持できるフィールドである必要があります。共通の属性またはそのレコードタイプのフィールドのいずれかです。他のキーは拒否されます。キーでは大文字と小文字が区別されるため、 Ownerは という名前のフィールドと一致しませんowner。

• 列挙値は、フィールドで許可される値の 1 つである必要があります。レコードタイプが フィールドを再定義する場合、許可される値の独自のリストが適用されます。

スキーマ自体の制限については、「スキーマのルールと制限」を参照してください。

関連情報

• カスタムメタデータスキーマを定義する

• レコードの作成と管理

• サポートされているレコードタイプと記述子