Cómo buscar agentes y herramientas

A medida que crece tu ecosistema de agentes, se vuelve fundamental encontrar el agente o la herramienta adecuados. Agent Registry proporciona capacidades de búsqueda para que puedas realizar búsquedas avanzadas de palabras clave y prefijos en tus agentes y servidores del Protocolo de contexto del modelo (MCP).

En este documento, se explica cómo construir consultas de búsqueda para descubrir capacidades en tu entorno.

Antes de comenzar

Antes de buscar agentes o herramientas en Agent Registry, registra un agente o un servidor de MCP. También necesitas tu ID del proyecto para realizar estas tareas.

Para usar los comandos de gcloud CLI en este documento, asegúrate de haber configurado tu entorno de Google Cloud CLI.

Roles obligatorios

Para obtener los permisos que necesitas para buscar agentes y herramientas en Agent Registry, pídele a tu administrador que te otorgue el rol de IAM Visualizador de la API de Agent Registry (roles/agentregistry.viewer) en el proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Puedes realizar una búsqueda de palabras clave para encontrar recursos que coincidan con términos específicos en sus capacidades, como las habilidades de un agente o las herramientas de un servidor de MCP. Para comprender cómo se estructuran estas capacidades en el registro, consulta los esquemas JSON. Para obtener una lista completa de los campos en los que se puede buscar, consulta la referencia de la API.

Para buscar por palabras clave, proporciona la marca --search-string. Este parámetro acepta consultas de texto libre y admite operadores lógicos: AND, OR y NOT.

Por ejemplo, busca un agente que pueda administrar reservas de vuelos:

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

También puedes buscar un servidor de MCP según las herramientas específicas que ofrece o su descripción. Por ejemplo, busca un servidor de MCP que proporcione herramientas de base de datos:

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

Reemplaza lo siguiente:

  • PROJECT_ID: El ID del proyecto
  • REGION: La región del registro

Las búsquedas de prefijos están altamente optimizadas para la latencia, lo que permite que tus aplicaciones recuperen agentes y herramientas relevantes de forma dinámica a medida que un usuario escribe.

Si compilas una interfaz de orquestador o una función de autocompletar, puedes realizar búsquedas de prefijos en Agent Registry para obtener resultados que coincidan con el comienzo de una cadena de consulta. Las búsquedas de prefijos usan el símbolo de comodín de sufijo (*) para buscar coincidencias en el comienzo de una palabra.

Por ejemplo, busca agentes cuyo nombre visible comience con un prefijo específico, como Best_A2A_*:

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

Del mismo modo, puedes buscar servidores de MCP cuyo nombre visible comience con un prefijo específico, como Prod_Server_*:

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

Reemplaza lo siguiente:

  • PROJECT_ID: El ID del proyecto
  • REGION: La región del registro