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.
Questo documento ti aiuta a scegliere il meccanismo di registrazione più adatto ai runtime degli agenti.
Registrazione automatica
I runtime supportati Google Cloud registrano gli agenti in Agent Registry all'interno dello 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.
- Agenti Google integrati: gli agenti forniti direttamente da Google, come gli agenti Google Workspace e Gemini Enterprise, sono rilevabili senza alcuna configurazione.
- Google Kubernetes Engine: gli agenti containerizzati di cui è stato eseguito il deployment in Google Kubernetes Engine (GKE) vengono registrati quando includono un'etichetta di tipo funzionale specifica di Agent Registry.
I metadati e le skill A2A di un agente acquisiti durante la registrazione dipendono dal protocollo dell'agente:
- Agenti che implementano il protocollo Agent2Agent (A2A): A2A è uno standard aperto che consente agli agenti di dichiarare le proprie funzionalità e la propria identità. Se l'agente implementa questo protocollo, Agent Registry estrae automaticamente le skill A2A dell'agente dalla relativa scheda e popola il registry.
- Agenti che non implementano il protocollo A2A: Agent Registry registra l' agente, ma non può acquisire automaticamente i metadati come l'URL di inferenza e le skill A2A. Per fornire queste informazioni in modo che l'agente sia rilevabile, utilizza la registrazione manuale.
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 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 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 policy 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.