La registrazione di un agente lo trasforma in un componente rilevabile all'interno di Agent Registry. Pubblicando le skill A2A del tuo agente, aiuti altri sviluppatori e agenti orchestratori della tua organizzazione a trovare e riutilizzare il tuo lavoro, accelerando lo sviluppo complessivo dell'AI.
Agent Registry si integra perfettamente con il
protocollo Agent2Agent (A2A) e le relative
specifiche. A2A è uno standard aperto che consente agli agenti di dichiarare le proprie funzionalità e la propria identità. Agent Registry supporta le versioni 0.3 e 1.0 della specifica A2A. Per saperne di più, consulta lo
schema della scheda dell'agente.
A seconda dei runtime degli agenti, Agent Registry supporta due meccanismi di registrazione principali: la registrazione automatica e la registrazione manuale.
Seleziona il meccanismo di registrazione adatto ai runtime degli agenti.
Registrazione automatica
I runtime supportati Google Cloud registrano gli agenti in Agent Registry nello stesso progetto, per impostazione predefinita o tramite un passaggio di deployment con consenso esplicito. La registrazione automatica opera a livello di progetto e non rileva automaticamente gli agenti di cui è stato eseguito il deployment in altri Google Cloud progetti.
La registrazione automatica è supportata per i seguenti Google Cloud runtime:
- Agent Runtime su Gemini Enterprise Agent Platform: gli agenti di cui è stato eseguito il deployment utilizzando l'SDK vengono registrati senza configurazione aggiuntiva. Per saperne di più, consulta Registrare gli agenti da Agent Runtime.
- Agenti Google integrati: gli agenti forniti direttamente da Google, come gli agenti Google Workspace e Gemini Enterprise, sono rilevabili senza alcuna configurazione. Per saperne di più, consulta Registrare gli agenti Google integrati.
- Google Kubernetes Engine: gli agenti containerizzati di cui è stato eseguito il deployment in Google Kubernetes Engine (GKE) vengono registrati quando sono configurati con l'etichetta del tipo funzionale dell'agente AI e l'annotazione della scheda dell'agente. Il controller di runtime del cluster GKE esegue la scansione di introspezione e pubblica i metadati in Agent Registry. Per saperne di più, consulta Registrare gli agenti da GKE.
- Cloud Run: gli agenti containerizzati di cui è stato eseguito il deployment nei
servizi o nei job Cloud Run vengono registrati quando viene eseguito il deployment con i
flag del tipo funzionale e di identità. Cloud Run registra automaticamente il nome, l'URL e il tipo (
AGENT) dell'agente in Agent Registry. Per saperne di più, consulta Registrare gli agenti da Cloud Run.
I metadati e le funzionalità indicizzati per un agente durante la registrazione dipendono dal fatto che l'agente implementi il protocollo Agent2Agent (A2A):
- Agenti che implementano il protocollo A2A: il sistema esegue una query sulla scheda dell'agente
Agent Card (
/.well-known/agent-card.json) per estrarre automaticamente le skill e le funzionalità A2A pubblicizzate nel catalogo del registry. - Agenti che non implementano il protocollo A2A (endpoint REST o gRPC standard): il sistema registra l'URL dell'interfaccia e l'associazione di trasporto dell'agente, ma non può estrarre automaticamente le funzionalità semantiche. Per associare le funzionalità agli endpoint non A2A, puoi descriverle utilizzando la registrazione manuale o collegarle a skill autonome e server MCP all'interno di un' applicazione AI.
Per informazioni sui Google Cloud runtime che supportano la registrazione automatica, consulta Utilizzare la registrazione automatica.
Registrazione manuale
Per gli agenti ospitati su piattaforme esterne, on-premise, su Google Cloud runtime che non supportano il rilevamento automatico o su progetti diversi Google Cloud , devi utilizzare la registrazione manuale.
Per registrare manualmente un agente, utilizza l'API Agent Registry, Google Cloud CLI o Terraform per creare una risorsa Service che definisca l'endpoint e la configurazione dell'agente. Questa risorsa Service scrivibile contiene anche i dettagli specifici dell'agente. Dopo la creazione di Service, il registry genera una
risorsa Agent di sola lettura che puoi utilizzare per il rilevamento.
Puoi registrare manualmente due tipi di agenti:
- Agenti conformi ad A2A: agenti che implementano la specifica A2A
(
A2A_AGENT_CARD). Il registry esegue la scansione dell'endpoint della scheda dell'agente (agent-card.json) per indicizzare le skill A2A. - Agenti REST standard: agenti remoti che non implementano la specifica A2A (
NO_SPEC), ad esempio un endpoint API REST standard.
Per scoprire come registrare manualmente gli agenti, consulta Utilizzare la registrazione manuale.
Considerazioni sulla registrazione tra progetti
Se la tua organizzazione utilizza un'architettura di governance centralizzata con Agent Gateway, puoi eseguire il deployment di un gateway di uscita Agent-to-Anywhere in un progetto di governance centrale e registrare gli agenti di cui è stato eseguito il deployment in più progetti spoke o di workload.
Poiché la registrazione automatica rileva solo le risorse nel progetto locale, devi registrare manualmente gli agenti remoti nel registry del progetto di governance centrale. La registrazione tra progetti consente al gateway centrale di individuare e gestire gli agenti. Per istruzioni, consulta Registrare un agente da un altro progetto.
Integrare le skill autonome
Agent Registry ti consente di gestire e controllare le skill autonome
per gli agenti come risorse di primo livello.
Le skill autonome vengono registrate come risorse Skill nel registry,
consentendo agli amministratori di applicare criteri di accesso granulari e gestire la cronologia delle
versioni utilizzando le revisioni delle skill.
Quando crei e gestisci gli agenti in Gemini Enterprise, puoi fare riferimento a queste skill registrate per estendere le funzionalità dell'agente. Per informazioni su come registrare e gestire le skill autonome, consulta Registrare le skill e Gestire le skill.