Creare un record di registro Elenca i record del registro Visualizza i dettagli dei record Aggiornare un record di registro Invia un record per l'approvazione Eliminare un record di registro Convalida dello schema

Creare e gestire i record

Prossima migrazione del namespace

AWS Agent Registry è attualmente disponibile in anteprima pubblica nel namespace bedrock-agentcore. A partire dal 6 agosto 2026, il servizio passerà allo spazio dei nomi agent-registry. Se utilizzi AWS Agent Registry, devi aggiornare gli endpoint, le policy IAM, i client SDK, gli script CLI e i dati del registro. Per ulteriori informazioni sulla migrazione dall'anteprima pubblica, consulta la Guida completa alla migrazione del registro.

Creare un record di registro

Console

Apri la pagina dei dettagli del registro.
Nella sezione Record del registro, scegli Crea record.
Scegli un tipo di fonte:
1. Sincronizzazione dall'endpoint: fornisci un URL dell'endpoint e credenziali opzionali per richiamare l'endpoint e il registro recupererà i metadati dalla fonte. Disponibile solo per i tipi di record MCP e Agent. Per aggiornare il record dopo la modifica dell'origine, è necessario attivare manualmente la sincronizzazione. Per ulteriori informazioni, consulta Sincronizzare i record da fonti esterne.
2. Manuale: configura manualmente i dettagli del record e la configurazione del protocollo.

Sincronizzazione dall'endpoint

In Dettagli del record, selezionare il tipo di record: MCP o Agente.

Nota
La sincronizzazione è supportata solo per i tipi di record MCP e Agent. I tipi di record Agent Skills e Custom non supportano la sincronizzazione: utilizzate invece il tipo di sorgente Manual.
Inserisci l'URL dell'endpoint. Deve essere un URL HTTPS valido.
In Tipo di credenziale, scegli in che modo il registro autorizza l'endpoint:
1. IAM: fornisce un ARN di ruolo per la firma di SIGv4 e un nome di servizio (ad es.,,bedrock-agentcore). execute-api lambda Facoltativamente, specifica una regione per la firma.
2. OAuth: seleziona o inserisci un ARN del provider di credenziali da Identity. AgentCore Facoltativamente, configura gli ambiti e i parametri personalizzati in Configurazione aggiuntiva.
3. Nessuna: nessuna autorizzazione (per gli endpoint pubblici).
Scegli Crea record.

Il record viene creato nello stato CREATING. Il registro si connette all'endpoint, estrae i metadati e compila i descrittori del record. Al termine della sincronizzazione, il record passa a DRAFT. Se la sincronizzazione fallisce, il record passa allo stato CREATE_FAILED con i dettagli dell'errore disponibili nel campo Status Reason nella pagina dei dettagli del record. Per la risoluzione dei problemi, vedere Registrare gli errori di sincronizzazione. Per aggiornare il record quando la fonte cambia, usa il pulsante Sincronizza nella pagina dei dettagli del record o seleziona Re-sync dall'endpoint durante la modifica.

Per esempi di creazione di record con sincronizzazione tramite AWS CLI e SDK, consulta Sincronizzare i record da fonti esterne.

Manuale

In Dettagli del record, inserisci:
1. Nome: deve iniziare con una lettera o una cifra. I caratteri validi sono a-z, 0-9 A-Z, _ (trattino basso), - (trattino),. (punto) e/(barra). Il nome può contenere fino a 255 caratteri.
2. Descrizione (opzionale): da 1 a 4.096 caratteri.
3. Versione del record: specificare la versione di questo record (ad esempio, 1.0.0, v2.1).
In Tipo di record, selezionare una delle seguenti opzioni: MCP, Agent, Agent Skills o Custom.
Viene visualizzato un editor specifico per tipo. Inserisci la configurazione del protocollo in formato JSON.
1. Per i tipi Agent e MCP, attiva Mostra schema ufficiale per visualizzare lo schema di riferimento fianco a fianco come guida.
2. La console convalida il tuo JSON rispetto allo schema ufficiale e mostra gli errori in linea (ad esempio, «Nome della proprietà mancante») con un pulsante Diagnostica con Amazon Q.
Scegli una delle seguenti opzioni:
1. Crea come bozza: crea il record con lo stato Bozza.
2. Crea e invia per l'approvazione: crea il record e lo invia immediatamente per l'approvazione.

AWS CLI


