View a markdown version of this page

Creazione e gestione dei record - Fondamento Amazon AgentCore
Crea un record di registroElenca i record del registroVisualizza i dettagli dei recordAggiorna un record di registroInvia un record per l'approvazioneEliminare un record di registroConvalida dello schema

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

Creazione e gestione dei record

La migrazione è ora aperta

AWS Agent Registry è stato lanciato con il nuovo agent-registry namespace. Il supporto per il bedrock-agentcore namespace di anteprima pubblico verrà interrotto il 17 settembre 2026. Per le istruzioni sulla migrazione, consulta la Guida completa alla migrazione del registro.

Crea un record di registro

Console

Esempio
AWS Agent Registry namespace

  1. Aprire la pagina dei dettagli del registro nella console del registro degli AWS agenti.

  2. Nella sezione Record di registro, scegli Crea record.

  3. 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 dall'origine. Disponibile solo per i tipi di record MCP e Agent. Per aggiornare il record dopo le modifiche all'origine, è necessario attivare manualmente la sincronizzazione. Per i dettagli, consulta Sincronizzare i record da fonti esterne.

    2. Manuale: configura manualmente i dettagli del record e la configurazione del protocollo.

Sincronizzazione dall'endpoint

  1. In Dettagli del record, seleziona il tipo di record: MCP o Agent.

    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 origine Manuale.

  2. Inserisci l'URL dell'endpoint. Deve essere un URL HTTPS valido.

  3. In Tipo di credenziale, scegli la modalità di autorizzazione del registro con l'endpoint:

    1. IAM: fornisci un Role ARN per la firma Sigv4 e un nome di servizio (ad esempio,,). agent-registry 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).

  4. 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 non riesce, 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, consulta Errori di sincronizzazione dei record. Registra gli errori di sincronizzazione Per aggiornare il record quando la fonte cambia, scegli Gestisci, quindi scegli Sincronizzazione nella pagina dei dettagli del record, oppure scegli Gestisci → Modifica e seleziona Re-sync dall'endpoint.

Per esempi AWS CLI e SDK di creazione di record con sincronizzazione, vedi Sincronizzazione di record da fonti esterne.

Manuale

  1. Nella sezione Dettagli del record, per Nome, inserisci un nome univoco per il record. Il nome deve essere univoco all'interno del registro: la combinazione di Name e Record version deve essere univoca. Il nome deve iniziare con un carattere alfanumerico. I caratteri validi sono a—z, A—Z, 0—9, (trattino basso), _ (trattino), - (punto) e (barra in avanti). . / Il nome può contenere fino a 255 caratteri.

  2. (Facoltativo) Per Nome visualizzato, inserisci un'etichetta leggibile dall'uomo per il record. Viene visualizzato nella tabella dei record del registro e nei risultati della ricerca insieme al nome tecnico del record.

  3. (Facoltativo) Per Descrizione, inserisci una descrizione per il record. La descrizione può contenere da 1 a 4.096 caratteri.

  4. Per Versione record, immettete un identificatore di versione per il record (ad esempio, 1.0.0 o). v2.1

  5. Nella sezione Tipo di record e descrittore:

    1. In Tipo, seleziona il tipo semantico del record. Il tipo determina quali chiavi descrittive primarie sono valide.

      • MCP: protocollo progettato per le comunicazioni tra strumenti di intelligenza artificiale e agenti. Gestisce la gestione del contesto e i formati strutturati dei messaggi.

      • Agente: protocollo progettato per interazioni sicure tra agenti. Consente flussi di lavoro distribuiti e lo scambio di informazioni.

      • Competenze: registra le competenze degli agenti con la documentazione markdown e una definizione strutturata opzionale.

      • Personalizzato: implementazione di un protocollo personalizzato per modelli di comunicazione specializzati. Definisci le tue specifiche di interfaccia e i requisiti di integrazione.

    2. In Descriptor, scegli la forma dei dati descrittori del record. Le opzioni disponibili dipendono dal tipo selezionato:

      • MCP → Server MCP o Personalizzato

      • Agente → Scheda agente A2A, server MCP o personalizzata

      • Competenze → Definizione delle competenze degli agenti o Personalizzate

      • Personalizzato → Personalizzato

  6. Viene visualizzato un editor specifico per il descrittore in base alla selezione del descrittore. Inserisci la configurazione del protocollo in formato JSON. Per i descrittori del server MCP e della scheda agente A2A, attiva Mostra schema ufficiale per visualizzare lo schema di riferimento fianco a fianco. La console convalida il tuo JSON rispetto allo schema ufficiale e mostra gli errori in linea (ad esempio, «Nome della proprietà mancante») con il pulsante Diagnosi con Amazon Q. Per i dettagli di configurazione per descrittore, consulta Tipi di record supportati. Tipi di record e descrittori supportati

  7. (Facoltativo) Nella sezione Tag, scegli Aggiungi nuovo tag per allegare uno o più tag al record. Ogni tag ha una chiave e un valore opzionale.

  8. Scegli una delle seguenti opzioni:

    1. Crea come bozza: crea il record in stato Bozza.

    2. Crea e invia per l'approvazione: crea il record e lo invia immediatamente per l'approvazione.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Aprire la pagina dei dettagli del registro nella Bedrock-AgentCore console.

  2. Nella sezione Record di registro, scegli Crea record.

  3. 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 dall'origine. Disponibile solo per i tipi di record MCP e Agent. Per aggiornare il record dopo le modifiche all'origine, è necessario attivare manualmente la sincronizzazione. Per i dettagli, consulta Sincronizzare i record da fonti esterne.

    2. Manuale: configura manualmente i dettagli del record e la configurazione del protocollo.

