管理已部署的服務專員

本頁說明如何管理已部署至 Vertex AI Agent Engine 受管理執行階段的代理程式。已部署的代理程式是 Vertex AI 中的 reasoningEngine 類型資源。

列出已部署的代理程式

列出指定專案和位置的所有已部署代理程式：

控制台

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

    前往 Agent Engine

清單中會顯示屬於所選專案的已部署代理程式。您可以使用「篩選器」欄位，依據指定欄篩選清單。

Python 適用的 Vertex AI SDK 

from vertexai import agent_engines

agent_engines.list()

如要依 display_name 篩選清單：

from vertexai import agent_engines

agent_engines.list(filter='display_name="Demo Langchain Agent"')

REST

呼叫 reasoningEngines.list 方法。

使用任何要求資料之前，請先替換以下項目：

  • PROJECT_ID：您的 GCP 專案 ID
  • LOCATION：支援的區域

HTTP 方法和網址：

GET https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines

如要傳送要求，請展開以下其中一個選項：

您應該會收到執行成功的狀態碼 (2xx) 和空白回應。

取得已部署的代理程式

每個已部署的代理程式都有專屬的 RESOURCE_ID ID。 詳情請參閱「部署代理程式」。

控制台

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

    前往 Agent Engine

    清單中會顯示屬於所選專案的已部署代理程式。您可以使用「篩選器」欄位，依據指定欄篩選清單。

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

  3. (選用) 如要查看代理程式的部署詳細資料，請按一下「部署詳細資料」。「Deployment details」(部署作業詳細資料) 窗格隨即開啟。如要關閉窗格，請按一下「完成」。

  4. (選用) 如要查看代理程式的 query 和 streamQuery 網址，請按一下「API URLs」。「API URLs」窗格隨即開啟。如要關閉窗格，請按一下「完成」。

Python 適用的 Vertex AI SDK

以下程式碼可讓您取得特定已部署的代理程式：

from vertexai import agent_engines

remote_agent = agent_engines.get("RESOURCE_ID")

或者，您也可以提供完整資源名稱：

from vertexai import agent_engines

remote_agent = agent_engines.get(
"projects/PROJECT_ID_OR_NUMBER/locations/LOCATION/reasoningEngines/RESOURCE_ID"
)

REST

呼叫 reasoningEngines.get 方法。

使用任何要求資料之前，請先替換以下項目：

  • PROJECT_ID：您的 GCP 專案 ID
  • LOCATION：支援的區域
  • RESOURCE_ID：已部署代理程式的資源 ID

HTTP 方法和網址：

GET https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/RESOURCE_ID

如要傳送要求，請展開以下其中一個選項：

您應該會收到執行成功的狀態碼 (2xx) 和空白回應。

更新已部署的代理程式

您可以同時更新已部署代理程式的一或多個欄位， 但必須指定至少一個要更新的欄位。更新已部署的代理程式所需的時間取決於執行的更新，但通常只需要幾秒到幾分鐘。

控制台

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

    前往 Agent Engine

  2. 針對指定代理程式，按一下「更多動作」選單 ()。

  3. 按一下「編輯」。代理程式的「編輯」窗格隨即開啟。

  4. 編輯代理的顯示名稱或說明。

  5. 按一下 [儲存]。

Python 適用的 Vertex AI SDK

如要將已部署的代理程式 (對應至 RESOURCE_NAME) 更新為更新後的代理程式 (對應至 UPDATED_AGENT)，請按照下列步驟操作：

from vertexai import agent_engines

agent_engines.update(
    resource_name=RESOURCE_NAME,    # Required.
    agent_engine=UPDATED_AGENT,     # Optional.
    requirements=REQUIREMENTS,      # Optional.
    display_name="DISPLAY_NAME",    # Optional.
    description="DESCRIPTION",      # Optional.
    extra_packages=EXTRA_PACKAGES,  # Optional.
)

引數與部署代理程式時相同。 詳情請參閱 API 參考資料。

REST

呼叫 reasoningEngines.patch 方法，並提供 update_mask 來指定要更新的欄位。

使用任何要求資料之前，請先替換以下項目：

  • PROJECT_ID：您的 GCP 專案 ID
  • LOCATION：支援的區域
  • RESOURCE_ID：已部署代理程式的資源 ID
  • update_mask：以逗號分隔的欄位清單，列出要更新的欄位

HTTP 方法和網址：

PATCH https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/RESOURCE_ID?update_mask="display_name,description"

JSON 要求主體：

{
"displayName": "DISPLAY_NAME",
"description": "DESCRIPTION"
}

如要傳送要求，請展開以下其中一個選項：

您應該會收到執行成功的狀態碼 (2xx) 和空白回應。

刪除已部署的代理程式

從 Vertex AI Agent Engine 代管執行階段刪除已部署的代理程式。

控制台

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

    前往 Agent Engine

  2. 針對指定代理程式，按一下「更多動作」選單 ()。

  3. 點選「刪除」。

  4. 按一下「刪除代理程式」。

Python 適用的 Vertex AI SDK

如果您已部署代理程式執行個體 (如 remote_agent)，可以執行下列指令：

remote_agent.delete()

或者，您也可以透過下列方式呼叫 agent_engines.delete()，刪除與 RESOURCE_NAME 對應的已部署代理程式：

from vertexai import agent_engines

agent_engines.delete(RESOURCE_NAME)

REST

呼叫 reasoningEngines.delete 方法。

使用任何要求資料之前，請先替換以下項目：

  • PROJECT_ID：您的 GCP 專案 ID
  • LOCATION：支援的區域
  • RESOURCE_ID：已部署代理程式的資源 ID

HTTP 方法和網址：

DELETE https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/RESOURCE_ID

如要傳送要求，請展開以下其中一個選項：

您應該會收到執行成功的狀態碼 (2xx) 和空白回應。

後續步驟