在 Google AI Studio 應用程式中新增 Cloud Firestore 和 Authentication

Google AI Studio 直接與 Cloud Firestore 和 Firebase Authentication 整合，讓您建構具有持續性資料和安全登入流程的應用程式。在 Google AI Studio 中使用「Add Firebase backend」(新增 Firebase 後端) 功能時，代理程式會產生必要程式碼，並將應用程式連結至 Firebase 專案。

總覽：在 Google AI Studio 應用程式中新增後端

  1. 描述您的構想：在 Google AI Studio 中建立新應用程式，並描述需要資料庫或驗證的功能 (例如「建立共用待辦事項清單」)。

  2. 啟用 Firebase 整合：選取「新增 Firebase 後端」晶片。代理程式會產生必要的程式碼，包括 /src/lib/firebase.ts 檔案和 firestore.rules 檔案，然後將應用程式連結至 Cloud Firestore 和 Firebase Authentication。

  3. 部署：準備就緒後，使用「分享」 >「發布」選項，將應用程式部署到 Cloud Run。

瞭解「Cloud Firestore」的共用配額

代理程式在 Cloud Firestore 中佈建的所有 Google AI Studio 資料庫，都會放在 Firebase 專案的同一個資料庫「群組」中。這些特徵包括：

  • 共用配額：群組中的所有資料庫共用使用配額 (詳情請參閱下文)。
  • 不需帳戶Cloud Billing：您可以建構及測試應用程式，不必新增帳單資訊。如要瞭解如何選擇性新增帳單，請參閱下方詳細資料。
  • 每日重設：如果達到每日配額上限 (例如每日 5 萬次讀取)，服務會暫停群組內所有資料庫的作業，並在隔天太平洋時間午夜左右恢復作業。

共用配額群組中的 Cloud Firestore 資料庫共用下列限制：

指標 配額
儲存的資料量 總共 1 GiB
網路輸出 每月 10 GiB
寫入單位 每日 40,000 次寫入作業
讀取單位 每日 50,000 次讀取作業
即時更新單元 每天 50,000 次更新

(選用) 新增帳單資訊，取得更多 Cloud Firestore 配額

如果應用程式開始受到歡迎，且您需要超出 Cloud Firestore 的免費限制，可以將專案升級至即付即用 Blaze 定價方案。

  1. 新增帳單 (如果尚未新增)：前往 Firebase 控制台，然後將帳單帳戶連結至專案。

  2. 升級資料庫：根據預設，由 Google AI Studio 代理程式建立的 Cloud Firestore 資料庫會繼續使用共用配額，即使您升級定價方案也是如此。如要為特定資料庫啟用完整付費調整資源配置功能，請使用 curl 指令，手動將資料庫移出群組。

    • PROJECT_ID：Firebase 專案 ID，請在 Firebase 控制台的「專案設定」中找到這個 ID。
    • DATABASE_ID：Cloud Firestore資料庫 ID，與小程式 ID 相同；在 Firebase 控制台的Cloud Firestore 資料庫頁面中，找出「名稱」資料欄中的資料庫 ID。
    curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://firestore.googleapis.com/v1/projects/PROJECT_ID/databases/DATABASE_ID?updateMask=limited_free_tier" \
-d '{"limited_free_tier": false}'

Security Rules 項生成作業

Google AI Studio會根據應用程式的邏輯自動產生 Firebase Security Rules。 這些 Security Rules 的設計宗旨是「預設拒絕」，也就是說，應用程式的終端使用者只能存取自己的資料。

請注意，如果您直接在Firebase管理中心手動調整 Security Rules，Google AI Studio 代理程式不會知道這些變更，且這些變更會在後續的應用程式疊代中遭到覆寫。建議使用 Google AI Studio 代理程式調整 Firebase Security Rules，確保變更內容得以保留，並與應用程式的邏輯保持一致。

使用現有專案

您也可以要求Google AI Studio代理程式Cloud Firestore在您擁有的現有Google Cloud專案中佈建。使用提示詞指示代理程式使用現有專案，例如：

Add Firestore to this app using project PROJECT_ID.
  • 系統會使用共用配額，在該專案中佈建新的 Cloud Firestore 資料庫。
  • Firebase Authentication 系統會設定 Google 登入功能。
  • 服務帳戶會取得 Cloud Firestore 資料庫的存取權。如要允許 Google AI Studio 取得管理員存取權，系統會授予名為 ais-sandbox@PROJECT_ID.iam.gservice.com 的新服務帳戶存取 Cloud Firestore 資料庫的權限。這個帳戶只會與你的 Google AI Studio 應用程式建立關聯。
  • 限制：如果 Firebase 專案已有資料庫，代理程式就無法再新增資料庫。Cloud Firestore您必須建立新的空白專案才能使用。

使用 Firebase 控制台

