Registrare agenti

Anteprima

Questo prodotto o funzionalità sono soggetti ai "Termini delle Offerte pre-GA" nella sezione Termini di servizio generali dei Termini specifici dei servizi. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

La registrazione di un agente lo trasforma in un servizio rilevabile. 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.

A seconda dei runtime degli agenti, il registro degli agenti 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 dell'agente.

Registrazione automatica

I runtime Google Cloud supportati registrano gli agenti in Agent Registry per impostazione predefinita o tramite un passaggio di deployment con attivazione.

La registrazione automatica è supportata per i seguenti runtime Google Cloud :

• Vertex AI Agent Engine: 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 GKE vengono registrati quando includono un'annotazione di tipo funzionale specifico 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 Agent2Agent (A2A): A2A è uno standard aperto che consente agli agenti di dichiarare le proprie funzionalità e la propria identità. Se il tuo agente implementa questo protocollo, Agent Registry estrae automaticamente le competenze dell'agente dalla relativa scheda dell'agente e popola il registro.
• 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 il rilevamento automatico, devi utilizzare la registrazione manuale.

Per registrare manualmente un agente, utilizza l'API Agent Registry per creare una risorsa Service che definisce l'endpoint e la configurazione dell'agente. Questa risorsa modificabile 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 la scoperta.

Puoi registrare manualmente due tipi di agenti:

• Agenti conformi ad A2A: agenti che implementano la specifica Agent2Agent (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.