Agent Registry classifica i componenti agentici del tuo ecosistema in tre tipi principali che puoi scoprire nel tuo ambiente:
- Agenti: attori autonomi che possiedono competenze specifiche. Le skill rappresentano le funzionalità di alto livello di un agente e sono un meccanismo principale per la scoperta.
- Server MCP: fornitori di risorse di dati standardizzate e strumenti. Gli strumenti sono funzioni deterministiche esposte da un server MCP che gli agenti possono richiamare per eseguire azioni specifiche.
- Endpoint: URL di destinazione, in genere API REST, a cui accede un agente. Astrattendo queste destinazioni in risorse gestibili, Agent Registry ti consente di controllare a livello centrale a quali API esterne possono accedere i tuoi agenti.
Per saperne di più su questi e altri concetti utilizzati da Agent Registry, consulta Concetti chiave.
L'API Agent Registry separa le operazioni di lettura e scrittura. Nel registry dell'agente, un
Service è una risorsa API scrivibile
che rappresenta un agente, un server MCP o un endpoint che aggiungi manualmente
al tuo registry. Agent Registry registra automaticamente anche gli agenti
e i server di cui è stato eseguito il deployment sui runtime Google Cloud supportati.
Registra e gestisci i tuoi agenti, i server MCP e gli endpoint attivando l'API
Agent Registry API. Puoi utilizzare la risorsa Service scrivibile per creare, aggiornare ed eliminare manualmente le voci nel registro. Poi esegui query sulle risorse
Agent, McpServer o Endpoint di sola lettura per ottenere, elencare e cercare
i tuoi agenti, server ed endpoint registrati, rispettivamente.
Per iniziare, consulta Configurare il registro degli agenti.
Registrare i componenti basati su agenti nel registro
Agent Registry gestisce il catalogo di agenti e server MCP tramite due meccanismi di registrazione: automatico e manuale. Utilizza la risorsa Service per
creare, aggiornare ed eliminare manualmente le voci.
| Meccanismo di registrazione | Descrizione | Componente registrato | Prodotti Google Cloud supportati |
|---|---|---|---|
| Registrazione automatica | Puoi configurare e utilizzare Agent Registry per rilevare e importare automaticamente risorse specifiche di cui è stato eseguito il deployment su runtime Google Cloud supportati. Per gli agenti che implementano il protocollo aperto Agent2Agent (A2A), il registro estrae automaticamente anche le loro competenze e capacità dalla scheda dell'agente. | Agenti |
|
| Server MCP | Server MCP ufficiali di Google e Google Cloud remoti | ||
| Registrazione manuale |
Per le risorse esterne, i componenti agentici personalizzati su runtime non supportati o gli agenti REST standard che non implementano il protocollo A2A, devi registrarli manualmente creando una risorsa Service nel registry.
|
Agenti | Agenti remoti |
| Server MCP | Componenti agentici personalizzati su runtime non supportati o server MCP esterni |
Passaggi successivi
- Esamina i concetti chiave per acquisire familiarità con i termini essenziali utilizzati nel Registro degli agenti.
- Configura Agent Registry.
- Scopri la differenza tra registrazione automatica e manuale per gli agenti.