Sincronizzazione dall'endpoint

  1. In Dettagli del record, seleziona il tipo di record: MCP o Agent.

    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 origine Manuale.

  2. Inserisci l'URL dell'endpoint. Deve essere un URL HTTPS valido.

  3. In Tipo di credenziale, scegli la modalità di autorizzazione del registro con l'endpoint:

    1. IAM: fornisci un Role ARN per la firma Sigv4 e un nome di servizio (ad esempio,,). 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).

  4. 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 non riesce, 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, consulta Errori di sincronizzazione dei record. Registra 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 AWS CLI e SDK sulla creazione di record con sincronizzazione, vedi Sincronizzazione di record da fonti esterne.

Manuale

  1. In Dettagli del record, inserisci:

    1. Nome: deve iniziare con una lettera o una cifra. I caratteri validi sono a-z, A-Z, 0-9, _ (trattino basso), - (trattino),. (punto) e/(barra in avanti). Il nome può contenere fino a 255 caratteri.

    2. Descrizione (opzionale): da 1 a 4.096 caratteri.

    3. Versione del record: specifica la versione di questo record (ad esempio, 1.0.0, v2.1).

  2. In Tipo di record, seleziona una delle seguenti opzioni: MCP, Agent, Agent Skills o Custom.

  3. Viene visualizzato un editor specifico per il tipo. Inserisci la configurazione del protocollo in formato JSON.

    1. Per i tipi di agente 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 il pulsante Diagnosi con Amazon Q.

  4. Scegli una delle seguenti opzioni:

    1. Crea come bozza: crea il record in stato Bozza.

    2. Crea e invia per l'approvazione: crea il record e lo invia immediatamente per l'approvazione.

AWS CLI

Esempio
AWS Agent Registry namespace
aws agent-registry-control create-registry-record \
  --registry-id <registryId> \
  --name "my-mcp-server" \
  --display-name "MyMCPServer" \
  --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" \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
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

Esempio
AWS Agent Registry namespace
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',
    displayName='MyMCPServer',
    recordType='MCP',
    descriptors={
        'mcpServer': {
            'data': server_content,
            'dataSchemaVersion': '2025-12-11'
        }
    },
    recordVersion='1.0'
)
print(f"Record ARN: {response['recordArn']}")
print(f"Status: {response['status']}")  # CREATING
Amazon Bedrock AgentCore namespace (to be deprecated)
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
Nota

