Definir valores de metadados personalizados em um registro

A migração já está aberta

AWS O Agent Registry foi lançado sob o novo agent-registry namespace. O suporte para o bedrock-agentcore namespace de pré-visualização pública será descontinuado em 30 de outubro de 2026. Para obter instruções de migração, consulte o guia abrangente de migração do registro.

Quando um registro tem um esquema de metadados personalizado, você preenche seus campos ao criar ou editar um registro. Um registro pode conter os atributos comuns do registro, definidos em seu esquema padrão, além de quaisquer campos definidos para seu tipo de registro. Para configurar os campos, consulte Definir um esquema de metadados personalizado.

nota

Você pode criar ou atualizar um registro sem metadados personalizados. Se você inserir algum, preencha todos os campos obrigatórios. Antes que um registro possa ser enviado para aprovação, todos os campos obrigatórios devem ter um valor.

Definir valores

Console

1. Na página Criar registro ou Editar registro no AWS Agente, selecione um tipo de registro. Se o registro tiver atributos ou campos comuns para esse tipo de registro, a seção Metadados personalizados será exibida.

2. Escolha como inserir valores:

   1. Formulário — Insira um valor para cada campo usando um controle que corresponda ao seu tipo: uma caixa de texto, uma lista suspensa para campos Enum ou uma opção para campos booleanos.

   2. JSON — Insira valores diretamente como JSON. O editor valida sua entrada em relação ao esquema e mostra o esquema ao lado do seu conteúdo para referência.

3. Se você fornecer metadados personalizados, insira um valor para cada campo marcado como obrigatório. Os valores de texto e URL podem ter até 128 caracteres.

4. Escolha Criar registro ou Salvar alterações.

AWS CLI

Esses exemplos usam o esquema do exemplo em Definir um esquema de metadados 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 alterar os valores em um registro existente, useupdate-registry-record. O --custom-metadata parâmetro funciona da seguinte forma:

• Omita-o para manter os valores existentes.

• Passe {"optionalValue": {…​}} com o conjunto completo de valores. Eles substituem todos os valores existentes, em vez de se fundirem com eles.

• Passe {"optionalValue": {}} para remover todos os valores de metadados personalizados do registro. O esquema do registro não muda.

Esse exemplo substitui os valores do 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 alterar os valores posteriormente, passe customMetadata encapsuladooptionalValue, como na CLI. Omita customMetadata para manter os valores existentes ou passe {'optionalValue': {}} para remover os valores do registro.

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

Exibir valores

Console

Em uma página de detalhes do registro, a seção Metadados personalizados mostra os valores do registro. Os valores booleanos são exibidos como Sim ou Não, e os valores de URL são exibidos como links clicáveis.

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

Restrições

• Os valores devem ser strings ou booleanos nativos (true/false). Números, matrizes, objetos e nulos são rejeitados.

• Os valores de texto e URL podem ter até 128 caracteres. Um valor Enum deve ser um dos valores permitidos do campo, cada um com até 64 caracteres.

• Um campo booleano requer um booleano JSON nativo. A string "true" é rejeitada — não há conversão de tipo.

• Cada chave deve ser um campo que o registro possa conter: um atributo comum ou um dos campos do tipo de registro. Outras chaves são rejeitadas. As chaves diferenciam maiúsculas de minúsculas, portanto, Owner não correspondem a um campo chamado. owner

• Um valor Enum deve ser um dos valores permitidos do campo. Se o tipo de registro redefinir o campo, sua própria lista de valores permitidos será aplicada.

Para ver os limites do esquema em si, consulte Regras e limites do esquema.

Informações relacionadas

• Definir um esquema de metadados personalizado

• Crie e gerencie registros

• Tipos de registro e descritores compatíveis