Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Impostare valori di metadati personalizzati su un record
<a name="registry-custom-metadata-values"></a>

**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](registry-faq.md) 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](registry-custom-metadata-schema.md).

**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
<a name="registry-custom-metadata-values-set"></a>

### Console
<a name="registry-custom-metadata-values-set-console"></a>

1. Nella pagina **Crea record** o **Modifica record** dell'[AWS agente](https://console.aws.amazon.com/agent-registry/home?region=us-east-1#), selezionare un **tipo di record**. Se il registro ha attributi o campi comuni per quel tipo di record, viene visualizzata la sezione **Metadati personalizzati**.

1. 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.**

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

1. 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.

1. Scegli **Crea record** o **Salva modifiche**.

### AWS CLI
<a name="registry-custom-metadata-values-set-cli"></a>

Questi esempi utilizzano lo schema dell'[esempio](registry-custom-metadata-schema.md#registry-custom-metadata-schema-example) 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, utilizzare`update-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
<a name="registry-custom-metadata-values-set-sdk"></a>

```
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 incluso`optionalValue`, 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
<a name="registry-custom-metadata-values-view"></a>

### Console
<a name="registry-custom-metadata-values-view-console"></a>

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
<a name="registry-custom-metadata-values-view-cli"></a>

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

### AWS SDK
<a name="registry-custom-metadata-values-view-sdk"></a>

```
import boto3

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

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

## Vincoli
<a name="registry-custom-metadata-values-constraints"></a>
+ 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](registry-custom-metadata-schema.md#registry-custom-metadata-schema-constraints).

## Informazioni correlate
<a name="registry-custom-metadata-values-related"></a>
+  [Definire uno schema di metadati personalizzato](registry-custom-metadata-schema.md) 
+  [Crea e gestisci i record](registry-create-manage-records.md) 
+  [Tipi di record e descrittori supportati](registry-supported-record-types.md)