在 Google AI Studio 中开发全栈应用

Google AI Studio 现在支持全栈开发,让您能够构建超出客户端原型范围的应用。借助服务器端运行时,您可以管理密钥、连接到外部 API,并打造实时多人游戏体验。

服务器端运行时

Google AI Studio 应用现在可以包含服务器端组件 (Node.js)。 借助此功能,您可以:

  • 执行服务器端逻辑:运行不应向客户端公开的代码。
  • 访问 npm 软件包Antigravity Agent 可以安装和使用来自庞大 npm 生态系统的软件包。
  • 处理密文:安全地使用 API 密钥和凭证。

使用 npm 软件包

您无需手动运行 npm install。只需让代理添加需要软件包的功能,它就会处理安装和导入。

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

安全地管理密文

借助服务器端代码和密文管理,您现在可以构建与外界互动的应用。

  • 第三方 API:连接到 Stripe、SendGrid 或自定义 REST API 等服务。
  • 数据库:连接到外部数据库(例如通过 Supabase、Firebase 或 MongoDB Atlas),以便在会话结束后仍能保留数据。

在构建实际应用时,您通常需要连接到需要 API 密钥的第三方服务(例如 Twilio、Slack 或数据库)。您可以按照以下步骤手动添加密钥:

  1. 添加 Secret:前往 Google AI Studio 中的设置菜单,然后找到“Secret”部分。
  2. 存储密钥:在此处添加 API 密钥或密钥令牌。
  3. 在代码中访问:代理可以编写服务器端代码,以安全方式(通常通过环境变量)访问这些密钥,确保它们永远不会暴露给客户端浏览器。

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

设置 OAuth

密钥管理的一个主要使用场景是设置 OAuth 以连接到其他网站或应用。如果您的提示包含有关连接到需要 OAuth 身份验证的第三方应用的说明,代理将提供有关如何为该应用设置 OAuth 的说明。这些说明将包含配置 OAuth 应用所需的回调网址。 您还可以在“设置”面板中的集成下找到回调网址。

打造多人游戏体验

全栈运行时可实现实时协作功能。

  • 实时状态:您可以让智能体构建“实时聊天”“协作白板”或“多人游戏”等功能。
  • 同步会话:服务器管理状态,允许多个用户实时与同一应用实例互动。

提示示例:>“将此游戏设为多人游戏,让玩家可以看到彼此的光标。”

多人游戏应用测试提示

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

  1. 在多个标签页中以 Google AI Studio Build 模式打开应用。在“构建”模式下开发时,您的应用位于开发容器中。在多个标签页中打开应用可让您模拟多个用户使用您的应用。
  2. 使用右上角的分享菜单与他人分享应用。 然后,使用分享菜单的集成标签页中的共享网址,与您分享了应用的玩家一起使用该应用。

最佳做法

  • Secret 安全性:请始终使用 Secret 管理器来处理敏感密钥。切勿在文件中对其进行硬编码。
  • 关注点分离:将界面逻辑保留在客户端框架 (React/Angular) 中,并将业务逻辑/数据处理保留在服务器端。
  • 错误处理:确保您的服务器端代码能够稳健地处理来自外部 API 调用的错误,以防止应用崩溃。

后续步骤