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à.
Concetti e terminologia
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.
Registro
Un registro è un catalogo centralizzato che crei nel tuo AWS account per organizzare e gestire le risorse. Ogni registro ha un nome, una descrizione, una configurazione di autorizzazione che controlla il modo in cui i consumatori accedono alle API del piano dati rilevabili e all'endpoint MCP e una configurazione di approvazione che determina se i record richiedono una revisione manuale prima di diventare rilevabili.
Il modo in cui organizzi i registri dipende dalle tue esigenze, ad esempio registri dedicati per diversi tipi di risorse (un registro degli agenti, un registro del server MCP, un registro delle competenze), registri per diverse fasi di sviluppo (produzione, QA, sviluppo), registri indipendenti per diversi team o unità aziendali o un registro unico per l'intera organizzazione.
Record di registro
Un record di registro rappresenta i metadati di una singola risorsa pubblicata in un registro. Ogni record acquisisce i metadati chiave che descrivono la risorsa sottostante, fornendo informazioni su cos'è, cosa fa e come può essere trovata. I record hanno una name descrizione opzionale leggibile dall'uomodisplayName, una descrizione opzionale, a, a recordType (, recordVersion AGENT MCPSKILL, oCUSTOM) e specifici del tipo di risorsa che riportano il contenuto effettivo. La combinazione di name e recordVersion deve essere univoca all'interno del registro (utilizzata come chiave di deduplicazione), in modo che la stessa possa essere riutilizzata in diverse versioni della stessa risorsa. name
Tipi di risorse
Server MCP: i server Model Context Protocol (MCP) forniscono strumenti che gli agenti di intelligenza artificiale possono scoprire e richiamare. Un record del server MCP contiene una definizione del server che descrive la configurazione del server e le definizioni degli strumenti per tutti gli strumenti forniti dal server, inclusi i parametri di input e i formati di output. AWS Agent Registry convalida i record del server MCP rispetto allo schema del protocollo MCP per garantirne la correttezza.
Agenti: gli agenti sono programmi autonomi in grado di ragionare, pianificare e intraprendere azioni per portare a termine le attività. Il record di un agente contiene una scheda agente che descrive le capacità, le competenze e l'interfaccia di comunicazione dell'agente secondo le specifiche del protocollo A2A (Agent-to-Agent)
Competenze: le competenze sono funzionalità riutilizzabili che possono essere condivise tra gli agenti. Un record di competenze contiene metadati descrittori di base come Nome, Descrizione, informazioni di accesso opzionali come i dettagli del pacchetto o del repository e una documentazione markdown opzionale che descrive cosa fa la skill e come usarla.
Risorse personalizzate: per le risorse che non soddisfano i tipi standard di cui sopra, puoi definire il tuo schema di metadati utilizzando qualsiasi struttura JSON valida.
Provider di credenziali
Quando si configura un record di registro per sincronizzare i metadati da una fonte esterna (autorizzazione in uscita), AWS Agent Registry necessita delle credenziali per accedere a tale fonte. Un provider di credenziali memorizza i dettagli di autorizzazione, credenziali OAuth o un ruolo IAM, che AWS Agent Registry utilizza per richiamare l'endpoint della risorsa esterna durante la sincronizzazione. Si fa riferimento a un provider di credenziali tramite il relativo ARN quando si configura la sincronizzazione su un record. Per ulteriori informazioni, consulta Gestire i provider di credenziali.
L'autorizzazione del registro è di due tipi:
-
Autorizzazione in entrata: utilizza questa configurazione per controllare il modo in cui i tuoi consumatori cercano, navigano e richiamano le API del piano dati rilevabili e l'endpoint MCP del registro (tramite AWS CLI, SDK o un client). AWS MCP-compatible Il registro supporta l'autorizzazione in entrata. IAM-based JWT-based L'autorizzazione in entrata viene specificata come parte del flusso di lavoro per la creazione di un registro.
-
Autorizzazione in uscita: quando si configura un record per la sincronizzazione con un endpoint MCP o A2A remoto, il registro necessita di credenziali in uscita per richiamare la risorsa remota sull'endpoint specificato e recuperare i metadati. Queste credenziali vengono fornite come parte dell'impostazione del processo di sincronizzazione per un particolare record di registro.
Tag
È possibile allegare tag ai registri e ai record di registro per l'allocazione dei costi, il controllo degli accessi e il monitoraggio dell'organizzazione. Ogni tag è una coppia chiave-valore e sia le chiavi che i valori sono stringhe definite dall'utente. I tag non influiscono sul comportamento in fase di esecuzione di un registro o di un record: esistono come metadati che tu e la tua organizzazione potete utilizzare per classificare le risorse in un account. AWS
Personaggi chiave
Le persone che utilizzano il Registro possono variare da organizzazione a organizzazione. Tuttavia, abbiamo visto i seguenti personaggi generici che interagiscono con il Registro, che si trovano comunemente nelle organizzazioni.
- Amministratore
-
In qualità di amministratore, sei il proprietario dell'infrastruttura del registro. Crei e configuri i registri all'interno dell' AWS account, decidi come è organizzato ogni registro (per team, ambiente o tipo di risorsa) e scegli il metodo di autorizzazione (IAM o JWT) che determina in che modo i consumatori accedono al registro. Tu configuri il flusso di approvazione, decidendo se i record richiedono una revisione manuale o sono approvati automaticamente, e configuri EventBridge le integrazioni Amazon per connettere il registro ai sistemi di notifica e revisione esistenti della tua organizzazione. Gestisci le autorizzazioni IAM per controllare quali editori, curatori e consumatori possono accedere a ciascun registro. In qualità di amministratore, hai anche pieno accesso per creare, aggiornare ed eliminare i record e puoi approvare, rifiutare o deprecare i record quando necessario.
- Editore
-
In qualità di editore, sei un costruttore all'interno dell'organizzazione che ha creato una risorsa (un server MCP, un agente, una competenza o qualche altro strumento) e desidera renderla rilevabile ad altri. Crei record di registro che descrivono le tue risorse, fornendo i metadati, le definizioni e le informazioni sulla versione che aiutano gli altri a trovare e capire cosa fa la risorsa. Si procede iterando sui record in stato di bozza, perfezionando le descrizioni e gli schemi fino a quando il record non è pronto, quindi lo si invia per l'approvazione. Se un record viene rifiutato, rivedi il feedback del curatore, apporti le modifiche necessarie e invialo nuovamente. Puoi anche configurare URL-based la sincronizzazione in modo che i tuoi record rimangano sincronizzati con i server MCP attivi senza aggiornamenti manuali.
- Curatore/Approvatore
-
In qualità di curatore, sei il custode della qualità del registro e spesso puoi anche essere l'amministratore del registro. Esamini i record che gli editori hanno inviato per l'approvazione, valutandoli in base agli standard dell'organizzazione in materia di sicurezza, conformità, completezza dei metadati e a qualsiasi altro criterio definito dall'organizzazione. Approvi i record che soddisfano questi standard, rendendoli visibili tramite le API del piano dati rilevabili (search, list, batch-get) e tramite l'endpoint MCP, e rifiuti i record che non lo fanno, fornendo un feedback chiaro su ciò che deve essere corretto. Quando una risorsa viene disattivata, presenta problemi noti o viene sostituita da una versione più recente, il record viene deprecato per rimuoverlo dalla scoperta. In qualità di curatore, contribuisci a mantenere il registro un catalogo affidabile e di alta qualità su cui i creatori di tutta l'organizzazione possono fare affidamento.
- Consumatore
-
In qualità di consumatore, sei un umano o un agente che deve trovare e utilizzare risorse. Puoi scoprire i record approvati in tre modi:
-
Effettua ricerche tramite interrogazioni in linguaggio naturale o ricerche per parole chiave per trovare i record che corrispondono a un argomento, a una funzionalità o a un caso d'uso ()
SearchDiscoverableRegistryRecords. -
Sfoglia il catalogo dei record approvati con un elenco suddiviso in pagine, facoltativamente filtrato per tipo di record, e recupera i dettagli per uno o più record alla volta (e/).
ListDiscoverableRegistryRecordsGetDiscoverableRegistryRecordBatchGetDiscoverableRegistryRecord -
Connettiti all'endpoint MCP del registro da qualsiasi MCP-compatible client per scoprire gli strumenti disponibili in modo programmatico ().
InvokeRegistryMcpCome consumatore, puoi vedere solo i record approvati, quindi puoi essere certo che tutto ciò che trovi nel registro è stato esaminato e soddisfa gli standard di qualità dell'organizzazione. Puoi effettuare l'autorizzazione tramite credenziali IAM o token JWT da un provider di identità aziendale, a seconda di come è configurato il registro.
-
