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. Astraggendo 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 registro.
  • 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.

Le skill autonome non utilizzano il modello di Service proiezione. Al contrario, gestisci, controlli le versioni ed elenchi le skill direttamente utilizzando le risorse API Skill, SkillRevision e Publisher.

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

Registrare i componenti agentici nel registro

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 gli agenti, i server MCP e gli endpoint abilitando 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 scoprire 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 registro estrae automaticamente anche le skill e le funzionalità A2A dalla scheda dell'agente. Agenti
Server MCP Server MCP ufficiali di Google e Google Cloud remoti
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 registro. 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