Impostare valori di metadati personalizzati su un record

La migrazione è ora aperta

AWS Agent Registry è stato lanciato con il nuovo agent-registry namespace. Il supporto per lo spazio dei bedrock-agentcore nomi di anteprima pubblica verrà interrotto il 30 ottobre 2026. Per le istruzioni sulla migrazione, consulta la Guida completa alla migrazione del registro.

Quando un registro ha uno schema di metadati personalizzato, compili i relativi campi quando crei o modifichi un record. Un record può contenere gli attributi comuni del registro, definiti nello schema predefinito, oltre a tutti i campi definiti per il tipo di record. Per configurare i campi, consulta Definire uno schema di metadati personalizzato.

Nota

Puoi creare o aggiornare un record senza metadati personalizzati. Se ne inserisci uno, compila tutti i campi obbligatori. Prima che un record possa essere inviato per l'approvazione, tutti i campi obbligatori devono avere un valore.

Impostare i valori

Console

1. Nella pagina Crea record o Modifica record dell'AWS agente, selezionare un tipo di record. Se il registro ha attributi o campi comuni per quel tipo di record, viene visualizzata la sezione Metadati personalizzati.

2. Scegli come inserire i valori:

   1. Modulo: inserisci un valore per ogni campo utilizzando un controllo corrispondente al tipo corrispondente: una casella di testo, un menu a discesa per i campi Enum o un interruttore per i campi booleani.

   2. JSON: inserisci i valori direttamente come JSON. L'editor convalida l'input rispetto allo schema e mostra lo schema insieme al contenuto come riferimento.

3. Se fornisci metadati personalizzati, inserisci un valore per ogni campo contrassegnato come obbligatorio. I valori di testo e URL possono contenere fino a 128 caratteri.

4. Scegli Crea record o Salva modifiche.

AWS CLI

Questi esempi utilizzano lo schema dell'esempio in Definizione di uno schema di metadati personalizzato.

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

Per modificare i valori di un record esistente, utilizzareupdate-registry-record. Il --custom-metadata parametro funziona nel modo seguente:

• Omettilo per mantenere i valori esistenti.

• Passa {"optionalValue": {…​}} con il set completo di valori. Sostituiscono tutti i valori esistenti, anziché fondersi con essi.

• Passa {"optionalValue": {}} per rimuovere tutti i valori di metadati personalizzati dal record. Lo schema del registro non cambia.

Questo esempio sostituisce i valori del 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']}")

Per modificare i valori in un secondo momento, customMetadata passa inclusooptionalValue, come con la CLI. Ometti customMetadata per mantenere i valori esistenti o passa {'optionalValue': {}} per rimuovere i valori del record.

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

Visualizza i valori

Console

In una pagina dei dettagli del record, la sezione Metadati personalizzati mostra i valori del record. I valori booleani vengono visualizzati come Sì o No e i valori URL vengono visualizzati come link cliccabili.

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

Vincoli

• I valori devono essere stringhe o valori booleani nativi (/). true false I numeri, gli array, gli oggetti e i valori null vengono rifiutati.

• I valori di testo e URL possono contenere fino a 128 caratteri. Un valore Enum deve essere uno dei valori consentiti del campo, ognuno dei quali può contenere fino a 64 caratteri.

• Un campo booleano richiede un booleano JSON nativo. La stringa "true" viene rifiutata: non viene effettuata alcuna conversione del tipo.

• Ogni chiave deve essere un campo che il record può contenere: un attributo comune o uno dei campi del tipo di record corrispondente. Le altre chiavi vengono rifiutate. Le chiavi fanno distinzione tra maiuscole e minuscole, quindi Owner non corrispondono a un campo denominato. owner

• Un valore Enum deve essere uno dei valori consentiti del campo. Se il tipo di record ridefinisce il campo, viene applicato il relativo elenco di valori consentiti.

Per i limiti dello schema stesso, vedi Regole e limiti dello schema.

Informazioni correlate

• Definire uno schema di metadati personalizzato

• Crea e gestisci i record

• Tipi di record e descrittori supportati