Establecer valores de metadatos personalizados en un registro

La migración ya está abierta

AWS Agent Registry se lanzó con el nuevo espacio de agent-registry nombres. Support para el espacio de bedrock-agentcore nombres de versión preliminar pública se suspenderá el 30 de octubre de 2026. Para obtener instrucciones de migración, consulta la guía completa de migración del registro.

Cuando un registro tiene un esquema de metadatos personalizado, debe rellenar sus campos al crear o editar un registro. Un registro puede incluir los atributos comunes del registro, definidos en su esquema predeterminado, además de cualquier campo definido para su tipo de registro. Para configurar los campos, consulte Definir un esquema de metadatos personalizado.

nota

Puede crear o actualizar un registro sin metadatos personalizados. Si introduce alguno, rellene todos los campos obligatorios. Para poder enviar un registro para su aprobación, todos los campos obligatorios deben tener un valor.

Defina valores

Consola

1. En la página Crear registro o Editar registro del AWS agente, seleccione un tipo de registro. Si el registro tiene atributos o campos comunes para ese tipo de registro, aparece la sección Metadatos personalizados.

2. Elija cómo introducir los valores:

   1. Formulario: introduzca un valor para cada campo mediante un control que coincida con su tipo: un cuadro de texto, un menú desplegable para los campos de enumeración o un conmutador para los campos booleanos.

   2. JSON: introduce los valores directamente como JSON. El editor valida la entrada comparándola con el esquema y muestra el esquema junto con el contenido como referencia.

3. Si proporciona metadatos personalizados, introduzca un valor para cada campo marcado como obligatorio. Los valores de texto y URL pueden tener hasta 128 caracteres.

4. Selecciona Crear registro o Guardar cambios.

AWS CLI

En estos ejemplos se utiliza el esquema del ejemplo de Definir un esquema de metadatos personalizado.

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

Para cambiar los valores de un registro existente, utiliceupdate-registry-record. El --custom-metadata parámetro funciona de la siguiente manera:

• Omitelo para conservar los valores existentes.

• Pase {"optionalValue": {…​}} con el conjunto completo de valores. Sustituyen a todos los valores existentes, en lugar de fusionarse con ellos.

• Pase {"optionalValue": {}} para eliminar todos los valores de metadatos personalizados del registro. El esquema del registro no cambia.

Este ejemplo reemplaza los valores del registro:

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

Para cambiar los valores más adelante, pase customMetadata incluidooptionalValue, como en la CLI. Omita customMetadata para conservar los valores existentes o pase {'optionalValue': {}} para eliminar los valores del registro.

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

Ver valores

Consola

En la página de detalles de un registro, la sección de metadatos personalizados muestra los valores del registro. Los valores booleanos se muestran como Sí o No, y los valores de URL se muestran como enlaces en los que se puede hacer clic.

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

Restricciones

• Los valores deben ser cadenas o valores booleanos nativos (/). true false Se rechazan los números, las matrices, los objetos y los valores nulos.

• Los valores de texto y URL pueden tener hasta 128 caracteres. Un valor de enumeración debe ser uno de los valores permitidos del campo, cada uno de los cuales tiene un máximo de 64 caracteres.

• Un campo booleano requiere un booleano JSON nativo. "true"Se rechaza la cadena; no hay conversión de tipos.

• Cada clave debe ser un campo que el registro pueda contener: un atributo común o uno de los campos de su tipo de registro. Se rechazan las demás claves. Las claves distinguen entre mayúsculas y minúsculas, por lo que Owner no coinciden con un campo denominadoowner.

• Un valor de enumeración debe ser uno de los valores permitidos del campo. Si el tipo de registro redefine el campo, se aplica su propia lista de valores permitidos.

Para conocer los límites del propio esquema, consulte Reglas y límites del esquema.

Información relacionada

• Defina un esquema de metadatos personalizado

• Cree y administre registros

• Tipos de registros y descriptores compatibles