Prerequisiti Fase 1: Creare un registro Fase 2: Aggiungere un record di registro Fase 3: Inviare il record per l'approvazione Fase 4: Approvare il record Fase 5: Scopri i record approvati Cosa hai costruito Fasi successive

Inizia con AWS Registro degli agenti

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.

In questa guida, creerai il tuo primo registro, aggiungerai un record, lo approverai e lo cercherai.

Prerequisiti

Completa i passaggi indicati in Prerequisiti.

Fase 1: Creare un registro

Crea un registro con autorizzazione IAM e approvazione manuale.

Console

Creazione di un registro con IAM-based autorizzazione

Esempio

AWS Agent Registry namespace

Aprire la console AWS Agent Registry.
Nel riquadro di navigazione, scegli Registro.
Nella sezione Registri, scegli Crea registro.
Nella sezione Dettagli del registro, per Nome, inserisci un nome per il tuo registro. 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 64 caratteri.
(Facoltativo) Scegli Dettagli aggiuntivi per espandere la sezione, quindi per Descrizione, inserisci una descrizione per identificare questo registro.
Nella sezione Discovery Authorization, per il tipo di autenticazione, scegli Usa autorizzazione IAM (autorizzazione in entrata).
Nella sezione Approvazione dei record, attiva o disattiva: Auto-approval
- Quando Auto-approval è attiva, quando invii un record per l'approvazione, il record passa direttamente allo stato Approvato e diventa visibile nei risultati di ricerca poco dopo.
- Quando Auto-approval è disattivata, quando invii un record per l'approvazione, il record passa allo stato In attesa di approvazione e richiede a un curatore di esaminarlo e approvarlo prima che venga pubblicato.
(Facoltativo) Nella sezione Tag, scegli Aggiungi nuovo tag per allegare uno o più tag al registro. Ogni tag ha una chiave e un valore opzionale.
Scegli Crea registro.

Amazon Bedrock AgentCore namespace (to be deprecated)

Aprire la pagina del registro degli AWS agenti nella Bedrock-AgentCore console.
Nel riquadro di navigazione, scegli Registro.
Nella sezione Registri, scegli Crea registro.
Nella sezione Dettagli del registro, per Nome, inserisci un nome per il tuo registro. 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 64 caratteri.
(Facoltativo) Scegli Dettagli aggiuntivi per espandere la sezione, quindi per Descrizione, inserisci una descrizione per identificare questo registro.
Nella sezione Search API Authorization, per il tipo di autenticazione, scegli Usa autorizzazione IAM (autorizzazione in entrata).
Nella sezione Approvazione dei record, attiva o disattiva: Auto-approval
- Quando Auto-approval è attiva, quando invii un record per l'approvazione, il record passa direttamente allo stato Approvato e diventa visibile nei risultati di ricerca poco dopo.
- Quando Auto-approval è disattivata, quando invii un record per l'approvazione, il record passa allo stato In attesa di approvazione e richiede a un curatore di esaminarlo e approvarlo prima che venga pubblicato.
Scegli Crea registro.

Creazione di un registro con JWT-based autorizzazione

L'autorizzazione del provider di identità utilizza JSON Web Tokens (JWT) per controllare l'accesso alle API del piano dati rilevabili e all'endpoint MCP del registro. Puoi utilizzare Amazon Cognito per configurare rapidamente l'autorizzazione o chiamare il tuo provider di identità per abilitare OAuth 2.0.

Esempio

AWS Agent Registry namespace

