Modello dei dati di Agent Registry

Agent Registry classifica i componenti agentici del tuo ecosistema in quattro tipi di risorse principali che puoi gestire e scoprire:

  • Agenti: attori di AI autonomi che eseguono workflow di AI specifici. Un agente comprende le proprie funzionalità di workflow possedendo skill specifiche. In Agent Registry, le skill degli agenti sono rappresentate come metadati dichiarativi (skill A2A) o come pacchetto modulare eseguibile (skill).
  • Server MCP: fornitori di risorse e strumenti di dati standardizzati. Gli strumenti sono funzioni deterministiche esposte da un server MCP che gli agenti possono richiamare per eseguire azioni specifiche.
  • Endpoint: URL di destinazione, in genere API REST, a cui accede un agente. Astrattando queste destinazioni in risorse gestibili, Agent Registry ti consente di controllare centralmente a quali API esterne possono accedere i tuoi agenti.
  • Skill: pacchetti eseguibili autonomi di istruzioni, codice e metadati gestiti direttamente in Agent Registry. Le skill autonome sono distinte da skill A2A, che sono manifest di blocchi di metadati dichiarativi dichiarati in linea all'interno della scheda agente.

Per saperne di più su questi e altri concetti utilizzati da Agent Registry, consulta Concetti chiave.

Risorse API

L'API Agent Registry separa le operazioni di lettura e scrittura per agenti, endpoint e server MCP:

  • Risorsa API scrivibile: gestisci questi componenti agentici creando, aggiornando o eliminando manualmente una risorsa Service nel registry.
  • Risorsa API di sola lettura:per eseguire query, elencare o cercare questi componenti agentici, richiedi la risorsa di sola lettura Agent, McpServer o Endpoint all'API Agent Registry.

I flag di specifica che utilizzi durante la creazione di un Service determinano la raccolta di risorse di sola lettura risultante:

Bandiere Raccolta di risorse Caso d'uso Valori validi:
--agent-spec-type
--agent-spec-content		 Agent (agents) Agenti remoti (agenti REST standard o conformi ad A2A) a2a-agent-card, no-spec
--endpoint-spec-type
--endpoint-spec-content		 Endpoint (endpoints) API REST di destinazione esterne o URL di servizi no-spec
--mcp-server-spec-type
--mcp-server-spec-content		 McpServer (mcp-servers) Server Model Context Protocol (MCP) esterni tool-spec

Queste coppie di flag si escludono a vicenda. Se specifichi flag non validi, la risorsa viene creata nella raccolta errata e potrebbe non funzionare con le norme specifiche per il tipo.

Le skill autonome non utilizzano il modello di Service proiezione. Puoi invece gestire, controllare le versioni ed elencare le skill direttamente utilizzando le risorse API Skill, SkillRevision e Publisher.

Per iniziare, consulta Configura Agent Registry. Per saperne di più su l'API Agent Registry, consulta la documentazione di riferimento dell'API.

Registra i componenti agentici nel registry

Agent Registry gestisce il catalogo di agenti e server MCP tramite due meccanismi di registrazione: automatico e manuale.

Agent Registry registra automaticamente gli agenti e i server di cui è stato eseguito il deployment su runtime supportati Google Cloud . Registra e gestisci agenti, server MCP ed endpoint attivando l'API Agent Registry. Le skill create da Google sono visibili immediatamente quando configuri Agent Registry.

Inoltre, puoi utilizzare la risorsa Service per creare, aggiornare ed eliminare manualmente le voci. Poi, esegui una query sulle risorse di sola lettura Agent, McpServer o Endpoint per ottenere, elencare e cercare rispettivamente gli agenti, i server e gli endpoint registrati. Per la registrazione manuale e la ricerca delle skill, utilizza la risorsa Skill.

Meccanismo di registrazione Descrizione Componente registrato Prodotti supportati Google Cloud
Registrazione automatica Puoi configurare e utilizzare Agent Registry per rilevare e importare automaticamente risorse specifiche di cui è stato eseguito il deployment su runtime supportati Google Cloud . Per gli agenti che implementano il protocollo Agent2Agent (A2A) aperto, il registry estrae automaticamente anche le skill e le funzionalità A2A dalla scheda dell'agente. Agenti
Server MCP
Skill Le skill pubbliche di Google sono rilevabili a livello globale da tutti i progetti
Registrazione manuale Per le risorse esterne, i componenti agentici personalizzati su runtime non supportati o gli agenti REST standard che non implementano il protocollo A2A, devi registrarli manualmente creando una risorsa Service nel registry. Per le skill autonome, utilizza la risorsa Skill. Agenti Agenti remoti
Server MCP Componenti agentici personalizzati su runtime non supportati o server MCP esterni
Skill Le tue skill autonome

Passaggi successivi