Integrations

连接 Supabase

当你希望应用使用 Supabase 数据库、身份验证、文件存储或后端函数时，将 Atoms 项目连接到 Supabase。

本指南将带你完成整个流程：准备 Supabase 账户和项目、授权正确的组织、连接项目、检查连接是否成功，以及在需要时断开连接。

连接如何工作

每个 Supabase 项目都属于一个 organization，它控制谁可以访问和管理其中的项目。当你将 Supabase 连接到 Atoms 时，你需要先授权 Atoms 访问你想使用的 organization，然后从该 organization 中选择一个项目进行连接。

每个 Atoms 项目在同一时间只能连接到 一个 Supabase 项目。不过，同一个 Supabase 项目可以连接到多个 Atoms 项目。

Supabase 和 Atoms 云是可选的替代后端方案。 你不能同时将两者连接到同一个 Atoms 项目。

开始之前

在连接 Supabase 之前，请确保：

你是包含该项目的 Atoms 工作区所有者。只有工作区所有者才能授权、连接或断开 Supabase。
你拥有一个 Supabase 账户，或已准备好在设置过程中创建一个。
你有权限授权 Supabase organization，并访问你想连接的项目。
智能体 已完成其当前任务，并且 赛马模式 已关闭。
你的浏览器允许来自 Atoms 的弹出窗口。
你的 Atoms 项目 尚未连接到 Atoms 云。

如果这是你第一次尝试此连接，建议在学习流程时使用一个测试项目。

切勿将 Supabase 密码、API 密钥、访问令牌或其他凭据粘贴到 Chat 中。

连接 Supabase

打开 Supabase 连接器

打开你想连接的项目。
点击聊天面板右上角的项目名称。
在出现的下拉菜单中选择 Connectors 。
在可用连接器列表中找到 Supabase ，然后点击 connect。

你也可以打开 Settings → Connectors → Supabase ，然后选择 Connect。

打开 Settings → Connectors，并为 Supabase 选择 Connect。

在 Supabase 中授权 Atoms

如果 Organizations 已显示你想使用的 Supabase organization，则表示它已经获得授权。你可以继续到 选择 Supabase 项目。

Atoms 会打开一个 Supabase 授权窗口。登录你想连接的 Supabase 账户，或在需要时创建一个新账户。
确认你已登录到正确的 Supabase 账户，然后选择你希望 Atoms 访问的 organization。
查看 Atoms 请求的权限。若要查看所有权限，请选择 Show detailed permissions。如果你同意，请选择 Authorize Atoms。
返回 Atoms，并等待 Connect success 消息出现。
在 Atoms 中，打开 Connectors → Supabase，并确认该 organization 显示在 Organizations 下。

Atoms 会请求对 数据库、Secrets、Auth、Edge Functions、Environment、Projects、PostgREST 和 Storage 的读写权限。它还会请求对 Organizations 和 Domains 的读取权限。这些权限使 Atoms 能够连接并管理你的项目所使用的受支持 Supabase 服务。

此授权适用于所选的 Supabase organization，并不限于你之后连接到当前 Atoms 项目的那个 Supabase 项目。Atoms 无法访问已连接的 Supabase 账户本身无权访问的 organization 或项目，而 Supabase 权限本身也可能施加额外限制。

在授权 Atoms 之前，查看 organization 和权限。

选择 Supabase 项目

在 Organizations 下，展开你已授权的 organization。
在 Projects 下，找到你想连接的活动 Supabase 项目。
如果未列出你需要的 organization，请选择 New Organization 并对其进行授权。这不会创建新的 Supabase organization；它只是让你能够授权 Supabase 账户中已存在的另一个 organization。
如果你还没有项目，请选择 Create Project 并在 Supabase 中创建一个。等待项目变为活动并可用后，返回 Atoms 并选择 Update 以刷新项目列表。
在你想使用的项目旁边，选择 Connect。

从已授权的 organization 中选择一个 Supabase 项目。

确认项目

在确认窗口中，检查 Supabase Project 下显示的 organization 和项目。
如有需要，可使用 Supabase Dashboard 或 View Tables 来确认你选择了正确的项目。
选择 Connect。
Atoms 会将一个 Supabase 连接项添加到项目 Chat 中。请保持页面打开，并等待其完成，然后再让智能体构建数据库、身份验证、存储或后端功能。

连接前确认所选的 Supabase 项目。

检查连接是否成功

打开 Settings → Connectors → Supabase。
确认显示为已连接的是正确的 organization 和 Supabase 项目。
选择 Dashboard 或 Tables，并检查它是否在 Supabase 中打开了同一个项目。

已连接项目面板还可能包含指向 Manage Users、SQL Editor、Edge Functions 和 Manage Secrets 的链接。你只需要使用与你正在构建的功能相关的区域。

查看已连接的 Supabase 项目及其管理链接。

测试你的应用是否可以保存数据

连接 Supabase 本身不会自动为你的应用添加数据库功能。在 Chat 中，请让 智能体 构建你想要的功能，并使用已连接的 Supabase 项目来存储其数据。智能体完成后，请测试完整流程。

在 Chat 中，描述你想要的功能、它应保存哪些信息，以及用户应在何处再次看到这些信息。告诉 智能体 使用已连接的 Supabase 项目。
等待 智能体 完成功能构建。
在 App 预览 中，像用户一样使用该功能并输入无害的测试数据。不要使用个人、机密或敏感信息。
刷新 App 预览 或重新打开该功能。确认已保存的信息仍然存在，并显示在正确的位置。
打开 Settings → Connectors → Supabase，选择 Tables，并确认匹配的记录出现在正确的表中。

如果该功能允许用户编辑或删除已保存的信息，也请测试这些操作，并确认应用和 Supabase 中的结果都正确。直接在 Supabase 中所做的更改是否会立即显示在应用中，取决于应用的构建方式。

断开 Supabase

当你不再希望当前 Atoms 项目使用已连接的 Supabase 项目时，请断开 Supabase。

打开 Settings → Connectors → Supabase。
确认你正在查看的是正确 Atoms 项目的连接。
选择 Disconnect Project。
等待 Chat 中的 Supabase 断开连接项完成。
重新打开 Connectors → Supabase，并确认该项目不再显示为已连接。

断开连接会移除当前 Atoms 项目的连接。它 不会删除 Supabase 项目或其数据，也不会移除对 Supabase organization 的授权。

断开后，你的 Atoms 项目中任何依赖 Supabase 的功能都可能停止工作。如果你的应用已经发布，你可能需要先更新已发布版本，变更才会生效。断开后，请同时测试你的项目和线上应用。

从一个 Atoms 项目中断开 Supabase，不会影响连接到同一 Supabase 项目的其他 Atoms 项目。

常见问题

为什么我的 Supabase 连接停止工作了？

打开 Supabase Dashboard 并检查受影响项目的状态。低活跃度的免费套餐项目可能会在七天后被暂停。
如果项目已暂停，请选择 Resume project，并等待 Supabase 报告其已恢复为活动状态。
返回 Atoms，打开项目的 Connectors 面板，并验证 Supabase 连接。将失败的操作重试一次。
如果 Supabase 已经处于活动状态，请记录准确的 Atoms 或 Supabase 错误，并检查连接是否显示为已断开或已过期。仅在状态表明有必要时才重新连接。

在你查明原因并保护好现有数据之前，不要轮换密钥或创建替代项目。如果故障持续，请向支持团队提供 Chat Link、时间和时区、连接状态以及已脱敏的错误截图。

外部参考：Supabase — Project Pausing

如何重新连接一个已暂停的 Supabase 项目？