Apri la console AWS Agent Registry.
Nel riquadro di navigazione, scegli Registro.
Nella sezione Registri, scegli Crea registro.
Nella sezione Dettagli del registro, per Nome, inserisci un nome per il tuo registro. 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 64 caratteri.
(Facoltativo) Scegli Dettagli aggiuntivi per espandere la sezione, quindi per Descrizione, inserisci una descrizione per identificare questo registro.
Nella sezione Discovery Authorization, per il tipo di autenticazione, scegli Usa JSON Web Tokens (JWT) (autorizzazione in entrata).
Per la configurazione dello schema JWT, scegli una delle seguenti opzioni:
1. Creazione rapida di configurazioni con Cognito (consigliato): AWS Agent Registry crea le configurazioni di autorizzazione per tuo conto utilizzando Amazon Cognito come provider di identità. e non sono necessarie ulteriori configurazioni.
2. Utilizza le configurazioni dei provider di identità esistenti: porta il tuo provider di identità per abilitare OAuth 2.0. Se scegli questa opzione, completa i seguenti passaggi:
  1. Per Discovery URL, inserisci l'URL di scoperta del tuo provider di identità. AWS Agent Registry utilizza questo URL per recuperare automaticamente le impostazioni di accesso, token e verifica per il tuo provider. Puoi trovare questo URL nella dashboard o nella documentazione del tuo provider di identità (ad esempio,https://cognito-identity.amazonaws.com/.well-known/openid-configuration).
    
    Nota
    L'URL di scoperta non può essere modificato dopo la creazione del registro.
  2. (Facoltativo) Nella configurazione dell'autorizzazione JWT, seleziona Audiences consentiti per fornire un elenco di segmenti di pubblico consentiti che AWS Agent Registry convalida in base alla aud dichiarazione nel token JWT. Un'attestazione di pubblico (aud) in OAuth 2.0 specifica a quale server di risorse (API) è destinato il token. Ciò garantisce che il token sia il destinatario corretto prima di elaborare la richiesta, impedendo che un token venga riutilizzato in un'API diversa per la quale non è stato emesso.
  3. (Facoltativo) Seleziona Client consentiti per fornire un elenco di identificativi client consentiti che AWS Agent Registry convalida in base alla client_id dichiarazione contenuta nel token JWT. A client_id è un identificatore pubblico e univoco per un'applicazione che richiede token di accesso per accedere alle API del piano dati rilevabili o all'endpoint MCP del registro. Se abiliti questa opzione, inserisci uno o più ID client nel campo Client, quindi scegli Aggiungi client per aggiungere altri client.
  4. (Facoltativo) Seleziona Ambiti consentiti per fornire un elenco di autorizzazioni consentite, definite come ambiti. Se configurato, almeno un valore dell'ambito nel token in ingresso deve corrispondere a uno dei valori configurati. Gli ambiti fungono da autorizzazioni per limitare ciò che un'applicazione può fare.
  5. (Facoltativo) Seleziona attestazioni personalizzate per fornire una serie di regole che abbinino le attestazioni specifiche del token in entrata ai valori predefiniti. Per ogni regola, specifica il nome dell'attestazione, il tipo di valore (STRING o STRING_ARRAY) e il valore di corrispondenza richiesto.
Nella sezione Approvazione dei record, attiva o disattiva: Auto-approval
1. Quando Auto-approval è attiva, quando invii un record per l'approvazione, il record passa direttamente allo stato Approvato e diventa immediatamente visibile nei risultati di ricerca.
2. Quando Auto-approval è disattivato, quando si invia un record per l'approvazione, il record passa allo stato In attesa di approvazione e richiede a un amministratore del registro di esaminarlo e approvarlo prima della pubblicazione.
(Facoltativo) Nella sezione Tag, scegli Aggiungi nuovo tag per allegare uno o più tag al registro. Ogni tag ha una chiave e un valore opzionale.
Scegli Crea registro.

Amazon Bedrock AgentCore namespace (to be deprecated)

