Vertex AI Agent Engine 簡介

Vertex AI Agent Engine 支援 VPC-SC 安全性控制項。不支援資料落地、CMEK 和 AXT 安全控管機制。

如要查看 Vertex AI Agent Engine 入門範例，請在下列其中一個環境中執行「Building and Deploying an Agent with 」(使用 建構及部署代理) 筆記本：

在 Colab 中開啟 | 在 Colab Enterprise 中開啟 | 在 Vertex AI Workbench 中開啟 | 在 GitHub 上查看

Vertex AI Agent Engine 是一組服務，可讓開發人員在正式環境中部署、管理及調度 AI 代理。Agent Engine 會處理基礎架構，以便在正式環境中調度代理，讓您專心打造應用程式。Vertex AI Agent Engine 提供下列服務，可單獨或搭配使用：

• 執行階段：

  • 部署及擴充代理程式，並使用代管執行階段和端對端管理功能。
  • 使用系統依附元件的建構時間安裝指令碼，自訂代理程式的容器映像檔。
  • 使用安全防護功能，包括 VPC-SC 法規遵循和驗證與 IAM 設定。
  • 存取模型和工具，例如函式呼叫。
  • 部署使用不同 Python 架構建構的代理程式：
  • 透過 Google Cloud Trace (支援 OpenTelemetry)、Cloud Monitoring 和 Cloud Logging，瞭解代理程式的行為。

• 品質和評估 (搶先版)：使用整合式 Gen AI Evaluation Service 評估代理程式品質，並透過 Gemini 模型訓練執行作業，最佳化代理程式。

• 樣本儲存庫 (搶先版)：儲存及動態擷取少量樣本，提升代理程式成效。

• 工作階段 (搶先版)：Agent Engine 工作階段可儲存使用者與代理之間的個別互動，提供對話脈絡的明確來源。

• 記憶庫 (搶先版)：Agent Engine 記憶庫可讓您儲存及擷取工作階段資訊，以便個人化代理互動。

Vertex AI Agent Engine 是 Vertex AI Agent Builder 的一部分，這組功能可用於探索、建構及部署 AI 代理。

注意： 由於 Vertex AI Agent Engine 的名稱會隨時間變更，API 參考資料中的資源名稱為 ReasoningEngine，以維持回溯相容性。

在 Vertex AI Agent Engine 中建立及部署

注意：如要透過 IDE 簡化 Vertex AI Agent Engine 的開發和部署體驗，請考慮使用代理程式入門套件。這項服務提供即時可用的範本、內建的實驗 UI，並簡化部署、作業、評估、自訂和可觀測性。

在 Vertex AI Agent Engine 上建構代理的流程如下：

步驟	說明
1. 設定環境	設定 Google 專案，並安裝最新版 Vertex AI SDK for Python。
2. 開發代理程式	開發可部署至 Vertex AI Agent Engine 的代理程式。
3. 部署代理程式	在 Vertex AI Agent Engine 受管理執行階段部署代理程式。
4. 使用代理程式	傳送 API 要求來查詢代理程式。
5. 管理已部署的代理程式	管理及刪除已部署至 Vertex AI Agent Engine 的代理程式。

下圖說明這些步驟：

 

支援的架構

下表說明 Vertex AI Agent Engine 對各種代理程式架構的支援程度：

支援級別	代理程式架構
自訂範本：您可以調整自訂範本，支援從架構部署至 Vertex AI Agent Engine。	CrewAI、自訂架構
整合 Vertex AI SDK：Vertex AI Agent Engine 會在 Vertex AI SDK 和說明文件中，提供每個架構的受管理範本。	AG2、LlamaIndex
完整整合：這些功能已整合至架構、Vertex AI Agent Engine 和更廣泛的 Google Cloud 生態系統。	代理程式開發套件 (ADK)、LangChain、LangGraph

使用 Agent Starter Pack 部署至正式環境

