連接 Supabase

本指南將帶您完成整個流程：準備 Supabase 帳戶與專案、授權正確的組織、連接專案、檢查連接是否成功，以及在需要時中斷連接。

連接如何運作

每個 Supabase 專案都隸屬於一個 組織，該組織控制誰可以存取及管理其中的專案。當您將 Supabase 連接到 Atoms 時，您會先授權 Atoms 存取您想使用的組織，然後從該組織中選擇一個專案進行連接。

每個 Atoms 專案一次只能連接到 一個 Supabase 專案。不過，同一個 Supabase 專案可以連接到多個 Atoms 專案。

Supabase 和 Atoms 雲是替代性的後端選項。 您無法同時將兩者連接到同一個 Atoms 專案。

開始之前

在連接 Supabase 之前，請確認：

• 您是包含該專案的 Atoms 工作區擁有者。只有工作區擁有者可以授權、連接或中斷 Supabase。
• 您有 Supabase 帳戶，或已準備好在設定過程中建立一個。
• 您有權限授權 Supabase 組織，並存取您想連接的專案。
• 智能體 已完成目前的任務，且 賽馬模式 已關閉。
• 您的瀏覽器允許來自 Atoms 的彈出式視窗。
• 您的 Atoms 專案 尚未連接到 Atoms 雲。

如果這是您第一次嘗試此連接，建議您在熟悉流程時先使用測試專案。

切勿將 Supabase 密碼、API 金鑰、存取 Token 或其他憑證貼到 Chat 中。

連接 Supabase

開啟 Supabase 連接器

1. 開啟您想連接的專案。
2. 在聊天面板右上角，點擊專案名稱。
3. 在出現的下拉選單中選擇 Connectors。
4. 在可用連接器清單中找到 Supabase，然後點擊 connect。

您也可以開啟 Settings → Connectors → Supabase，然後選擇 Connect。

開啟 Settings → Connectors，並為 Supabase 選擇 Connect。

在 Supabase 中授權 Atoms

如果 Organizations 已經顯示您想使用的 Supabase 組織，表示它已經完成授權。您可以繼續前往 選擇 Supabase 專案。

1. Atoms 會開啟一個 Supabase 授權視窗。登入您想連接的 Supabase 帳戶，或在需要時建立新帳戶。
2. 確認您已登入正確的 Supabase 帳戶，然後選擇您要讓 Atoms 存取的組織。
3. 檢查 Atoms 要求的權限。若要查看所有權限，請選擇 Show detailed permissions。如果您同意，請選擇 Authorize Atoms。
4. 返回 Atoms，並等待 Connect success 訊息出現。
5. 在 Atoms 中，開啟 Connectors → Supabase，並確認該組織顯示在 Organizations 下方。

Atoms 會要求對 資料庫、Secrets、Auth、Edge Functions、Environment、Projects、PostgREST 和 Storage 的讀寫權限。它也會要求對 Organizations 和 Domains 的讀取權限。這些權限可讓 Atoms 連接並管理您的專案所使用、受支援的 Supabase 服務。

此授權適用於所選的 Supabase 組織，並不限於您之後連接到目前 Atoms 專案的 Supabase 專案。Atoms 無法存取已連接的 Supabase 帳戶本身無權存取的組織或專案，而 Supabase 權限也可能施加額外限制。

在授權 Atoms 之前，檢查組織與權限。

選擇 Supabase 專案

1. 在 Organizations 下，展開您已授權的組織。
2. 在 Projects 下，找到您想連接的啟用中 Supabase 專案。
3. 如果清單中沒有您需要的組織，請選擇 New Organization 並進行授權。這不會建立新的 Supabase 組織；它只是讓您授權 Supabase 帳戶中另一個已存在的組織。
4. 如果您還沒有專案，請選擇 Create Project 並在 Supabase 中建立一個。等待專案啟用並可供使用後，返回 Atoms 並選擇 Update 以重新整理專案清單。
5. 在您想使用的專案旁，選擇 Connect。

從已授權的組織中選擇一個 Supabase 專案。

確認專案

1. 在確認視窗中，檢查 Supabase Project 下顯示的組織與專案。
2. 如有需要，使用 Supabase Dashboard 或 View Tables 確認您選擇的是正確的專案。
3. 選擇 Connect。
4. Atoms 會將一個 Supabase 連接項目加入專案 Chat。請保持頁面開啟，並等待其完成後，再要求智能體建立資料庫、驗證、儲存或後端功能。

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

檢查連接是否成功

1. 開啟 Settings → Connectors → Supabase。
2. 確認正確的組織與 Supabase 專案顯示為已連接。
3. 選擇 Dashboard 或 Tables，並檢查它是否在 Supabase 中開啟相同的專案。

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

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

測試您的 app 是否能儲存資料

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

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

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

中斷 Supabase 連接

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

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

中斷連接會將此連接從目前的 Atoms 專案中移除。它 不會刪除 Supabase 專案或其資料，也不會移除 Supabase 組織的授權。

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

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

常見問題

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

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

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

外部參考：Supabase — Project Pausing

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

1. 登入正確的 Supabase 組織並開啟已暫停的專案。
2. 選擇 Resume project，並等待直到其狀態為啟用。Supabase 目前的指引指出，低活動量的免費套餐專案可能會在七天的低活動期間後被暫停。
3. 返回 Atoms 並開啟專案的 Connectors 面板。確認 Supabase 已連接，然後重新嘗試受影響的操作。
4. 如果 Atoms 仍顯示連接器為已中斷或已過期，請重新連接並完成要求的授權。

在既有資料受到保護之前，請勿建立新的 Supabase 專案或輪替憑證。如果重新連接失敗，請向 Support 提供 Chat Link、Supabase 專案狀態、時間與時區，以及已去識別化的錯誤截圖。

外部參考：Supabase — Project Pausing