Google AI Studio 的建構模式

本頁說明如何使用 Google AI Studio 的「建構」模式，快速建構 (或撰寫) 及部署應用程式，測試 Gemini 的最新功能，例如 nano banana 和 Live API。

開始使用

在 Google AI Studio 的建構模式中，以直覺方式開發程式。您可以透過下列幾種方式開始建構：

先輸入提示：在「建構」模式中，使用輸入框輸入要建構的內容說明。選取「AI 晶片」，在提示中加入特定功能，例如生成圖片或 Google 地圖資料。你甚至可以按語音轉文字按鈕，說出想聽的內容。
「好手氣」按鈕：如果需要靈感，請使用「好手氣」按鈕，Gemini 就會生成含有專案構想的提示，協助你開始創作。
從範本庫重新混音專案：從應用程式範本庫開啟專案，然後選取「複製應用程式」。

執行提示詞後，系統會生成必要的程式碼和檔案，並在右側顯示應用程式的即時預覽畫面。

執行提示時，AI Studio 會建立網路應用程式。根據預設，系統會建立 React 網路應用程式，但您可以在「設定」選單中選擇建立 Angular 應用程式。如要查看產生的程式碼，請選取右側預覽窗格中的「程式碼」分頁。

請注意下列檔案：

geminiService.ts：這個檔案包含應用程式的主要邏輯，從建構提示到呼叫 Gemini API 和剖析其回覆。您可以在這個檔案中編輯基本提示，或直接修改任何元件功能，也可以在「建構」模式中與 Gemini 互動對話，請注意，這個檔案中的程式碼會使用 GenAI TS SDK 與 Gemini API 互動。

Google AI Studio 為您的網路應用程式產生初始程式碼後，您有兩種主要選項可繼續進行專案：在 AI Studio 中建構或在外部開發。

您可以在 Google AI Studio 環境中，直接繼續調整及擴充應用程式：

使用 Gemini 進行反覆運算：在建構模式中使用對話面板，要求 Gemini 進行修改、新增功能或變更樣式。舉例來說，你可以要求「新增會向使用者發出快訊的按鈕」，或是「將配色方案改為藍色和白色」。
直接編輯程式碼：開啟預覽面板中的「程式碼」分頁，即可即時編輯。您可以將專案儲存至 GitHub，在開發時使用版本控管功能。

如要使用更進階的工作流程，可以匯出程式碼，並在偏好的環境中作業：

下載並在本機開發：將產生的程式碼匯出為 ZIP 檔案，然後匯入程式碼編輯器。這可讓您使用熟悉的工具、建構系統和本機版本控管做法，在初始原型之外繼續建構。
推送至 GitHub：將程式碼推送至 GitHub 存放區，與現有的開發和部署程序整合。

Google AI Studio 提供多項功能，讓建構過程直覺易懂且視覺化：

註解模式：您不必編寫程式碼來變更應用程式的外觀，只要在註解模式中醒目顯示應用程式 UI 的任何部分，並說明您想進行的變更，舉例來說，您可以選取元件並輸入「將這個按鈕設為藍色」，或「讓這張圖片從左側滑入」。選取「新增至即時通訊」後，系統會根據附註應用程式的螢幕截圖生成提示。
分享應用程式：你可以與他人分享創作內容，共同協作或展示作品。
應用程式庫：應用程式庫提供專案構想的視覺化資料庫。你可以瀏覽 Gemini 的功能、即時預覽應用程式，並重混應用程式，打造專屬版本。

應用程式準備就緒後，即可直接從 AI Studio 部署。部署選項包括：

本節將說明在 Google AI Studio 中使用「建構」模式時的重要限制。

API 金鑰安全性和曝光

任何檢視共用應用程式的使用者都能看到程式碼。請勿直接在應用程式程式碼中使用實際的 API 金鑰。
根據預設，應用程式會使用預留位置 (例如 process.env.GEMINI_API_KEY) 做為 API 金鑰。使用者在 AI Studio 中執行共用應用程式時，AI Studio 會充當 Proxy，以使用者的 API 金鑰取代預留位置，確保您的金鑰保持私密。

應用程式顯示設定和分享

應用程式會儲存在 Google 雲端硬碟中，並沿用其權限模式，因此預設為私人應用程式。
共用權限：將應用程式分享給其他使用者時：
- 共用使用者可以查看程式碼，並將應用程式複製到自己的帳戶。
- 如果共用使用者獲得編輯權限，就能修改應用程式的程式碼。

在 AI Studio 以外部署

您可以將應用程式部署至 Cloud Run，取得公開網址，但這樣一來，所有使用者呼叫 Gemini API 時，都會使用您的 API 金鑰。
- JavaScript 應用程式是在用戶端執行，因此請確保 API 金鑰只有最低存取權，避免資料外洩或遭到濫用。舉例來說，使用者可透過這項機制存取同一專案的其他檔案搜尋商店。
安全地部署至外部：如要在 AI Studio 以外安全地執行應用程式 (例如下載 zip 檔案後)，您必須將使用 API 金鑰的邏輯移至伺服器端元件，防止金鑰暴露給使用者。如果您使用 Cloud Run 部署，則不需要執行這項操作。
金鑰曝光警告：強烈建議不要在用戶端環境中，直接將預留位置替換為實際 API 金鑰，因為這樣一來，所有使用者都能看到金鑰。

工具和功能支援