Ciclo di vita e rilevamento dei componenti

Agent Registry ti consente di registrare, scoprire e connettere componenti agentici modulari in modo che gli sviluppatori e gli agenti orchestratori possano trovare e riutilizzare le funzionalità di AI nella tua organizzazione. Comprendere in che modo il Registro degli agenti rappresenta i componenti nella registrazione automatica e manuale ti aiuta a scoprire le funzionalità e a connetterle utilizzando associazioni e provider di autenticazione.

Ecosistema AI

Puoi registrare, scoprire e gestire quattro tipi di componenti agentici modulari per integrare il tuo ecosistema AI:

  • Agenti: attori AI autonomi che pianificano, ragionano, richiamano strumenti e collaborano con altri agenti.
  • 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 agentici 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 gli agenti orchestratori, le applicazioni client e gli 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 acquisisce i metadati direttamente dai runtime supportati e crea e aggiorna automaticamente la risorsa di rilevamento Agent o McpServer corrispondente. I componenti registrati automaticamente non hanno una risorsa Service in 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 Service scrivibile, identificata dal proprio nome risorsa. Utilizza questa risorsa per aggiornare o annullare la registrazione di un componente. La modifica o l'eliminazione della risorsa Service modifica 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 rilevamento 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 gli agenti.

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 gli 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 Skill e SkillRevision in tutti i progetti.
  • Registrazione manuale: quando registri o aggiorni una skill autonoma privata, crei o aggiorni la risorsa Skill e carichi le risorse SkillRevision immutabili direttamente in Agent Registry. I consumer elencano, cercano e recuperano le skill utilizzando le stesse risorse Skill e SkillRevision.

Modelli di registrazione

Agent Registry supporta due modelli per la registrazione dei componenti agentici:

Caratteristica Registrazione automatica Registrazione manuale
Ambito L'ambito dei componenti di cui è stato eseguito il deployment è limitato a un singolo progetto. 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 a un singolo progetto o centralizzato su più progetti.
Configurazione Agent Runtime su Gemini Enterprise Agent Platform, gli agenti Google integrati, i server MCP di Google e remoti Google Cloud 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 dagli endpoint dell'ambiente di runtime o 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 richiedere la creazione manuale di 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 remotiGoogle Cloud e le competenze 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 competenze 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 ti 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 Compute Engine, GKE, Cloud Run, infrastruttura on-premise o piattaforme cloud esterne, inclusi gli agenti che non implementano il protocollo A2A. La registrazione manuale consente anche di registrare i componenti remoti di cui è stato eseguito il deployment in progetti Google Cloud separati nel registry di un progetto di governance centrale per il rilevamento e la governance centralizzati.

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 discovery 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 orchestratori possono richiamare in fase di runtime. Sviluppatori e agenti eseguono 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 loro identificatori del registry (URN):

  • Associazioni tra agenti: stabilisci percorsi di delega che consentono a un agente orchestratore di richiamare sottoagenti 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: collega 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 su come creare e gestire le 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.

Se associ 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