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

在 Agent Registry 註冊代理，即可將獨立元件轉化為 AI 生態系統中可供探索的部分。發布代理的 A2A 技能，可協助貴組織的其他開發人員和協調器代理，找到並重複使用您的工作。

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

事前準備

  1. 設定 Agent Registry。
  2. 取得已啟用 Agent Registry 的管理專案專案 ID。

必要的角色

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

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

註冊模擬代理

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

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

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

    前往代理程式註冊頁面

    如果出現提示訊息，請點選「啟用」來啟用 Agent Registry API。

  2. 在專案挑選器中，選取設定 Agent Registry 的 Google Cloud 專案。

  3. 選取「代理」分頁標籤。

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

  5. 在「Agent details」(代理詳細資料) 面板中，輸入下列詳細資料：

    • Type：選取「A2A」。
    • 「區域」：選取「global」(全域)。

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

  7. 貼上以下範例代理卡片內容：

    {
  "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」A2A 技能顯示在「Overview」(總覽) 分頁中。

清除所用資源

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

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

後續步驟