在 Agent Studio 設計代理

本頁面提供簡介，說明如何在Google Cloud 控制台中使用 Agent Studio。

Agent Studio 是 Google Cloud 控制台中的低程式碼視覺化設計工具，可簡化代理開發作業。您可以透過視覺化方式規劃代理工作流程、即時測試回覆，並嘗試不同設定，再著手部署或銜接程式碼。

本文將簡要介紹 Agent Studio，並說明如何設定環境、建立及測試代理程式，以及直接將代理程式部署至正式版執行階段。

設定環境

使用 Agent Studio 前，請先設定Google Cloud。

取得必要角色

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

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

建立虛擬服務專員

如要在 Agent Studio 中設計及測試代理程式，請按照下列步驟操作：

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

    前往「代理程式」頁面

  2. 按一下「建立代理」，開啟新代理的 Agent Studio 畫布。

  3. 在 Agent Studio 畫布中設計及儲存代理。你可以切換下列分頁：

    • 流程：以代理工作流程和控制邏輯的視覺化呈現方式，建立主要代理和子代理。

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

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

        1. 名稱：新增名稱，方便識別代理程式。

        2. 說明：簡要說明代理的用途。

        3. 指令：新增指令來引導代理。

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

        5. 工具：按一下「新增工具」圖示 (+)，新增可讓代理完成工作的工具。詳情請參閱「設定及新增工具」。

      3. 如要儲存服務專員，請按一下畫布標題中的「儲存」，然後按照提示操作。詳情請參閱「儲存代理程式」。

    • 「預覽」分頁：在預覽窗格中與代理對話，測試代理的功能和回覆。

  4. 按一下「取得程式碼」即可查看代理商代碼。如要在其他地方繼續開發代理程式，可以複製程式碼並貼到所選的程式碼編輯器。

代理完成後，即可直接從 Agent Studio 部署。 詳情請參閱「從 Agent Studio 部署代理程式」。

儲存代理程式

您必須先儲存服務專員，才能預覽或部署，因為未儲存的服務專員尚未建立身分。首次儲存代理程式：

  1. 在 Agent Studio 畫布中，按一下「儲存」。

  2. 在「儲存代理程式」對話方塊中，輸入「代理程式名稱」。

  3. 按一下 [儲存]。

首次儲存後，Agent Studio 會自動儲存您所做的任何後續變更。如果您在儲存新代理程式前嘗試離開畫布，Agent Studio 會提示您先儲存。

在 Agent Studio 中設定及新增工具

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

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

  • 網址內容：讓模型分析傳送給代理程式的提示中的網址。 這項設定預設為開啟。

  • Agent Platform Search 資料儲存庫：點選「新增」 (+)，讓代理程式存取 Agent Search 資料儲存庫中已建立索引的資訊。

    如果沒有現有資料儲存庫，請參閱「開始使用自訂搜尋」一文，瞭解如何建立資料儲存庫。然後授予服務帳戶 Agent Platform Search 的存取權：

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

      前往身分與存取權管理 (IAM)

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

    3. 在「新增主體」欄位中，輸入下列服務帳戶資訊：

      service-PROJECT_NUMBER@gcp-sa-aiplatform-re.。

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

  • MCP 伺服器：直接連線至 Model Context Protocol (MCP) 伺服器。

    1. 如要透過連線至 MCP 伺服器新增 MCP 工具，請按一下「MCP 伺服器」旁的「新增」 (+)。
    2. MCP 顯示名稱：輸入 MCP 伺服器的名稱。
    3. 端點網址：輸入 MCP 伺服器的端點網址。
    4. 驗證：自動填寫為「無」。Agent Studio 僅支援不需要驗證的 MCP 伺服器。

    代理可以存取已連結 MCP 伺服器的所有工具。

從 Agent Studio 部署代理

建立及預覽代理程式後，即可部署至正式環境。如要從 Agent Studio 部署代理程式，請按照下列步驟操作：

  1. 在「代理程式」清單頁面中，按一下要部署的代理程式。 系統會顯示所選代理程式的「代理程式詳細資料」頁面。
  2. 按一下「Deploy」(部署)，開啟「Deploy to an Agent Runtime instance」(部署至 Agent Runtime 執行個體) 對話方塊。

  3. (選用) 編輯代理的顯示名稱或說明。

  4. 從可用區域清單中選取部署區域，然後按一下「確定」。

  5. 點選「Deploy」(部署)。

部署作業會建立新的執行階段執行個體，最多可能需要五分鐘才能完成。成功後，Agent Studio 畫布的「流程」分頁會顯示訊息。您的代理現在已可用於正式環境，並可安全整合外部應用程式。

查看已部署的代理程式

如要查看已部署的代理，請按照下列步驟操作：

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

    前往 Agent Platform

  2. 使用「Region」(區域) 清單依部署區域篩選。

  3. 清單中會顯示所選專案的已部署代理程式。

  4. 按一下指定代理的名稱，系統會開啟該代理程式的「指標」頁面。

  5. 選取「Playground」分頁標籤，測試代理。

  6. 在聊天窗格中輸入測試查詢，確認代理程式是否順利執行。

如要進一步瞭解代理程式可用的指標，請參閱「查看已部署代理程式的指標」。