Agent Runtime 是全代管的執行階段，可供您部署、運作及調度代理式應用程式。Agent Runtime 會抽象化底層基礎架構，讓您專注於代理邏輯，而非作業。
Agent Runtime 可讓您執行下列操作：
- 部署及調度代理，並透過代管執行階段和端對端管理功能進行管理。
- 使用系統依附元件的建構時間安裝指令碼，自訂代理程式的容器映像檔。
- 使用安全性功能，包括 VPC-SC 法規遵循，以及驗證和 IAM 設定。
- 存取模型和工具，例如函式呼叫。
- 部署使用不同語言和架構建構的代理，以及 Agent2Agent 開放式通訊協定。
在 Agent Runtime 建立及部署
在 Agent Runtime 上建構代理的工作流程如下：
- 設定環境：設定 Google 專案，並安裝最新版 Agent Platform SDK for Python。
- 開發代理：開發可部署至 Agent Runtime 的代理。
- 部署代理：在 Agent Runtime 受管理執行階段中部署代理。
- 使用代理程式：傳送 API 要求來查詢代理程式。
- 管理已部署的代理：管理及刪除已部署至 Agent Runtime 的代理。
支援的語言和架構
只要代理應用程式可以容器化，並符合執行階段合約，Agent Runtime 就支援以任何程式設計語言和代理架構部署代理：
從容器映像檔：如果您為代理程式建構容器映像檔，可以直接從 Artifact Registry 部署至 Agent Runtime。詳情請參閱「從容器映像檔部署」。
透過 Dockerfile：如果您有容器化的原始碼，可以提供
Dockerfile和來源檔案。Agent Runtime 會自動建構及部署容器映像檔。詳情請參閱「從 Dockerfile 部署」。
對於支援的語言和架構，我們提供更高層級的工具和 SDK，簡化部署作業。下表說明 Agent Runtime 對各種代理程式架構的支援程度：
| 支援級別 | 代理架構 |
|---|---|
| 自訂範本：您可以調整自訂範本，支援從框架部署至 Agent Runtime。如要部署自訂容器，請參閱「執行階段合約」。 | CrewAI、 自訂架構 |
| 整合 Agent Platform SDK：Agent Runtime 會在 Agent Platform SDK 和說明文件中，為每個框架提供受管理的範本。 | LangChain, LangGraph, AG2, LlamaIndex |
| 完整整合：整合各項功能，可在框架、Agent Runtime 和更廣泛的 Google Cloud 生態系統中運作。 | Agent Development Kit (ADK) |
使用 Agents CLI 部署至正式環境
Agents CLI 是 Gemini Enterprise Agent Platform 的統一指令列介面和技能組合。為程式設計代理和開發人員提供可預測的路徑，完成代理開發生命週期：支架、評估、部署、發布及觀察。Agents CLI 提供下列功能：
- 預先建構的代理範本：ReAct、RAG、多代理和其他範本。
- 互動式遊樂場：測試及使用代理。
- 自動化基礎架構：使用 Terraform 簡化資源管理。
- CI/CD 管道：運用 Cloud Build 的自動部署工作流程。
- 觀測功能：內建支援 Cloud Trace 和 Cloud Logging。
如要開始使用，請參閱「快速入門導覽課程」。
用途
如要透過端對端範例瞭解 Agent Runtime，請參閱下列資源：
按一下即可展開應用實例
支援的地區
如需 Agent Runtime 支援的區域清單，請參閱「位置」。
配額
如需 Agent Runtime 配額資訊，請參閱「配額與系統限制」。
定價
Agent Runtime 提供免費方案。如要瞭解 Agent Runtime 的定價資訊，請參閱 Gemini Enterprise Agent Platform 定價。
遷移至用戶端 SDK
在 Agent Platform SDK 2.0.1 版中，agent_engines 模組經過重構，並重新命名為獨立 google-cloud-agentplatform 套件 (agentplatform) 下的個別模組 (例如 runtimes、sessions、sandboxes 和 memory_banks)。SDK 採用以用戶端為基礎的設計，主要原因如下：
- 與 Agent Development Kit (ADK) 和 Google Gen AI SDK (
google-genai) 的標準類型表示法保持一致。這可確保不同 SDK 間的資料類型表示方式一致且標準化，進而簡化互通性並減少轉換負擔。 - 在多專案多地點應用程式中，以用戶端層級限定 Google Cloud 參數。這樣一來，應用程式就能透過設定每個用戶端例項 (
client = agentplatform.Client(project=..., location=...)) 的專屬專案和位置資訊設定，管理不同 Google Cloud 專案和地理位置的資源互動。 - 提升 Gemini Enterprise Agent Platform 服務 (
client.runtimes、client.sessions、client.sandboxes和client.memory_banks) 的可探索性和一致性。 - 提供輕量級的解耦套件 (
google-cloud-agentplatform)，專為代理程式工作負載量身打造，同時將生成式 AI 模組遷移至 Google Gen AI SDK (google-genai)。
如需遷移至新版 SDK 架構的詳細操作說明，請參閱下列指南：
- Agent Runtime SDK 遷移：從
vertexai.agent_engines遷移至agentplatform.Client().runtimes。 - Agent Platform SDK for Python：2.0.1 版遷移指南：這份指南涵蓋套件解除耦合、模組淘汰，以及將生成式 AI 模組遷移至 Google Gen AI SDK。