aws bedrock-agentcore-control create-registry-record \
  --registry-id <registryId> \
  --name "MyMCPServer" \
  --descriptor-type MCP \
  --descriptors '{"mcp": {"server": {"inlineContent": "{\"name\": \"my/mcp-server\", \"description\": \"My MCP server\", \"version\": \"1.0.0\"}"}}}' \
  --record-version "1.0" \
  --region us-east-1

AWS SDK


import boto3
import json

client = boto3.client('bedrock-agentcore-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='MyMCPServer',
    descriptorType='MCP',
    descriptors={
        'mcp': {
            'server': {
                'inlineContent': server_content
            }
        }
    },
    recordVersion='1.0'
)
print(f"Record ARN: {response['recordArn']}")
print(f"Status: {response['status']}")  # CREATING

Elenca i record del registro

Console

Apri la pagina dei dettagli del registro.
La sezione Record del registro mostra:
1. Contatori di riepilogo dello stato: totale inviato, in attesa di approvazione, approvato, obsoleto, rifiutato.
2. Tabella dei record con colonne: Nome, Descrizione, Stato, Tipo di record, ARN del record, Ultimo aggiornamento.
Utilizza la barra dei record di ricerca per filtrare in base al nome.
Utilizza il menu a discesa Aggiorna stato per apportare modifiche di stato in blocco ai record selezionati.

AWS CLI


aws bedrock-agentcore-control list-registry-records \
  --registry-id "<registryId>" \
  --region us-east-1

AWS SDK


import boto3

client = boto3.client('bedrock-agentcore-control')

response = client.list_registry_records(
    registryId='<registryId>'
)
for record in response['registryRecords']:
    print(f"{record['name']} - {record['status']} - {record['descriptorType']}")

Visualizza i dettagli dei record

Console

Dalla pagina dei dettagli del registro, scegli un nome di record dalla tabella dei record.
La pagina dei dettagli del record mostra:
1. Sezione dei dettagli del record: nome, descrizione, ARN del record, stato (visualizzato come badge accanto al nome del record), versione, data dell'ultimo aggiornamento, tipo di record, ID record, data di creazione.
2. Sezione di configurazione della sincronizzazione (se configurata): tipo di sincronizzazione, URL di origine e dettagli del provider di credenziali (ARN del ruolo IAM, servizio, regione o ARN del provider OAuth, tipo di concessione, ambiti, parametri personalizzati).
3. Sezione di configurazione del protocollo: il contenuto del descrittore visualizzato come JSON in formato JSON (ad esempio, «Agent card» per i record A2A, «Server» e «Tools» per i record MCP).
Azioni disponibili:
1. Pulsante di sincronizzazione (solo record MCP e Agent): attiva una nuova sincronizzazione dall'endpoint configurato. Apre una finestra di dialogo di conferma prima di procedere. Il record passa allo stato UPDATING durante la sincronizzazione.
2. Elenco a discesa dello stato di aggiornamento: invia per approvazione, approva, rifiuta o depreca.
3. Three-dot menu (⋮) — Modifica o Elimina.

AWS CLI


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

AWS SDK


import boto3

client = boto3.client('bedrock-agentcore-control')

response = client.get_registry_record(
    registryId='<registryId>',
    recordId='<recordId>'
)
print(f"Name: {response['name']}")
print(f"Description: {response['description']}")
print(f"Status: {response['status']}")
print(f"Descriptor Type: {response['descriptorType']}")
print(f"Version: {response['recordVersion']}")

Aggiornare un record di registro

Console

Dalla pagina dei dettagli del record, scegli il menu a tre punti (⋮), quindi scegli Modifica.
Nella pagina Modifica record, aggiorna uno dei seguenti elementi:
1. Nome, Descrizione, Versione del record in Dettagli del record.
2. Tipo di record: se necessario, modificare il tipo di protocollo.
(Solo record MCP e Agent) In Sincronizza dall'endpoint, configura facoltativamente la sincronizzazione:

