在 Google AI Studio 開發全端應用程式¶
Google AI Studio 現在支援全端開發,讓你能建置超越用戶端原型的應用程式。透過伺服器端執行環境,你可以管理機密、連接外部 API,並建置即時多人體驗。
伺服器端執行環境¶
Google AI Studio 應用程式現在可以包含伺服器端元件(Node.js)。這讓你能:
-
執行伺服器端邏輯:執行不應向用戶端公開的程式碼。
-
存取 npm 套件:Antigravity Agent 可以安裝並使用龐大 npm 生態系中的套件。
-
處理機密:安全地使用 API 金鑰與憑證。
使用 npm 套件¶
你不需要手動執行 npm install。只要請 Agent 加入需要套件的功能,它就會處理安裝與匯入。
Example: > "Use axios to fetch data from the external API."
安全地管理機密¶
有了伺服器端程式碼與機密管理,你現在可以建置與外界互動的應用程式。
Gemini API 金鑰¶
當你建立使用 Gemini API 的新應用程式時,AI Studio 會自動將你的 GEMINI_API_KEY 設定為伺服器端機密,無需手動設定。你可以在 Settings 的 Secrets 面板中檢視這把金鑰。你的應用程式會使用這把金鑰,從伺服器端程式碼發出 Gemini API 呼叫,因此金鑰絕不會在瀏覽器中公開。
第三方 API 金鑰¶
對於其他服務,你可以手動加入 API 金鑰:
-
第三方 API:連接 Stripe、SendGrid 等服務,或自訂 REST API。
-
資料庫:連接外部資料庫(例如透過 Supabase、Firebase 或 MongoDB Atlas),將資料持久保存至工作階段之外。
建置實際應用程式時,你經常需要連接需要 API 金鑰的第三方服務(例如 Twilio、Slack 或資料庫)。你可以依照以下步驟手動加入金鑰:
-
加入機密:前往 Google AI Studio 的 Settings 選單,找到 Secrets 區段。
-
儲存你的金鑰:在這裡加入你的 API 金鑰或機密權杖。
-
在程式碼中存取:Agent 可以撰寫伺服器端程式碼,安全地存取這些機密(通常透過環境變數),確保它們絕不會向用戶端瀏覽器公開。
需要時,Agent 也會在聊天中顯示卡片,提示你加入金鑰;無論是需要新的機密時,或在專案的環境變數中偵測到新金鑰時,都會如此。
用於資料庫與驗證的 Firebase 整合¶
Google AI Studio 現在讓你能透過 Firebase integration,輕鬆為應用程式加入資料庫或驗證功能。Antigravity Agent 可以自動為你佈建並設定以下服務:
-
Firestore database:靈活、可擴展的 NoSQL 雲端資料庫,可為用戶端與伺服器端開發儲存並同步資料。
-
Firebase Authentication:讓你的使用者透過「Sign in with Google」流程,安全地登入你的應用程式。
只要請 Agent「add a database to my app」或「set up Google Sign-in」,它就會為你處理必要的設定與程式碼產生。建置 Android apps 時,Firebase 整合也會佈建 Firebase AI Logic 與 Firebase App Check,以便安全地從用戶端發出 Gemini API 呼叫。
Firebase 讓你能免費開始使用,並在你準備好取得更多配額或使用付費功能時,隨時選擇以付費帳戶擴展規模。
Google Workspace API¶
Google AI Studio 讓你能建置連接 Google Workspace API 的應用程式,讓你的使用者能在應用程式中處理他們的真實資料:電子郵件、試算表、文件、行事曆活動等。你不再需要設定 Google Cloud 專案、設定 OAuth,或手動管理你的 API。
運作方式¶
你可以用兩種方式加入 Workspace 整合:
- 在聊天面板中描述:只要在底部的聊天面板中告訴 Agent 你想要什麼。例如,"Build an expense tracker that logs receipts to my Google Sheet" 或 "Create a dashboard that summarizes my unread Gmail messages."
- 從整合面板選取:在 Build mode 右側邊欄中開啟 Integrations 面板,並啟用你想連接的 Workspace 應用程式。
加入 Workspace 應用程式後,AI Studio 會自動:
- 為你的應用程式接上必要的 Google API。
- 產生呼叫該 API 的伺服器端程式碼。
- 加入安全的「Sign in with Google」流程,讓你應用程式的最終使用者能授權存取他們自己的資料。
受支援的應用程式¶
以下 Google Workspace 應用程式可供使用:
| App | 你可以建置什麼 |
|---|---|
| Google Calendar | 讀取、建立並管理活動與行事曆 |
| Google Chat | 讀取對話與群組空間並與之互動 |
| Google Docs | 建立、讀取、更新文件並設定格式 |
| Google Drive | 組織、搜尋並管理檔案與資料夾 |
| Google Forms | 建立問卷、更新問題並擷取回覆 |
| Gmail | 讀取、傳送並管理電子郵件內容 |
| Google Keep | 管理筆記、清單與附件 |
| Google Meet | 安排並管理視訊通話 |
| Contacts | 同步並管理聯絡人 |
| Google Sheets | 讀取、寫入試算表資料並設定格式 |
| Google Slides | 建立並修改簡報 |
| Google Tasks | 建立、管理並組織工作 |
驗證與權限¶
身為建置者,你不需要設定 OAuth 用戶端、管理憑證,或設定 Google Cloud 專案。AI Studio 會為你處理這一切。
整合 Workspace API 的應用程式使用「Sign in with Google」來驗證最終使用者。當使用者開啟你的應用程式時,系統會提示他們登入,並授予你的應用程式所需的特定權限(例如,對其行事曆的唯讀存取權,或編輯試算表的能力)。你的應用程式只會存取正在使用它的那個人的資料。每位使用者都會授權存取他們自己的帳戶。
範例提示詞¶
以下是幾個幫助你開始使用 Workspace 整合的想法:
-
"Build an app that reads my Google Calendar and drafts prep emails in Gmail for each meeting."
-
"Create a tool that takes a Google Doc and generates a 5-slide summary presentation in Google Slides."
-
"Make an expense tracker where I upload a receipt, Gemini extracts the details, and it logs a new row in my Google Sheet."
設定 OAuth¶
機密管理的一個關鍵使用案例,是設定 OAuth 以連接其他網站或應用程式。當你的提示詞包含連接需要 OAuth 驗證的第三方應用程式的指示時,Agent 會提供如何為該應用程式設定 OAuth 的指示。這些指示會包含設定你的 OAuth Application 所需的回呼網址。你也可以在 Settings 面板的 Integrations 下找到回呼網址。
建置多人體驗¶
全端執行環境可實現即時協作功能。
-
即時狀態:你可以請 Agent 建置「a live chat」、「a collaborative whiteboard」或「a multiplayer game」等功能。
-
同步的工作階段:伺服器會管理狀態,讓多位使用者能即時與同一個應用程式執行個體互動。
Example prompt: > "Make this a multiplayer game where players can see each other's cursors."
測試多人應用程式的提示¶
在部署應用程式之前,你可以用兩種方式測試多人模式。
-
在多個分頁中於 Google AI Studio Build mode 開啟你的應用程式。在 Build mode 中開發時,你的應用程式位於開發容器中。在多個分頁中開啟應用程式,可以讓你模擬多位玩家使用你的應用程式。
-
使用右上角的 Share 選單將應用程式分享給他人。然後使用 Share 選單的 Integrations 分頁中的 Shared URL,與你已分享應用程式的玩家一起使用該應用程式。
最佳做法¶
-
Gemini API calls:你的
GEMINI_API_KEY會自動設定為伺服器端機密。請使用這把金鑰,從你的伺服器端程式碼發出 Gemini API 呼叫。你可以在 Secrets 面板中檢視它。 -
Secrets security:務必使用 Secrets 管理工具處理敏感金鑰。絕不要將它們寫死在檔案中。
-
Separation of concerns:將你的 UI 邏輯保留在用戶端框架(React/Angular)中,並將你的業務邏輯/資料處理保留在伺服器端。
-
Error handling:確保你的伺服器端程式碼能穩健地處理外部 API 呼叫的錯誤,以防止應用程式當機。