Aprire la pagina del registro degli AWS agenti nella Bedrock-AgentCore console.
Nel riquadro di navigazione, scegli Registro.
Nella sezione Registri, scegli Crea registro.
Nella sezione Dettagli del registro, per Nome, inserisci un nome per il tuo registro. 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 64 caratteri.
(Facoltativo) Scegli Dettagli aggiuntivi per espandere la sezione, quindi per Descrizione, inserisci una descrizione per identificare questo registro.
Nella sezione Autorizzazione dell'API di ricerca, per il tipo di autenticazione, scegli Usa JSON Web Tokens (JWT) (autorizzazione in entrata).
Per la configurazione dello schema JWT, scegli una delle seguenti opzioni:
1. Creazione rapida di configurazioni con Cognito (consigliato): AWS Agent Registry crea le configurazioni di autorizzazione per tuo conto utilizzando Amazon Cognito come provider di identità. e non sono necessarie ulteriori configurazioni.
2. Utilizza le configurazioni dei provider di identità esistenti: porta il tuo provider di identità per abilitare OAuth 2.0. Se scegli questa opzione, completa i seguenti passaggi:
  1. Per Discovery URL, inserisci l'URL di scoperta del tuo provider di identità. AWS Agent Registry utilizza questo URL per recuperare automaticamente le impostazioni di accesso, token e verifica per il tuo provider. Puoi trovare questo URL nella dashboard o nella documentazione del tuo provider di identità (ad esempio,https://cognito-identity.amazonaws.com/.well-known/openid-configuration).
    
    Nota
    L'URL di scoperta non può essere modificato dopo la creazione del registro.
  2. (Facoltativo) Nella configurazione dell'autorizzazione JWT, seleziona Audiences consentiti per fornire un elenco di segmenti di pubblico consentiti che AWS Agent Registry convalida in base alla aud dichiarazione nel token JWT. Un'attestazione di pubblico (aud) in OAuth 2.0 specifica a quale server di risorse (API) è destinato il token. Ciò garantisce che il token sia il destinatario corretto prima di elaborare la richiesta, impedendo che un token venga riutilizzato in un'API diversa per la quale non è stato emesso.
  3. (Facoltativo) Seleziona Client consentiti per fornire un elenco di identificativi client consentiti che AWS Agent Registry convalida in base alla client_id dichiarazione contenuta nel token JWT. A client_id è un identificatore pubblico e univoco per un'applicazione che richiede token di accesso per accedere all'API di ricerca del registro. Se abiliti questa opzione, inserisci uno o più ID client nel campo Client, quindi scegli Aggiungi client per aggiungere altri client.
  4. (Facoltativo) Seleziona Ambiti consentiti per fornire un elenco di autorizzazioni consentite, definite come ambiti. Se configurato, almeno un valore dell'ambito nel token in ingresso deve corrispondere a uno dei valori configurati. Gli ambiti fungono da autorizzazioni per limitare ciò che un'applicazione può fare.
  5. (Facoltativo) Seleziona attestazioni personalizzate per fornire una serie di regole che abbinino le attestazioni specifiche del token in entrata ai valori predefiniti. Per ogni regola, specifica il nome dell'attestazione, il tipo di valore (STRING o STRING_ARRAY) e il valore di corrispondenza richiesto.
Nella sezione Approvazione dei record, attiva o disattiva: Auto-approval
1. Quando Auto-approval è attiva, quando invii un record per l'approvazione, il record passa direttamente allo stato Approvato e diventa immediatamente visibile nei risultati di ricerca.
2. Quando Auto-approval è disattivato, quando si invia un record per l'approvazione, il record passa allo stato In attesa di approvazione e richiede a un amministratore del registro di esaminarlo e approvarlo prima della pubblicazione.
Scegli Crea registro.

Nota

* È richiesto almeno un campo di configurazione dell'autorizzazione JWT: destinatari consentiti, client consentiti, ambiti consentiti o attestazioni personalizzate. Se ne configuri più di uno, AWS Agent Registry li verifica tutti. * L'URL di rilevamento non può essere modificato dopo la creazione del registro. * Il tipo di autorizzazione (IAM o JWT) non può essere modificato dopo la creazione del registro. * Un registro supporta solo una forma di autorizzazione in entrata alla volta: IAM Sigv4 o JWT Bearer Token. Non è possibile utilizzarli entrambi contemporaneamente. La ricerca tramite IAM è supportata solo tramite il IAM-based registro; e la ricerca tramite Oauth è supportata solo tramite il registro basato su Oauth.

Dopo aver creato il registro, la console accede alla pagina dei dettagli del registro. Lo stato del registro è inizialmente in fase di creazione. AWS Agent Registry assegna al registro un ARN, che puoi trovare nella sezione dei dettagli del registro. Lo stato del registro diventa Pronto al termine del provisioning. È possibile aggiungere record al registro quando il suo stato è Pronto.

