Atoms 云

什么是 Atoms 云？

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

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

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

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

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

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

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

连接前须知

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 云 以查看其模块。

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

从项目工具栏打开 Atoms 云。

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

云使用量与发布

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

当你的应用准备就绪后，使用 发布你的项目 — 帮助中心草稿 让它在实时 URL 上可用。

常见问题

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

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

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

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

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

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

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

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