Nel agent-registry namespace, name è la chiave univoca all'interno di un registro (name+ recordVersion combinato deve essere univoco). Da utilizzare displayName per l'etichetta leggibile dall'uomo. La descriptors struttura è piatta e codificata in base al tipo di descrittore primario (mcpServer,, a2aAgentCardagentSkillsDefinition,custom); i campiinlineContent/precedenti vengono rinominati in/schemaVersion. data dataSchemaVersion

Elenca i record del registro

Console

Esempio
AWS Agent Registry namespace

  1. Aprire la pagina dei dettagli del registro nella console del registro degli AWS agenti.

  2. La sezione Record del registro mostra:

    1. Contatori riepilogativi dello stato: totale inviato, In attesa di approvazione, Approvato, Obsoleto, Rifiutato.

    2. Tabella dei record con colonne: Nome, Nome visualizzato, Descrizione, Stato, Tipo di record, ARN del record, Ultimo aggiornamento.

  3. Usa la barra Cerca nei record per filtrare per nome.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Apri la pagina dei dettagli del registro nella Bedrock-AgentCore console.

  2. La sezione Record del registro mostra:

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

  3. Usa la barra Cerca nei record per filtrare per nome.

  4. Utilizza il menu a discesa Aggiorna stato per eseguire modifiche di stato in blocco sui record selezionati.

AWS CLI

Esempio
AWS Agent Registry namespace
aws agent-registry-control list-registry-records \
  --registry-id "<registryId>" \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control list-registry-records \
  --registry-id "<registryId>" \
  --region us-east-1

AWS SDK

Esempio
AWS Agent Registry namespace
import boto3

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

response = client.list_registry_records(
    registryId='<registryId>'
)
for record in response['registryRecords']:
    print(f"{record['displayName']} ({record['name']}) - {record['status']} - {record['recordType']}")
Amazon Bedrock AgentCore namespace (to be deprecated)
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']}")
Nota

Nel agent-registry namespace, ListRegistryRecords accetta un filters parametro strutturato (un elenco di {"name": "<dotted.path>", "values": […​]} voci) anziché parametri di interrogazione discreti per campo. Nomi di filtro supportati:, e. name status recordType

Visualizza i dettagli dei record

Console

Esempio
AWS Agent Registry namespace

  1. Dalla pagina dei dettagli del registro nella console del registro degli AWS agenti, scegliete il nome di un record dalla tabella dei record.

  2. La pagina dei dettagli del record mostra:

    1. Sezione dei dettagli del record: nome, nome visualizzato, descrizione, ARN del record, stato (mostrato 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): dettagli sul tipo di sincronizzazione, l'URL di origine e il provider di credenziali (ARN del ruolo IAM, ARN del servizio, della regione o del provider OAuth, tipo di concessione, ambiti, parametri personalizzati).

    3. Sezione di configurazione del protocollo: il contenuto del descrittore viene visualizzato come JSON formattato (ad esempio, «Agent card» per i record A2A, «Server» e «Tools» per i record MCP).

    4. Sezione Tag: mostra i tag associati al record come tabella chiave-valore. Per aggiungere, rimuovere o modificare i tag, scegli Modifica in questa sezione per aprire la pagina Modifica tag.

  3. Azioni disponibili:

    1. Elenco a discesa dello stato dell'aggiornamento: Invia per l'approvazione, Approva, Rifiuta o Depreca.

    2. Pulsante Gestisci: scegli Modifica per modificare il record, Elimina per rimuoverlo definitivamente o Sincronizzazione per attivare una nuova sincronizzazione dall'endpoint configurato (solo record MCP e Agent). La sincronizzazione apre una finestra di dialogo di conferma; il record passa allo stato UPDATING durante la sincronizzazione.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Dalla pagina dei dettagli del registro nella Bedrock-AgentCore console, scegliete il nome di un record dalla tabella dei record.

  2. La pagina dei dettagli del record mostra:

    1. Sezione dei dettagli del record: nome, descrizione, ARN del record, stato (mostrato come badge accanto al nome del record), versione, data dell'ultimo aggiornamento, tipo di record, ID del 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, ARN del servizio, della regione o del provider OAuth, tipo di concessione, ambiti, parametri personalizzati).

    3. Sezione di configurazione del protocollo: il contenuto del descrittore viene visualizzato come JSON formattato (ad esempio, «Agent card» per i record A2A, «Server» e «Tools» per i record MCP).

  3. 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 dell'aggiornamento: Invia per approvazione, Approva, Rifiuta o Deprecato.

    3. Three-dot menu (⋮) — Modifica o Elimina.

