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:
- Vertex AI Agent Engine:
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:SERVICE_ID
Entità agente
L'identificatore IAM univoco assegnato a un agente, che gli consente di detenere autorizzazioni ed 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 deployment di Vertex AI Agent Engine è simile al seguente:
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.
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. I binding vengono utilizzati 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 o strumenti MCP esistenti in base a descrizioni, tag o skill. La scoperta per abilità è disponibile per gli agenti che espongono le proprie funzionalità tramite una scheda dell'agente, ad esempio quelli che implementano il protocollo Agent2Agent (A2A).
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 toolset 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:SERVICE_NAME - Server MCP registrati manualmente:
urn:mcp:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:agentregistry:SERVICE_ID
Registrazione
Il processo di aggiunta di un servizio al registro. Agent Registry fornisce i seguenti meccanismi di registrazione:
- Registrazione automatica: importazione automatica dei workload supportati Google Cloud, ad esempio in Vertex AI Agent Engine.
- Registrazione manuale: onboarding manuale di carichi di lavoro 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 Vertex AI, un deployment 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 unici in formato URN che identificano i tuoi agenti e i server MCP nel registro. 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 agent principal per identificare in modo univoco il workload nelle policy 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 carichi di lavoro personalizzati o esterni nel registro. Un servizio rappresenta un agente, un server MCP o un endpoint aggiunto manualmente al registry. Crea e gestisci una risorsa Service per definire l'endpoint e i metadati per i carichi di lavoro che Agent Registry non inserisce automaticamente.
A seconda della specifica che fornisci, Agent Registry proietta automaticamente
questo servizio 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.
Competenza
Una funzionalità di alto livello posseduta da un agente A2A. Le competenze vengono estratte dalle schede degli agenti 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.