È possibile aggiornare i record tramite la sincronizzazione indipendentemente dal fatto che siano stati originariamente creati con la sincronizzazione. Quando la sincronizzazione viene attivata durante un aggiornamento, il record passa allo stato UPDATING. Se l'operazione ha esito positivo, viene creata una nuova versione del record con lo stato DRAFT. Se fallisce, il record passa allo stato UPDATE_FAILED con i dettagli dell'errore nel campo Status Reason. I dati sincronizzati sovrascrivono il nome, la descrizione, la versione, le definizioni degli strumenti e le definizioni del server del record con i valori trovati all'origine, ma non modificano i campi che l'origine non fornisce. Un amministratore o un curatore deve esaminare e approvare la nuova bozza affinché diventi visibile nella ricerca. Fino ad allora, l'eventuale revisione approvata precedente rimane ricercabile. Per ulteriori informazioni sul comportamento della doppia revisione, consulta Record lifecycle.
1. Inserisci un URL dell'endpoint per abilitare la sincronizzazione. I campi del tipo di credenziali vengono visualizzati quando viene fornito un endpoint. Se nel record è già configurata la sincronizzazione, i campi dell'endpoint e del provider di credenziali sono precompilati con la configurazione esistente.
2. Scegli un tipo di credenziale (IAM, OAuth o Nessuno) e compila i campi obbligatori. Se il record è stato precedentemente configurato con un provider di credenziali, i valori esistenti sono precompilati.
3. Seleziona Re-sync da endpoint per attivare una nuova sincronizzazione durante il salvataggio. Il record passa allo stato UPDATING durante la sincronizzazione.
4. Per rimuovere la sincronizzazione, scegli il pulsante Cancella accanto al campo dell'endpoint. Ciò ripristina l'endpoint e tutti i campi delle credenziali.
In Configurazione del record, aggiorna le definizioni del record nell'editor JSON.
1. È possibile configurare entrambi gli endpoint per la sincronizzazione e modificare manualmente le definizioni del record. Quando viene attivata la sincronizzazione, il registro recupera i metadati più recenti dall'endpoint e aggiorna il nome, la descrizione, la versione, le definizioni degli strumenti e le definizioni del server del record con i valori trovati all'origine, avendo la precedenza su qualsiasi modifica manuale a tali campi. I campi che l'origine non fornisce non vengono modificati.
La console convalida il tuo JSON rispetto allo schema ufficiale e mostra gli errori in linea con un pulsante Diagnostica con Amazon Q.
Scegli una delle seguenti opzioni:
1. Salva le modifiche: salva il record come bozza.
2. Salva e invia per l'approvazione: salva e invia in un unico passaggio.

Un banner di successo conferma: «[Nome] è stato aggiornato e inviato per l'approvazione con successo».

AWS CLI


aws bedrock-agentcore-control update-registry-record \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --description "Updated description" \
  --region us-east-1

AWS SDK


import boto3

client = boto3.client('bedrock-agentcore-control')

response = client.update_registry_record(
    registryId='<registryId>',
    recordId='<recordId>',
    description='Updated description'
)
print(f"Updated: {response['name']} - Status: {response['status']}")

Invia un record per l'approvazione

Console

Dalla pagina dei dettagli del record -

Scegli il menu a discesa Aggiorna stato
Quindi, scegli Invia per approvazione.
1. In alternativa, usa Crea e invia per l'approvazione o Salva e invia per l'approvazione durante la creazione o la modifica.

Nota

Se la Auto-Approval configurazione del Registro è impostata su TRUE, l'invio di un record per l'approvazione lo approva automaticamente. Altrimenti, se la Auto-Approval configurazione è impostata su FALSE, il record passa allo stato «In attesa di approvazione» e attende che il curatore lo approvi o lo rifiuti. Inoltre, viene attivata una EventBridge notifica Amazon che indica che è stata richiesta l'approvazione di un nuovo record.

AWS CLI


aws bedrock-agentcore-control submit-registry-record-for-approval \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --region us-east-1

AWS SDK


import boto3

client = boto3.client('bedrock-agentcore-control')

response = client.submit_registry_record_for_approval(
    registryId='<registryId>',
    recordId='<recordId>'
)
print(f"Status: {response['status']}")  # PENDING_APPROVAL or APPROVED

Eliminare un record di registro

Console

Dalla pagina dei dettagli del record, scegli il menu a tre punti (⋮), quindi scegli Elimina.
Conferma l'eliminazione digitando «elimina» quando richiesto

L'eliminazione è permanente e non può essere annullata.

AWS CLI


aws bedrock-agentcore-control delete-registry-record \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --region us-east-1

AWS SDK


import boto3

client = boto3.client('bedrock-agentcore-control')

response = client.delete_registry_record(
    registryId='<registryId>',
    recordId='<recordId>'
)
print("Record deleted successfully")

Convalida dello schema

Quando crei o modifichi un record, la console e l'API convalidano la configurazione del protocollo rispetto allo schema ufficiale per il tipo di record selezionato. Maggiori dettagli sulle convalide sono disponibili in Tipi di record supportati.

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Ciclo di vita da record

Sincronizza i record da fonti esterne