AWS CLI

Esempio
AWS Agent Registry namespace
aws agent-registry-control get-registry-record \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control get-registry-record \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --region us-east-1

AWS SDK

Esempio
AWS Agent Registry namespace
import boto3

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

response = client.get_registry_record(
    registryId='<registryId>',
    recordId='<recordId>'
)
print(f"Name (dedup key): {response['name']}")
print(f"Display Name: {response['displayName']}")
print(f"Description: {response['description']}")
print(f"Status: {response['status']}")
print(f"Record Type: {response['recordType']}")
print(f"Version: {response['recordVersion']}")
Amazon Bedrock AgentCore namespace (to be deprecated)
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']}")

Aggiorna un record di registro

Console

Esempio
AWS Agent Registry namespace

  1. Dalla pagina dei dettagli del record nella console del registro degli AWS agenti, scegli Gestisci, quindi scegli Modifica.

  2. Nella pagina Modifica record, aggiorna uno dei seguenti elementi:

    1. Nome, Nome visualizzato, Descrizione, Versione del record in Dettagli del record.

    2. Tipo di record e descrittore: modifica la forma del and/or descrittore del tipo semantico, se necessario. La modifica del tipo potrebbe richiedere la selezione di un nuovo descrittore e la reimmissione del contenuto del descrittore.

  3. (Solo record MCP e Agent) In Sincronizza dall'endpoint, configura facoltativamente la sincronizzazione:

    È possibile aggiornare i record tramite 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. In caso di esito positivo, viene creata una nuova versione del record in stato DRAFT. In caso di esito negativo, 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 non forniti dall'origine. Un amministratore o un curatore deve esaminare e approvare la nuova bozza affinché diventi visibile nei risultati di ricerca. Fino ad allora, la precedente revisione approvata (se presente) rimane ricercabile. Per ulteriori informazioni sul comportamento della doppia revisione, consulta Ciclo di vita dei record. Ciclo di vita dei record

    1. Inserisci un URL dell'endpoint per abilitare la sincronizzazione. I campi relativi al tipo di credenziale vengono visualizzati quando viene fornito un endpoint. Se il record ha già la sincronizzazione configurata, i campi dell'endpoint e del provider di credenziali sono precompilati con la configurazione esistente.

    2. Scegli un tipo di credenziale (IAM, OAuth o None) 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 un 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 Endpoint. Questo ripristina l'endpoint e tutti i campi delle credenziali.

  4. In Configurazione del record, aggiorna le definizioni del record nell'editor JSON.

    1. È possibile configurare sia l'endpoint per la sincronizzazione sia 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 non forniti dall'origine non vengono modificati.

  5. La console convalida il tuo JSON rispetto allo schema ufficiale e mostra gli errori in linea con il pulsante Diagnosi con Amazon Q.

  6. Scegli una delle seguenti opzioni:

    1. Salva modifiche: salva il record come bozza.

    2. Salva e invia per l'approvazione: salva e invia in un solo passaggio.

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

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Dalla pagina dei dettagli del record nella Bedrock-AgentCore console, scegli il menu a tre punti (⋮), quindi scegli Modifica.

  2. Nella pagina Modifica record, aggiorna uno dei seguenti elementi:

    1. Nome, Descrizione, Versione del record in Dettagli del record.

    2. Tipo di record: modifica il tipo di protocollo, se necessario.

  3. (Solo record MCP e Agent) In Sincronizza dall'endpoint, configura facoltativamente la sincronizzazione:

    È possibile aggiornare i record tramite 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. In caso di esito positivo, viene creata una nuova versione del record in stato DRAFT. In caso di esito negativo, 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 non forniti dall'origine. Un amministratore o un curatore deve esaminare e approvare la nuova bozza affinché diventi visibile nei risultati di ricerca. Fino ad allora, la precedente revisione approvata (se presente) rimane ricercabile. Per ulteriori informazioni sul comportamento della doppia revisione, consulta Ciclo di vita dei record. Ciclo di vita dei record

    1. Inserisci un URL dell'endpoint per abilitare la sincronizzazione. I campi relativi al tipo di credenziale vengono visualizzati quando viene fornito un endpoint. Se il record ha già la sincronizzazione configurata, i campi dell'endpoint e del provider di credenziali sono precompilati con la configurazione esistente.

    2. Scegli un tipo di credenziale (IAM, OAuth o None) e compila i campi obbligatori. Se il record è stato precedentemente configurato con un fornitore di credenziali, i valori esistenti sono precompilati.

    3. Seleziona Re-sync un 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 Endpoint. Questo ripristina l'endpoint e tutti i campi delle credenziali.

  4. In Configurazione del record, aggiorna le definizioni del record nell'editor JSON.

    1. È possibile configurare sia l'endpoint per la sincronizzazione sia 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 non forniti dall'origine non vengono modificati.

  5. La console convalida il tuo JSON rispetto allo schema ufficiale e mostra gli errori in linea con il pulsante Diagnosi con Amazon Q.

  6. Scegli una delle seguenti opzioni:

    1. Salva modifiche: salva il record come bozza.

    2. Salva e invia per l'approvazione: salva e invia in un solo passaggio.

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

