什么是 Atoms 云？

Atoms 云 提供你的应用与真实用户和信息交互所需的幕后服务。它让你的应用能够保存数据和文件、管理用户、安全存储私密凭证，并使用 AI 功能。与静态网站不同，连接到 Atoms 云的应用可以记住信息，并对用户的操作作出响应。

智能体会同时构建你应用的前端和后端。如果你的应用需要数据库、用户身份验证或文件存储，Atoms 会在构建期间自动连接 Atoms 云。你也可以将其手动连接到现有的受支持项目。

连接后，Atoms 会为你管理底层基础设施。你可以使用 Atoms 云 工作区查看和管理项目的云服务，在开发期间测试你的应用，并在准备就绪后发布它。

本页面概述了 Atoms 云及其工作区当前提供的功能。有关设置步骤和详细说明，请参阅专门的指南。

使用 Atoms 云侧边栏打开 AI、数据库、用户、密钥和 App 存储。

你可以在 Atoms 云中管理的内容

模块	涵盖内容	详细指南
AI	为应用中的功能选择 AI 模型，并查看其使用情况。	在你的应用中使用 AI
数据库	查看和管理你的应用使用的结构化数据。	数据库
Users	查看并搜索已在你的应用中注册的用户。	Authentication
密钥	存储和管理你的应用用于访问外部服务的凭证。	密钥和密文
App 存储	存储和管理你的应用使用的文件。	App 存储

在构建你的应用时，智能体可以为你设置并连接这些服务。请记得在发布前测试结果。

连接前须知

Atoms 云仅适用于受支持的项目，并且只能在桌面端进行管理。已连接到 Supabase 的项目不能再连接 Atoms 云，反之亦然。你的 工作区 权限决定了你可以访问哪些模块。

如果 Connect 被阻止

功能尚不可用： Atoms 云尚未对该项目开放。请等待 Atoms 云对该项目可用，或联系支持团队确认是否符合条件。

套餐限制或出现 Upgrade 消息： 按照屏幕上的升级说明操作，然后返回项目并重试 Connect。

使用限制： 该项目已达到此功能的使用配额。请查看套餐和使用信息，按照可用的升级或续期选项操作，并仅在限制解除后重试。

存储限制： 该项目已达到图片或文件存储上限。请删除不需要的已存储文件，或在产品提供该选项时增加可用存储空间，然后重试。

另一个消息仍在进行中： 在开始连接之前，请先完成当前的智能体消息或请求，然后重试。

Supabase 已连接： 如果你想继续使用 Supabase，请保持连接。若要切换到 Atoms 云，请先断开 Supabase，然后重试 Connect。

打开或连接 Atoms 云

如果在构建期间未连接 Atoms 云，或者你想将其添加到现有的受支持项目中，你可以手动连接它。

1. 在桌面设备上打开该项目。
2. 在包含 App 预览 的同一工作区工具栏中，选择 Atoms 云。
3. 如果 Atoms 云尚未连接，请选择 Connect。如果你看到 Upgrade，请按照屏幕上的说明完成所需的套餐或资源变更。如果有其他消息阻止连接，请停止操作并使用 连接前须知 中的恢复指引。
4. 智能体会启用 Atoms 云并将你带回 App 预览。重新打开 Atoms 云 以查看其模块。

你也可以直接在项目 Chat 中请求智能体为你连接 Atoms 云。

从项目工具栏打开 Atoms 云。

选择 Connect 以为项目启用 Atoms 云。

云使用情况与发布

云和 AI 使用量与用于构建项目的积分分开计量。请参阅 Cloud & AI Wallet 了解当前余额、使用情况和账户控制。

当你的应用准备就绪后，使用 发布你的项目 — 帮助中心草稿 将其发布到在线 URL。

常见问题

为什么我的 Supabase Edge Function 无法运行？

此故障排查路径适用于 Supabase Edge Functions。Edge Functions 不属于上面列出的 Atoms 云工作区模块之一，因此请打开已连接的 Supabase 项目来部署、调用并查看其函数日志。

1. 触发该函数一次，并记录时间、请求、响应状态以及确切错误。
2. 判断该函数是部署失败，还是已成功部署但在调用时失败。
3. 查看该时间戳对应的函数日志。检查请求路径和方法、输入、身份验证、依赖项以及所需环境变量名称。切勿分享密钥值。
4. 进行一项有针对性的修正，部署一次，然后重复相同测试。
5. 确认响应符合预期，并验证相关流程仍可正常工作。

如果该函数仍然失败，请联系支持团队，并提供 Chat Link、函数名称、时间戳和时区、复现步骤、响应状态以及已脱敏的日志。

“Cloud / AI Wallet balance insufficient” 是什么意思？

此消息表示 Cloud & AI 服务的可用余额不足以执行所请求的操作。该钱包与 Plans & Credits 下显示的用于智能体使用的积分是分开的。

1. 打开 Settings → Cloud & AI，查看可用余额和最近使用情况。
2. 如果你选择充值，请在完成充值前确认金额和支付详情。
3. 在确认余额更新后，返回被阻止的操作并重试。

促销金额和资格可能会发生变化，因此请以你自己账户中显示的优惠为准，而不要依赖本 FAQ 中的固定金额。余额过低可能会中断符合条件的云服务或已发布的应用。如果已完成的充值未显示，请不要再次付款；请联系支持团队，并提供交易参考信息和打码后的截图。