快速入門導覽課程：註冊代理程式

註冊代理程式後，代理程式就會從獨立元件變成可探索的整合式元件，成為 Agent Registry 中 AI 生態系統的一環。發布代理的技能後，貴機構的其他開發人員和協調器代理就能找到並重複使用您的工作，加快整體 AI 開發速度。

本快速入門導覽課程說明如何使用 Google Cloud 控制台，在代理程式登錄服務中手動註冊模擬代理程式。如要進一步瞭解 Agent Registry 中的代理程式註冊機制，請參閱「註冊代理程式」。

事前準備

開始之前，請先設定代理程式登錄。您需要專案 ID 才能執行這些工作。

啟用 Agent Registry API：

控制台

啟用 API 時所需的角色

您必須具備 serviceusage.services.enable 權限，才能啟用 API。如果您建立了專案，可能已透過「擁有者」角色 (roles/owner) 取得這項權限。否則，您可以透過「服務使用情形管理員」角色 (roles/serviceusage.serviceUsageAdmin) 取得這項權限。瞭解如何授予角色。

啟用 API

gcloud

在專案中啟用 Agent Registry API：

gcloud services enable agentregistry.googleapis.com \
    --project=PROJECT_ID

將 PROJECT_ID 替換為專案 ID。

必要的角色

如要取得在 Agent Registry 中註冊代理程式所需的權限，請要求管理員授予您專案的「Agent Registry API 編輯者」 (roles/agentregistry.editor) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

您或許也能透過自訂角色或其他預先定義的角色，取得必要權限。

註冊模擬代理程式

如要試用 Agent Registry，請手動註冊模擬代理，方法是貼上 Agent2Agent (A2A) 代理資訊卡範例。

請按照下列步驟註冊代理程式：

  1. 前往 Google Cloud 控制台的「Agent Registry」：

    前往 Agent Registry

    如果系統提示，請按一下「啟用」來啟用 Agent Registry API。

  2. 在專案選擇工具中，選取 Google Cloud 您設定代理程式登錄的專案。

  3. 選取「代理人」分頁。

  4. 按一下「新增代理」。

  5. 在「代理程式詳細資料」面板中，輸入下列詳細資料：

    • 類型：選取「A2A」。
    • 「區域」：選取「global」(全球)。

  6. 選取「貼上 JSON」分頁標籤。

  7. 複製並貼上下列範例 Agent Card 內容：

    {
  "supportedInterfaces": [
    {
      "url": "https://example.com/mock-travel-agent",
      "protocolBinding": "HTTP+JSON",
      "protocolVersion": "1.0.0"
    }
  ],
  "name": "mock-travel-agent",
  "description": "A mock agent that plans travel itineraries.",
  "version": "1.0.0",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false
  },
  "defaultInputModes": ["text/plain"],
  "defaultOutputModes": ["text/plain"],
  "skills": [
    {
      "id": "BookFlight",
      "name": "BookFlight",
      "description": "Books a flight to a destination.",
      "tags": ["travel", "booking"]
    },
    {
      "id": "SearchHotels",
      "name": "SearchHotels",
      "description": "Searches for hotels in a destination city.",
      "tags": ["travel", "accommodation"]
    }
  ]
}

  8. 按一下 [儲存]。

Agent Registry 會處理代理人證件並註冊代理人。

驗證註冊

如要確認模擬代理程式是否已成功註冊，請按照下列步驟操作：

  1. 在「代理程式」分頁中，找出清單中的模擬代理程式。
  2. 按一下代理程式名稱即可查看詳細資料。
  3. 確認「總覽」分頁中顯示「BookFlight」和「SearchHotels」技能。

清除所用資源

為避免專案中留下模擬資源，請刪除已註冊的代理：

  1. 在「代理程式」分頁中，找出清單中的模擬代理程式。
  2. 在模擬代理程式的「Actions」(動作) 欄中，按一下 「More options」(更多選項) 選單，然後選取「Delete」(刪除)。
  3. 在確認對話方塊中輸入 DELETE，確認要執行這項操作。
  4. 點選「刪除」。

後續步驟