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

在快捷模式下，您可以註冊 Gemini Enterprise Agent Platform，並開始在 Google Cloud上建構生成式 AI 應用程式。簡化設定程序後，您就能更輕鬆地存取 Google Cloud API，因為組織、帳單和專案管理作業都變得更簡單。

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

申請使用快捷模式

開發人員只要有 Google 帳戶，即可透過快捷模式使用 Agent Platform：@gmail.com

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

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

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

選取快捷模式

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

瞭解 Agent Platform 快捷模式

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

訂閱快捷模式後，即可享有下列福利：

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

如果您是現有 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)) 不支援快捷模式，且 Gemini Live API 無法在快捷模式的Google Cloud 控制台中使用。如要使用支援的 Gemini Live API 模型，請從快捷模式升級至標準 Google Cloud帳戶。

Agent Platform 快捷模式工作流程

您可以透過下列三個步驟，開始從應用程式傳送要求至 Agent Platform API：

  1. 註冊使用快捷模式後，即可透過 Agent Studio 試用 Agent Platform 功能：

    前往 Agent Studio

    舉例來說，選取「Agent Studio」>「建立提示」，即可使用各種 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 時，您不必擔心機構或專案。不過，在快速模式下使用 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})：在快捷模式 REST API 參考資料的 Agent Platform 中，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 標頭中傳遞 API 金鑰 (例如 -H "x-goog-api-key: API_KEY")。如果用戶端環境不允許您設定 HTTP 標頭，可以改為傳遞 key 系統查詢參數 (?key=API_KEY)。詳情請參閱「使用 API 金鑰」。

查看及管理 API 金鑰

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

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

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

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

    前往 API 金鑰

啟用及管理帳單

啟用帳單功能後，即可提高配額並移除 90 天限制。

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

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

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

    前往 Agent Studio

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

    前往「帳單」頁面

  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