快速模式下的 Gemini Enterprise Agent Platform 簡介

使用 Gemini Enterprise Agent Platform 的快捷模式，即可註冊並開始在 Google Cloud建構生成式 AI 應用程式。這項簡化設定體驗可簡化組織、計費和專案管理，進而簡化 Google Cloud API 的存取。

如要進一步瞭解 Agent Platform 快捷模式，請參閱「Google Cloud快捷模式常見問題」。

申請使用快捷模式

開發人員只要有 @gmail.com Google 帳戶，就能使用 Agent Platform 的快捷模式：

  • 新使用者： Google Cloud 的新使用者可以註冊免費方案的快捷模式帳戶，在指定配額內免費試用 Agent Platform 最多 90 天。註冊免費方案時，不必提供帳單資訊。新增帳單帳戶即可升級至付費級別。

    Agent Platform 快捷模式與 Google Cloud 免費計畫分開，無法透過該計畫使用。如果您使用的是 Google Cloud 免費計畫，請參閱「開始使用」一節中的其他快速入門指南。

如要以快捷模式註冊 Agent Platform，請從 Google Cloud 控制台開啟快捷模式：

前往快捷模式

設定完成後，即可按照下列任一教學課程，開始使用 Agent Platform 的快捷模式：

瞭解 Agent Platform 快捷模式

註冊快捷模式後， Google Cloud 會代您啟用 API。這項程序會在背景執行，因此您不必手動設定資源，就能開始使用 Agent Platform。

註冊快捷模式後，即可使用下列功能：

  • Agent Studio 核心功能。測試及自訂各種生成式 AI 模型的提示詞，並取得可用於自有應用程式的相應程式碼。
  • API 金鑰。驗證應用程式發出的要求。
  • 新 Google Cloud 使用者可享 90 天免費方案。新 Google Cloud 使用者在 90 天的免費方案限制內，可免付費使用支援快捷模式的 Agent Platform API，用量上限為配額。您不必提供帳單資訊。您隨時都能啟用計費功能，提高配額限制。

如果您是現有的 Google Cloud 使用者，或已啟用計費功能，90 天免費方案就會移除。轉換至付費級別，即可享有更高的配額限制和額外 Google Cloud 功能。配額提高後，您用多少就付多少。您隨時可以選擇結束快捷模式，開始使用所有 Google Cloud 服務和功能。

下表列出快捷模式和完整 Agent Platform 體驗的差異：

項目 免費方案中的 Agent Platform 快捷模式 完整 Agent Platform
時間限制 90 天 無限制
可用服務 基本生成式 AI 服務。 所有 Google Cloud 服務，包括 Agent Platform。
資料來源 Google 雲端硬碟 Google Cloud中所有可用的資料來源。
配額 免費方案限制。請參閱「快捷模式中的可用模型和頻率限制」。 標準即付即用限制。請參閱「頻率限制」。
API 端點的標準格式 使用不含專案 ID 或位置的全域端點，並在 x-goog-api-key HTTP 標頭 (或 key 查詢參數) 中傳遞 API 金鑰。例如：
https://aiplatform.googleapis.com/v1/publishers/google/models/MODEL_ID:streamGenerateContent 		指定專案 ID 和位置。例如：
https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:streamGenerateContent

快捷模式下的可用模型和頻率限制

您可以在快捷模式下試用多種模型，包括 Gemini Flash 模型。下表列出快捷模式中可用的模型，以及其頻率限制：

模型類別 可用模型 每分鐘要求數量上限
Gemini gemini-3-pro-image 動態
gemini-3.1-flash-image 動態
gemini-3.1-pro-preview 動態
gemini-3-flash-preview 動態
gemini-2.5-pro 10
gemini-2.5-flash-image 10
gemini-2.5-flash 10
gemini-2.5-flash-lite 10

快捷模式僅支援上表列出的模型。專用的 Gemini Live API 模型 (例如 Gemini 3.8 Live (gemini-3.8-live) 和 Gemini 2.5 Flash Live API Native Audio (gemini-live-2.5-flash-native-audio)) 不支援快捷模式，且Google Cloud 控制台的快捷模式不提供 Gemini Live API。如要使用支援的 Gemini Live API 模型，請從快捷模式升級至標準 Google Cloud帳戶。

Agent Platform 快捷模式工作流程

只要完成三個步驟，即可開始從應用程式傳送要求至 Agent Platform API：

  1. 註冊快捷模式後，請使用 Agent Studio 試用 Agent Platform 功能：

    前往 Agent Studio

    例如，依序選取「Agent Studio」 >「Create prompt」(建立提示)，即可使用各種 Gemini 模型建立及 最佳化多模態提示。

  2. 取得透過使用者介面導入項目的程式碼。

    在提示頁面，依序點選「使用程式碼建構」>「取得程式碼」。面板開啟後，會顯示以程式輔助方式傳送相同要求的程式碼，這些要求與您在使用者介面中實作的要求相同。您可以取得程式設計語言或 curl 的程式碼。您可以使用 Google Colab 試用 Python 程式碼。

  3. 使用 API 金鑰向 Agent Platform API 進行驗證。

    在 Google Cloud 控制台的快捷模式中，依序開啟「API 和服務」 >「憑證」：

    前往「憑證」

    接著，將 Generative Language API 金鑰複製到程式碼中 "YOUR_API_KEY" 的位置。例如：

    Python

    Google Gen AI SDK for Python 可在 PyPI 和 GitHub 取得：

    詳情請參閱 Python SDK 參考資料 (在新分頁中開啟)。 

    from google import genai

