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 capacità e la propria identità. Agent Registry supporta le versioni 0.3 e 1.0 della specifica A2A. Per saperne di più, consulta
Schema della scheda dell'agente.
A seconda dei runtime degli agenti, Agent Registry supporta due meccanismi di registrazione principali: registrazione automatica e registrazione manuale.
Seleziona il meccanismo di registrazione adatto ai runtime dell'agente.
Registrazione automatica
I runtime Google Cloud supportati registrano gli agenti in Agent Registry all'interno dello stesso progetto, per impostazione predefinita o tramite un passaggio di deployment con attivazione esplicita. La registrazione automatica opera a livello di progetto e non rileva automaticamente gli agenti di cui è stato eseguito il deployment in altri Google Cloudprogetti.
La registrazione automatica è supportata per i seguenti runtime Google Cloud :
- Runtime dell'agente su Gemini Enterprise Agent Platform: gli agenti di cui è stato eseguito il deployment utilizzando l'SDK vengono registrati senza configurazione aggiuntiva. Per ulteriori informazioni, 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 runtime del cluster GKE esegue la scansione di introspezione e pubblica i metadati in Agent Registry. Per maggiori informazioni, 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 di tipo funzionale e di identità. Cloud Run registra automaticamente
il nome e il tipo dell'agente (
AGENT) in Agent Registry. Per maggiori informazioni, consulta la pagina Registrare agenti da Cloud Run.
I metadati e le funzionalità indicizzati per un agente durante la registrazione dipendono dall'implementazione o meno del protocollo Agent2Agent (A2A):
- Agenti che implementano il protocollo A2A: il sistema esegue query sulla scheda dell'agente (
/.well-known/agent-card.json) per estrarre automaticamente le competenze A2A e le funzionalità pubblicizzate nel catalogo del registro. - Agenti che non implementano il protocollo A2A (endpoint REST o gRPC standard): Agent Registry registra l'agente, ma non può acquisire automaticamente metadati come l'URL dell'endpoint, l'identità dell'agente e le skill A2A. Per associare funzionalità ad agenti non A2A, utilizza la registrazione manuale o registra le skill.
Per informazioni sui runtime Google Cloud che supportano la registrazione automatica, consulta Utilizzare la registrazione automatica.
Registrazione manuale
Per gli agenti ospitati su piattaforme esterne, on-premise, su runtime Google Cloudche non supportano il rilevamento automatico o in progettiGoogle Cloud diversi, 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 definisce l'endpoint e la configurazione dell'agente. Questa risorsa Service scrivibile contiene anche i dettagli specifici dell'agente. Dopo la creazione di Service, il registro genera una risorsa Agent di sola lettura che puoi utilizzare per l'individuazione.
Puoi registrare manualmente due tipi di agenti:
- Agenti conformi ad A2A: agenti che implementano la specifica A2A
(
A2A_AGENT_CARD). Il registro esegue la scansione dell'endpoint Agent Card (agent-card.json) per indicizzare le loro 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 le istruzioni, vedi Registrare un agente da un altro progetto.
Integrare skill autonome
Agent Registry 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 tuo registro,
consentendo agli amministratori di applicare policy di accesso granulari e gestire la cronologia delle versioni
utilizzando le revisioni delle skill.
Quando crei e gestisci agenti in Gemini Enterprise, puoi fare riferimento a queste competenze registrate per estendere le funzionalità del tuo agente. Per informazioni su come registrare e gestire le skill autonome, vedi Registrare le skill e Gestire le skill.