# 在 Google AI Studio 中开发全栈应用

Google AI Studio 现在支持全栈开发，使您能够构建超越客户端原型的应用程序。通过服务器端运行时，您可以管理机密、连接到外部 API 并构建实时多人游戏体验。

## 服务器端运行时  {% #server-side %}

Google AI Studio 应用程序现在可以包含服务器端组件 (Node.js)。这可以让您：

- **执行服务器端逻辑**：运行不应向客户端公开的代码。

- **访问 npm 包**: 的 [Antigravity 智能体](https://antigravity.google/docs/agent)
  可以安装和使用来自庞大的 npm 生态系统的包。

- **处理秘密**：安全地使用 API 密钥和凭证。

### 使用 npm 包  {% #use-npm-packages %}

您不需要手动运行 `npm install`。只需要求智能体添加需要软件包的功能，它就会处理安装和导入。

**示例**：>“使用 `axios` 从外部 API 获取数据。”

## 安全地管理秘密  {% #secrets %}

通过服务器端代码和机密管理，您现在可以构建与世界交互的应用程序。

### Gemini API 密钥  {% #gemini-api-key %}

当您创建使用 Gemini API 的新应用程序时，AI Studio 会自动配置您的 `GEMINI_API_KEY` 作为服务器端秘密 - 无需手动设置。您可以在 **秘密** 设置中的面板。您的应用程序的 Gemini API 调用是使用此密钥从服务器端代码进行的，因此它永远不会在浏览器中公开。

### 第三方API 密钥  {% #third-party-keys %}

对于其他服务，您可以手动添加API 密钥：

- **第三方API**：连接到 Stripe、SendGrid 或自定义 REST API 等服务。

- **数据库**：连接到外部数据库（例如，通过 Supabase、Firebase 或 MongoDB Atlas）以在会话之外保留数据。

在构建实际应用程序时，您经常需要连接到需要 API 密钥的第三方服务（例如 Twilio、Slack 或数据库）。您可以通过以下步骤手动添加密钥：

1. **添加秘密**: 前往 **设置** Google AI Studio 中的菜单并查找 Secrets 部分。

1. **存储您的密钥**：在此处添加您的 API 密钥或秘密 token。

1. **通过代码访问**：智能体可以编写安全访问这些机密的服务器端代码（通常通过环境变量），确保它们永远不会暴露给客户端浏览器。

需要时，智能体还会在聊天中显示一张卡片，提示您在需要新密钥或在项目的环境变量中检测到新密钥时添加密钥。

### Firebase 数据库和身份验证集成  {% #firebase-integration %}

Google AI Studio 现在可以通过 [Firebase 集成](https://firebase.google.com/docs/ai-assistance/ai-studio-integration)。 Antigravity 智能体可以自动为您配置和设置以下服务：

- **Firestore数据库**：一个灵活、可扩展的 NoSQL 云数据库，用于存储和同步客户端和服务器端开发的数据。

- **Firebase认证**：允许您的用户使用“使用 Google 登录”流程安全地登录您的应用程序。

只需要求智能体“将数据库添加到我的应用程序”或“设置 Google 登录”，它就会为您处理必要的配置和代码生成。建造时 [安卓应用程序](/docs/aistudio-android#firebase-integration)，Firebase集成还规定 **Firebase人工智能逻辑** 和 **Firebase 应用程序检查** 用于安全的客户端 Gemini API 调用。

Firebase 可让您免费开始，并在您准备好获得更多配额或使用付费功能时可选择使用付费帐户进行扩展。

## Google Workspace API  {% #workspace %}

Google AI Studio 允许您构建连接到 Google Workspace API 的应用程序，以便您的用户可以使用他们的真实数据：电子邮件、电子表格、文档、日历事件等，所有这些都在您的应用程序中。您不再需要手动设置 Google Cloud 项目、配置 OAuth 或管理 API。

### 它是如何运作的  {% #workspace-how %}

您可以通过两种方式添加工作区集成：

- **在聊天面板中描述一下**：只需在底部的聊天面板中告诉智能体您想要什么即可。例如， *“构建一个费用跟踪器，将收据记录到我的 Google 表格中”* 或 *“创建一个仪表板来汇总我未读的 Gmail 邮件。”*
- **从集成面板中选择**：打开 **集成** 面板并启用您要连接的 Workspace 应用程序。

当您添加 Workspace 应用程序时，AI Studio 会自动：

1. 为您的应用连接必要的 Google API。
1. 生成服务器端代码以调用 API。
1. 添加安全的“使用 Google 登录”流程，以便您的应用的最终用户可以授权访问自己的数据。

### 支持的应用程序  {% #workspace-apps %}

以下 Google Workspace 应用程序可用：

| 应用程序   | 您可以构建什么           |
| ------ | ----------------- |
| 谷歌日历   | 读取、创建和管理事件和日历     |
| 谷歌聊天   | 阅读对话和群组空间并与之互动    |
| 谷歌文档   | 创建、读取、更新和格式化文档    |
| 谷歌云端硬盘 | 组织、搜索和管理文件和文件夹    |
| 谷歌表单   | 创建调查、更新问题和检索回复    |
| 邮箱     | 阅读、发送和管理电子邮件内容    |
| 谷歌保留   | 管理笔记、列表和附件        |
| 谷歌见面   | 安排和管理视频通话         |
| 联系方式   | 同步和管理联系人          |
| 谷歌表格   | 读取、写入电子表格数据并设置其格式 |
| 谷歌幻灯片  | 创建和修改演示文稿         |
| 谷歌任务   | 创建、管理和组织任务        |

### 身份验证和权限  {% #workspace-auth %}

作为构建者，您不需要配置 OAuth 客户端、管理凭据或设置 Google Cloud 项目。 AI Studio 会为您处理这一切。

集成了 Workspace API 的应用程序使用“使用 Google 登录”来对最终用户进行身份验证。当用户打开您的应用程序时，系统会提示他们登录并授予您的应用程序所需的特定权限（例如，对其日历的只读访问权限或编辑电子表格的能力）。您的应用程序仅访问使用它的人的数据。每个用户都授权访问自己的帐户。

### 提示示例  {% #workspace-examples %}

以下是开始使用 Workspace 集成的一些想法：

- *“构建一个应用程序，可以读取我的 Google 日历并在 Gmail 中为每次会议起草准备电子邮件。”*

- *“创建一个工具，采用 Google 文档并在 Google 幻灯片中生成 5 幻灯片摘要演示文稿。”*

- *“制作一个费用跟踪器，我上传收据，Gemini 提取详细信息，并在我的 Google 表格中记录一个新行。”*

### 设置 OAuth  {% #oauth-setup %}

秘密管理的一个关键用例是设置 OAuth 以连接到其他网站或应用程序。当您的提示包含有关连接到需要 OAuth 身份验证的第 3 方应用程序的说明时，智能体将提供有关如何为该应用程序设置 OAuth 的说明。这些说明将包括配置 OAuth 应用程序所需的回调 URL。您还可以在下面找到回调 URL **集成** 在“设置”面板中。

## 打造多人游戏体验  {% #multiplayer %}

全栈运行时支持实时协作功能。

- **实时状态**：您可以要求智能体构建“实时聊天”、“协作白板”或“多人游戏”等功能。

- **同步会话**：服务器管理状态，允许多个用户与同一个应用程序实例实时交互。

**提示示例**：>“使其成为一款多人游戏，玩家可以看到彼此的光标。”

### 测试多人应用程序的提示  {% #testing-multiplayer %}

在部署应用程序之前，您可以通过两种方式测试多人游戏模式。

1. 在多个选项卡中以 Google AI Studio 构建模式打开您的应用程序。在构建模式下开发时，您的应用程序位于开发容器中。在多个选项卡中打开应用程序将允许您使用您的应用程序模拟多个玩家。

1. 使用以下方式与其他人共享应用程序 **分享** 菜单位于右上角。然后使用 **共享网址** 从 **集成**
   的选项卡 **分享** 菜单，以便与您共享应用程序的玩家一起使用该应用程序。

## 最佳实践  {% #best-practices %}

- **Gemini API 呼叫**: 你的 `GEMINI_API_KEY` 自动配置为服务器端机密。使用此密钥从服务器端代码进行 Gemini API 调用。您可以在 **秘密** 面板。

- **机密安全**：始终对敏感密钥使用机密管理器。切勿将它们硬编码到您的文件中。

- **关注点分离**：将 UI 逻辑保留在客户端框架（React/Angular）中，将业务逻辑/数据处理保留在服务器端。

- **错误处理**：确保您的服务器端代码能够稳健地处理来自外部 API 调用的错误，以防止应用程序崩溃。

## 后续步骤  {% #whats-next %}

- [在 Google AI Studio 中构建应用](/docs/aistudio-build-mode)
- [在 Google AI Studio 中发布应用](/docs/aistudio-deploying)
- [应用程序库](https://aistudio.google.com/apps?source=showcase)
