搜索代理和工具

随着智能体生态系统的发展，找到合适的智能体或工具变得至关重要。Agent Registry 提供搜索功能，可让您在代理和 Model Context Protocol (MCP) 服务器中执行高级关键字和前缀搜索。

本文档介绍了如何构建搜索查询，以发现环境中的功能。

准备工作

在 Agent Registry 中搜索智能体或工具之前，请注册智能体或 MCP 服务器。您还需要项目 ID 才能执行这些任务。

如需使用本文档中的 gcloud CLI 命令，请确保您已设置 Google Cloud CLI 环境。

所需的角色

如需获得在代理注册表中搜索代理和工具所需的权限，请让管理员向您授予项目的 Agent Registry API Viewer (roles/agentregistry.viewer) IAM 角色。 如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

您也可以通过自定义角色或其他预定义角色来获取所需的权限。

您可以执行关键字搜索，以查找在功能方面与特定字词匹配的资源，例如代理的技能或 MCP 服务器的工具。 如需了解这些功能在注册表中的结构，请参阅 JSON 架构。如需查看可搜索字段的完整列表，请参阅 API 参考文档。

如需按关键字搜索，请提供 --search-string 标志。此参数接受自由文本查询，并支持逻辑运算符：AND、OR 和 NOT。

例如，搜索可以处理航班预订的代理：

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

您还可以根据 MCP 服务器提供的特定工具或其说明来搜索 MCP 服务器。例如，搜索提供数据库工具的 MCP 服务器：

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

替换以下内容：

  • PROJECT_ID：项目 ID。
  • REGION：注册区域。

前缀搜索经过高度优化，可实现低延迟，让您的应用在用户输入内容时动态检索相关代理和工具。

如果您要构建编排器界面或自动补全功能，可以在代理注册表中执行前缀搜索，以获取与查询字符串开头匹配的结果。前缀搜索使用后缀通配符 (*) 来匹配字词的开头。

例如，搜索显示名称以特定前缀（例如 Best_A2A_*）开头的代理：

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

同样，您也可以搜索显示名称以特定前缀（例如 Prod_Server_*）开头的 MCP 服务器：

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

替换以下内容：

  • PROJECT_ID：项目 ID。
  • REGION：注册区域。