AWS CLI

Esempio

Lo stato del registro inizia con CREATING e passa a READY al termine del provisioning.

AWS SDK

Esempio

Fase 2: Aggiungere un record di registro

Crea un record per un server MCP nel tuo registro.

Console

Un record di registro rappresenta un agente, uno strumento, un'abilità o una risorsa personalizzata.

Esempio

AWS Agent Registry namespace

Aprire la console AWS Agent Registry.
Nel riquadro di navigazione, scegli Registro, quindi scegli il nome del registro in cui desideri aggiungere un record.
Nella sezione Record di registro, scegli Crea record.
Scegli un tipo di fonte:
1. Sincronizzazione dall'endpoint: fornisci un URL dell'endpoint e credenziali opzionali per recuperare i metadati da un server MCP o da un endpoint Agent (A2A). Per i dettagli, consulta Sincronizzare i record da fonti esterne.
2. Manuale: configura manualmente i dettagli del record e la configurazione del protocollo. Continua con i passaggi seguenti.
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.
(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.
(Facoltativo) Per Descrizione, inserisci una descrizione per il record. La descrizione può contenere da 1 a 4.096 caratteri.
Per Versione record, immettete un identificatore di versione per il record (ad esempio, 1.0.0 o). v2.1
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
Viene visualizzato un editor specifico per il descrittore in base alla selezione del descrittore:
1. Server MCP: seleziona una versione dello schema dal menu a discesa Versione dello schema (ad esempio2025-12-11) e inserisci il tuo registro Model Context Protocol server.json dal sito Web Model Context Protocol nell'editor di definizioni del server Your MCP. La definizione deve essere conforme allo schema ufficiale del server MCP per la versione selezionata. Per visualizzare lo schema ufficiale come riferimento, attiva Mostra schema ufficiale. (Facoltativo) Seleziona Aggiungi definizione dello strumento per aggiungere gli strumenti disponibili su questo server con i relativi parametri di input, output ed esempi di utilizzo. Selezionate una versione dello schema (ad esempio2025-11-25) e immettete la definizione dello strumento nell'editor delle definizioni dello strumento.
2. A2A Agent Card: la versione dello schema è. 0.3 Inserisci la definizione della tua carta agente nell'editor. Per visualizzare lo schema ufficiale come riferimento, attiva Mostra schema ufficiale.
3. Definizione delle competenze degli agenti: per la documentazione delle competenze, inserisci il markdown che descrive questa abilità. (Facoltativo) Seleziona Includi definizione delle competenze per aggiungere una definizione strutturata. Seleziona una versione dello schema e inserisci la definizione come oggetto JSON.
4. Personalizzato: immettete la definizione personalizzata come oggetto JSON.
(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.
Scegli Crea record.

Amazon Bedrock AgentCore namespace (to be deprecated)

Aprire la pagina del registro degli AWS agenti nella Bedrock-AgentCore console.
Nel riquadro di navigazione, scegli Registro, quindi scegli il nome del registro in cui desideri aggiungere un record.
Nella sezione Record di registro, scegli Crea record.
Scegli un tipo di fonte:
1. Sincronizzazione dall'endpoint: fornisci un URL dell'endpoint e credenziali opzionali per recuperare i metadati da un server MCP o da un endpoint Agent (A2A). Per i dettagli, consulta Sincronizzare i record da fonti esterne.
2. Manuale: configura manualmente i dettagli del record e la configurazione del protocollo. Continua con i passaggi seguenti.
Nella sezione Dettagli del record, per Nome, inserisci un nome per il record. 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.
(Facoltativo) Per Descrizione, inserisci una descrizione per il record. La descrizione può contenere da 1 a 4.096 caratteri.
Per Versione record, immettete un identificatore di versione per il record (ad esempio, 1.0.0 o). v2.1
Nella sezione Tipo di record, scegli il tipo che corrisponde alla tua risorsa:
1. MCP: protocollo progettato per le comunicazioni con strumenti di intelligenza artificiale e agenti. Gestisce la gestione del contesto e i formati strutturati dei messaggi. Se scegli questo tipo, completa i seguenti passaggi:
  1. Nella sezione di definizione del server MCP, seleziona una versione dello schema dal menu a discesa Versione dello schema (ad esempio2025-12-11), quindi inserisci Model Context Protocol registry server.json dal sito Web Model Context Protocol nell'editor di definizioni del server Your MCP. La definizione deve essere conforme allo schema ufficiale del server MCP per la versione selezionata. Per visualizzare lo schema ufficiale come riferimento, attiva Mostra schema ufficiale.
  2. (Facoltativo) Seleziona Aggiungi definizione dello strumento per aggiungere strumenti specifici disponibili su questo server con i relativi parametri di input, output ed esempi di utilizzo per migliorare la rilevabilità. Se selezionate questa opzione, selezionate una versione dello schema dal menu a discesa Versione dello schema (ad esempio,2025-11-25), quindi immettete la definizione dello strumento nell'editor delle definizioni dello strumento. Per visualizzare lo schema ufficiale dello strumento come riferimento, attiva Mostra schema ufficiale.
2. Agente: protocollo progettato per interazioni sicure tra agenti. Consente flussi di lavoro distribuiti e lo scambio di informazioni. Se si sceglie questo tipo, la versione dello schema è0.3. Inserisci la definizione della tua carta agente nell'editor. Per visualizzare lo schema ufficiale come riferimento, attiva Mostra schema ufficiale.
3. Competenze degli agenti: registra le competenze degli agenti con la documentazione Markdown e una definizione strutturata opzionale. Se scegli questo tipo, completa i seguenti passaggi:
  1. Per la documentazione sulle abilità, inserisci la documentazione markdown che descrive questa abilità.
  2. (Facoltativo) Seleziona Includi definizione di abilità per aggiungere una definizione strutturata. Se selezioni questa opzione, seleziona una versione dello schema dal menu a discesa Versione dello schema, quindi inserisci la definizione della skill come oggetto JSON nell'editor.
4. Personalizzato: implementazione del protocollo personalizzato per modelli di comunicazione specializzati. Definisci le tue specifiche di interfaccia e i requisiti di integrazione. Se scegli questo tipo, inserisci la tua definizione personalizzata come oggetto JSON nell'editor.
Scegli Crea record.

Nota

Per aggiungere un server o un agente al registro che non è conforme agli schemi di protocollo MCP o A2A standard, utilizzate il tipo di record personalizzato.

Dopo aver scelto Crea record, AWS Agent Registry inizia il provisioning del record. Lo stato del record è inizialmente in fase di creazione. Una volta completato il provisioning, lo stato passa a Draft. Per rendere il record disponibile ad altri utenti, inviatelo per l'approvazione. Per ulteriori informazioni, consulta la Fase 3: Inviare il record per l'approvazione.

AWS CLI

Esempio

Il record viene creato nello stato CREATING e passa a DRAFT al termine dell'elaborazione. Per altri esempi AWS CLI per la creazione di record di altri tipi, consulta la sezione Crea e gestisci record.

AWS SDK

Esempio

AWS Agent Registry namespace


import boto3
import json

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

server_content = json.dumps({
    "name": "io.example/weather-server",
    "description": "A weather MCP server",
    "version": "1.0.0"
})

tools_content = json.dumps({
    "tools": [{
        "name": "get_weather",
        "description": "Get the current weather for a location",
        "inputSchema": {
            "type": "object",
            "properties": {
                "location": {
                    "type": "string",
                    "description": "City name"
                }
            },
            "required": ["location"]
        }
    }]
})

response = client.create_registry_record(
    registryId='<registryId>',
    name='my-mcp-server',
    displayName='My MCP Server',
    recordType='MCP',
    descriptors={
        'mcpServer': {
            'data': server_content,
            'dataSchemaVersion': '2025-12-11',
            'additionalData': {
                'tools': {
                    'data': tools_content,
                    'dataSchemaVersion': '2024-11-05'
                }
            }
        }
    },
    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": "io.example/weather-server",
    "description": "A weather MCP server",
    "version": "1.0.0"
})

tools_content = json.dumps({
    "tools": [{
        "name": "get_weather",
        "description": "Get the current weather for a location",
        "inputSchema": {
            "type": "object",
            "properties": {
                "location": {
                    "type": "string",
                    "description": "City name"
                }
            },
            "required": ["location"]
        }
    }]
})

response = client.create_registry_record(
    registryId='<registryId>',
    name='my-mcp-server',
    descriptorType='MCP',
    descriptors={
        'mcp': {
            'server': {
                'schemaVersion': '2025-12-11',
                'inlineContent': server_content
            },
            'tools': {
                'protocolVersion': '2024-11-05',
                'inlineContent': tools_content
            }
        }
    },
    recordVersion='1.0'
)
print(f"Record ARN: {response['recordArn']}")
print(f"Status: {response['status']}")  # CREATING

Fase 3: Inviare il record per l'approvazione

Console

L'invio di un record per l'approvazione avvia il processo di revisione che rende il record disponibile per l'individuazione. È possibile inviare un record dalla tabella dei record del registro o dalla pagina dei dettagli del record.

Per inviare un record per l'approvazione dalla tabella dei record del registro

Esempio

Per inviare un record per l'approvazione dalla pagina dei dettagli del record

Esempio

Dopo aver inviato un record per l'approvazione, lo stato del record cambia in base alle impostazioni di approvazione del registro:

Se il registro è Auto-approval attivo, lo stato del record cambia direttamente in Approvato e diventa visibile nei risultati di ricerca poco dopo.
Se il registro è Auto-approval disattivato, lo stato del record diventa In attesa di approvazione e richiede che un amministratore del registro lo esamini e lo approvi prima della pubblicazione.

AWS CLI

Esempio

Il record passa a PENDING_APPROVAL (o direttamente a APPROVED se l'approvazione automatica è abilitata).

AWS SDK

Esempio

Fase 4: Approvare il record

Console

Per approvare un record dalla tabella dei record del registro

Esempio

Per approvare un record dalla pagina dei dettagli del record

Esempio

AWS Agent Registry namespace

Aprire la console AWS Agent Registry.
Nel riquadro di navigazione, scegli Registro, quindi scegli il nome del registro.
Nella sezione Record di registro, scegli il nome del record che desideri approvare.
Nella pagina dei dettagli del record, scegli Aggiorna stato, quindi scegli Approva.
Nella finestra di dialogo di conferma, inserisci il motivo della modifica dello stato.
Scegli Conferma.

Amazon Bedrock AgentCore namespace (to be deprecated)

Aprire la pagina del registro degli AWS agenti nella Bedrock-AgentCore console.
Nel riquadro di navigazione, scegli Registro, quindi scegli il nome del registro.
Nella sezione Record di registro, scegli il nome del record che desideri approvare.
Nella pagina dei dettagli del record, scegli Aggiorna stato, quindi scegli Approva.
Nella finestra di dialogo di conferma, inserisci il motivo della modifica dello stato.
Scegli Conferma.

AWS CLI

Esempio

AWS SDK

Esempio

Fase 5: Scopri i record approvati

La directory Record è la pagina della console per sfogliare e cercare i record approvati in un registro. Quando si seleziona un registro nella pagina Record directory, la console elenca automaticamente i record approvati. Da lì puoi sfogliare l'elenco o utilizzare la casella di ricerca per eseguire una query in linguaggio naturale. A livello di programmazione, ListDiscoverableRegistryRecords utilizzalo per SearchDiscoverableRegistryRecords sfogliare, cercare e BatchGetDiscoverableRegistryRecord recuperare i dettagli completi di molti record in un'unica chiamata.

Console

Nota

Console-based discovery è disponibile solo per i registri che utilizzano Use IAM come tipo di autorizzazione. Se il tuo registro utilizza JSON Web Tokens (JWT), chiama direttamente le API del data-plane rilevabili utilizzando un client HTTP come curl o Postman con un JWT Bearer Token valido nell'intestazione della richiesta. La AWS CLI e gli SDK utilizzano la firma IAM Sigv4 e non possono essere utilizzati con i registri. AWS JWT-authorized Per maggiori dettagli, consulta Cerca i record di registro. Cerca i record del registro

Esempio

AWS Agent Registry namespace

Per sfogliare o cercare i record approvati

Aprire la console AWS Agent Registry.
Nel riquadro di navigazione, scegli Record directory.
In Registro, seleziona il registro di cui desideri esplorare i record approvati. La pagina elenca automaticamente tutti i record approvati in quel registro.
(Facoltativo) Passa dalla visualizzazione a scheda a quella tabella nella parte superiore destra della pagina.
(Facoltativo) Nei record approvati dalla ricerca, inserisci una query in linguaggio naturale o un nome per restringere i risultati, quindi scegli Cerca.
Scegli una scheda o una riga per aprire i dettagli completi del record.

La directory Record mostra solo i record in stato Approvato. I record in stato Bozza, In attesa di approvazione, Rifiutato o Obsoleto non vengono visualizzati.

Amazon Bedrock AgentCore namespace (to be deprecated)

Per cercare i record del registro

Aprire la pagina del registro degli AWS agenti nella Bedrock-AgentCore console.
Nel riquadro di navigazione, scegli Registro, quindi scegli il nome del registro.
Scegli la scheda Cerca nei record.
Nel campo Cerca nei record approvati, inserisci la tua query di ricerca.
(Facoltativo) Per filtrare i risultati in base a una proprietà specifica, scegli il campo di ricerca per espandere il menu Proprietà, quindi scegli un filtro: Nome , Tipo di descrittore o Versione.
Selezionare Search (Cerca).

La ricerca restituisce solo i record con stato Approvato. I record in altri stati, ad esempio Bozza, In attesa di approvazione, Rifiutato o Obsoleto, non vengono visualizzati nei risultati di ricerca.

AWS CLI

Sfoglia i record approvati: elenca i record approvati in un registro:


aws agent-registry list-discoverable-registry-records \
  --registry-id "<registry-id>" \
  --region us-east-1

Cerca nei record approvati: esegui una ricerca semantica ibrida + parola chiave:

Esempio

Recupera i dettagli completi per più record contemporaneamente:


aws agent-registry batch-get-discoverable-registry-record \
  --entries '[{"registryId": "<registry-id>", "recordIds": ["<recordId-1>", "<recordId-2>"]}]' \
  --region us-east-1

Nota

ListDiscoverableRegistryRecordse BatchGetDiscoverableRegistryRecord sono disponibili solo nel agent-registry namespace. Non sono disponibili nel namespace. bedrock-agentcore

AWS SDK

Sfoglia i record approvati:


import boto3

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

list_response = client.list_discoverable_registry_records(
    registryId='<registry-id>',
    maxResults=20
)
for record in list_response['registryRecords']:
    print(f"{record['displayName']} ({record['name']}) - {record['recordType']}")

Cerca nei record approvati:

Esempio

Recupera i dettagli completi per più record contemporaneamente:


batch_response = client.batch_get_discoverable_registry_record(
    entries=[{'registryId': '<registry-id>', 'recordIds': ['<recordId-1>', '<recordId-2>']}]
)
for record in batch_response['registryRecords']:
    print(f"{record['displayName']} ({record['name']}) - {record['recordType']}")
for err in batch_response['errors']:
    print(f"Error for {err['recordId']}: {err['errorCode']}")

Cosa hai costruito

Un registro con autorizzazione IAM e approvazione manuale
Un record di registro che descrive un server MCP
Un record approvato consultabile e ricercabile nella directory Record

Fasi successive

Crea esperienze di scoperta in stile catalogo su e ListDiscoverableRegistryRecords BatchGetDiscoverableRegistryRecord
Configura EventBridge le notifiche Amazon per automatizzare il flusso di approvazione
Aggiungi altri record per i tuoi agenti, server, competenze e risorse personalizzate

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

Esempi di casi d'uso

Creazione e gestione dei registri