Agent Starter Pack 是一系列適用於正式環境的生成式 AI 代理範本，專為 Vertex AI Agent Engine 而建。Agent Starter Pack 提供下列項目：

• 預先建構的代理範本：ReAct、RAG、多代理和其他範本。
• 互動式遊樂場：測試及與代理互動。
• 自動化基礎架構：使用 Terraform 簡化資源管理。
• 持續整合/持續部署管道：運用 Cloud Build 的自動部署工作流程。
• 可觀測性：內建支援 Cloud Trace 和 Cloud Logging。

如要開始使用，請參閱快速入門。

用途

如要透過端對端範例瞭解 Vertex AI Agent Engine，請參閱下列資源：

用途	說明	連結
連線至公開 API 來建構代理程式	換算貨幣。 建立可連結至匯率應用程式的函式，讓模型能準確回答「今天歐元兌美元的匯率是多少？」等查詢。	Vertex AI SDK for Python 筆記本 - 簡介如何使用 Vertex AI Agent Engine 建構及部署代理程式
	設計社區太陽能專案。 找出潛在位置、查詢相關政府機關和供應商，並查看區域和建築物的衛星圖像和太陽能發電潛力，找出安裝太陽能面板的最佳位置。	Vertex AI SDK for Python 筆記本 - 使用 Vertex AI Agent Engine 建構及部署 Google Maps API 代理程式
連結至資料庫來建構代理程式	與 AlloyDB 和 PostgreSQL 適用的 Cloud SQL 整合。	網誌文章 - 隆重推出適用於 AlloyDB 和 PostgreSQL 適用的 Cloud SQL 的 Vertex AI LangChain Vertex AI SDK for Python 筆記本 - 將使用 PostgreSQL 適用的 Cloud SQL 的 RAG 應用程式部署至 Vertex AI Agent Engine Vertex AI SDK for Python 筆記本 - 將使用 PostgreSQL 適用的 AlloyDB 的 RAG 應用程式部署至 Vertex AI Agent Engine
	使用可存取資料庫中資料的工具建構代理程式。	Vertex AI SDK for Python 筆記本 - 使用 Vertex AI Agent Engine 和 MCP Toolbox for Databases 部署代理程式
	使用自然語言查詢及瞭解結構化資料儲存區。	Vertex AI SDK for Python 筆記本 - 使用 Vertex AI Agent Engine 和 Vertex AI Search 的 RAG 建構對話式搜尋代理
	使用自然語言查詢及瞭解圖形資料庫	網誌文章 - 使用 Vertex AI Agent Engine、LangChain 和 Neo4j 建構 GenAI GraphRAG 和 AI 代理
	使用自然語言查詢及解讀向量儲存庫	網誌文章 - 使用 MongoDB Atlas 和 Vertex AI Agent Engine 簡化生成式 AI RAG
使用 Agent Development Kit (預先發布版) 建構代理	使用 Agent Development Kit 建構及部署代理程式。	Agent Development Kit - Deploy to Vertex AI Agent Engine
	在 Vertex AI Express 模式中，使用 Vertex AI Agent Engine 工作階段和 Memory Bank 管理情境，無須付費。	代理開發套件 - Vertex AI 快速模式中的 Vertex AI Agent Engine 工作階段和 Memory Bank。
使用 OSS 架構建構代理	使用 OneTwo 開放原始碼架構建構及部署代理程式。	網誌文章 - OneTwo 和 Vertex AI Agent Engine：探索 Google Cloud上的進階 AI 代理程式開發作業
	使用 LangGraph 開放原始碼架構建構及部署代理程式。	Vertex AI SDK for Python 筆記本 - 使用 Vertex AI Agent Engine 建構及部署 LangGraph 應用程式
偵錯及最佳化代理	使用 OpenTelemetry 和 Cloud Trace 建構及追蹤代理程式。	Vertex AI SDK for Python 筆記本 - 偵錯及最佳化代理程式：Vertex AI Agent Engine 中的追蹤指南