# TODO(developer): Update below line
API_KEY = "YOUR_API_KEY"

client = genai.Client(vertexai=True, api_key=API_KEY)

response = client.models.generate_content(
    model="gemini-3.5-flash",
    contents="Explain bubble sort to me.",
)

print(response.text)
# Example response:
# Bubble Sort is a simple sorting algorithm that repeatedly steps through the list

快捷模式有何不同

Agent Platform 的快捷模式提供生成式 AI 的部分功能。因此，如果您以快捷模式註冊，部分 Agent Platform 說明文件可能不適用。如要進一步瞭解快捷模式中可用的 API 端點，請參閱「Agent Platform 快捷模式 REST API 參考資料」。

此外， Google Cloud 中的客戶通常會使用組織和專案來處理資源 (例如呼叫 API 端點)。在快捷模式下使用 Agent Platform 時，不必擔心組織或專案。不過，在以 Express 模式使用 Agent Platform 時，您可能會在參考的 Google Cloud 說明文件中看到這些概念。您仍可使用說明文件，但請忽略提及組織和專案的概念和操作說明。此外，您在快捷模式註冊時選取的位置，會套用至整個體驗。

在快捷模式中呼叫 REST API 端點時，請使用快捷模式的全域端點格式，並以 API 金鑰進行驗證：

標準端點網址 https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:streamGenerateContent
快捷模式中的端點網址 https://aiplatform.googleapis.com/v1/publishers/google/models/MODEL_ID:streamGenerateContent

在快捷模式中傳送 REST 要求時，請注意下列端點和驗證詳細資料：

  • 發布者模型路徑 ({model})：在Agent Platform 快捷模式 REST API 參考資料中，https://aiplatform.googleapis.com/v1/{model}:streamGenerateContent 和 https://aiplatform.googleapis.com/v1beta1/{model}:streamGenerateContent 等端點範本會使用 {model} 代表完整的發布者模型資源路徑 (publishers/google/models/MODEL_ID)。兩者都會解析為相同的端點網址。
  • API 金鑰驗證標頭：不需將 API 金鑰做為查詢參數傳遞。在 x-goog-api-key HTTP 標頭 (例如 -H "x-goog-api-key: API_KEY") 中傳遞 API 金鑰。如果用戶端環境不允許設定 HTTP 標頭，則可改為傳遞 key 系統查詢參數 (?key=API_KEY)。詳情請參閱「使用 API 金鑰」。

查看及管理 API 金鑰

如要向支援快捷模式的 Agent Platform API 端點進行驗證，請使用註冊時建立的 API 金鑰，或在快捷模式中建立的任何金鑰。API 金鑰是加密字串，在您以快捷模式註冊時自動生成。您可以在「APIs & Services」(API 和服務) 頁面查看及管理這些 API 金鑰。

如要進一步瞭解 API 金鑰的最佳管理做法，請參閱「API 金鑰的最佳管理做法」。

如要查看及管理 API 金鑰，請按照下列步驟操作：

  1. 前往 Google Cloud 控制台的「API Keys」(API 金鑰) 頁面：

    前往「API Keys」(API 金鑰) 頁面

啟用及管理帳單

啟用計費功能後，即可提高配額並移除 90 天期限。

啟用計費功能後，您只需為使用的資源付費。您也可以儲存提示詞，並在 Google Cloud 控制台使用其他設定 (未啟用計費功能時，這些設定會顯示為灰色)。

如要管理帳單，請按照下列步驟操作：

  1. 前往 Agent Studio 總覽頁面，並選取快捷模式。

    前往 Agent Studio

  2. 在 Google Cloud 控制台的快捷模式中，開啟「Billing」(帳單)：

    前往「帳單」頁面

  3. 管理帳單帳戶。

開始使用所有 Google Cloud 功能和服務

快捷模式旨在協助您快速上手。當您準備好使用其他Google Cloud 服務，或需要進一步控管環境時，可以將快捷模式帳戶轉換為標準 Google Cloud 帳戶。這個程序有時稱為「升級」。

只要升級快捷模式帳戶，即可開始在專案中使用Google Cloud 提供的所有功能和服務。

如要從快捷模式升級，請按照下列步驟操作：

  1. 在快捷模式中，前往 Agent Studio 總覽頁面。

    前往 Agent Studio

  2. 按一下「立即啟用」，然後按照指示操作。

從快捷模式升級後，請在呼叫 REST API 端點時指定專案 ID 和位置，而非 API 金鑰。例如：

https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:streamGenerateContent