Agent Registry utilizza una terminologia standardizzata per descrivere i componenti, le risorse e i meccanismi di governance nel tuo ecosistema di AI. Comprendere questi concetti di base ti aiuta a registrare, scoprire, connettere e gestire agenti, server MCP, endpoint e skill in Agent Registry.
Skill A2A
Confronta con la skill.
Una descrizione della funzionalità elencata in linea nella scheda dell'agente agent-card.json. Una skill A2A descrive le attività che un agente può eseguire e le sue interfacce di comunicazione, in modo che gli altri agenti sappiano quando e come delegargli il lavoro.
Agent Registry supporta le versioni 0.3 e 1.0 della
specifica Agent2Agent (A2A). Per un confronto con le skill autonome, consulta Differenze tra skill autonome e skill A2A.
Agente
Un attore autonomo nel tuo ecosistema di AI che pianifica, ragiona, richiama strumenti e collabora con altri agenti. Un agente è definito dal suo
identificatore agente
e da ogni skill A2A o skill autonoma che possiede. In Agent Registry, un agente registrato è rappresentato come una risorsa di discovery Agent di sola lettura.
Entità dell'agente
L'identità univoca di Identity and Access Management (IAM) assegnata a un agente, che gli consente di detenere autorizzazioni, accedere alle risorse downstream e generare audit log. Assume la forma di un service account verificabile Google Cloud o di una Workload Identity gestita, ad esempio un ID SPIFFE, associato direttamente al runtime di computing dell'agente.
Le stringhe delle entità incorporano il percorso del riferimento di runtime e supportano tre ambiti: l'istanza dell'engine, i set di entità a livello di progetto e i set di entità a livello di organizzazione.
Per una guida completa alla sintassi e controllo dell'accesso, consulta Entità dell'agente.
Componente agentico
Un'entità modulare e funzionale all'interno di un ecosistema di AI che Agent Registry ti consente di registrare, scoprire e gestire. Il registry classifica i componenti degli agenti in quattro tipi principali: agente, server MCP, endpoint e skill.
Per saperne di più, consulta Ciclo di vita e rilevamento dei componenti.
Workflow agentico
Una sequenza di passaggi in cui un agente AI determina in modo indipendente l'utilizzo degli strumenti, il ragionamento e i percorsi di esecuzione per completare un'attività.
Provider autorizzazione
Una configurazione all'interno del gestore di autenticazione di Agent Identity per archiviare, acquisire e gestire le credenziali, come le chiavi API o i token OAuth, per connettere l'agente a strumenti esterni e servizi downstream.
Per saperne di più sull'associazione degli agenti ai provider di autenticazione, consulta Relazioni tra i componenti.
Associazione
Una connessione diretta tra un agente di origine e una risorsa di destinazione, ad esempio un altro agente, un server MCP o un endpoint. Le associazioni stabiliscono percorsi di delega espliciti tra i componenti e associano un agente a un provider di autenticazione per le autorizzazioni delegate.
Per saperne di più, consulta Associazioni.
Risorsa di dati
Un contesto di dati o un set di dati specifico esposto da un server MCP a cui un agente può accedere per basare le sue risposte o informare le sue azioni.
Discovery
Il processo di query di Agent Registry per trovare un agente, uno strumento MCP, un endpoint o una skill registrati utilizzando la ricerca in linguaggio naturale, i tag o gli identificatori del registry.
Il rilevamento in Agent Registry si concentra sul rilevamento del consumo, che identifica le funzionalità e i componenti che gli agenti orchestratori possono richiamare in fase di runtime. Per saperne di più, consulta Tipi di discovery.
Endpoint
Un URL di destinazione, in genere un'API REST, a cui accede un agente. In Agent Registry, un endpoint registrato è rappresentato come una risorsa di rilevamento Endpoint di sola lettura, che ti consente di gestire centralmente i servizi esterni a cui un agente può accedere.
Progetto di governance
Il progetto Google Cloud in cui abiliti l'API Agent Registry per catalogare, scoprire e gestire centralmente i tuoi componenti agentici. Per saperne di più sulle configurazioni per un singolo progetto e tra progetti, consulta Definisci il progetto di governance per un registry centrale.
Ambito di governance
Il confine geografico e architettonico in cui le risorse di Agent Registry vengono registrate e gestite.
Agent Registry utilizza un progetto di governance Google Cloudcentrale, in cui abiliti l'API Agent Registry per catalogare e gestire i componenti degli agenti. La registrazione automatica rileva i workload supportati di cui è stato eseguito il deployment nel progetto di governance. Per gestire i componenti remoti, ovvero agenti, server MCP o endpoint ospitati al di fuori del progetto di governance in progetti Google Cloud , ambienti on-premise o cloud esterni separati, devi registrarli manualmente nel registry del progetto di governance.
Quando Agent Registry registra automaticamente un server MCP Google o Google Cloud
remoto, crea la risorsa McpServer solo nella località global, non nelle singole regioni. Puoi registrare manualmente agenti, server MCP ed endpoint e creare associazioni in una località regionale supportata o nella località global. I gateway regionali possono gestire e instradare il traffico sia alle risorse regionali sia ai server MCP global.
Per le regole complete di definizione dell'ambito regionale e i requisiti delle policy, consulta Località di Agent Registry.
Model Context Protocol (MCP)
Lo standard aperto utilizzato per connettere i modelli di AI a origini dati e strumenti, sostituendo i plug-in personalizzati.
Server MCP
Un programma che implementa il
Model Context Protocol (MCP)
per esporre funzionalità standardizzate di strumenti e risorse di dati
a un agente AI. In Agent Registry, un server MCP registrato è rappresentato come una risorsa di rilevamento McpServer di sola lettura.
Publisher
Un'entità che crea e registra una skill, rappresentata come una risorsa Publisher in Agent Registry. Un publisher stabilisce la proprietà e la sintassi dell'identificatore della skill per una skill.
Le skill gestite da Google utilizzano i domini di servizio. Le skill create manualmente vengono assegnate automaticamente al publisher private con un prefisso private-.
Per saperne di più, consulta Publisher.
Registrazione
Il processo di aggiunta di un componente agentico, come un agente, un server MCP, un endpoint o una skill, ad Agent Registry.
Agent Registry supporta due modelli di registrazione:
- Registrazione automatica: importazione automatica di agenti, server MCP e skill gestite da Google dai runtime Google Cloud supportati, come Agent Runtime su Gemini Enterprise Agent Platform, di cui è stato eseguito il deployment nel progetto di governance in cui è abilitato Agent Registry.
- Registrazione manuale: registrazione esplicita di agenti remoti o personalizzati, server MCP, endpoint e skill autonome private, inclusi i componenti ospitati in progetti Google Cloud separati, ambienti on-premise, cloud esterni o runtime non supportati, creando risorse nel registry del progetto di governance.
Per un confronto dettagliato dell'architettura, consulta Modelli di registrazione.
Identificatore del registro
Un URN (Uniform Resource Name) immutabile e univoco a livello globale che Agent Registry assegna a un componente agente registrato. Questo identificatore fornisce un riferimento stabile per i consumer e gli agenti orchestratori per scoprire, filtrare e cercare i componenti in Agent Registry, rimanendo costante indipendentemente dalle modifiche all'infrastruttura sottostante o dagli aggiornamenti del codice.
Per i formati di sintassi URN dettagliati, consulta Identificatori del registry.
Riferimento di runtime
La località di runtime fisica o l'infrastruttura di computing che ospita un agente, un server MCP o un endpoint, rappresentata in Agent Registry dall'attributo agentregistry.googleapis.com/system/RuntimeReference. Ad esempio, un riferimento di runtime può puntare a un motore di ragionamento Agent Runtime, a un deployment di Google Kubernetes Engine (GKE) o a un servizio Cloud Run.
Il percorso di riferimento del runtime è incorporato nell'entità dell'agente per la valutazione delle policy IAM. Per saperne di più, consulta Riferimenti di runtime.
Risorsa di servizio
La risorsa scrivibile in Agent Registry, identificata dal proprio nome risorsa, che utilizzi per le operazioni di gestione quando registri manualmente un agente, un server MCP o un endpoint. La risorsa Service archivia i metadati del componente, incluso il tipo di componente agentico e i dettagli di configurazione, come l'URL dell'interfaccia, la descrizione, l'associazione del protocollo e la specifica delle funzionalità. Un componente registrato automaticamente o una skill autonoma non utilizza una risorsa Service.
Puoi creare, aggiornare o eliminare una risorsa Service per registrare, aggiornare i metadati o annullare la registrazione di un componente registrato manualmente in Agent Registry senza modificare o eliminare il deployment sottostante. Quando crei o aggiorni una risorsa Service, Agent Registry legge i metadati e crea o aggiorna automaticamente la risorsa di rilevamento Agent, McpServer o Endpoint corrispondente. In Agent Registry, i consumer, come gli agenti orchestratori, le applicazioni client e gli sviluppatori, utilizzano queste risorse di rilevamento di sola lettura per elencare, cercare e visualizzare i componenti agentici. Per saperne di più, consulta Rappresentazione dei componenti agentici in Agent Registry.
Competenza
Confronta con la skill A2A.
Un pacchetto autonomo registrato come risorsa Skill di primo livello in Agent Registry che estende le funzionalità di un agente fornendo istruzioni specifiche e script facoltativi per completare un'attività. Una skill contiene un file di istruzioni SKILL.md, script facoltativi e asset di metadati.
Una skill è identificata da un identificatore della skill con ambito definito da un publisher e un nome risorsa standard. Ogni skill mantiene un puntatore di revisione predefinito e ha uno o più snapshot con versione, ciascuno rappresentato come una revisione dello skill.
Per i dettagli su architettura, pacchettizzazione e ciclo di vita, consulta Architettura delle skill.
Revisione della skill
Uno snapshot immutabile e con controllo delle versioni di un pacchetto di skill, rappresentato come una risorsa SkillRevision in Agent Registry. Una revisione della skill ti consente di aggiornare le istruzioni della skill o gli script facoltativi senza modificare l'identificatore della skill principale o interrompere le dipendenze degli agenti esistenti.
Per saperne di più sul controllo delle versioni e sull'immutabilità delle revisioni, consulta Revisioni delle competenze.
Strumento
Una funzione deterministica fornita da un server MCP che un agente può richiamare.