Agent Registry organizza il tuo ecosistema di AI in risorse standardizzate in modo che tu possa registrare, scoprire e gestire agenti, server MCP, endpoint e skill in un singolo progetto o in un limite di gestione. Comprendere in che modo il registro degli agenti separa le risorse Service scrivibili dalle risorse di rilevamento di sola lettura, definisce l'ambito delle risorse tra i progetti e supporta la registrazione automatica e manuale ti aiuta a progettare e gestire il registro.
Componenti agentici
Agent Registry consente di registrare, scoprire e gestire i seguenti tipi di componenti degli agenti:
- Agenti: attori AI autonomi che svolgono attività specifiche, richiamano strumenti e collaborano con altri agenti.
- Server MCP: programmi che implementano il Model Context Protocol (MCP) per esporre risorse e strumenti di dati standardizzati. Gli strumenti sono funzioni deterministiche esposte da un server MCP che gli agenti possono richiamare per eseguire azioni specifiche.
- Endpoint: URL di destinazione, in genere API REST, a cui accede un agente. Astrando queste destinazioni in risorse gestibili, Agent Registry ti consente di gestire centralmente le API esterne a cui i tuoi agenti possono accedere.
- Skill: funzionalità modulari che estendono le azioni che un agente può eseguire. Le skill autonome sono pacchetti di istruzioni e script facoltativi gestiti direttamente nel registry. Le competenze A2A sono descrizioni delle capacità presenti nella scheda dell'agente che indicano agli altri agenti quando e come comunicare con l'agente. Per saperne di più, consulta Architettura delle competenze.
Risorse di servizio e risorse di rilevamento
Il modo in cui Agent Registry rappresenta un componente dipende dal tipo di componente e dal modello di registrazione. Per saperne di più sui cicli di vita e sul discovery dei componenti, consulta Ciclo di vita e discovery dei componenti.
Agenti, server MCP ed endpoint
Indipendentemente dal fatto che un agente, un server MCP o un endpoint venga registrato automaticamente o manualmente, Agent Registry lo rappresenta come una risorsa di rilevamento Agent, McpServer o Endpoint di sola lettura. I consumer, come gli agenti orchestratori, le applicazioni client e gli sviluppatori, utilizzano queste risorse di rilevamento per elencare, cercare e visualizzare i componenti registrati.
Per i componenti registrati automaticamente, Agent Registry importa i metadati direttamente dai runtime supportati e crea la risorsa di rilevamento senza una risorsa Service.
Quando registri manualmente un agente, un server MCP o un endpoint, Agent Registry separa le operazioni di gestione dal rilevamento dei componenti creando i seguenti elementi:
- Una risorsa
Servicescrivibile: archivia i metadati del componente, tra cui il tipo di componente agentico, l'URL dell'interfaccia, la descrizione, l'associazione del protocollo e la specifica delle funzionalità. Puoi creare, aggiornare o eliminare la risorsaServiceper operazioni di gestione come l'aggiornamento dei metadati o l'annullamento della registrazione del componente, senza modificare o eliminare il deployment sottostante. - Una risorsa di rilevamento: quando crei o aggiorni una risorsa
Service, Agent Registry legge i metadati e crea o aggiorna automaticamente una risorsa di rilevamentoAgent,McpServeroEndpointche rappresenta il componente nel tuo registry.
I flag di specifica che utilizzi durante la creazione di una risorsa Service determinano la raccolta di risorse di sola lettura risultante:
| Bandiere | Raccolta di risorse | Caso d'uso | Valori validi |
|---|---|---|---|
--agent-spec-type--agent-spec-content |
Agent risorsa nella raccolta agents |
Agenti REST standard o conformi ad A2A remoti | a2a-agent-card, no-spec |
--endpoint-spec-type--endpoint-spec-content |
Endpoint risorsa nella raccolta endpoints |
URL di servizi o API REST di destinazione esterni | no-spec |
--mcp-server-spec-type--mcp-server-spec-content |
McpServer risorsa nella raccolta mcp-servers |
Server Model Context Protocol (MCP) esterni | tool-spec, no-spec |
Queste coppie di flag si escludono a vicenda; se specifichi flag di più di una coppia, viene restituito un errore. Se specifichi la coppia di flag per il tipo di componente errato, Agent Registry crea la risorsa di rilevamento nella raccolta che corrisponde al flag specificato. Ad esempio, se passi --agent-spec-type=no-spec durante la registrazione di un endpoint, viene creata una risorsa Agent anziché una risorsa Endpoint, pertanto le query e le policy di governance specifiche per il tipo non verranno applicate come previsto.
Skill autonome
Le skill autonome non utilizzano risorse Service separate. Invece, registri, crei versioni ed esegui query sulle skill direttamente utilizzando le risorse Skill di primo livello, le risorse SkillRevision secondarie e le risorse Publisher.
Per iniziare, consulta Configura Agent Registry. Per saperne di più sull'API Agent Registry, consulta la documentazione di riferimento dell'API.
Modello dei dati tra progetti
Quando configuri un confine di gestione, Agent Registry centralizza il rilevamento e la governance in tutti i progetti membri dal tuo progetto di gestione.
Quando esegui query, elenchi o cerchi risorse dal progetto di gestione, Agent Registry applica le seguenti regole di definizione dell'ambito per fornire un catalogo consolidato senza duplicare le risorse o creare collisioni di endpoint:
| Categoria della risorsa | Ambito in un confine di gestione | Descrizione |
|---|---|---|
| Risorse rilevate automaticamente | Aggregati dai progetti membri | Gli agenti e i server MCP rilevati automaticamente nei progetti membri vengono aggregati nella visualizzazione del progetto di gestione quando li elenchi o li cerchi in una località del progetto di gestione. Quando visualizzi, elenchi o cerchi un agente o un server MCP, puoi specificare l'ID progetto di gestione o l'ID progetto membro nella richiesta. Il nome della risorsa conserva l'ID assegnato da Agent Registry al componente e utilizza il progetto specificato nella richiesta. |
| Risorse registrate manualmente | Ambito limitato al progetto in cui vengono create | Gli agenti personalizzati, i server MCP esterni e gli endpoint registrati manualmente come risorse Service hanno come ambito il progetto in cui vengono creati. Creale nel progetto di gestione per renderle visibili oltre il confine di gestione o in un progetto membro per mantenerle visibili solo all'interno di quel singolo progetto. |
| Associazioni | Ambito limitato al progetto in cui vengono create | Le risorse Binding rientrano nell'ambito del progetto in cui vengono create. Creale nel progetto di gestione per la visibilità a livello di confine o in un progetto membro per la visibilità di un singolo progetto. |
| Skill e publisher autonomi | Ambito limitato al progetto in cui vengono create | Le risorse Skill, SkillRevision e Publisher autonome personalizzate hanno come ambito il progetto in cui vengono create e non vengono aggregate dai progetti membri nel progetto di gestione. Le skill autonome gestite da Google sono rilevabili automaticamente in tutti i progetti quando configuri il registro degli agenti. |
| Applicazioni AI | Ambito limitato al progetto in cui vengono create | Le risorse AiApplication di sola lettura e le relative visualizzazioni dei componenti collegate hanno come ambito il progetto e la località in cui è stata creata l'applicazione. |
Prodotti e componenti supportati
Agent Registry classifica i prodotti e i componenti supportati in base alla modalità di registrazione: automatica o manuale.
Registrazione automatica
Agent Registry rileva e importa automaticamente i workloadGoogle Cloud supportati di cui è stato eseguito il deployment nel tuo progetto o nei progetti membri all'interno del tuo confine di gestione. Per gli agenti che implementano il protocollo aperto Agent2Agent (A2A), il registry estrae automaticamente le loro competenze e funzionalità A2A dalla loro scheda dell'agente. Le skill autonome gestite da Google sono rilevabili anche in tutti i progetti quando configuri Agent Registry.
La tabella seguente elenca i prodotti e i componenti che Agent Registry registra automaticamente:
| Tipo di componente | Prodotti supportati |
|---|---|
| Agenti |
|
| Server MCP |
|
| Skill | Le skill gestite da Google sono rilevabili da tutti i progetti |
Registrazione manuale
I componenti remoti sono agenti, server MCP o endpoint ospitati al di fuori del tuo progetto di governance o del tuo confine di gestione, ad esempio in progetti Google Cloud separati senza un confine, un'infrastruttura on-premise o cloud esterni. Registri manualmente questi componenti remoti nel progetto di governance utilizzando una risorsa Service. Puoi anche utilizzare una risorsa Service per registrare manualmente i componenti su runtime non supportati o per gli agenti che non implementano il protocollo A2A. Per le skill autonome personalizzate,
utilizza una risorsa Skill.
La tabella seguente elenca i prodotti e i componenti che registri manualmente:
| Tipo di componente | Risorse supportate |
|---|---|
| Agenti | Agenti remoti di cui è stato eseguito il deployment su Compute Engine, GKE, Cloud Run, sistemi on-premise o cloud esterni |
| Server MCP | Componenti agentici personalizzati su runtime non supportati o server MCP esterni |
| Endpoint | API REST o URL di servizi di destinazione esterni gestiti come endpoint |
| Skill | Skill autonome create dalla tua organizzazione |
Passaggi successivi
- Scopri di più su identità e identificatori.
- Scopri di più sul ciclo di vita e sul rilevamento dei componenti.
- Scopri di più sui confini tra progetti.
- Scopri di più sull'architettura delle skill.
- Configura Agent Registry.