代理程式設計工具總覽

本頁面提供總覽,說明如何在 Google Cloud 控制台使用 Agent Designer。

代理程式設計工具是低程式碼的視覺化設計工具,可讓您在 Google Cloud 控制台中設計及測試代理程式。您可以在 Agent Designer 中試用代理程式,然後使用 Agent Development Kit 將開發作業轉移至程式碼。

設定環境

使用 Agent Designer 前,請先設定 Google Cloud

取得必要角色

如要取得使用 Agent Designer 所需的權限,請要求管理員授予您專案的「Vertex AI 使用者 」(roles/aiplatform.user) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。

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

使用 Agent Designer

請按照下列步驟,在 Agent Designer 中設計及測試代理程式:

  1. 前往 Google Cloud 控制台的「Agent Designer」頁面。

    前往 Agent Designer

  2. 按一下「建立代理程式」,開啟新代理程式的代理程式設計師畫布。

  3. 在代理設計工具畫布中設計代理。你可以切換下列分頁:

    • 流程:使用代理程式工作流程和控制邏輯的視覺化表示法,建立主要代理程式和子代理程式。

      1. 按一下代理程式,開啟該代理程式的「詳細資料」面板。你也可以按一下「新增子代理」 (+) 新增子代理。

      2. 在「詳細資料」面板中設定主要代理程式和子代理程式:

        1. 名稱:新增名稱,方便識別代理程式。

        2. 說明:代理程式用途的摘要。

        3. 指令:新增指令來引導代理程式。

        4. 模型:選取要驅動代理程式的模型。

        5. 工具:按一下「新增工具」 (+),新增可讓代理程式完成工作的工具。詳情請參閱「設定及新增工具」。

    • 預覽:建構代理程式時,測試代理程式的功能和回應。與虛擬服務專員對話,測試其功能。

  4. 按一下「取得程式碼」即可查看代理商代碼。複製程式碼並貼到您選擇的程式碼編輯器。請參閱 Agent Development Kit 教學課程,繼續開發及部署代理程式。

在代理設計工具中設定及新增工具

您可以為代理程式設定下列工具:

  • Google 搜尋:允許代理使用 Google 搜尋執行網頁搜尋,這項設定預設為開啟。

  • 網址內容:啟用這項功能後,模型就能分析傳送給代理程式的提示中的網址。這項設定預設為開啟。

  • Vertex AI Search 資料儲存庫:按一下「新增」 (+),讓代理程式存取 Vertex AI Search 資料儲存庫中已建立索引的資訊。

    如果沒有現有資料儲存區,請參閱「開始使用自訂搜尋」一文,瞭解如何建立資料儲存區。接著授予服務帳戶 Vertex AI Search 的存取權:

    1. 前往 Google Cloud 控制台的「IAM」頁面。

      前往「IAM」頁面

    2. 按一下「授予存取權」

    3. 在「新增主體」欄位中,輸入下列服務帳戶資訊: service-PROJECT_NUMBER@gcp-sa-aiplatform-re.iam.gserviceaccount.com

    4. 選取「+ 新增角色」。搜尋並選取「Discovery Engine 使用者」。按一下「套用」,然後點選「儲存」

  • MCP 伺服器:按一下「新增」圖示 (+),連線至 MCP 伺服器來新增 MCP 工具。

    1. MCP 顯示名稱:輸入 MCP 伺服器的名稱。

    2. 端點網址:輸入 MCP 伺服器的端點網址。

    3. 驗證:自動填入「無」。Agent Designer 只支援不需要驗證的 MCP 伺服器。

    連線的 MCP 伺服器中的所有工具,都會提供給代理使用。