Google AI Studio 现在支持全栈开发，让您能够构建超越客户端原型的应用。借助服务器端运行时，您可以管理 Secret、连接到外部 API，以及打造实时多人游戏体验。
服务器端运行时
Google AI Studio 应用现在可以包含服务器端组件 (Node.js)。 借助此功能，您可以：
- 执行服务器端逻辑：运行不应向客户端公开的代码。
- 访问 npm 软件包：Antigravity 智能体可以安装和使用来自庞大 npm 生态系统的软件包。
- 处理 Secret：安全地使用 API 密钥和凭证。
使用 npm 软件包
您无需手动运行 npm install。只需让 Agent 添加需要软件包的功能，它就会处理安装和导入。
示例：>“使用 axios 从外部 API 提取数据。”
安全地管理 Secret
借助服务器端代码和密钥管理，您现在可以构建与世界互动的应用。
Gemini API 密钥
当您创建使用 Gemini API 的新应用时，AI Studio 会自动将您的 GEMINI_API_KEY 配置为服务器端密钥，无需手动设置。您可以在“设置”中的密钥面板中查看此密钥。应用的 Gemini API 调用是通过服务器端代码使用此密钥发出的，因此绝不会在浏览器中公开。
第三方 API 密钥
对于其他服务，您可以手动添加 API 密钥：
- 第三方 API：连接到 Stripe、SendGrid 或自定义 REST API 等服务。
- 数据库：连接到外部数据库（例如通过 Supabase、Firebase 或 MongoDB Atlas），以便在会话结束后保留数据。
在构建实际应用时，您通常需要连接到需要 API 密钥的第三方服务（例如 Twilio、Slack 或数据库）。您可以按照以下步骤手动添加密钥：
- 添加 Secret：前往 Google AI Studio 中的设置菜单，然后找到“Secret”部分。
- 存储密钥：在此处添加 API 密钥或 Secret 令牌。
- 在代码中访问：智能体可以编写服务器端代码，以安全地访问这些密钥（通常通过环境变量），从而确保这些密钥绝不会暴露给客户端浏览器。
需要时，智能体会 在对话中显示一张卡片，提示您在需要新密钥或在项目的环境变量中检测到新密钥时添加密钥。
Firebase 集成，用于数据库和身份验证
Google AI Studio 现在通过 Firebase 集成，可轻松为应用添加数据库或身份验证功能。Antigravity 智能体可以自动为您预配和设置以下服务：
- Firestore 数据库：一种灵活且可扩缩的 NoSQL 云端数据库，用于存储和同步数据，以便进行客户端及服务器端的开发。
- Firebase Authentication：让用户能够使用“使用 Google 账号登录”流程安全地登录您的应用。
只需让代理“向我的应用添加数据库”或“设置 Google 登录”，它就会为您处理必要的配置和代码生成。 在构建 Android 应用时，Firebase 集成还会预配 Firebase AI Logic 和 Firebase App Check，以确保客户端 Gemini API 调用的安全性。
Firebase 允许您免费开始使用，并可选择在您准备好获取更多配额或使用付费功能时，升级到付费账号。
Google Workspace API
借助 Google AI Studio，您可以构建连接到 Google Workspace API 的应用，让用户能够在您的应用中处理其真实数据：电子邮件、电子表格、文档、日历活动等。您不再需要设置 Google Cloud 项目、配置 OAuth 或手动管理 API。
运作方式
您可以通过以下两种方式添加 Workspace 集成：
- 在对话面板中描述：只需在底部的对话面板中告诉智能体您想要什么。例如，“构建一个费用跟踪器，将收据记录到我的 Google 表格中”或“创建一个信息中心，汇总我的未读 Gmail 邮件。”
- 从“集成”面板中选择：在构建模式的右侧边栏中打开集成面板，然后启用要关联的 Workspace 应用。
添加 Workspace 应用后，AI Studio 会自动执行以下操作：
- 为您的应用连接必要的 Google API。
- 生成用于调用 API 的服务器端代码。
- 添加安全的“使用 Google 账号登录”流程，以便应用的最终用户可以授权访问自己的数据。
支持的应用
以下 Google Workspace 应用可供使用：
| App | 您可以构建的内容 |
|---|---|
| Google 日历 | 读取、创建和管理活动及日历 |
| Google Chat | 阅读对话和群组聊天室并与之互动 |
| Google 文档 | 创建、阅读、更新和设置文档格式 |
| Google 云端硬盘 | 整理、搜索和管理文件和文件夹 |
| Google 表单 | 创建调查问卷、更新问题和检索回复 |
| Gmail | 读取、发送和管理邮件内容 |
| Google Keep | 管理记事、清单和附件 |
| Google Meet | 安排和管理视频通话 |
| 通讯录 | 同步和管理联系人 |
| Google 表格 | 读取、写入和设置电子表格数据格式 |
| Google 幻灯片 | 创建和修改演示文稿 |
| Google Tasks | 创建、管理和整理任务 |
身份验证和权限
作为构建者，您无需配置 OAuth 客户端、管理凭证或设置 Google Cloud 项目。AI Studio 会为您处理所有这些操作。
集成了 Workspace API 的应用会使用“使用 Google 账号登录”功能对最终用户进行身份验证。当用户打开您的应用时，系统会提示他们登录并授予应用所需的特定权限（例如，对其日历的只读权限，或编辑电子表格的能力）。您的应用只能访问使用该应用的人员的数据。每位用户都需授权访问自己的账号。
示例提示
以下是一些关于如何开始使用 Workspace 集成的建议：
- “构建一个应用，用于读取我的 Google 日历，并在 Gmail 中为每个会议起草准备电子邮件。”
- “创建一个工具，用于获取 Google 文档，并在 Google 幻灯片中生成一个包含 5 张幻灯片的摘要演示文稿。”
- “制作一个费用跟踪器，当我上传收据时，Gemini 会提取详细信息，并在我的 Google 表格中记录一个新行。”
设置 OAuth
密钥管理的一个关键用例是设置 OAuth 以连接到其他网站或应用。如果您的提示包含有关连接到需要 OAuth 身份验证的第三方应用的说明，代理将提供有关如何为该应用设置 OAuth 的说明。这些说明将包含配置 OAuth 应用所需的回调网址。您还可以在“设置”面板中的集成下找到回调网址。
打造多人游戏体验
全栈运行时可实现实时协作功能。
- 实时状态：您可以让智能体构建“实时聊天”“协作白板”或“多人游戏”等功能。
- 同步会话：服务器管理状态，允许多用户实时与同一应用实例进行交互。
提示示例：>“将此游戏改为多人游戏，让玩家可以看到彼此的光标。”
多人游戏应用测试提示
在部署应用之前，您可以通过两种方式测试多人游戏模式。
- 在多个标签页中以 Google AI Studio 构建模式打开您的应用。在构建模式下开发时，您的应用位于开发容器中。在多个标签页中打开应用，即可模拟多个玩家使用应用。
- 使用右上角的分享菜单与他人分享应用。然后，使用分享菜单的集成标签页中的分享网址，与您已分享应用的用户一起使用该应用。
最佳做法
- Gemini API 调用：您的
GEMINI_API_KEY会自动配置为服务器端 Secret。使用此密钥从服务器端代码发出 Gemini API 调用。您可以在密钥面板中查看该密钥。 - Secret 安全：始终使用 Secret Manager 来管理敏感密钥。切勿在文件中对它们进行硬编码。
- 关注点分离：将界面逻辑保留在客户端框架（React/Angular）中，并将业务逻辑/数据处理保留在服务器端。
- 错误处理：确保您的服务器端代码能够稳健地处理外部 API 调用中的错误，以防止应用崩溃。