Registrare agenti

Agent Registry ti consente di registrare gli agenti AI in modo che gli sviluppatori e gli agenti orchestratori possano scoprire e richiamare le loro funzionalità nel tuo ecosistema AI. Pubblicando le skill A2A del tuo agente, aiuti altri sviluppatori e agenti orchestratori della tua organizzazione a trovare e riutilizzare il tuo lavoro.

Agent Registry si integra con le versioni 0.3 e 1.0 del protocollo open source Agent2Agent (A2A), che consente agli agenti di dichiarare le proprie funzionalità e la propria identità in una scheda agente. A seconda di dove vengono eseguiti gli agenti, puoi registrarli utilizzando la registrazione automatica o la registrazione manuale.

Registrazione automatica

I runtime Google Cloud supportati registrano automaticamente gli agenti e gli agenti Google integrati sono rilevabili senza configurazione. All'interno del progetto di governance in cui è abilitato Agent Registry, la registrazione automatica avviene per impostazione predefinita o tramite un passaggio di deployment di attivazione. La procedura di registrazione opera a livello di progetto e non rileva automaticamente gli agenti remoti di cui è stato eseguito il deployment in altri progettiGoogle Cloud .

Per informazioni sui runtime Google Cloud che supportano la registrazione automatica e sui metadati indicizzati per gli agenti registrati automaticamente, consulta Utilizza la registrazione automatica per gli agenti.

Registrazione manuale

Agent Registry utilizza un progetto di governance Google Cloudcentrale. Il termine remoto si riferisce agli agenti ospitati al di fuori del progetto di governance in progettiGoogle Cloud , ambienti on-premise o piattaforme esterne separati o in esecuzione su runtime Google Cloud che non supportano il rilevamento automatico. Devi utilizzare la registrazione manuale per aggiungere agenti remoti al registry del progetto di governance.

Per registrare manualmente un agente, utilizza la console Google Cloud , Google Cloud CLI, Terraform o l'API Agent Registry per creare una risorsa Service che archivia i metadati dell'agente, inclusi l'URL dell'endpoint e la configurazione. Dopo aver creato la risorsa Service, Agent Registry crea automaticamente una risorsa Agent di sola lettura che puoi utilizzare per il discovery.

Per scoprire come registrare manualmente gli agenti REST standard e conformi ad A2A, consulta Utilizza la registrazione manuale per gli agenti.

Considerazioni sulla registrazione tra progetti

Se la tua organizzazione utilizza un'architettura di governance centralizzata con Agent Gateway, come il pattern multi-progetto descritto in Pattern di deployment di esempio, puoi eseguire il deployment di un gateway in modalità di traffico in uscita Agent-to-Anywhere in un progetto di governance centrale in cui è abilitato Agent Registry, eseguendo al contempo il deployment degli agenti in progetti Google Cloud separati.

Poiché la registrazione automatica rileva solo le risorse nel progetto di governance in cui è abilitato Agent Registry, non rileva automaticamente gli agenti remoti di cui è stato eseguito il deployment in altri progetti Google Cloud . Per consentire al gateway centrale di individuare e gestire questi agenti remoti, devi registrare manualmente ogni agente remoto nel registry del progetto di governance centrale. Per le istruzioni, consulta Registra un agente da un altro progetto.

Integra skill autonome

Agent Registry ti consente di gestire e governare le skill autonome per gli agenti come risorse di primo livello. Le skill autonome sono registrate come risorse Skill nel tuo 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 autonome registrate per estendere le funzionalità dell'agente Gemini Enterprise. Per informazioni su come registrare e gestire le skill autonome, consulta Registra le skill e Gestisci le skill.