Cercare agenti e strumenti

Man mano che il tuo ecosistema agentico cresce, trovare l'agente o lo strumento giusto diventa fondamentale. Il registry degli agenti fornisce funzionalità di ricerca che ti consentono di eseguire ricerche avanzate di parole chiave e prefissi nei tuoi agenti e nei server Model Context Protocol (MCP).

Questo documento spiega come creare query di ricerca per scoprire le funzionalità nel tuo ambiente.

Prima di iniziare

Prima di cercare agenti o strumenti in Agent Registry, registra un agente o un server MCP. Per eseguire queste attività, devi anche disporre dell'ID progetto.

Per utilizzare i comandi gcloud CLI in questo documento, assicurati di aver configurato l'ambiente Google Cloud CLI.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per cercare agenti e strumenti in Agent Registry, chiedi all'amministratore di concederti il ruolo IAM Visualizzatore API Agent Registry (roles/agentregistry.viewer) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Puoi eseguire una ricerca per parola chiave per trovare risorse che corrispondono a termini specifici nelle loro funzionalità, ad esempio le competenze di un agente o gli strumenti di un server MCP. Per capire come sono strutturate queste funzionalità nel registro, consulta Schemi JSON. Per un elenco completo dei campi in cui è possibile eseguire ricerche, consulta il riferimento API.

Per eseguire la ricerca per parole chiave, fornisci il flag --search-string. Questo parametro accetta query di testo libero e supporta gli operatori logici: AND, OR e NOT.

Ad esempio, cerca un agente che possa gestire le prenotazioni di voli:

gcloud alpha agent-registry agents search \
  --project=PROJECT_ID \
  --location=REGION \
  --search-string="flight OR booking"

Puoi anche cercare un server MCP in base agli strumenti specifici che offre o alla sua descrizione. Ad esempio, cerca un server MCP che fornisca strumenti per database:

gcloud alpha agent-registry mcp-servers search \
  --project=PROJECT_ID \
  --location=REGION \
  --search-string="database"

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto.
  • REGION: la regione del registro.

Le ricerche con prefisso sono altamente ottimizzate per la latenza, consentendo alle tue applicazioni di recuperare dinamicamente agenti e strumenti pertinenti mentre un utente digita.

Se stai creando un'interfaccia di orchestrator o una funzionalità di completamento automatico, puoi eseguire ricerche con prefisso in Agent Registry per ottenere risultati corrispondenti all'inizio di una stringa di query. Le ricerche con prefisso utilizzano il simbolo jolly del suffisso (*) per trovare corrispondenze con l'inizio di una parola.

Ad esempio, cerca gli agenti il cui nome visualizzato inizia con un prefisso specifico, come Best_A2A_*:

gcloud alpha agent-registry agents search \
  --project=PROJECT_ID \
  --location=REGION \
  --search-string="displayName:Best_A2A_*"

Allo stesso modo, puoi cercare i server MCP il cui nome visualizzato inizia con un prefisso specifico, ad esempio Prod_Server_*:

gcloud alpha agent-registry mcp-servers search \
  --project=PROJECT_ID \
  --location=REGION \
  --search-string="displayName:Prod_Server_*"

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto.
  • REGION: la regione del registro.