Questo documento spiega i termini e i concetti chiave relativi al registry degli agenti.
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 degli agenti vengono generati automaticamente dal registry degli agenti durante l'importazione e seguono un formato URN (Uniform Resource Name). Il formato esatto dipende dalla posizione in cui viene eseguito il deployment dell'agente. Di seguito sono riportati 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 di Identity and Access Management (IAM) assegnato a un agente, che gli consente di avere autorizzazioni e di essere sottoposto a audit. Assume la forma di un account di servizio verificabile Google Cloud o di un'identità del carico di lavoro gestita, ad esempio un ID SPIFFE, associato a un agente o server.
Poiché questa identità è associata direttamente alla risorsa di calcolo del runtime dell'agente, la stringa dell'entità incorpora il percorso esatto della risorsa sottostante. Ad esempio, un'entità agente per un deployment di Agent Runtime su Gemini Enterprise Agent Platform ha il seguente aspetto:
principal://agents.global.org-ORGANIZATION_ID.system.id.goog/resources/aiplatform/projects/PROJECT_NUMBER/locations/REGION/reasoningEngines/REASONING_ENGINE_ID
Componente agentico
Un'entità modulare e funzionale all'interno di un ecosistema di AI che il registry degli agenti ti consente di registrare, rilevare 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 portare a termine un'attività.
Provider autorizzazione
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 associazioni, 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 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 risposte o informare le sue azioni.
Discovery
Il processo di esecuzione di query sul registry per trovare agenti, strumenti MCP o endpoint esistenti in base a descrizioni, tag o competenze.
Il rilevamento nel registry 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 i sistemi di AI.
Questo processo nel registry degli agenti è diverso dal rilevamento dell'infrastruttura, ad esempio in App Hub, che identifica le risorse di calcolo non registrate nei tuoi Google Cloud progetti.
Endpoint
Per l'API Agent Registry, una risorsa che rappresenta un URL di destinazione, in genere un'API REST, a cui accede un agente. Astrattando queste destinazioni in risorse gestibili, il registry degli agenti ti consente di controllare a livello centrale i servizi esterni a cui un agente può accedere.
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 dati standardizzati agli agenti AI.
Identificatore del server MCP
Un nome 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 la scoperta di set di strumenti specifici.
Il formato dipende dal fatto che si tratti di un servizio Google integrato o di un server esterno registrato. Di seguito sono riportati 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 agentico, come un agente, un server MCP o un endpoint, al registry. Il registry degli agenti fornisce i seguenti meccanismi di registrazione:
- Registrazione automatica: importazione automatica di risorse di Google Cloud AI supportate, ad esempio in Agent Runtime.
- Registrazione manuale: onboarding manuale di componenti agentici personalizzati o esterni.
URI risorsa
La posizione di runtime fisica o l'infrastruttura che ospita un agente o 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 di Agent Runtime, un deployment di Google Kubernetes Engine (GKE) o un servizio Cloud Run.
L'URI risorsa è diverso dall'identificatore dell'agente o 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 risorsa punta alla risorsa di calcolo effettiva in cui viene eseguito l'agente o il server.
Il percorso dell'URI risorsa di un agente è incorporato nella stringa dell'entità agente principale per identificare in modo univoco la risorsa nelle policy IAM.
Puoi utilizzare l'URI 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 i componenti agentici personalizzati o
esterni nel registry. Un Service 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 componenti agentici che il registry degli agenti non importa automaticamente.
A seconda della specifica fornita, il registry degli agenti proietta automaticamente questo Service sul lato del consumatore come risorsa Agent, McpServer o Endpoint di sola lettura per il rilevamento.
Utilizza sempre la risorsa Service per creare, modificare o eliminare le voci del registry. Tuttavia, per ottenere, elencare o cercare queste voci, esegui una query sulle risorse Agent, McpServer o Endpoint di sola lettura.
Skill
Una funzionalità di alto livello posseduta da un agente. Le competenze vengono estratte
dalle schede agente Agent2Agent (A2A) Agent Cards
e fungono da punti dati principali per il rilevamento degli agenti discovery.
Il registry degli agenti supporta le versioni 0.3 e 1.0 della specifica A2A.
Strumento
Una funzione deterministica fornita da un server MCP che un agente può richiamare.