Questo documento spiega i termini e i concetti chiave relativi ad Agent Registry.
Agente
Un attore autonomo nel tuo ecosistema di AI, definito dal suo identificatore e dalle competenze specifiche che possiede.
Identificatore dell'agente
Un nome univoco e immutabile a livello globale per l'agente. Questo identificatore logico fornisce un riferimento stabile per i consumatori per chiamare l'agente, rimanendo costante indipendentemente dalle modifiche all'infrastruttura sottostante.
Gli identificatori dell'agente vengono generati automaticamente dal registro agenti durante l'importazione e seguono un formato URN (Uniform Resource Name). Il formato esatto dipende da dove viene eseguito il deployment dell'agente. Ecco alcuni esempi:
- Agent Runtime su Gemini Enterprise Agent Platform:
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:reasoningEngines:AGENT_ID - Servizi Cloud Run:
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:run:services:SERVICE_NAME - Deployment GKE:
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:containers:CLUSTER_NAME:namespace:NAMESPACE:deployment:DEPLOYMENT_NAME - Gemini Enterprise:
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:discoveryengine:INSTANCE_ID:root - Google Workspace:
urn:agent:googleapis.com:locations:global:workspaceagent:workspaceagent--a2a - Agenti registrati manualmente:
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:agentregistry:AGENT_ID
Entità agente
L'identificatore univoco Identity and Access Management (IAM) assegnato a un agente, che gli consente di detenere autorizzazioni e di essere sottoposto a audit. Assume la forma di un account di servizio verificabile Google Cloud o di un'identità per i workload gestita, ad esempio un ID SPIFFE, associato a un agente o a un server.
Poiché questa identità è associata direttamente alla risorsa di calcolo del runtime dell'agente, la stringa principale incorpora il percorso esatto della risorsa sottostante. Ad esempio, un principal agente per un runtime dell'agente nel deployment di Gemini Enterprise Agent Platform ha questo aspetto:
principal://agents.global.org-ORGANIZATION_ID.system.id.goog/resources/aiplatform/projects/PROJECT_NUMBER/locations/REGION/reasoningEngines/REASONING_ENGINE_ID
Il registro degli agenti mostra questa identità come attributo di sola output quando visualizzi i dettagli di un 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 agentici in tre tipi principali: agenti, server MCP ed endpoint.
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 svolgere un'attività.
Provider autorizzazione
Una configurazione all'interno del gestore di autenticazione di identità dell'agente per archiviare, acquisire e gestire le credenziali, come chiavi API o token OAuth, per collegare l'agente a strumenti e applicazioni esterni specifici e definire il tipo di autenticazione.
Associazione
Una connessione tra un agente di origine e una risorsa di destinazione, ad esempio un altro agente, un server MCP o un endpoint. Creando i binding, stabilisci relazioni esplicite che consentono agli agenti orchestratori di interagire con le funzionalità downstream. Le associazioni vengono utilizzate anche per associare un agente a un provider di autenticazione per supportare le autorizzazioni delegate.
Risorsa di dati
Un contesto di dati o un insieme 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 esecuzione di query nel registry per trovare agenti, strumenti MCP o endpoint esistenti in base a descrizioni, tag o competenze.
Discovery nel Registro degli agenti si concentra sulle funzionalità incentrate sul consumo che gli orchestratori di AI possono utilizzare. Scopri le funzionalità già registrate per creare e orchestrare sistemi di AI.
Questo processo in Agent Registry è diverso dal rilevamento dell'infrastruttura, ad esempio in App Hub, che identifica le risorse di calcolo non registrate nei tuoi progetti Google Cloud .
Endpoint
Per l'API Agent Registry, una risorsa che rappresenta un URL di destinazione, in genere un'API REST, a cui accede un agente. Astrattendo queste destinazioni in risorse gestibili, il registry dell'agente ti consente di controllare a livello centrale a quali servizi esterni può accedere un agente.
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 (o server)
Un servizio che implementa il Model Context Protocol (MCP) per fornire strumenti e risorse di dati standardizzati agli agenti AI.
Identificatore del server MCP
Un nome della risorsa uniforme (URN) univoco e immutabile a livello globale per un server MCP. Analogamente agli identificatori degli agenti, questo nome fornisce un riferimento stabile per scoprire set di strumenti specifici.
Il formato dipende dal fatto che si tratti di un servizio Google integrato o di un server esterno registrato. Ecco alcuni esempi:
- Google Cloud Server MCP remoti:
urn:mcp:googleapis.com:projects:PROJECT_NUMBER:locations:global:SERVER_NAME - Server MCP registrati manualmente:
urn:mcp:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:agentregistry:SERVER_ID
Registrazione
Il processo di aggiunta di un componente agentic, ad esempio un agente, un server MCP o un endpoint, al registry. Agent Registry fornisce i seguenti meccanismi di registrazione:
- Registrazione automatica: inserimento automatico delle risorse AI Google Cloud supportate, ad esempio in Agent Runtime.
- Registrazione manuale: onboarding manuale di componenti di agenti personalizzati o esterni.
URI risorsa
La posizione o l'infrastruttura di runtime fisica che ospita un agente o un server MCP. L'URI (Uniform Resource Identifier) è la sequenza univoca di caratteri che identifica questa risorsa di runtime. Ad esempio, un URI risorsa può essere un endpoint Agent Runtime, un deployment Google Kubernetes Engine (GKE) o un servizio Cloud Run.
L'URI della risorsa è diverso dall'identificatore dell'agente o dall'identificatore del server MCP. Questi valori sono i nomi univoci in formato URN che identificano gli agenti e i server MCP nel registry. Al contrario, l'URI della risorsa punta alla risorsa di calcolo effettiva in cui viene eseguito l'agente o il server.
Il percorso dell'URI della risorsa di un agente è incorporato nella stringa entità agente per identificare in modo univoco la risorsa nei criteri IAM.
Il registro degli agenti mostra questo URI come attributo di sola output quando visualizzi i dettagli di un agente.
Puoi utilizzare l'URI della risorsa per creare query nel grafico della topologia per visualizzare i flussi di traffico e le relazioni per agenti specifici. Nell'API
Agent Registry, questo valore è rappresentato dall'attributo
agentregistry.googleapis.com/system/RuntimeReference.
Servizio
Per l'API Agent Registry, la risorsa scrivibile utilizzata per registrare manualmente componenti agentici personalizzati o
esterni nel registro. Un Service
rappresenta un agente, un server MCP o un endpoint aggiunto manualmente al
tuo registry. Crea e gestisci una risorsa Service per definire l'endpoint
e i metadati per i componenti agentici che Agent Registry non acquisisce
automaticamente.
A seconda della specifica che fornisci, il registro degli agenti proietta automaticamente questo Service sul lato consumer come risorsa Agent, McpServer o Endpoint di sola lettura per la scoperta.
Utilizzi sempre la risorsa Service per creare, modificare o eliminare le voci del registro. Tuttavia, per ottenere, elencare o cercare queste voci, devi eseguire query sulle risorse
di sola lettura Agent, McpServer o Endpoint.
Skill
Una funzionalità di alto livello posseduta da un agente A2A. Le competenze vengono estratte dalle schede agente A2A e fungono da punti dati principali per l'individuazione degli agenti.
Strumento
Una funzione deterministica fornita da un server MCP che un agente può richiamare.