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

註冊代理程式後，代理程式就會從獨立工作負載轉換為 Agent Registry 中的可探索元件。發布代理程式的技能後，貴機構的其他開發人員和協調器代理程式就能找到並重複使用您的工作，加快 AI 開發速度。

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

事前準備

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

必要的角色

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

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

註冊模擬代理程式

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

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

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

    前往 Agent Registry

  2. 在專案選擇工具中，選取 Google Cloud 您設定 Agent Registry 的專案。

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

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

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

    • 顯示名稱：Mock Travel Agent
    • 說明：A mock agent that plans travel itineraries.
    • 「位置」：選取 global。
    • 代理程式類型：選取「A2A」。

  6. 在「代理程式規格」部分中，選取「貼上 JSON」分頁標籤。

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

    {
  "schemaVersion": "0.3",
  "agent": {
    "name": "mock-travel-agent",
    "description": "A mock agent that plans travel itineraries.",
    "skills": [
      {
        "name": "BookFlight",
        "description": "Books a flight to a destination."
      },
      {
        "name": "SearchHotels",
        "description": "Searches for hotels in a destination city."
      }
    ]
  }
}

  8. 按一下 [儲存]。

Agent Registry 會處理代理程式資訊卡，並註冊代理程式。

驗證註冊

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

  1. 在「代理」分頁中，找出清單中的「Mock Travel Agent」。
  2. 按一下「Mock Travel Agent」(模擬旅行社) 即可查看詳細資料。
  3. 確認「BookFlight」和「SearchHotels」技能顯示在「總覽」分頁中。

清除所用資源

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

  1. 在「代理」分頁中，找出清單中的「Mock Travel Agent」。
  2. 按一下「模擬旅遊代理」旁的「更多選項」選單 ，然後選取「刪除」。
  3. 在確認對話方塊中點按「刪除」。

後續步驟