Agent Registry ti consente di registrare, scoprire e connettere componenti agentici modulari in modo che tu e i tuoi agenti orchestratori possiate riutilizzare le funzionalità di AI nella tua organizzazione. Comprendere in che modo Agent Registry rappresenta i componenti registrati automaticamente e manualmente ti aiuta a eseguire query sulle risorse e ad allegare associazioni e provider di autenticazione.
Ecosistema AI
Puoi registrare, scoprire e gestire quattro tipi di componenti agentici modulari per integrare il tuo ecosistema di AI:
- Agenti: attori di AI autonomi che pianificano, ragionano, richiamano strumenti e collaborano con altri agenti tramite protocolli come il protocollo Agent2Agent (A2A).
- Server MCP: programmi che implementano il Model Context Protocol (MCP) per esporre strumenti e risorse di dati standardizzati.
- Endpoint: URL di destinazione, in genere API REST, a cui accedono gli agenti.
- Skill: pacchetti autonomi di istruzioni e script facoltativi o skill A2A inline che estendono le funzionalità di un agente.
Rappresentazione dei componenti degli agenti in Agent Registry
In Agent Registry, puoi registrare i componenti degli agenti tramite la registrazione automatica o manuale. Il modo in cui Agent Registry rappresenta un componente dipende dal tipo di componente e dal modello di registrazione.
Agenti, server MCP ed endpoint
Indipendentemente da come viene registrato un agente, un server MCP o un endpoint, Agent Registry lo rappresenta come una risorsa di rilevamento Agent, McpServer o Endpoint di sola lettura con un nome risorsa standard.
I consumer di componenti agentici, come agenti orchestratori, applicazioni client e sviluppatori, utilizzano le risorse di rilevamento per elencare, cercare e visualizzare tutti i componenti disponibili nel registry.
Il modo in cui Agent Registry crea e aggiorna queste risorse di rilevamento dipende da come viene registrato il componente:
- Registrazione automatica: Agent Registry importa i metadati direttamente dai runtime supportati e crea e aggiorna automaticamente la risorsa di rilevamento
AgentoMcpServercorrispondente. I componenti registrati automaticamente non hanno una risorsaServicein Agent Registry. Invece, Agent Registry sincronizza le modifiche quando aggiorni o elimini il deployment o il workload sottostante nel relativo runtime. - Registrazione manuale: quando registri o aggiorni manualmente un componente, Agent Registry crea o aggiorna due risorse:
- Una risorsa
Servicescrivibile, identificata dal proprio nome risorsa. Utilizza questa risorsa per aggiornare o annullare la registrazione di un componente. La modifica o l'eliminazione della risorsaServicemodifica solo la relativa voce in Agent Registry e non modifica o elimina il deployment sottostante. - Una risorsa di rilevamento di sola lettura per il tipo di componente agentico, che viene creata e aggiornata automaticamente in base ai metadati della risorsa
Service:- Risorsa
Agent: la risorsa di discovery di sola lettura che gli agenti orchestratori, le applicazioni client e gli sviluppatori leggono per trovare e richiamare gli agenti. - Risorsa
McpServer: la risorsa di rilevamento di sola lettura che espone gli strumenti e le risorse di dati standardizzati di un server MCP. - Risorsa
Endpoint: la risorsa di discovery di sola lettura per gli URL esterni e le API REST a cui accedono i tuoi agenti.
- Risorsa
- Una risorsa
Per informazioni dettagliate su come i flag di specifica delle risorse Service vengono mappati alle raccolte di risorse di sola lettura, consulta Risorse di servizio e risorse di discovery.
Skill autonome
A differenza di agenti, server MCP ed endpoint, le skill autonome non utilizzano risorse Service separate e risorse di rilevamento di sola lettura. Invece, Agent Registry rappresenta ogni skill utilizzando una risorsa Skill di primo livello sia per la gestione che per il rilevamento, insieme a risorse SkillRevision secondarie per snapshot con controllo delle versioni immutabili e una risorsa Publisher per l'ambito della proprietà:
- Registrazione automatica: le skill gestite da Google sono automaticamente disponibili come risorse
SkilleSkillRevisionin tutti i progetti. - Registrazione manuale: quando registri o aggiorni una skill autonoma privata, crei o aggiorni la risorsa
Skille carichi le risorseSkillRevisionimmutabili direttamente in Agent Registry. I consumer elencano, cercano e recuperano le competenze utilizzando le stesse risorseSkilleSkillRevision.
Modelli di registrazione
Agent Registry supporta due modelli per la registrazione dei componenti agentici:
| Caratteristica | Registrazione automatica | Registrazione manuale |
|---|---|---|
| Ambito | Per impostazione predefinita, l'ambito dei componenti di cui è stato eseguito il deployment è limitato a un singolo progetto. Puoi configurare un confine di gestione per aggregare questi componenti tra i progetti membri. Gli agenti Google integrati, i server MCP Google e Google Cloud remoti e le skill gestite da Google sono disponibili in tutti i progetti. | Con ambito limitato al progetto in cui viene creata la risorsa, ad esempio un singolo progetto o un progetto di governance centrale. |
| Configurazione | Agent Runtime su Gemini Enterprise Agent Platform, gli agenti Google integrati, i server MCP Google e Google Cloud remoti e le skill gestite da Google si registrano automaticamente. I workload di Google Kubernetes Engine (GKE) e Cloud Run richiedono un'etichetta o un flag di deployment di attivazione. | Richiede la creazione di una risorsa Service o Skill in Agent Registry. |
| Runtime | Agent Runtime, GKE, Cloud Run e runtime gestiti da Google. | Compute Engine, GKE, Cloud Run, sistemi on-premise e piattaforme cloud esterne. |
| Componenti di destinazione | Agenti, server MCP e skill autonome gestite da Google. | Agenti personalizzati o esterni, server MCP, endpoint e skill autonome private. |
| Aggiornamenti dei metadati | Sincronizzati automaticamente dall'ambiente di runtime o dagli endpoint della scheda dell'agente. | Richiede aggiornamenti manuali modificando la risorsa Service o caricando una nuova risorsa SkillRevision in Agent Registry. |
Registrazione automatica
La registrazione automatica importa agenti, server MCP e skill autonome gestite da Google dai runtime Google Cloud supportati senza che tu debba creare manualmente le risorse in Agent Registry. Gli agenti di cui è stato eseguito il deployment in Agent Runtime, gli agenti Google integrati di Google Workspace e Gemini Enterprise, i server MCP Google e remoti diGoogle Cloud e le skill autonome gestite da Google vengono registrati automaticamente. Per i deployment GKE e i workload Cloud Run, attiva la registrazione automatica aggiungendo un'etichetta o un flag di tipo funzionale quando esegui il deployment dell'agente o del server MCP.
Durante la registrazione automatica, Agent Registry estrae gli endpoint, gli identificatori del registry, i riferimenti di runtime e le skill A2A o gli strumenti MCP pubblicizzati del componente nella risorsa di rilevamento in Agent Registry.
Per saperne di più sulla configurazione della registrazione automatica, consulta Utilizza la registrazione automatica per gli agenti e Registra i server MCP.
Registrazione manuale
La registrazione manuale consente di registrare agenti remoti o personalizzati, server MCP, endpoint e skill autonome private creando risorse direttamente in Agent Registry. Puoi registrare manualmente agenti, server MCP o endpoint API REST ospitati su Google Cloud, infrastruttura on-premise o piattaforme cloud esterne. Puoi anche utilizzare la registrazione manuale per gli agenti che non implementano il protocollo A2A. Se non utilizzi un confine di gestione, puoi utilizzare la registrazione manuale per registrare i componenti remoti di altri progettiGoogle Cloud in un progetto di governance centrale.
Per registrare manualmente un agente, un server MCP o un endpoint, crea una risorsa Service in Agent Registry e specifica l'URL dell'interfaccia del componente, l'associazione del protocollo e il flag di specifica --agent-spec-type, --mcp-server-spec-type o --endpoint-spec-type. Per registrare manualmente una skill autonoma, devi creare una risorsa Skill con un file ZIP.
Per saperne di più sulla configurazione della registrazione manuale, consulta Utilizza la registrazione manuale per gli agenti, Registra gli endpoint e Registra le skill.
Tipi di rilevamento
In Google Cloud, il rilevamento in Agent Registry è diverso da quello negli strumenti di gestione dell'infrastruttura:
- Rilevamento del consumo: Agent Registry si concentra sulla ricerca di agenti, strumenti MCP, endpoint e skill registrati che gli agenti orchestratore possono chiamare in fase di runtime. Tu e i tuoi agenti orchestratori eseguite query su Agent Registry utilizzando la ricerca in linguaggio naturale, i tag o gli identificatori del registry per individuare le funzionalità necessarie per completare i workflow.
- Rilevamento dell'infrastruttura: servizi come App Hub si concentrano sul rilevamento di risorse di computing fisiche, come macchine virtuali, servizi GKE e deployment di Cloud Run, nei tuoi progetti Google Cloud . App Hub organizza questi asset di computing in applicazioni e ambienti per il monitoraggio dell'integrità dell'infrastruttura, il monitoraggio delle risorse e il monitoraggio dell'affidabilità.
Il rilevamento dell'infrastruttura monitora dove vengono eseguiti i workload, mentre il rilevamento del consumo in Agent Registry identifica le funzionalità fornite da un agente o uno strumento.
Relazioni tra componenti
Per comporre workflow multi-agente e gestire le credenziali in uscita, crei relazioni esplicite tra i componenti utilizzando associazioni e provider di autenticazione.
Associazioni
Un'associazione definisce una connessione diretta tra un agente di origine e una risorsa di destinazione utilizzando i relativi identificatori del registry (URN):
- Associazioni tra agenti: stabilisci percorsi di delega che consentono a un agente orchestratore di chiamare subagenti specializzati.
- Associazioni agente-server MCP: connetti un agente a un server MCP, associandolo agli strumenti e alle risorse di dati pubblicati del server.
- Associazioni agente-endpoint: connetti un agente a un endpoint esterno registrato, ad esempio un'API REST.
Le associazioni offrono visibilità sulla topologia multi-agente, aiutando i team a controllare quali agenti interagiscono con le funzionalità downstream. Per istruzioni sulla creazione e sulla gestione delle associazioni, consulta Gestisci le associazioni.
Provider di autenticazione
Quando un agente interagisce con strumenti esterni, server MCP o API, spesso richiede credenziali dedicate. Un provider di autenticazione è una configurazione nel gestore di autenticazione di Agent Identity che archivia, acquisisce e gestisce le credenziali, come i token OAuth o le chiavi API, per conto dell'agente.
Associando un'associazione a un provider di autenticazione, consenti all'agente di autenticarsi con destinazioni esterne senza incorporare secret nei template di prompt o nel codice sorgente dell'agente. Per saperne di più, consulta Esegui l'autenticazione in strumenti e risorse.
Passaggi successivi
- Scopri di più sul protocollo A2A.
- Scopri di più su identità e identificatori.
- Scopri di più sui confini tra progetti.
- Scopri di più sull'architettura delle skill.