搜尋代理和工具

隨著代理生態系統擴大，找到合適的代理或工具變得至關重要。Agent Registry 提供搜尋功能，可讓您對代理和 Model Context Protocol (MCP) 伺服器執行進階關鍵字和前置字元搜尋。

本文說明如何建構搜尋查詢，以探索環境中的功能。

事前準備

在 Agent Registry 中搜尋代理程式或工具前，請先註冊代理程式或 MCP 伺服器。您也需要專案 ID 才能執行這些工作。

如要使用本文中的 gcloud CLI 指令，請務必設定 Google Cloud CLI 環境。

必要的角色

如要取得在 Agent Registry 中搜尋代理程式和工具所需的權限，請要求管理員授予您專案的「Agent Registry API 檢視者」(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 伺服器：

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

更改下列內容：

  • PROJECT_ID：專案 ID。
  • REGION：登錄檔區域。

前置字元搜尋經過高度最佳化，可縮短延遲時間，讓應用程式在使用者輸入內容時，動態擷取相關聯的代理程式和工具。

如果您要建構協調器介面或自動完成功能，可以在 Agent Registry 中執行前置字元搜尋，取得與查詢字串開頭相符的結果。前置字串搜尋會使用後置字串萬用字元符號 (*) 比對字詞開頭。

舉例來說，搜尋顯示名稱開頭為特定前置字元的代理程式，例如 Best_A2A_*：

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

同樣地，您也可以搜尋顯示名稱開頭為特定前置字串的 MCP 伺服器，例如 Prod_Server_*：

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

更改下列內容：

  • PROJECT_ID：專案 ID。
  • REGION：登錄檔區域。