企業安全性

Vertex AI Agent Engine 支援 VPC Service Controls，可強化資料安全防護，並降低資料遭竊風險。設定 VPC Service Controls 後，已部署的代理程式會保留 Google API 和服務 (例如 BigQuery API、Cloud SQL Admin API 和 Vertex AI API) 的安全存取權，確保在您定義的範圍內順暢運作。VPC Service Controls 的重要功能是有效封鎖所有公用網路存取權，將資料移動限制在授權網路邊界內，大幅提升企業安全狀態。

注意： 如果在 VPC-SC 環境中使用 Vertex AI Agent Engine，您必須在範圍中建立連入規則，允許從 Reasoning Engine 服務代理 ([e-mail]) 連入 storage.googleapis.com 服務和 artifactregistry.googleapis.com 服務。

支援的地區

Vertex AI Agent Engine 支援下列區域：

區域	位置	支援的版本
us-central1	愛荷華州	Google Analytics 功能支援 v1。v1beta1 支援預先發布版功能。
us-east4	北維吉尼亞州	Google Analytics 功能支援 v1。v1beta1 支援預先發布版功能。
us-west1	奧勒岡州	Google Analytics 功能支援 v1。v1beta1 支援預先發布版功能。
europe-west1	比利時	Google Analytics 功能支援 v1。v1beta1 支援預先發布版功能。
europe-west2	倫敦	Google Analytics 功能支援 v1。v1beta1 支援預先發布版功能。
europe-west3	法蘭克福	Google Analytics 功能支援 v1。v1beta1 支援預先發布版功能。
europe-west4	荷蘭	Google Analytics 功能支援 v1。v1beta1 支援預先發布版功能。
europe-southwest1	馬德里	Google Analytics 功能支援 v1。v1beta1 支援預先發布版功能。
asia-east1	台灣	Google Analytics 功能支援 v1。v1beta1 支援預先發布版功能。
asia-northeast1	東京	Google Analytics 功能支援 v1。v1beta1 支援預先發布版功能。
asia-south1	孟買	Google Analytics 功能支援 v1。v1beta1 支援預先發布版功能。
asia-southeast1	新加坡	Google Analytics 功能支援 v1。v1beta1 支援預先發布版功能。
australia-southeast2	墨爾本	Google Analytics 功能支援 v1。v1beta1 支援預先發布版功能。

Agent Engine Memory Bank (預覽版) 支援下列區域：

區域	位置	支援的版本
us-central1	愛荷華州	支援 v1beta1 版本。
us-west1	奧勒岡州	支援 v1beta1 版本。
europe-west1	比利時	支援 v1beta1 版本。
europe-west4	荷蘭	支援 v1beta1 版本。
europe-southwest1	馬德里	支援 v1beta1 版本。

配額

下列限制適用於各區域中特定專案的 Vertex AI Agent Engine：

說明	限制
每分鐘建立、刪除或更新 Vertex AI Agent Engine	10
每分鐘建立、刪除或更新 Vertex AI Agent Engine 工作階段	100
Query 或 StreamQuery Vertex AI Agent Engine 每分鐘	60
每分鐘將事件附加至 Vertex AI Agent Engine 工作階段	100
Vertex AI Agent Engine 資源數量上限	100
每分鐘建立、刪除或更新 Vertex AI Agent Engine 記憶體資源	100
每分鐘從 Vertex AI Agent Engine Memory Bank 取得、列出或擷取資料	300

定價

價格取決於部署至 Vertex AI Agent Engine 受管理執行階段的代理程式所用運算 (vCPU 時數) 和記憶體 (GiB 時數) 資源。

產品	SKU ID	價格
ReasoningEngine vCPU	8A55-0B95-B7DC	$0.0994 美元/vCPU 時數
ReasoningEngine Memory	0B45-6103-6EC1	$0.0105 美元/GiB 時數

詳情請參閱定價。

後續步驟

• 設定環境。
• 取得支援。