Questo documento spiega i termini e i concetti chiave relativi ad Agent Registry.
Skill A2A
Confronta con le skill.
Un blocco di metadati delle funzionalità dichiarative rappresentato in linea all'interno della
scheda dell'agente
(agent-card.json). Le competenze A2A descrivono le interfacce di comunicazione da agente ad agente
e le funzionalità di alto livello possedute da un agente conforme ad A2A.
Agent Registry supporta le versioni 0.3 e 1.0 della specifica Agent2Agent (A2A).
Agente
Un attore autonomo nel tuo ecosistema AI, definito dal suo identificatore e dalle skill A2A o skill specifiche che possiede.
Identificatore 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 sono diversi dalle identità dell'agente. Gli identificatori degli agenti sono URN logici progettati esclusivamente per il monitoraggio dell'inventario, la ricerca di identità cross-surface e il filtraggio dei servizi registrati. Al contrario, le identità dell'agente rappresentano l'identità di runtime sicura dell'agente. Per gestire la comunicazione sicura e basata su policy degli agenti, devi utilizzare l'entità agente. Per saperne di più, consulta la pagina Panoramica delle policy IAM.
Gli identificatori dell'agente vengono generati automaticamente da Agent Registry 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 - Cloud Run Jobs:
urn:agent:projects-PROJECT_NUMBER:projects:PROJECT_NUMBER:locations:REGION:run:jobs:JOB_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 Identity and Access Management (IAM) univoco assegnato a un agente, che gli consente di disporre di autorizzazioni e di essere sottoposto a audit. Assume la forma di unGoogle Cloud service account o di un'identità per i carichi di lavoro gestita, ad esempio un ID SPIFFE, associato a un agente o a un server verificabile.
Poiché questa identità è associata direttamente alla risorsa di computing del runtime dell'agente, la stringa dell'entità incorpora il percorso esatto della risorsa sottostante. Ad esempio, un principal 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
Agent Registry 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 agentic in quattro tipi principali: agenti, server MCP, endpoint e skill.
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 skill.
La scoperta in Agent Registry si concentra sulle funzionalità incentrate sul consumo che gli orchestratori 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. Astrarre queste destinazioni in risorse gestibili consente all'Agent Registry 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.
Come gli identificatori degli agenti, gli identificatori del server MCP sono nomi logici utilizzati per la ricerca stabile e la catalogazione dell'inventario. Per gestire la comunicazione agentica sicura e regolata da policy, devi utilizzare l'entità agente.
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: importazione automatica delle risorse AIGoogle Cloud supportate, ad esempio in Agent Runtime. La registrazione automatica opera nell'ambito di un singolo progetto.
- Registrazione manuale: onboarding manuale di componenti agentici personalizzati o esterni o di agenti di cui è stato eseguito il deployment in più Google Cloud progetti per il rilevamento e la governance centralizzati.
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 unica 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 unici 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 nelle policy IAM. Per le registrazioni tra progetti, l'URI della risorsa fa riferimento al progetto in cui si trova la risorsa di computing.
Agent Registry visualizza 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, Agent Registry proietta automaticamente
questo Service sul lato consumatore 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
Confronta con le skill A2A.
Un pacchetto eseguibile autonomo registrato come risorsa di primo livello in
Agent Registry che estende le funzionalità di un agente fornendo
istruzioni specifiche, linguaggio naturale o codice per completare un'attività.
Le skill contengono file di istruzioni (SKILL.md), script di esecuzione runtime e
asset di metadati.
Le competenze sono identificate da un nome risorsa uniforme (URN). Il formato esatto dipende dall'editore. Ecco alcuni esempi:
- Skill create da Google:
urn:skill:PUBLISHER_ID:NAMESPACE:SKILL_ID. Ad esempio:urn:skill:discoveryengine.googleapis.com:discoveryengine:report-writing. - Competenze registrate manualmente:
urn:skill:projects-PROJECT_NUMBER:locations:LOCATION:private-SKILL_ID. Ad esempio:urn:skill:projects-123456789:locations:global:private-create-docs.
Le skill create da Google sono visibili immediatamente quando configuri Agent Registry. Tuttavia, puoi anche registrare le tue skill. Registri le competenze in Agent Registry come risorse correlate agli agenti e ai server MCP. Ogni skill ha una revisione predefinita e può contenere più revisioni della skill con controllo delle versioni.
Gli amministratori della piattaforma gestiscono le competenze gestendo i relativi stati del ciclo di vita e impostando i puntatori della versione predefinita per la risoluzione del runtime.
Revisione della skill
Uno snapshot immutabile e con controllo delle versioni di un pacchetto di skill. Le revisioni ti consentono di aggiornare le istruzioni o il codice dell'intent senza modificare l'identificatore dell'intent principale.
Puoi gestire le revisioni delle skill per consentire il controllo delle versioni delle tue skill.
Publisher
Un'entità che crea e registra skill in Agent Registry.
I publisher precompilati includono i publisher Google, come cloud.google.com
e discoveryengine.googleapis.com, e i partner verificati. Le skill create da Google di questi publisher sono visibili immediatamente quando configuri Agent Registry.
Le competenze che crei vengono assegnate automaticamente al publisher private
predefinito, quindi l'ID pubblicato di una determinata competenza è preceduto da
private-. Non puoi registrare risorse personalizzate per i publisher.
Esamina e controlla i dettagli del publisher per le tue skill registrate.
Strumento
Una funzione deterministica fornita da un server MCP che un agente può richiamare.