Nota

I tag non vengono modificati dalla pagina Modifica record nella console del registro degli AWS agenti. Per modificare i tag, vai alla pagina dei dettagli del record, scegli Modifica nella sezione Tag, aggiungi o rimuovi tag nella pagina Modifica tag e scegli Salva modifiche. (I tag sono supportati solo nella console del registro degli AWS agenti).

AWS CLI

Esempio
AWS Agent Registry namespace
aws agent-registry-control update-registry-record \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --description "Updated description" \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control update-registry-record \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --description "Updated description" \
  --region us-east-1

AWS SDK

Esempio
AWS Agent Registry namespace
import boto3

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

response = client.update_registry_record(
    registryId='<registryId>',
    recordId='<recordId>',
    description='Updated description'
)
print(f"Updated: {response['name']} - Status: {response['status']}")
Amazon Bedrock AgentCore namespace (to be deprecated)
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 -

  1. Scegli il menu a discesa dello stato dell'aggiornamento

  2. Quindi, scegli Invia per l'approvazione.

    1. In alternativa, utilizza 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 di sistema è 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

Esempio
AWS Agent Registry namespace
aws agent-registry-control submit-registry-record-for-approval \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control submit-registry-record-for-approval \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --region us-east-1

AWS SDK

Esempio
AWS Agent Registry namespace
import boto3

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

response = client.submit_registry_record_for_approval(
    registryId='<registryId>',
    recordId='<recordId>'
)
print(f"Status: {response['status']}")  # PENDING_APPROVAL or APPROVED
Amazon Bedrock AgentCore namespace (to be deprecated)
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

Esempio
AWS Agent Registry namespace

  1. Dalla pagina dei dettagli del record nella console del registro degli AWS agenti, scegli Gestisci, quindi scegli Elimina.

  2. Conferma l'eliminazione digitando delete quando richiesto.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Dalla pagina dei dettagli del record nella Bedrock-AgentCore console, scegli il menu a tre punti (⋮), quindi scegli Elimina.

  2. Conferma l'eliminazione digitando quando richiestodelete.

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

AWS CLI

Esempio
AWS Agent Registry namespace
aws agent-registry-control delete-registry-record \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control delete-registry-record \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --region us-east-1

AWS SDK

Esempio
AWS Agent Registry namespace
import boto3

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

response = client.delete_registry_record(
    registryId='<registryId>',
    recordId='<recordId>'
)
print("Record deleted successfully")
Amazon Bedrock AgentCore namespace (to be deprecated)
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.