Integrations

連接 Supabase

當您希望 app 使用 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 key、access token 或其他憑證貼到 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 帳戶本身無權存取的 organizations 或專案，而 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 會在專案 Chat 中新增一個 Supabase 連接項目。請保持頁面開啟，並等待其完成後，再請智能體建立資料庫、驗證、儲存或後端功能。

在連接之前，確認所選的 Supabase 專案。

檢查連接是否成功

開啟 Settings → Connectors → Supabase。
確認顯示為已連接的是正確的 organization 與 Supabase 專案。
選擇 Dashboard 或 Tables，並確認它會在 Supabase 中開啟相同的專案。

已連接的專案面板也可能包含 Manage Users、SQL Editor、Edge Functions 與 Manage Secrets 的連結。您只需要使用與您正在建立功能相關的區域。

檢查已連接的 Supabase 專案及其管理連結。

測試您的 app 是否可以儲存資料

連接 Supabase 本身不會自動為您的 app 新增資料庫功能。在 Chat 中，請要求 智能體 建立您想要的功能，並使用已連接的 Supabase 專案來儲存其資料。智能體完成後，請測試完整流程。

在 Chat 中，描述您想要的功能、它應儲存哪些資訊，以及使用者應在哪裡再次看到這些資訊。請告訴 智能體 使用已連接的 Supabase 專案。
等待 智能體 完成功能建置。
在 App 預覽 中，以使用者的方式使用該功能，並輸入無害的測試資料。請勿使用個人、機密或敏感資訊。
重新整理 App 預覽 或重新開啟該功能。確認已儲存的資訊仍然存在，且顯示在正確位置。
開啟 Settings → Connectors → Supabase，選擇 Tables，並確認對應記錄出現在正確的資料表中。

如果該功能允許使用者編輯或刪除已儲存的資訊，也請測試這些操作，並確認 app 與 Supabase 中的結果都正確。直接在 Supabase 中所做的變更是否會立即顯示在 app 中，取決於該 app 的建置方式。

中斷 Supabase 連接

當您不再希望目前的 Atoms 專案使用已連接的 Supabase 專案時，請中斷 Supabase 連接。

開啟 Settings → Connectors → Supabase。
確認您正在查看的是正確 Atoms 專案的連接。
選擇 Disconnect Project。
等待 Chat 中的 Supabase 中斷連接項目完成。
重新開啟 Connectors → Supabase，並確認該專案不再顯示為已連接。

中斷連接會將目前 Atoms 專案與 Supabase 的連接移除。它 不會刪除 Supabase 專案或其資料，也不會移除該 Supabase organization 的授權。

在您中斷連接後，Atoms 專案中任何依賴 Supabase 的功能都可能停止運作。如果您的 app 已經發佈，您可能需要先更新已發佈版本，變更才會生效。中斷連接後，請同時測試您的專案與線上 app。

將某個 Atoms 專案與 Supabase 中斷連接，不會影響其他連接到同一個 Supabase 專案的 Atoms 專案。

常見問題

為什麼我的 Supabase 連接停止運作了？

開啟 Supabase Dashboard 並檢查受影響專案的狀態。低活動量的免費套餐專案可能會在七天期間後被暫停。
如果它已被暫停，請選擇 Resume project，並等待 Supabase 顯示其已啟用。
返回 Atoms，開啟專案的 Connectors 面板，並驗證 Supabase 連接。將失敗的操作再重試一次。
如果 Supabase 已經是啟用狀態，請記錄確切的 Atoms 或 Supabase 錯誤，並檢查連接是否顯示為已中斷或已過期。只有在狀態顯示需要時才重新連接。

在您找出原因並保護現有資料之前，請勿輪替金鑰或建立替代專案。如果故障持續發生，請向 Support 提供 Chat Link、時間與時區、連接狀態，以及已去識別化的錯誤截圖。

外部參考：Supabase — Project Pausing

如何重新連接已被暫停的 Supabase 專案？