La registrazione di un agente lo trasforma in un componente rilevabile all'interno di Agent Registry. Pubblicando le competenze 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.
Il registry degli agenti 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à. Il registro degli agenti 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.
Questo documento ti aiuta a scegliere il meccanismo di registrazione più adatto ai runtime dell'agente.
Registrazione automatica
I runtime Google Cloud supportati registrano gli agenti con il registro degli agenti per impostazione predefinita o tramite un passaggio di deployment con attivazione esplicita.
La registrazione automatica è supportata per i seguenti runtime Google Cloud :
- 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 del registro degli agenti.
I metadati e le competenze di un agente acquisiti durante la registrazione dipendono dal protocollo dell'agente:
- Agenti che implementano il protocollo A2A: se il tuo agente implementa il protocollo A2A, Agent Registry estrae automaticamente le competenze dell'agente dalla relativa scheda dell'agente e compila il registry.
- Agenti che non implementano il protocollo A2A: Agent Registry registra l'agente, ma non può acquisire automaticamente metadati come l'URL di inferenza e le competenze. Per fornire queste informazioni in modo che il tuo agente sia rilevabile, utilizza la registrazione manuale.
Per informazioni sui runtime che supportano la registrazione automatica, consulta Utilizzare la registrazione automatica. Google Cloud
Registrazione manuale
Per gli agenti ospitati su piattaforme esterne, on-premise o su runtime Google Cloud che non supportano l'individuazione automatica, 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 competenze. - 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.