您可以在 Firebase 控制台中查看應用程式的資料和設定。如要存取與 Google AI Studio 相關聯的專案，請按照下列步驟操作：

  1. 前往 Firebase 控制台，然後選取標示為「AI Studio」的專案。
  2. 在左側導覽窗格中，依序點選「建構」 >「Cloud Firestore 資料庫」，即可在 Cloud Firestore 中查看及編輯資料；依序點選「建構」 >「Authentication」，即可設定 Authentication 設定和資料。

疑難排解與常見問題

本文提供常見問題的解答，並說明如何整合 Firebase 與 Google AI Studio 應用程式，以及如何解決相關問題。

支援哪些驗證方法？

使用「Add Firebase backend」(新增 Firebase 後端) 功能時，Google AI Studio 代理程式會設定 Google 登入。如要設定其他方法，請在 Firebase 控制台中啟用這些方法，並請 Google AI Studio 代理程式協助更新程式碼集。

什麼是 firebase-blueprint.json 檔案？

這是 Google AI Studio 代理程式用來瞭解應用程式程式碼集的中繼檔案。請勿手動修改這個檔案，否則代理程式可能會產生不正確的程式碼或不安全的 Security Rules。

如果收到「超過配額」錯誤訊息，該怎麼辦？

達到 Cloud Firestore 配額上限，表示應用程式已達到 Cloud Firestore 資料庫共用配額群組的每日用量上限。解決方法有兩種：

  • 選項 1：等待：系統每天會在太平洋時間凌晨 12 點左右重設配額。
  • 選項 2：升級：升級至即付即用 Blaze 定價方案。
    • 如果 Google AI Studio 專員為您設定 Cloud Firestore，您必須使用這篇文章中說明的 curl 指令新增帳單資訊，將資料庫移至一般付費狀態，才能取得更多 Cloud Firestore 配額。如果您手動設定 Cloud Firestore，就不必執行 curl 指令。

如果收到「缺少權限或權限不足」錯誤訊息，該怎麼辦？

當應用程式嘗試讀取或寫入 Cloud Firestore 資料庫的資料，但要求遭到 Security Rules 拒絕時，就會發生這個錯誤。這表示 Security Rules 不允許根據目前的驗證狀態或資料路徑嘗試執行的作業。按一下「修正錯誤」按鈕，提示 Google AI Studio 代理程式嘗試修正 Security Rules。

刪除 Google AI Studio 應用程式後，Firebase 後端會發生什麼事？

在 Google AI Studio 中刪除應用程式不會自動刪除已連結的 Firebase 專案、Cloud Firestore資料庫或Firebase Authentication設定。

如果您新增了 Firebase 後端，請務必手動前往 Firebase 控制台，刪除專案或清除個別資源 (例如 Cloud Firestore 資料庫執行個體和 Authentication 供應商)，確保所有資料和設定都已移除。

Google AI Studio 代理程式能否刪除或編輯 Cloud Firestore 資料庫中的資料？

Google AI Studio 代理程式可協助佈建必要的後端資源，並生成程式碼和 Security Rules。雖然代理程式本身無法直接刪除、編輯或操控 Cloud Firestore 資料庫中的資料項目，但可以將程式碼寫入小程式，以執行這些動作。如要執行資料管理工作 (例如刪除項目)，請前往 Firebase 控制台的Cloud Firestore資料庫頁面。

我所屬的機構使用 Google Cloud，我可以將 Google AI Studio 應用程式連結至機構 Google Cloud 環境中的現有專案嗎？

確認 Firebase 專案位於特定Google Cloud機構資料夾中：

  1. 請預先手動建立 Firebase 專案。

  2. 在 Google AI Studio 中設定 Firebase 後端時，請指示代理程式使用現有專案：

    Add Firestore to this app using project PROJECT_ID.

為什麼我無法在 Firebase 控制台中找到特定文件？

如果 AI Studio 代理程式將資料儲存至巢狀路徑 (例如 /users/user1/messages/msg1)，但未先建立父項文件 (user1)，就會建立所謂的不存在的父項文件。這些文件不會顯示在 Firebase 控制台中，因此在瀏覽 Cloud Firestore 資料庫時可能難以找到。雖然這不會影響應用程式的執行方式，但您通常可以向 AI Studio 代理程式說明問題，提示代理程式建立缺少的父項文件。

詳情請參閱「不存在的父項文件」。

系統如何選擇 Cloud Firestore 資料庫的位置？

目前，系統會根據您的位置自動選取 Cloud Firestore 資料庫的位置，且無法變更或手動指定。如要選擇特定位置，請在 Google AI Studio 中依序前往「設定」>「提供意見」，將這個需求告訴我們。

Google 如何在 Google AI Studio 中使用我的資料 (例如程式碼和提示)？

如要進一步瞭解資料的使用方式，請參閱《Gemini API 附加服務條款》。